Files

3.3 KiB
Raw Permalink Blame History

质量数据分析平台项目规则

沿用全局沟通与执行习惯;本文件只补充项目约束和入口。

项目约束

  • 正式指标由后端指标服务和当前有效规则计算。月、季、年先汇总分量再计算,不平均月率;缺失阶段、零分母、去本部报废等语义以正式服务为准,不在页面、导出或 AI 中另造算法。
  • 当前智能分析固定使用 DSH,保留模型原始正文;普通提问直接回答,报告仅在明确要求时生成。图表失败静默省略并保留后台诊断。遗留 nao_*.py 与根目录兼容入口不表示可以恢复双引擎或增加模型审阅。
  • 权限、数据范围及来源绑定由服务端执行;查询、缓存、图表、报告和下载均保留当前授权检查,历史快照不能绕过实时权限。
  • 测试使用隔离数据库与合成数据,复用 OwnedTestDatabase 或 scripts/managed_test_resources.py 登记和清理自有资源。私有原表回归另选入口,不把业务主库当测试库。
  • .runtime/、runtimedata/、output/ 含私有数据、验收产物及可能正在使用的运行包,不按目录名称判断可删除。密钥、登录资料、业务原件和备份不得进入 Git 或普通交接记录。
  • 主工作目录可能在旧分支上积累已由其他工作目录交付的改动。继续开发前核对分支、最新主线及本次差异;不将全部未提交内容一并提交,不切换或重置当前目录来“清理”。

按需阅读与代码入口

任务 入口
接续当前工作 docs/当前进度.md;先核实记录与实际状态
启动、构建和验证 README.md;共享服务维护另读 deploy/macos/README.md
查询、指标和导出 web/src/QueryPage.tsx、web/src/metricWorkbook.ts;后端 metrics/、analytics/,均位于 backend/src/main/java/cn/yunsheng/quality/
智能分析 docs/DeepSeekHarness正式接入.md;前端 web/src/agent/、后端 analysis/、scripts/build_dsh_application.py 及 runtime/dsh/application/
数据接入和规则 后端 source/、ingestion/、workflow/、masterdata/、dictionary/;本地授权资产存在时,原表核对另读 verification/rules.md,其中样本范围属于历史基线,该文件不随源码同步
界面与交互 DESIGN.md 及现有组件、主题;无需为纯业务改动读取全部设计说明
备份、回收和迁移 deploy/macos/README.md、deploy/docker/README.md;版本变化触发的维护保护须经兼容性核实后再解除

验证入口

  • 前端按影响选择 node --test web/verification/<相关测试>.test.mjs;查询导出对应 metric_workbook.test.mjs。必要时再执行 pnpm --dir web build。
  • 完整本机构建入口为 python3 scripts/project.py build,运行后端非私有原表测试并构建前端;原表全量回归显式加 --private-acceptance,资产缺失不能当作通过。
  • Python 用项目对应环境按需运行 PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=scripts python3 -m unittest discover -s verification -p '<相关测试文件>';DSH 环境检查入口为 python3 scripts/setup_dsh_runtime.py --check,不调用模型。
  • 不因文档变更触发构建、服务重启、模型请求、数据库迁移或维护清理。开发测试通过、仓库同步和线上生效分别记录。