# 里程绩效工作台原型

独立 React + Vite 原型，不改动历史 Excel、原始数据及核算脚本。默认使用六辆虚构车辆，所有演示结果均不可用于发放。

## 启动

在项目根目录运行：

```sh
npm --prefix prototype install
npm --prefix prototype run dev
```

浏览器打开 http://127.0.0.1:5173 。如需真实接口，另开终端：

```sh
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 对接与系统化方案](../docs/里程绩效原型_API对接.md)。