mjava-ai/CLAUDE.md

mjava-ai

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

开发前必读

• 仓库基线：openspec/specs/project-baseline.md（代码锚点 + 子项目清单）
• 通用规范：/Users/malk/Desktop/Tech/claude/后端/CLAUDE.md（含 Client/Service 分层规则 R1~R7）
• 宜搭特化：/Users/malk/Desktop/Tech/claude/后端/.claude/docs/yida-serverside.md
• 分层规则 capability spec：openspec/specs/client-service-layering/spec.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/
• 2026-04-26-add-integration-user-api → specs/integration-user-api/
• 2026-06-10-standardize-client-service-layering → specs/client-service-layering/

进行中（changes/）：

• add-observability-foundation 12/14 — 待生产冒烟
• add-mjava-pro 15/30 — 骨架完成，DynamicDDService 推进中
• add-mjava-com 19/30 — 骨架完成，README 文档补完后归档；首批 action 等首调用方接入再补
• rename-dingtalk-impl-suffix 立项中 — 钉钉 14 个中缀文件改后缀，分 4 批
• define-customer-tiering 立项中 — 客户接入三档分流（A/B/C）

快速操作

• 新客户接入：复制 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 层）