8 Commits

Include renames

Author	SHA1	Message	Date
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	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
dsh-agent	9a9c9d08e1	refactor(stage4): 集中配置与启动校验，权限守卫 fail-closed，凭据移出仓库 ... 配置分层 - 新增 src/server/config.ts：环境变量集中读取 + 启动期校验。 删除公开兜底密钥 ln-bi-default-secret：SSO 模式下 JWT_SECRET 缺失或 短于 32 字符时 assertRuntimeConfig() 直接拒绝启动（已实测）。 - index.ts 不再自己读端口/环境；auth/config.ts 与 auth/login.ts 改为引用集中配置。 权限守卫 - energy / scheduling / hydrogen-heatmap 的守卫由 “user 存在才校验” 改为 “无角色即拒绝”：user 缺失时按无权限处理，不再静默放行（fail-closed）。 - /api/ele/* 此前完全无鉴权，任何已登录用户都能写入电费表；现按能源域 (BI-LEADER-ENERGY) 守卫。 接口契约 - 未匹配的 /api/* 由 200 text/html(SPA) 改为 404 application/json； 未认证时仍是 401，避免向未授权调用方暴露路由是否存在。 - 新增全局 onError 返回 JSON 500。 凭据治理（此前均为 git 跟踪文件中的明文） - Dockerfile 删除烧进镜像的 JWT_SECRET，改为必须运行时注入。 - docker-compose.yml 删除生产库口令/JWT 密钥/失效的 MILEAGE_DB_*， 改为强制注入写法；补齐 OSS_* 与 NODE_ENV/DEV_BYPASS_AUTH/BI_AUTH_*。 - woodpecker.yml 删除 Harbor base64 凭据改用 secret，pull_request 不再推镜像。 - 删除 scripts-tmp/（含生产库 root 口令）与已跟踪的 .DS_Store；.gitignore 补全。 - 文档中残留的里程库口令改为占位符。 lint / test(128) / build 全绿。	2026-09-11 10:19:07 +08:00
kkfluous	91202bdf71	fix asset module database migration	2026-06-17 11:53:39 +08:00
kkfluousandClaude Opus 4.7	d1d79f1c7c	feat(energy): 电能统计切到 bi_ele_charge_record，外部数据接通 ... - /api/energy/electric/overview & /electric/monthly 不再读 tab_energy_electricity_bill - 改读 bi_ele_charge_record：kwh/fee/start_time - 外部/我司用 vehicle_kind 区分（external/internal） - 电能默认 customer 由 'external' 改 'lingniu'，与导入页约定一致 - ElectricDaily 移除「数据对接中…」友好空状态（外部已有数据） ele 导入页同步收紧： - 命中系统车辆=internal，未命中（含车牌为空）一律 external - 移除 unknown 分类、KPI 卡、批次列、过滤按钮、UploadResult 字段 - 历史 unknown 行已 UPDATE 为 external Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-04-29 19:11:52 +08:00
kkfluousandClaude Opus 4.7	57fdd346cf	feat(ele): 充电记录后台导入页面 /ele/import（隐藏入口） ... 后端 - 新建 bi_ele_charge_record 表（首次访问自动 CREATE TABLE IF NOT EXISTS） 字段含订单编号(UNIQUE)、电站、时段、电量/费用、车牌/判定车牌、内外部分类、原始 JSON、批次号 - POST /api/ele/import：multipart 上传 xlsx，识别表头自动定位， 文件内 + 数据库双重去重（INSERT IGNORE on UNIQUE order_no） 上传时按 plate/judged_plate 在 tab_truck 中匹配，命中=internal、未命中但有牌=external、无牌=unknown - GET /api/ele/list 分页 + kind/batch/search 过滤 - GET /api/ele/batches 批次汇总（数量、内/外/未知拆分、电量/费用合计） - GET /api/ele/aggregate 全量与近 30 日按日 × 分类聚合 前端 - /ele/import 路径直接渲染 EleImportPage，主导航不显示，需手动输入 URL - 拖拽/点击上传，结果卡展示解析/新增/重复/分类 - KPI 8 卡：总数、内/外/未知记录、累计电量与费用、内/外电量 - 批次列表（点击筛选）+ 最新记录表（kind 切换 + 关键字搜索） - 上传后自动 reload 全部数据 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-04-29 19:02:38 +08:00