| | |
|---|
| | | ## 验证注意 |
|---|
| | | - 沙箱内 `Get-NetTCPConnection` 会因权限“拒绝访问”而静默失败，**不要**据此判定端口未监听；判断服务状态以 backend.log / frontend.log 为准。 |
|---|
| | | - 用户要求：临时脚本/文件未经同意不删；导入失败要在页面显示行号；AI 分析结果要给结构化排版 + 逐字输出动画。 |
|---|
| | | - **数据导入权限（2026-10-04 用户明确）**：除非用户明确要求助手导入，否则不要执行任何数据导入、覆盖或重导操作；用户自行导入的数据默认视为已完成，助手只做只读核对。 |
|---|
| | | |
|---|
| | | ## 重要节假日快报与分析报告口径（2026-10-04 起） |
|---|
| | | - 快报百分比必须先按导入的 `2026年十一数据.xlsx` 对应单元格的数字格式生成显示值，再按快报统一 1 位小数取整。当前源表不是全局同一精度：多数单元格是 `0.0%`；`人员流动量汇总` 的当日环比 D/P/J、累计同比 V/W/Y/Z/AB/AC，道路 `H`（同比2024年），以及水路当日环比 D 是 `0.00%`。 |
|---|
| | | - `人员流动量汇总` 的累计值 U/X/AA 存的是亿单位，单元格格式为 `0.0000000_`；快报必须在换算万人次前先按亿单位 7 位小数生成显示值，再乘 10000 并按快报 2 位输出。对应总计、公路合计、非营业性小客车三项。 |
|---|
| | | - 核对领导分析报告时，按该分析报告自身显示的小数位核对，不套用快报的 1 位小数口径；目标是复现人工在文档/Excel 上看到的值。 |
|---|
| | | |
|---|
| | | ## 工作规范（2026-09-02 起；2026-09-27 按同事提交方式调整） |
|---|
| | | |
|---|
| | |
|---|
| | | 4. **git 单仓库约定（2026-09-21 用户确认，替代 2026-09-07 的双仓库约定）** |
|---|
| | | - 本机只使用公司 gitea：`origin` = `http://61.183.254.94:3000/r/trafficAudit.git`（账号 zyj）。个人 gitee 仓库已不再使用，不要再把它当作 origin 或额外拉取源。 |
|---|
| | | - 拉取/推送一律走 `origin`（远端分支 `main`）：先拉合并，禁强推，再 commit/push。 |
|---|
| | | |
|---|
| | | |
|---|
| | | 5. **验收门禁（分级；2026-10-06 用户确认，参考同事 xyc 的做法）** |
|---|
| | | - **一般功能 / 修复 / 重构**：沿用现行规则——按第 1 条完成测试后即 commit + push，不等待人工验收。 |
|---|
| | | - **口径类 / 版式类 / 任何会改变输出数字或表格版式的改动**：代码与文档照常提交推送，但必须在 `HANDOFF.md` 对应段落标注 **【待验收】**，写清验收项与产物路径；用户验收通过后，再补一条 `docs(交接): …` 提交把状态改为「已验收（YYYY-MM-DD）」。 |
|---|
| | | - 未验收的改动，提交信息与交接段里禁止写成「已完成 / 已验证」，只能写「待用户验收」。 |
|---|
| | | - 例外优先：用户当次明确说「先不提交 / 等验收再提交」时，一切以用户当次指示为准。 |
|---|
