shishengliang
65904c8270
Preserve August hydrogen revision and September audit evidence; calculate interrupted vehicle history across all prior months. Record remaining carry-policy and layout-baseline discrepancies.
1.9 KiB
1.9 KiB
里程绩效工作台原型
独立 React + Vite 原型，不改动历史 Excel、原始数据及核算脚本。默认使用六辆虚构车辆，所有演示结果均不可用于发放。
启动
在项目根目录运行：
npm --prefix prototype install
npm --prefix prototype run dev
浏览器打开 http://127.0.0.1:5173 。如需真实接口，另开终端：
python3 -m venv prototype/.venv
prototype/.venv/bin/pip install -r assessment_service/requirements.txt
prototype/.venv/bin/python -m assessment_service --port 8765 --data-dir prototype/.data
页面切换「本机 API」。Vite 将 /api 转发到本机 8765。数据接入上传 Excel 后，配置规则 JSON，回到月度核算开始试算。可下载规则示例，也可用 prototype/.venv/bin/python prototype/make_sample.py 创建配套虚构 Excel 以验证真实接口链路。示例规则月份为 2026-08，车辆 DEMO-001。
当前实现与边界
- 演示模式：搜索、状态筛选、异常列表、逐日依据抽屉、月份切换、演示试算、JSON 导出。
- 本机 API：健康检查、Excel 原始二进制上传、导入结果及错误展示、规则 JSON 编辑、真实试算、快照详情与 Excel 导出。切换模式或修改输入会使已试算结果失效。
- 真实 API 复用现存
assessment_service，只生成租赁考核源表，尚不计算奖金、结转、历史补发，不具备审批或发放功能。 - 现存引擎采用「区间存在纯氢则整段纯氢、测试日清零」等旧规则，与
docs/8月绩效核算_20260911.md最新规则不一致。页面明确提示该差异，不能用此原型替代正式 8 月核算。 - 本机服务无鉴权，仅绑定 loopback。接入生产系统前应完成最新规则迁移、历史台账与分钱精度验证、权限及审批、批次锁定、任务队列和审计记录。
详见 API 对接与系统化方案。