影响:仓里不再有第二套日期换算实现;对外行为零变化
(239 条测试全绿、冒烟断言数仍 75、边界与实体自检全绿)。
改动:
- src/tdc/service/account.rs:删手写 civil_from_days(天元纪日换算)与手拼
now_iso(),一律 chrono(Utc::now().format("%Y-%m-%d %H:%M:%S"))
⇒ 输出值与原来逐字相同;单测换成 now_iso_is_utc_and_parsable
(形状可解析 + 与 Utc::now() 差 ≤ 5 秒 ⇒ 有人改成 Local::now() 会红)
- src/tdc/util/code.rs / src/tdc/service/crud.rs:补口径注释(业务编码与
DB 审计列 = 服务器本地时区,与上游 LocalDateTime.now()/now() 同口径)
- docs/contract.md(新):时间口径对照表(含 file:line 引用)
- docs/decisions.md(新):决策日志 D1–D16 摘要 + 补记 D17 + 新增 D18
- CLAUDE.md / .workbuddy/memory/2026-10-26.md 同步
设计:spec 的「口径统一为 UTC」没有全仓执行(记 D18)—— 全仓 UTC 会让业务
编码的日期段在上游的 8 小时错位窗口里差一天 ⇒ 造出新的对上游偏差,且违反
B1b「行为零变化」;落地口径 = 账号库自有审计字段用 UTC(无上游对照物),
业务编码与 DB 审计列用服务器本地时区(有上游对照物)。
Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
3.9 KiB
3.9 KiB
决策记录(decisions)
🔴 本文件是为什么这么定的唯一去处:每条 = 编号 / 决策 / 取值 / 来源。 规格原文见
docs/superpowers/specs/2026-10-26-tdc-rs-mvc-align-v3-design.md§12(D1–D16 的全文在那边)。 与docs/contract.md(对外形状)/docs/known-limitations.md(已知偏差)配套读。
| # | 决策 | 取值 | 来源 |
|---|---|---|---|
| D1 | 前端 | 继续用上游 Vue SPA(不做面 B) | 用户拍板 |
| D2 | 业务边界 | 与上游一致,分批,本批只做底座 | 用户拍板 |
| D3 | 业务包 MVC | 对位上游包结构 + 保留通用引擎 | 用户拍板 |
| D4 | 库 | 单库 | 用户拍板 |
| D5 | 账号层 | 一步切 base_user(官方双 md5) |
用户拍板 |
| D6 | 权限 | 按上游(角色码 + 管理员位,删 18 键) | 用户拍板 |
| D7 | 面 B / perm-smoke-jnpf.sh |
不做 | 由 D1 推导 |
| D8 | 存量 accounts.json 账号 |
不导入(D5 推导;文件保留不删) | 由 D5 推导 |
| D9 | tdsReadOnly |
判据在、种子不种(照抄上游不一致) | spec §4.1 |
| D10 | 借技能的工程化外壳,不借契约层 | 分层 / 尺子 / 文档 / 手册可借;契约层一律不借(面 A·面 B · 600/602 信封 · base_module 菜单 · 复合主键) |
2026-10-26 对标技能 ssw-jnpf-lite-rust |
| D11 | 权限宽严维持追平上游 = 显式敞开 + 显式记账 | 不收紧为 fail-closed(会造出与上游不一致的新偏差) | spec §5.2 / §5.4 |
| D12 | 技能化本批不做 | 阻塞在分发形态(static/ 定位依赖 current_exe() 向上找)⇒ 先做文档层(B5) |
spec §0.4 / §11.3 |
| D13 | B1 拆成 B1a(尺子先行)+ B1b(搬家 + 边界收敛) | cargo test 不覆盖 HTTP 层 ⇒ 无尺子不搬家;B1a 先锁基线断言数 N,B1b 后必须 == N |
spec §2.4 / §8 |
| D14 | codec.rs 归业务层 tdc/util/code.rs |
它是业务编码生成器(PRO/RES/API/DS),不是序列化 codec;ids.rs 留平台层 |
spec §2.1 |
| D15 | tdc_identity 双读写路径显式承认 + 收口 + 记账 |
不硬收进引擎(上游无「通用引擎」概念)⇒ 领域 SQL 收进 src/tdc/service/identity.rs、只 SELECT 明确列、记进 docs/known-limitations.md L1 |
spec §2.3.1 C10 / S8 |
| D16 | numeric 列输出 JSON 数字(不是 JSON 字符串) | 上游 ProductEntity.java:88 的 BigDecimal 只带 @TableField(无 @JsonSerialize)⇒ Jackson 默认 ⇒ 数字 |
2026-10-26 B1a 复核上游取证链 |
| D17 | 鉴权白名单按实际清单剪 9 条(不是 spec 预估的 7 条) | 上游 gateway.white-url 里 P2P 是 5 条(不是 4)⇒ 实际死路径 9 条 ⇒ 本仓照抄实际清单,账本逐条记明 |
2026-10-26 B1b C5(清单见 src/tdc/support/public_paths.rs) |
| D18 | 时间口径 = 两套,各自绑定上游对照物 | C12 的「口径统一为 UTC」若全仓执行 ⇒ 业务编码与 DB 审计列从服务器本地时区变 UTC ⇒ ①违反 B1b「行为零变化」②产生新的对上游偏差(上游 TdcCodeUtil 用 LocalDateTime.now()、审计列用 MySQL now(),都是服务器本地;跨零点的 8 小时里编码日期段直接差一天)⇒ 不做全仓 UTC。落地口径:① 仓里不再手写日历算法,一律 chrono;② 账号库自有审计字段 = UTC(本仓自有格式、无上游对照物;替换实现时保持原值 ⇒ 零行为变化);③ 业务编码与 DB 审计列 = 服务器本地时区(有上游对照物 ⇒ 必须同口径)。对照表写在 docs/contract.md §时间口径 |
2026-10-26 B1b C12(复核上游 TdcCodeUtil.java) |
补记说明
- D1–D16 的完整措辞(含来源链)在 v3 spec §12;本表只留一行摘要,方便日常查。
- D17 / D18 是 v3 spec 落点(
06f5a79)之后、执行中追加的决策 ⇒ 只住本文件。