|
@@ -0,0 +1,74 @@
|
|
|
|
|
+# 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 项)
|
|
|
|
|
+```
|