mjava-ai 待办看板
更新：2026-04-18
范围：跨 change 的待办池 + 每 change 内部进度汇总
用途：按优先级顺序执行；完成一项立即更新对应 tasks.md 和本文件
执行阶段
| 阶段 |
内容 |
当前状态 |
| A |
开发规范 + 待办清单（文档层） |
进行中 |
| B.1 |
代码优化：补全 mjava 模块 API 能力 |
待启动 |
| B.2 |
代码优化：待办功能添加（非 pro/com 的基座增强） |
待启动 |
| C |
mjava-pro / mjava-com 两个专项子模块开发 |
待 B 完成后启动 |
阶段 A 待办
| ID |
任务 |
状态 |
| A1 |
开发规范 11 章（mjava-baseline.md）写到 §3.5 审计、§3.4 Client/Service 分层 |
✅ 完成 |
| A2 |
yida-serverside.md 从原 CLAUDE.md 拆出 |
✅ 完成 |
| A3 |
后端/CLAUDE.md 改为总索引 |
✅ 完成 |
| A4 |
上层 claude/CLAUDE.md 同步索引 |
✅ 完成 |
| A5 |
server 目录分层 cur/pre |
✅ 完成 |
| A6 |
mjava-ai 仓库 git init + 首次 commit + push |
✅ 完成 |
| A7 |
敏感文件 .gitignore 防护 + .example 模板 |
✅ 完成 |
| A8 |
mjava-pro / mjava-com 专项提案四件套 |
✅ 完成 |
| A9 |
init-project-baseline tasks 5.1-5.3 验证 |
✅ 完成 |
| A10 |
执行 /opsx:archive extract-dingtalk-standard-api（全部 tasks 已 [x]） |
⏳ 等用户触发 |
| A11 |
brew install maven 后补做 init-baseline 任务 5.4（编译冒烟） |
⏳ 阻塞在本机未装 Maven |
| A12 |
/Users/malk/Desktop/Tech/claude/ 是否 git init（规范文档版本化）？ |
❓ 待用户决定 |
阶段 B.1 — 补全 mjava 模块 API 能力
现状观察：mjava/service/{vendor}/ 下每个 vendor 已有 Client + Client_{Domain} 的骨架，但官方新 API 不断增加，部分 endpoint 可能缺失。
| ID |
任务 |
备注 |
| B1.1 |
盘点钉钉 Client 覆盖度（对照钉钉开放平台官方 API 列表） |
输出缺失 endpoint 清单 |
| B1.2 |
盘点 YDClient 覆盖度 |
对照宜搭 API 文档 |
| B1.3 |
盘点 BSClient（北森）覆盖度 |
对照北森 API 文档 |
| B1.4 |
盘点其余 vendor（teambition / fxiaoke / h3yun / vika / xbongbong / feishu / ekuaibao）覆盖度 |
低优先级，按需补 |
| B1.5 |
按 §3.4 规范补缺失 endpoint：方法签名必须兼容官方全部参数，禁止为图省事删减字段 |
每个 vendor 一个 PR |
| B1.6 |
Client 新增方法的 Service 层编排（如需批量 / 分页聚合） |
按需 |
阶段 B.2 — 待办功能添加（基座增强）
不依赖 pro/com 专项的基座功能增强，都先做在 mjava/ 基座里，让三个现存客户模块可立刻受益。
| ID |
任务 |
需求出处 |
备注 |
| B2.1 |
UtilHttp 内部落实 §3.5 审计日志（请求/响应脱敏 + latency + success） |
mjava-baseline §3.5 |
脱敏规则：token/appSecret/password/aesKey/privateKey → *** |
| B2.2 |
UtilToken 支持 namespace 参数（为 mjava-pro 租户隔离铺路） |
mjava-pro design.md |
API：put(namespace, key, value, ttl)；回退模式保留无 namespace 版本 |
| B2.3 |
CallerRateLimiter 抽象（通用限流组件） |
mjava-com design.md |
Guava RateLimiter 封装；也可服务 pro 的租户级限流 |
| B2.4 |
完成 add-observability-foundation tasks 4.2 / 5.2（生产冒烟） |
observability change |
需 Maven |
| B2.5 |
把 Client 方法兼容全参数的代码审查清单（checklist）沉淀进 /opsx:propose 的模板 |
用户规范要求 |
避免将来 PR 漏传字段 |
| B2.6 |
请求监听的 trace 输出示例（配合 TraceIdFilter 展示完整链路格式） |
baseline §3.5 / §8 |
文档用 |
阶段 C — 专项子模块开发（最后启动）
| 专项 |
tasks.md 进度 |
add-mjava-pro/ |
0 / 30 |
add-mjava-com/ |
0 / 30 |
按 tasks.md 依序走 /opsx:apply。
进度总览（累计）
✅ 已完成：~20 项（初始化 + 规范 + 归档准备 + 验证）
⏳ 阻塞：2 项（Maven 未装）
📋 代办：~66 项（B.1 清单待出 + B.2 六项 + C 两专项 60 项）
