## 基线规范（本仓库视角）

本仓库 `mjava-ai` 采纳 mjava 基座通用后端开发规范。权威版本维护在文档中心：

**权威文档**：`/Users/malk/Desktop/Tech/claude/后端/mjava-baseline.md`（11 章）

本 spec 只记录**仓库内差异点**与**代码锚点**，不复述规范正文。

### 仓库内现状差异

| 项目 | 规范要求 | 本仓库现状 | 差距 |
|------|---------|-----------|------|
| 健康检查端点 | `/actuator/health` 可访问 | 已新增依赖与配置，未生产冒烟 | 见 `changes/add-observability-foundation` |
| TraceId 链路 | 每条日志带 traceId | 已实施 filter + logback pattern | 见 `changes/add-observability-foundation` |
| RSA 加密工具 | 基座 `com.malk.util.crypto` | 已下沉，旧位置留委托壳 | 见 `changes/extract-dingtalk-standard-api` |

### 代码锚点

| 规范章节 | 代码位置 |
|---------|---------|
| HTTP 调用 (mjava-baseline §3) | `mjava/src/main/java/com/malk/utils/UtilHttp.java` |
| Token 缓存 (§4) | `mjava/src/main/java/com/malk/utils/UtilToken.java` |
| 响应与异常 (§6) | `mjava/src/main/java/com/malk/server/common/{McR,VenR,McException,McPage}.java` |
| 全局异常拦截 (§6) | `mjava/src/main/java/com/malk/filter/CatchException.java` |
| 持久化基类 (§7) | `mjava/src/main/java/com/malk/base/{BaseRepository,BasePo,BaseDto}.java` |
| 链路追踪 (§8) | `mjava/src/main/java/com/malk/filter/TraceIdFilter.java` |
| 多数据源 (§5) | `mjava/src/main/java/com/malk/config/DataSourceConfig.java` |
| 客户子项目模板 (§9) | `mjava-mcli/` |

### 子项目清单

| 子模块 | 状态 | 端口/context-path |
|--------|------|-------------------|
| `mjava` | 基座 jar | - |
| `mjava-mcli` | 模板 + 最小实例 | 9001 / /api/mcli |
| `mjava-shunfeng` | 已交付生产 | 见 `mjava-shunfeng/application-prod.yml` |
| `mjava-guangming` | 已交付生产 | 见 `mjava-guangming/application-prod.yml` |

### 变更边界

规范正文修改（如新增第 12 章、调整 HTTP 封装约定）必须走 `/Users/malk/Desktop/Tech/claude/后端/mjava-baseline.md` 的编辑 + 本仓库 `/opsx:propose` 新建对应 change。**不在本 spec 内直接编辑规范正文。**