Intelligent Calibration Platform · 汽车热管理与空调舒适性实车标定工作台
当前仓库是依据《开发技术方案 V4》形成的首个可追溯工程基线。平台以任务为主线，把数据导入、收车质检、工况确认、透明 KPI、参数版本、边界校验、报告证据链与人工签发连接成同一条标定闭环。
| 基线 | 状态 | 最近验证 |
|---|---|---|
v0.1.0-baseline |
MVP 离线分析闭环已贯通；阶段 2 为可演示薄纵切 | 后端 106 项测试通过；前端类型检查与生产构建通过 |
实施依据：docs/开发落地基线_v4.md · V4 技术方案原文 · 变更记录
工作台使用项目 → 车型 → 任务三级上下文。所有数据集、工况段、KPI、参数版本与报告都绑定到当前任务；页面只展示真实状态，不用演示数字冒充完成度。
截图中的任务尚未形成 KPI 和参数版本，因此报告装配按钮保持禁用。相同门禁同时存在于后端，不能通过绕过前端直接签发。
- 把依赖个人经验的标定步骤沉淀为可复用规则、边界、版本和证据。
- 把 MDF/MF4、BLF/ASC、CSV、参数文件、Bug 和报告放到统一任务上下文。
- 让每个 KPI 都能展开到公式、时间窗和原始信号段，支持复核与金样回归。
- 让参数变化可比较、可追溯，并在进入交付前完成规格边界全覆盖校验。
- 让任何写参数、强控或正式签发动作都经过人工审批门、快照、回读和审计。
分析接口不是独立计算按钮。后端会依次检查：任务数据存在、收车质检已签署、工况段已确认；报告接口会再次检查 KPI 证据、参数版本、边界覆盖、规格来源和越界结果。
app/core提供配置、数据库、Celery、WebSocket 和日志。app/domains/<name>与 V4 S-D 规格一一对应，由app/api/router.py汇聚。- 长任务走 Celery；本地离线模式通过
CELERY_EAGER=1进程内执行。 - 生产数据进入 PostgreSQL/TimescaleDB；原始文件与 checkpoint 进入对象存储。
- 测控上层禁止直连厂商 API，只能经过 HAL。
每个 KPI 与派生值必须保存公式、输入信号、时间窗、工况段及原始数据引用。发布前以金样回归验证零差异。
Agent 工具集没有直接写工具。接口层 calibrate_write 强制携带授权上下文；正式写入链路仍属于后续现场验证范围。
生产设计要求 PostgreSQL RLS 行级隔离、审计 append-only、交付脱敏。SQLite 仅用于单机离线开发与演示，不等同于生产隔离能力。
| 领域 | V4 | 当前基线能力 | 成熟度 |
|---|---|---|---|
| 数据导入 | S-D1 | CSV/MDF/MAT、BLF/ASC+DBC；分片上传、信号映射、质量检查、任务隔离 | 已实现并测试；真实 10GB MF4 待现场复测 |
| 工况识别 | S-D2 | 状态机 DSL、覆盖度、人工确认/订正、反馈回流 | 已实现并测试 |
| 分析诊断 | S-D3 | 无 eval KPI DSL、规则告警、provenance、金样回归门 |
已实现并测试 |
| Bug 排查 | S-D4 | 生命周期、关闭门、DTC 解码、薄回放、血缘审计 | 阶段 2 薄纵切 |
| 实时标定 | S-D5 | HAL 测量订阅、齐帧、WebSocket、录制、只读 LiveScope | 只读纵切；实车写入未开放 |
| 参数版本 | S-D6 | JSON/CSV 参数集、标量/曲线/MAP diff、边界完整性/溯源/越界校验 | 已实现并测试；CDFx/PAR/HEX 为插件位 |
| 报告交付 | S-D7 | KPI+告警+参数边界证据快照、签发预检、人工签发冻结、脱敏、Word | 已实现并测试 |
| 知识库 | S-D8 | Bug/告警沉淀、评审门、关键词检索、血缘回链 | 薄纵切；向量化/RAG 未启用 |
| 标定计划 | S-D9 | 目标矩阵、覆盖度进度、缺口 | MVP 薄纵切 |
| 数据资产 | S-D10 | 多维查询、波形预览、CSV 导出、健康度和出域审计 | 阶段 2 薄纵切 |
| 协作审计 | S-D11 | 任务树、看板、lineage、append-only 审计挂载点 | MVP 脊柱；完整 RLS 待安全专项 |
| Agent 编排 | S-D12 | LangGraph runtime、checkpoint、ToolBus、TraceRun、审批中断/恢复 | 基座已接入；LLM 对话未启用 |
| 测控 HAL | S-D13 | 纯接口、SimAdapter、设备与测量会话 | 测试适配器可用；CANape 现场接入待验证 |
| 舒适性 | S-D15 | 瞬态/稳态评分、ISO 7730 PMV/PPD、全输入 provenance | 规则层薄纵切；jury/ML/自动化序列未进入基线 |
详细路线与验收口径见 docs/开发落地基线_v4.md。
| 层 | 主要技术 |
|---|---|
| Web | React 18、TypeScript、Vite、Ant Design 5、ECharts、Zustand、Axios |
| API | Python 3.11+、FastAPI、SQLAlchemy 2、Pydantic、Alembic |
| 分析 | NumPy、Pandas、SciPy、asammdf、cantools、python-can |
| 编排 | LangGraph、SQLite/PostgreSQL checkpointer、Celery、Redis |
| 数据 | PostgreSQL 16、TimescaleDB、SQLite 离线模式、对象存储目录 |
| 交付 | python-docx、Docker Compose |
前置条件：Docker Desktop / Docker Engine + Compose。
cp .env.example .env
docker compose up --buildWindows PowerShell：
Copy-Item .env.example .env
docker compose up --build启动后：
后端容器启动时自动执行 alembic upgrade head。请勿把生产密码写回 .env.example。
适用于无 PostgreSQL、Redis 或 Docker 的本机开发。SQLite 数据库和对象目录均已被 Git 忽略。
Set-Location backend
uv venv .venv
uv pip install --python .venv\Scripts\python.exe -e .
$env:PYTHONUTF8 = "1"
$env:DATABASE_URL = "sqlite:///E:/your-path/Intelligent-Calibration-platform/backend/icp_dev.db"
$env:OBJECT_STORE_DIR = "E:/your-path/Intelligent-Calibration-platform/backend/_objects"
$env:CELERY_EAGER = "1"
& .\.venv\Scripts\python.exe -m alembic upgrade head
& .\.venv\Scripts\python.exe -m uvicorn app.main:app --host 127.0.0.1 --port 8000另开终端启动前端：
Set-Location frontend
pnpm install
pnpm dev离线模式的 signal_ts 是普通表，批量入库回退为 bulk INSERT，审计由应用层保护；生产路径仍以 TimescaleDB、数据库触发器和 RLS 为准。
仓库附带合成热管理数据、DBC/ASC 示例和参数基线，不包含真实 OEM 数据。
python scripts\gen_sample_data.py
python scripts\e2e_demo.py演示顺序：项目/任务 → 数据导入 → 质检 → 工况识别 → KPI/告警 → 参数 diff/边界 → 报告装配 → 人工签发 → Word 导出 → 血缘与审计。详细说明见 scripts/README.md。
后端：
Set-Location backend
& .\.venv\Scripts\python.exe -m pytest -q
& .\.venv\Scripts\python.exe -m compileall app alembic
uvx ruff check app前端：
Set-Location frontend
pnpm lint
pnpm buildpnpm lint 当前执行 tsc --noEmit。基线发布前的实测结果记录在 CHANGELOG.md。
.
├─ backend/
│ ├─ app/core/ # 配置、DB、Celery、WS、日志
│ ├─ app/domains/ # 按 S-D 分包的领域服务
│ ├─ app/models/ # ORM 与核心数据契约
│ ├─ app/orchestration/ # GraphRuntime、trace、审批中断
│ ├─ alembic/versions/ # 0001 ~ 0012 数据库迁移
│ └─ tests/ # 纯函数、领域门禁与回归测试
├─ frontend/src/
│ ├─ pages/ # 20 个业务页面
│ ├─ components/ # 流程条、波形、覆盖度、参数查看器
│ ├─ stores/ # 项目/车型/任务全局上下文
│ └─ api/ # REST 与 WebSocket 客户端
├─ docs/ # V4 原文、落地基线、真实界面截图
├─ prototype/ # 设计交接参考，不作为可执行代码
├─ research/phase-minus-1/ # MDF 与 LangGraph 技术预研及实测结论
└─ scripts/ # 种子、样本生成和端到端演示
v0.1.0-baseline是开发基线，不是量产发布版。- CANape ASAM MCD-3、A2L 覆盖率和真实总线写入尚待现场硬件与许可证环境验证。
- MF4 当前采用
asammdf.select()批量读取；91.1 MB/s 来自 203 MB 合成样本，真实 10 GB 现场样本仍需复测。 - 多 OEM 的完整 RLS 策略、登录鉴权、生产密钥管理和灾备演练尚未完成。
- RAG、LLM 对话、NL2Query、ML 舒适性模型、MAP 在线编辑与强控不在本基线范围。
- 前端生产构建存在 Vite 大分块告警，功能构建成功；后续需要按页面和图表依赖继续拆包。
.env、本地数据库、对象存储、上传文件、MDF/MF4/BLF 等实车数据、依赖目录和构建产物均不会进入 Git。提交新样本前必须确认它是脱敏或合成数据；任何真实 OEM 数据都应留在受控存储中。
本仓库暂未声明开源许可证，默认保留全部权利。