# 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`。**不直接编辑本文件**。