shishengliang/ln-bi
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
398 Commits 8 Branches 0 Tags
523f7b312d92759c21f45583d9d26a0f7dba661f
Commit Graph
8 Commits
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
kkfluousandClaude Opus 4.7 2aeff0c2f4 fix(feedback): 隐藏页加返回按钮 + 入库时间用东八区
ci/woodpecker/push/woodpecker Pipeline was successful
Details 
- FeedbackAdminPage / EleImportPage 头部加 ← 返回按钮：
  优先 history.back（来自 SPA 内跳转），否则 hash=#mileage 兜底回主页
- 反馈入库（created_at / reply_at）改为 DATE_ADD(UTC_TIMESTAMP, INTERVAL 8 HOUR)
  不再依赖 MySQL/容器的本地时区设置，固定 CST

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-30 14:27:41 +08:00
kkfluousandClaude Opus 4.7 1a3d48b2d1 feat(feedback): 反馈 FAB 菜单加「反馈管理」入口，BI-ADMIN-FEEDBACK 角色可见
ci/woodpecker/push/woodpecker Pipeline was successful
Details 
- shared/auth/roles 新增 FEEDBACK_ADMIN_ROLES = ['BI-ADMIN-FEEDBACK']
  + canManageFeedback() helper（含 FULL_ACCESS_ROLES 兜底）
- FeedbackFab 菜单：在「我的反馈」下方加分割线 + 紫色 ⚙ 图标的「反馈管理」
  仅 canManageFeedback 为 true 时渲染，跳到 #/admin/feedback
- 后端守卫：GET /api/feedback/list 与 PATCH /api/feedback/:id 加角色判断
  无权限返回 403。/mine /submit /upload 仍对全部登录用户开放。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-30 14:20:45 +08:00
kkfluousandClaude Opus 4.7 20ebb16e08 feat(feedback): 截图上传 + 我的反馈历史 + 后台管理页
ci/woodpecker/push/woodpecker Pipeline was successful
Details 
后端
- 接入阿里云 OSS（ali-oss SDK），bucket=lnh2etest，目录 /dos/feedback/YYYY-MM-DD/
- POST /api/feedback/upload：单图 multipart 上传，限制 5MB，仅 png/jpeg/webp/gif
- bi_user_feedback 增加 screenshots(JSON)、reply_content/reply_user/reply_at、user_id 索引
  老表通过 try-catch 自动 ALTER 兼容
- POST /api/feedback/submit：增加 screenshots[] 字段
- GET /api/feedback/mine：当前用户自己的反馈历史
- PATCH /api/feedback/:id：更新状态 + 回复
- GET /api/feedback/list：增加 status 过滤

前端
- FeedbackFab 改为悬浮按钮 + 弹出菜单：「提个建议」/「我的反馈」
- 弹窗 Step 2 增加截图区：点击选择 / 多张 / 直接 Ctrl+V 粘贴
  缩略图预览 + 单张移除，最多 6 张，上传中转圈
- FeedbackHistoryDrawer 新组件：底部抽屉展示自己的反馈
  含状态徽章（待处理/处理中/已完成/已忽略）、截图缩略图、产品同学回复区
- 新增隐藏后台管理页 /admin/feedback（或 #/admin/feedback）
  状态分类计数 + 列表 + 详情弹窗（改状态 + 写回复，状态选项含徽章色）
  待处理项有快捷按钮（标记处理中 / 忽略）

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-30 14:06:21 +08:00
kkfluousandClaude Opus 4.7 e8f1604c11 feat: 全局反馈系统 + 各模块底部统一动态提示
ci/woodpecker/push/woodpecker Pipeline was successful
Details 
- 新增 components/RotatingFooterHint：统一文案+蓝色脉冲，4 秒轮换
- 新增 components/FeedbackFab：右下角悬浮按钮（渐变 + 心形信封 + 黄色脉冲点），
  点击打开 4 步引导式弹窗
    Step 1 选类型（💡新维度 / 🐛bug / 🎨界面 / 📝其他）
    Step 2 描述需求 + 选当前板块（chip）
    Step 3 留联系方式（可选）+ 提交概览
    Step 4 ❤️ 成功页（弹簧 √ 动画）
  顶部 spring 进度条，底部上一步/下一步，下拉手柄，背景点击或 X 关闭
- 后端 routes/feedback：bi_user_feedback 表（自动建表，含 status 字段）
  POST /api/feedback/submit + GET /api/feedback/list
- Shell 全局挂载 FeedbackFab，自动从 hash 检测当前模块
- 各模块底部追加 RotatingFooterHint：
  AssetsModule / MileageModule / SchedulingModule / EleImportPage
  HydrogenOverview / HydrogenDaily / ElectricOverview / ElectricDaily
  （HydrogenOverview 旧的内嵌实现已替换为共享组件）

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-30 13:50:39 +08:00