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]>
This commit is contained in:
adminandClaude Opus 4.8 committed 2026-10-26 22:38:24 +08:00
1 parent fbee7ae860
commit d4a22e18b0
7 files changed
+126 -36

No files matched your search

+26 -33
View File
@@ -8,8 +8,8 @@
use std::path::{Path, PathBuf};
use std::sync::Mutex;
use std::time::{SystemTime, UNIX_EPOCH};
use chrono::Utc;
use serde::{Deserialize, Serialize};
use crate::platform::cipher::md5_hex;
@@ -278,36 +278,17 @@ impl AccountStore {
}
/// 当前 UTC 时间(`YYYY-MM-DD HH:MM:SS`)。
///
/// 🔴 **口径 = UTC**(v3 spec §2.3.1 C12):本仓**不再手写日历算法**,
/// 一律用 `chrono` ⇒ 换库/换时区不会漂。
/// ⚠️ 别顺手改成 `chrono::Local`(`Local::now()` 是本机时区 ⇒ 值会变)。
///
/// 📌 全仓两套时间口径(详见 `docs/contract.md` §时间口径):
/// - **UTC**:账号库自己的审计字段(本函数)—— 本仓自有格式,无上游对照;
/// - **服务器本地时区**:业务编码(`tdc/util/code.rs`)与 DB 审计列(SQL `now()`)
/// —— **必须**与上游 Java `LocalDateTime.now()` / MySQL `now()` 同口径。
pub fn now_iso() -> String {
let secs = SystemTime::now()
.duration_since(UNIX_EPOCH)
.map(|d| d.as_secs() as i64)
.unwrap_or(0);
let days = secs.div_euclid(86_400);
let rem = secs.rem_euclid(86_400);
let (y, m, d) = civil_from_days(days);
format!(
"{y:04}-{m:02}-{d:02} {:02}:{:02}:{:02}",
rem / 3600,
(rem % 3600) / 60,
rem % 60
)
}
/// 天元纪日 → 公历年月日(Hinnant 算法,闰年规则完整)。
fn civil_from_days(z: i64) -> (i64, u32, u32) {
let z = z + 719_468;
// 🔴 `if/else` 表达式必须**加括号**再参与运算 —— 否则 `let era = if … {} / 146_097;`
// 的解析含义依赖 Rust 对「块表达式后接运算符」的贪婪规则,脆弱且易被误读。
let era = (if z >= 0 { z } else { z - 146_096 }) / 146_097;
let doe = (z - era * 146_097) as u64;
let yoe = (doe - doe / 1460 + doe / 36_524 - doe / 146_096) / 365;
let y = yoe as i64 + era * 400;
let doy = doe - (365 * yoe + yoe / 4 - yoe / 100);
let mp = (5 * doy + 2) / 153;
let d = (doy - (153 * mp + 2) / 5 + 1) as u32;
let m = if mp < 10 { mp + 3 } else { mp - 9 } as u32;
(if m <= 2 { y + 1 } else { y }, m, d)
Utc::now().format("%Y-%m-%d %H:%M:%S").to_string()
}
#[cfg(test)]
@@ -433,9 +414,21 @@ mod tests {
assert!(!store.bootstrap_admin_uses_default_password());
}
/// 🔴 手写日历算法已删(C12)⇒ 改测「格式 + 口径」两件事:
/// ① 形状必须是 `YYYY-MM-DD HH:MM:SS`(能被 `NaiveDateTime` 解析);
/// ② **口径是 UTC**(与 `Utc::now()` 相差在几秒内)——
/// 一旦有人图省事改成 `Local::now()`,本用例在非 UTC 时区下立刻红。
#[test]
fn civil_from_days_matches_known_dates() {
assert_eq!(civil_from_days(0), (1970, 1, 1));
assert_eq!(civil_from_days(20_750), (2026, 10, 24));
fn now_iso_is_utc_and_parsable() {
let s = now_iso();
let parsed = chrono::NaiveDateTime::parse_from_str(&s, "%Y-%m-%d %H:%M:%S")
.unwrap_or_else(|e| panic!("now_iso 形状不对: {:?} ({})", s, e));
let drift = (Utc::now().naive_utc() - parsed).num_seconds().abs();
assert!(
drift <= 5,
"now_iso 应是 UTC 口径: {} (与 Utc::now() 差 {} 秒)",
s,
drift
);
}
}
+3
View File
@@ -430,6 +430,9 @@ pub async fn create(
};
let op = operator(state, principal);
let id = next_id();
// 🔴 时间口径 = **服务器本地时区**(与上游 Java `LocalDateTime.now()` 同口径)。
// 这里的 `now` 只用于**业务编码**(`f_interface_code` / `f_resource_code` …);
// DB 审计列走 SQL `now()`(同为本机时区)。对照见 `docs/contract.md` §时间口径。
let now = Local::now();
let mut cols: Vec<String> = vec!["f_id".to_string()];
+5
View File
@@ -10,6 +10,11 @@
//!
//! 上游真源:`boot/ssw-tdc/ssw-tdc-biz/.../util/TdcCodeUtil.java`、
//! `boot/ssw-common/ssw-common-biz/.../util/BizCodeUtil.java`(2026-10-24 逐字核对)。
//!
//! 🔴 **时间口径 = 服务器本地时区**(`chrono::Local`,**不是 UTC**):
//! 上游用 `LocalDateTime.now()`(Java,服务器本地)⇒ 本仓必须同口径,
//! 否则同一时刻生成的编码会与上游差一个时区偏移(日期段在跨零点的 8 小时里直接变一天)。
//! 全仓两套口径的对照见 `docs/contract.md` §时间口径。
use chrono::{DateTime, Local};
use rand::Rng;