 dsh-agent
|
c199f031c5
|
refactor(stage10): ele / feedback 拆出 repository + model，并补契约测试
背景
- 这两个域把 SQL 与处理器放在同一文件，是全仓仅有的两个零接口测试的后端域。
直接拆会改动 SQL 与参数顺序，而硬约束要求不得变更统计口径 —— 因此按
"可注入化 -> 补契约测试 -> 再提取" 的顺序做。
改动
- ele：拆为 routes.ts（校验与组装）/ repository.ts（全部 SQL）/ model.ts（xlsx 解析、
取值清洗、筛选片段、插入值组装等纯逻辑），并改为 registerEleRoutes(app, deps) 可注入。
- feedback：拆为 routes.ts / repository.ts，同样可注入；建表与截图上传也作为依赖注入。
- 两域各补测试：ele 7 个接口契约 + 6 个模型用例，feedback 9 个接口契约。
mock pool 逐条断言 SQL 文本与参数顺序（含分页、状态白名单、批量插入的 30 列顺序）。
- 架构测试新增一条：已完整分层的三个域（vehicles / ele / feedback）必须有 repository.ts
且 routes.ts 不得出现 SQL。
等价性验证（关键）
- 把改造前的实现从 git 取出，与改造后的实现跑同一批请求（含真实 xlsx 解析路径），
对比每一步落库 SQL、参数、HTTP 状态与响应体：
feedback：6 个场景，SQL + 参数 + 状态完全一致（差异仅 DDL 已移交 db/schema 层）
ele ：5 个场景，SQL + 参数 + 状态 + 响应体完全一致（仅随机 batchId/时间戳做掩码）
- 期间的修正：曾把 /mine 与 /list 的列集合统一，二者实际不同（管理列表多 user_id/user_name），
已按原样保留；测试同时锁定了这一差异。
lint / test(161) / build 全绿，可达性 0 未引用文件。
|
2026-09-11 10:36:05 +08:00 |
|
|
dsh-agent
|
795fb207cb
|
refactor(stage9): 后端业务域目录形状统一
- 每个域现在都是 src/server/routes/<domain>/ 目录：
vehicles/routes.ts（原 routes/vehicles.ts）、vehicle-heatmap/{routes,model}.ts、
hydrogen-heatmap/{routes,model}.ts、ele/routes.ts、feedback/routes.ts。
- 命名约定：index.ts 是聚合器（挂子路由），routes.ts 是叶子路由。mileage/energy/
scheduling 保持 index.ts 聚合，其余统一为 routes.ts。
- 纯移动与改名，未改动任何 SQL、参数顺序、路由挂载前缀或处理器逻辑。
import 改写由一次性 codemod 完成；vehicles/repository.test.ts 读取的源码路径同步更新。
- docs/ARCHITECTURE.md 补充"后端业务域形状"表，并如实标注 ele / feedback 尚未拆出
repository（这两个域缺 SQL 指纹测试，建议先补测试再拆）。
lint / test(139) / build 全绿，可达性 0 未引用文件。
|
2026-09-11 10:30:54 +08:00 |
|
|
dsh-agent
|
954d626afc
|
refactor(stage8): 建表语句集中到 server/db/schema，并修复只读模式的漏写
问题
- 4 处运行时 DDL（scheduling / ele / feedback / mileage 日报）分散在路由与 store 里；
- 只读保护只按 HTTP 方法拦截，而建表由 GET 处理器触发，
于是 DB_READ_ONLY=1 的"只读预览"仍可能执行 CREATE TABLE / ALTER TABLE（已记录在案的漏洞）。
改动
- 新增 src/server/db/schema/{guard,scheduling,ele,feedback,mileage-report}.ts：
建表/改表的唯一位置；guard 提供 ddlAllowed()，DB_READ_ONLY=1 时每个 ensure* 直接跳过并打印一行日志。
- daily-report-store 的表名改为从 schema 模块导出，避免两处各写一份表名。
- 移除 feedback/index.ts 与 ele/migration.ts 中的内联 DDL。
验证
- 实测：DB_READ_ONLY=1 下依次调用 4 个 ensure*，全部跳过且未触碰数据库（无连接错误/挂起）。
- 架构测试新增 2 条：DDL 只允许出现在 server/db/schema；每个 schema 模块必须检查 ddlAllowed()。
lint / test(139) / build 全绿。
|
2026-09-11 10:29:50 +08:00 |
|
|
dsh-agent
|
507bc90ed2
|
refactor(stage5): 合并重复实现，移除失效的演示能力
Excel 导出（原先 4 份各自拼装 workbook）
- 新增 src/shared/xlsx.ts 作为唯一实现：文件名统一 .xlsx、sheet 名截断到 31 字符，
对外提供 buildAoaSheet / buildJsonSheet / writeWorkbook / exportAoaSheet / exportJsonSheet。
只收敛"组装与写出"这一层，各调用方仍自行决定列宽、冻结与数字格式，导出样式不变。
- 迁移 assets（内联 json_to_sheet + writeFile）、mileage/xlsx-export、
hydrogen 的两份 helper（prototype-download.ts 与 download-xls.js，均已删除）。
高德地图（原先 2 份近乎逐行复制）
- 新增 src/shared/amap.ts：SDK 版本、插件列表、安全码注入、底图参数、
控件位置与热力图色带只在此处定义；两个画布只保留各自的半径/透明度。
- 图例渐变条原先把同一组色值又写了一遍，改为复用 shared 的常量，图例与地图不会漂移。
数值格式化
- 两个下钻视图各自复制了同样的 formatNumber/format（共 42 处调用），
统一到 hydrogen/model/display-format.ts 的 formatFixed；默认路径与既有行为逐字一致。
- 原 display-format.ts 里的 finiteNumber/formatNumber/formatScaled 无任何生产调用方，
只被自己的测试引用；改为 formatFixed + blankForMissing 显式选项，
既保留了"真零 vs 不可用"的区分能力，也不再留无人使用的导出。测试同步重写。
失效的演示能力
- Blur / DemoModeProvider 恒为 enabled=false，等于永久 no-op：
移除 13 个文件里 50 处 <Blur> 包裹（渲染结果不变）、删除 components/Blur.tsx
与 Shell 中的 Provider，调用方直接渲染原表达式。
未做（刻意）
- src/lib/cn.ts 不引入 tailwind-merge：全仓只有 2 处调用，不值得新增传递依赖。已在文档说明。
架构守护新增 2 条：只有 shared/amap.ts 可加载高德 SDK；
modules/** 不得再出现 book_new / book_append_sheet / writeFile(。
lint / test(137) / build 全绿，可达性仍为 0 未引用文件。
|
2026-09-11 10:28:32 +08:00 |
|
|
dsh-agent
|
b28ca49491
|
refactor(stage7): 后端目录分层、架构守护测试与文档
后端目录
- db/：mysql / hydrogen / heatmap 连接与氢能只读 SQL 守卫收拢到一处。
- middleware/：auth（JWT → 注入 user）与 read-only 归位。
- 相关测试随文件移动（middleware/read-only.test.ts、db/hydrogen-read-only.test.ts）。
import 改写由一次性 codemod 完成，未改变任何逻辑。
架构守护
- 新增 src/architecture.test.ts，断言 6 条分层铁律：
server 不依赖 modules、前端不依赖 server、shared 为叶子层、
无 vendor 引用、model.ts 不依赖 react、@ts-nocheck 仅限已登记的原型快照。
豁免清单只减不增。
测试基建
- npm test 的 glob 同时匹配 .test.ts 与 .test.tsx（此前 .tsx 测试会被静默漏掉）。
文档
- 新增根 README.md：入口、快速开始、命令、目录、部署注意事项
（JWT_SECRET 必须注入且 >=32 字符，否则拒绝启动）。
- 新增 docs/ARCHITECTURE.md：依赖方向、6 条硬规则、业务域形状、
中间件顺序、新增模块步骤，以及"已知未尽事项"的诚实清单。
lint / test(134) / build 全绿。
|
2026-09-11 10:20:47 +08:00 |
|