Files
tdc-rs/docs/decisions.md
T
adminandClaude Opus 4.8 d4a22e18b0 refactor(b1b-c12): 手写日历算法换 chrono —— 时间口径写进 contract.md
影响:仓里不再有第二套日期换算实现;对外行为零变化
(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]>
2026-10-26 22:38:24 +08:00

34 lines
3.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 决策记录(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`)之后、执行中追加的决策 ⇒ 只住本文件。