mjava-ai

Java 后端基座 + 客户子项目仓库。Spring Boot 2.2.13 + MySQL，第一阶段不引入 Redis/Docker。

开发前必读

仓库基线：openspec/specs/project-baseline.md（代码锚点 + 子项目清单）
通用规范：/Users/malk/Desktop/Tech/claude/后端/mjava-baseline.md（11 章，权威）
宜搭特化：/Users/malk/Desktop/Tech/claude/后端/yida-serverside.md

OpenSpec 工作流（opsx）

任何规范变更或功能新增，走 change 流程：

命令	用途
`/opsx:explore`	在改动前做需求/约束梳理
`/opsx:propose`	新建 change（proposal+design+spec+tasks 四件套）
`/opsx:apply`	执行 tasks.md 的实现步骤
`/opsx:archive`	完成后归档到 `openspec/changes/archive/`

现有 change 状态（2026-04-19 更新）：

已归档（changes/archive/）：

2026-04-18-extract-dingtalk-standard-api → specs/crypto-utils/
2026-04-19-init-project-baseline → specs/project-baseline.md
2026-04-19-extend-yida-api-coverage → specs/yida-form-atomic/ + specs/yida-process-atomic/
2026-04-19-extend-dingtalk-contacts-api → specs/dingtalk-contacts-v2/
2026-04-19-add-request-auth-replay-guard → specs/request-auth/ + specs/replay-guard/

进行中（changes/）：

add-observability-foundation 12/14 — 待生产冒烟
add-mjava-pro 15/30 — 骨架完成，TenantTaskDecorator / DynamicDDService 延后
add-mjava-com 19/30 — 骨架完成，DingtalkActionRegistry / AliworkActionRegistry 首批 action 待补

快速操作

新客户接入：复制 mjava-mcli 模板，详见基线文档第 9 章
本地编译：mvn -pl mjava-{module} -am clean compile
打包：mvn -pl mjava-{module} -am clean package -Dmaven.test.skip=true

严禁

❌ 引入三方 SDK（钉钉/宜搭/飞书 SDK 都禁）—— 统一用 UtilHttp
❌ 每请求重新拉 token —— 统一走 UtilToken 缓存
❌ 硬编码 appKey/appSecret —— 读 application-{profile}.yml
❌ 绕过 JPA 写原生 SQL 字符串拼接

当前活跃目录位置

/Users/malk/server/cur/mjava-ai/（2026-04-18 从 /Users/malk/server/mjava-ai 迁入 cur 层）