shishengliang
c2f21a3a8a
fix: restore post-v1.1.14 features while preserving asset updates
...
ci/woodpecker/push/woodpecker Pipeline was successful
Undo the full-tree rollback in 6ea1b3d
2026-09-16 10:48:32 +08:00
shishengliang
6ea1b3d5dd
revert: restore v1.1.14 ( 37a9f303)
ci/woodpecker/push/woodpecker Pipeline failed
2026-09-16 09:29:30 +08:00
dsh-agent
25e53b8f66
refactor(stage16): 里程域移入 repository，后端分层全部完成
...
改动
- 新增 mileage/repository.ts：18 个查询函数，覆盖
vehicle-info（含搬走的 VEHICLE_INFO_SQL 共享常量）、trend、监控缓存、targets（8 条）、
daily-report-store（5 条）、daily-report-service。
- 6 个含 SQL 的文件改为调用 repository；路由/服务层不再出现 SQL 文本。
- 日报写入的两个函数改为返回 affectedRows（调用方本来只用它），而不是行数组。
- 架构守护的"已完整分层"清单加入 mileage —— 至此八个域全部在守护范围内。
SQL 保持性验证
- 逐字比对：改造前 6 个文件里的 19 条 SQL 字面量，除"动态 INSERT 关键字"一处外，
全部在 repository.ts 中原样出现。
- 那一处是 `${insert} INTO ${TABLE}`（insert 为 'REPLACE' | 'INSERT IGNORE'），
改为 `${replace ? "REPLACE" : "INSERT IGNORE"}`；已渲染两个分支与原文本逐字比对，均为 identical。
验证
- 全量 lint / test(191) / build 全绿，可达性 0 未引用文件。
- 里程域的模型层测试（cache-model / oneos-model / daily-report-model）以及依赖里程的
调度、车辆热力图契约测试全部通过。
2026-09-11 10:57:29 +08:00
dsh-agent
9750d35ba4
refactor(stage15): 氢能 v2 移入 repository，能源域完成并加入守护清单
...
改动
- hydrogen-bi-v2.ts 的 14 条查询移入 energy/repository.ts（SQL 与参数表达式逐条对应）。
- 片段组装也随之搬走，因为它们本质是 SQL 构造，留在路由里会让"路由不含 SQL"形同虚设：
resolvedWhere / stationMasterRegionSql / buildFilterClauses / buildGroupSelect /
buildGroupExpression / buildScopedWhere。
- 承担方映射片段（CUSTOMER/COMPANY/OTHER_BEARING_ORDER）移入 constants.ts 供多处共享。
- 结果形状从 mysql2 的 [rows, fields] 改为直接返回 rows，路由侧 13 处 [0] 索引同步调整。
- 架构守护的"已完整分层"清单加入 energy（现为 7 个域）。
提取方式与一次失误
- 查询文本用"反引号定界 + 括号配对"扫描提取。第一次用纯括号配对扫描时，
因为把 SQL 文本里的括号也算了进去，导致调用点跨度越界、文件被改坏；
已从 git 恢复并改用反引号定界（并对跨度做了"严格递增且不重叠"的断言）后一次通过。
- 中途还有一次变量写错文件（把 repository 内容写进了路由文件），
被随后的正常写入覆盖，未造成实际损坏；已核对两个文件的首行与关键符号确认无误。
验证
- energy/routes.test.ts 的 13 个用例（含氢能 v2 的口径、利润、账单、路由顺序、
SQL 与参数指纹）在提取前后全部通过。
- 全量 lint / test(191) / build 全绿，可达性 0 未引用文件。
2026-09-11 10:53:56 +08:00
dsh-agent
7802e5b0eb
refactor(stage14): 单站日报 10 条查询移入 repository（能源域四分之三）
...
改动
- energy/hydrogen-station-board.ts 的 10 条查询全部移入 energy/repository.ts，
参数表达式逐条对应（含区间、站点、以及租户与手工充值来源的固定顺序）。
- 相关 SQL 片段助手搬进 constants.ts 并导出：
NORMALIZED_PLATE / NORMALIZED_PLATE_UNICODE / EXTERNAL_CUSTOMER_MAP_CTE，
以及 HYDROGEN_TENANT_ID / MANUAL_RECHARGE_SOURCE。
它们本质是 SQL，继续留在路由里会让"路由不含 SQL"形同虚设；放 constants.ts
是因为被多条查询共享，避免复制。
- 路由文件随之删掉 4 个只为 SQL 服务的 constants 导入（HYDROGEN_BASE_WHERE /
_B / HYDROGEN_LOCAL / HYDROGEN_TABLE），它们已不再被该文件使用。
- 架构守卫允许 constants.ts 存放共享 SQL 片段，并注明理由。
提取方式
- 用平衡括号扫描从原文件按顺序取出 10 条 SQL 与各自的参数数组（含查询 10 的多行参数），
按调用点跨度精确替换，避免手工转写 200 余行 SQL。
验证
- energy/routes.test.ts 的 13 个既有用例在提取前后均通过，其中包含单站看板的
SQL 与参数断言（迁移未改变查询文本、参数顺序与响应口径）。
- 全量 lint / test(191) / build 全绿，可达性 0 未引用文件。
未完成
- hydrogen-bi-v2.ts 仍有 7 条带 ${sqlWhere} / ${groupOrder} 等动态插值的查询，
需要把 where 组装函数一并搬进 repository；完成后再把 energy 加入守护清单。
2026-09-11 10:48:35 +08:00
dsh-agent
e4c8195ede
refactor(stage13): 能源域先行搬迁电能与 ETC 的 SQL（该域完成一半）
...
改动
- 新增 energy/repository.ts：电能总览 KPI、本月逐日、最近有数据月份、昨日电量、
按日区间查询、ETC 汇总，共 6 个查询函数（SQL 与参数逐字保留）。
- electric.ts / etc.ts 改为调用 repository；两者本就是 register*(app, deps) 形态，
因此这次是纯粹的 SQL 位置迁移，没有改接口契约。
- 车辆归属筛选片段 electricKindClause 也移入 repository：
它本质是 SQL，留在路由里会让"路由不含 SQL"这条规则形同虚设。
验证
- energy/routes.test.ts 的 13 个既有用例直接作为安全网（其中多处对 SQL 与参数做断言），
迁移后全部通过，说明查询文本、参数顺序与口径未变。
- 全量 lint / test(191) / build 全绿，可达性 0 未引用文件。
未完成（已在文档中写明）
- hydrogen-station-board.ts 仍有 10 条查询 + 4 个本地 SQL 片段助手；
- hydrogen-bi-v2.ts 仍有 7 条带动态插值的查询。
因此 energy 暂不加入架构守护的"已完整分层"清单，避免给出已完成的不实信号。
2026-09-11 10:46:58 +08:00
dsh-agent
5196db5df7
refactor(stage12): 调度域拆出 repository，跨域数据源改为显式注入
...
改动
- 新增 scheduling/repository.ts：通知/干预与建议列表的全部 SQL（13 条）。
- notify.ts / suggestions.ts 改为 register*(app, deps) 可注入，保留默认导出与 create*Router 工厂。
- suggestions.ts 的两处跨域依赖（里程车辆信息、OneOS 里程）改为依赖注入：
既让本域可独立测试，也让"建议依赖里程数据"在类型上可见，而不是藏在 import 里。
- 跨域引用修正：mapRegion 原本从 '../vehicles/routes.js' 引入（为一个纯函数把整个
车辆路由拖进依赖图），改为直接从 '../vehicles/model.js' 引入。
契约测试（新增 10 个用例）
- 逐条锁定 SQL 与参数顺序：干预登记的三步（查重 → INSERT → 回读）、409 阻断、
批量循环、历史列表的状态过滤与 limit 上限（500/默认 200）、状态更新的 UPDATE 形状、
400/404 分支、活跃映射与近 7 天计数、建议列表五条基础查询的内容与顺序。
- 架构守护升级：不再只看 routes.ts，而是要求该域**除 repository.ts 外的任何非测试文件
都不得含 SQL**；匹配用"语句形状"正则（如 update <table> set）而非裸关键字，
避免把 UpdateNotification 或日志 "update error" 误判。已验证 6/6 个 repository 被识别、
其余文件零误判。
等价性验证
- 把 notify.ts / suggestions.ts 改造前的实现从 git 取出，与改造后跑同一批请求
（9 个场景，含建议列表整条链路 8 次查询），对比落库 SQL、参数、HTTP 状态与响应体：
完全一致。
- 期间修正了两处**验证工具自身**的缺陷（旧文件误引用新 notify；跨域默认实现的调用
被记到另一侧），修正后结论可信。
lint / test(191) / build 全绿，可达性 0 未引用文件。
2026-09-11 10:44:52 +08:00
dsh-agent
523f7b312d
refactor(stage11): 两个热力图拆出 repository，并补契约测试
...
vehicle-heatmap
- 拆为 routes.ts / repository.ts（model.ts 原已存在），改为 registerVehicleHeatmapRoutes(app, deps)。
- 该域同时访问两个库，因此依赖分成 MysqlDatabase（execute，考核批次→车牌）与
PgDatabase（query 返回 { rows }，定位点），两者返回形状不同，不做统一抽象。
- 保留 $4 的原语义：是否"选择了考核批次"（而非"车牌集合是否为空"）；
批次无车牌时由调用方提前返回，与原实现一致。
- 保留 loadBatchModelPlates 的降级行为（查询失败→空映射）与"命中缓存不查主库"。
hydrogen-heatmap
- 拆为 routes.ts / repository.ts，改为 registerHydrogenHeatmapRoutes(app, deps)。
- VALID_COORDINATE（含西藏排除）与 buildWhere 移入 repository 并导出：
它被 meta 的统计口径复用，散落两处极易漂移。
- 5 条 SQL 由脚本从原文件按顺序抽取后原样落位，避免手工转写长 SQL 出错。
契约测试（新增 19 个用例）
- 逐条断言 SQL 文本（规范化空格）与参数顺序：分页/白名单/批次车牌数组/
WHERE 片段顺序/IN 占位符拼接/半径内无站点时不发第二条查询。
- buildWhere 直接单测片段与参数顺序。
- 架构守护的"已完整分层"清单扩到 5 个域。
等价性验证（关键）
- 把两个文件改造前的实现从 git 取出，与改造后跑同一批请求，对比落库 SQL、参数、
HTTP 状态与响应体：
vehicle-heatmap ：8 个场景完全一致（含批次路径、"未知批次"提前返回、错误分支）
hydrogen-heatmap ：8 个场景完全一致（含筛选组合、无权限 403、错误分支）
期间的修正：曾为 /meta 的空结果新增 503 分支，属于原实现没有的行为变更，已回退为原样。
lint / test(181) / build 全绿，可达性 0 未引用文件。
2026-09-11 10:40:13 +08:00
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
shishengliang
dsh-agent