| | |
|---|
| | | ## 验证注意 |
|---|
| | | - 沙箱内 `Get-NetTCPConnection` 会因权限“拒绝访问”而静默失败，**不要**据此判定端口未监听；判断服务状态以 backend.log / frontend.log 为准。 |
|---|
| | | - 用户要求：临时脚本/文件未经同意不删；导入失败要在页面显示行号；AI 分析结果要给结构化排版 + 逐字输出动画。 |
|---|
| | | - **数据导入权限（2026-10-04 用户明确）**：除非用户明确要求助手导入，否则不要执行任何数据导入、覆盖或重导操作；用户自行导入的数据默认视为已完成，助手只做只读核对。 |
|---|
| | | |
|---|
| | | ## 工作规范（2026-09-02 起，必须遵守） |
|---|
| | | 1. **每做完一个功能，立即测试并写《功能测试报告》** |
|---|
| | | ## 重要节假日快报与分析报告口径（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 按同事提交方式调整） |
|---|
| | | |
|---|
| | | 1. **每做完一个功能，立即测试**（测试要求不变） |
|---|
| | | - 测试至少覆盖：正向用例（正常数据）、负向用例（错类型/错列位/缺列等）、入库抽查（与源文件逐项对齐）。 |
|---|
| | | - 报告写入 `docs/功能测试报告/`，命名：`功能测试报告_<功能名>_<YYYY-MM-DD>.md`。 |
|---|
| | | - 《功能测试报告》写在本地 `docs/功能测试报告/`，命名：`功能测试报告_<功能名>_<YYYY-MM-DD>.md`；**该目录已 gitignore，不入库**（自己留档/复查用）。 |
|---|
| | | - 报告须包含：功能说明、测试环境、用例表（输入/预期/实际/结论）、发现的问题与处置、结论。 |
|---|
| | | 2. **每天下班前写《工作日结》，命名附日期** |
|---|
| | | - 写入 `docs/工作日结/`，命名：`工作日结_<YYYY-MM-DD>.md`。 |
|---|
| | | - 内容至少包含：今天做了什么（功能/修复）、测试结果摘要、遗留问题与待办、明天计划。 |
|---|
| | | - 当天没有代码/测试工作时，也要写（一句话说明“今日无代码改动”即可）。 |
|---|
| | | - **入库的是结论**：把关键结论/口径/风险/待办写进 `HANDOFF.md`（必要时另写 `docs/交接文档_<日期>.md`、`docs/问题汇总/`），与该次代码改动**放在同一条提交**里。 |
|---|
| | | 2. **《工作日结》本地写、不入库** |
|---|
| | | - 写入本地 `docs/工作日结/`，命名：`工作日结_<YYYY-MM-DD>.md`；**该目录已 gitignore，不入库**（给自己看）。 |
|---|
| | | - 内容至少包含：今天做了什么、测试结果摘要、遗留问题与待办、明天计划；当天无代码/测试工作也要写一句话说明。 |
|---|
| | | - 需要交接的部分：把"当前状态 + 待办"追加到 `HANDOFF.md`（同事的做法就是这样）。 |
|---|
| | | 3. **git 工作流（2026-09-03 用户授权，无需再询问是否推送；提交粒度参考同事 xyc）** |
|---|
| | | - **一条提交 = 一个改动**：代码/脚本 + 该改动的说明文档（`HANDOFF.md` / 方案 / 口径清单）放在同一条提交里；不要为每个小改动单独建报告再单独提交。 |
|---|
| | | - message 写法：`feat(模块): …` / `fix(模块): …` / `docs: …` / `docs(交接): …`，一句话说清"改了什么"。 |
|---|
| | | - **禁止入库**：临时脚本与调试产物（`_tmp_*`、`_shots/`、`outputs/`）、构建产物（jar / dist / target）、密钥与口令、大体积备份（`*.sql` 全库导出）；过程日志与日结只留本地。 |
|---|
| | | - 推送前：先按上面完成测试，再 `git fetch origin` 与远端 `main` 对比合并（必要时解决冲突），确认无误后 commit 并 push 到公司 gitea（`http://61.183.254.94:3000/r/trafficAudit.git`，账号 zyj）。 |
|---|
| | | - 若远端已有同事新提交：必须先合并/基于最新再推，禁止强推覆盖同事代码。 |
|---|
| | | - 公司 git 账号密码只通过本机 git 凭据/临时 askpass 使用，禁止写进仓库内任何文档或提交内容。 |
|---|
| | | |
|---|
| | | 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。 |
|---|
