mjava-ai/openspec/changes/archive/2026-04-19-init-project-baseline/spec.md

基线规范（本仓库视角）

本仓库 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 内直接编辑规范正文。