mjava-ai/openspec/specs/project-baseline.md

project-baseline

mjava-ai 仓库稳态基线。2026-04-18 建立。

权威规范位置

不在本文件。规范正文维护在跨仓库共享的文档中心：

• 通用后端基座：/Users/malk/Desktop/Tech/claude/后端/mjava-baseline.md
• 宜搭服务端特化：/Users/malk/Desktop/Tech/claude/后端/yida-serverside.md
• 顶层共享规范：/Users/malk/Desktop/Tech/claude/CLAUDE.md

本文件只做三件事：指路、列代码锚点、列子项目清单。

代码锚点

基座 mjava/src/main/java/com/malk/：

能力	路径
HTTP 请求封装	utils/UtilHttp.java
Token 缓存	utils/UtilToken.java
统一响应	server/common/McR.java、server/common/VenR.java
业务异常	server/common/McException.java
全局异常拦截	filter/CatchException.java
链路追踪	filter/TraceIdFilter.java
请求拦截器	filter/RequestInterceptor.java
Repository 基类	base/BaseRepository.java
PO 基类（含审计）	base/BasePo.java
多数据源配置	config/DataSourceConfig.java
启动类	Boot.java（含 JPAQueryFactory Bean）

第三方对接服务：service/{dingtalk,aliwork,beisen,ekuaibao,fxiaoke,h3yun,teambition,vika,xbongbong}/

子项目清单

模块	作用	备注
mjava	基座 jar	无 repackage，被子项目 ${mjava.version} 依赖
mjava-mcli	客户模板	最小化 Boot.java + yml；新客户接入复制此模块
mjava-shunfeng	生产客户	会议聚合（腾讯会议/Zoom/钉钉日程）
mjava-guangming	生产客户	钉钉 SSO 邮箱

新客户接入（简版）

1. cp -r mjava-mcli mjava-{customer}
2. 改 pom.xml 的 artifactId
3. 改 Boot.java 包名与 scanBasePackages = {"com.malk"} 保持
4. 改 application-{dev,prod}.yml 的 server.port / server.servlet.context-path / spring.datasource.*
5. 根 pom.xml <modules> 追加 <module>mjava-{customer}</module>
6. mvn -pl mjava-{customer} -am clean compile 验证

完整流程与约束见权威文档第 9 章。

演进

对本基线的任何修改（新增代码约定、调整包结构、引入新依赖），必须走 /opsx:propose 流程新建 change，经 apply 后 archive。不直接编辑本文件。