chore: import existing codebase as baseline

docs/improvement-plan.html

@@ -0,0 +1,36 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>TraceIQ 完善项与执行路线图</title>
+<style>
+:root{color-scheme:light;--ink:#202725;--muted:#58645f;--line:#d8dfdc;--green:#17664f;--amber:#9a5200;--red:#a72f3d;--bg:#f5f7f6;--blue:#315d78}*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--ink);font:15px/1.7 system-ui,-apple-system,"PingFang SC","Microsoft YaHei",sans-serif}header{background:#fff;border-bottom:3px solid var(--green);padding:28px 20px}main,header>div,footer{max-width:1120px;margin:auto}main{padding:0 20px 40px}h1{font-size:30px;margin:4px 0 8px}h2{font-size:21px;margin:0 0 12px}h3{font-size:17px;margin:0 0 7px}.meta,.muted{color:var(--muted);font-size:13px}.notice{padding:15px 18px;margin:20px 0;background:#fff4e5;border-left:4px solid var(--amber)}section{padding:24px 0;border-bottom:1px solid var(--line)}.item{background:#fff;padding:16px 18px;margin:12px 0;border-left:4px solid var(--line)}.p0{border-color:var(--red)}.p1{border-color:var(--amber)}.p2{border-color:var(--green)}.tag{font-size:12px;font-weight:700;color:var(--muted)}table{border-collapse:collapse;width:100%;background:#fff}th,td{padding:10px 12px;border:1px solid var(--line);text-align:left;vertical-align:top}th{background:#eaf0ed}code{overflow-wrap:anywhere}footer{padding:22px 20px 36px;color:var(--muted)}@media(max-width:680px){h1{font-size:25px}table{font-size:13px}th,td{padding:8px}}
+</style>
+</head>
+<body>
+<header><div><div class="meta">TRACEIQ / 优先级核查与执行 / 2026-09-24</div><h1>完善项与执行路线图</h1><p>以当前源码、自动化测试和可访问环境为依据。测试通过不等同于业务签字或生产上线。</p></div></header>
+<main>
+<div class="notice"><strong>本轮基线：</strong>后端 40 passed，finance 覆盖率 86.72%（85% 门槛）；隔离 SQLite Playwright 3 passed、原附件专测 1 skipped；Ruff、格式、Django system check、迁移检查、TypeScript/Vite 构建、npm audit（0 漏洞）与 pip-audit 通过。production 模式 Django <code>check --deploy</code> 零告警。Docker daemon 未运行，本机无 LibreOffice。Microsoft Excel、332,830 行公式工作簿、真实 AI/合规及商业部署仍未验收。</div>
+<section><h2>P0 · 先确保验收证据可信</h2>
+<article class="item p0"><div class="tag">P0.1 · 已完成 / 已复核</div><h3>维护真实的源码与验收基线</h3><p>旧文档曾错误声称 <code>tests/test_finance.py</code> 为空并把公式导出标记为未实现；当前源码有 40 项后端测试，公式工作簿、说明页、对话新增列、追问与下载均已实现。本轮路线图按当前代码、测试结果和外部门禁重建。</p></article>
+<article class="item p0"><div class="tag">P0.2 · 已修复并通过专项回归</div><h3>隐藏导出任务的内部异常</h3><p>状态接口不再把 worker 异常文本发给用户，只返回通用失败提示；前端显示任务编号，数据库保留内部诊断。失败任务脱敏、临时文件删除及状态访问专项 8 passed。</p></article>
+<article class="item p0"><div class="tag">P0.3 · 本机生产配置检查通过</div><h3>验证 production 部署安全配置</h3><p>production 模式、有效测试密钥、受信 HTTPS 代理下 <code>manage.py check --deploy</code> 零告警。真实域名、TLS 终止及代理头行为仍需部署环境验收。</p></article>
+<article class="item p0"><div class="tag">P0.4 · 外部目标引擎</div><h3>Microsoft Excel 公式重算与兼容验收</h3><p>目标 Excel Windows/Mac 打开、重算、保存并核对公式及缓存；覆盖缺期、零分母、退款/负值、ROI、毛利来源和输入修改依赖。LibreOffice/openpyxl 不能替代目标 Excel 证据。</p></article>
+<article class="item p0"><div class="tag">P0.5 · 真实数据与资源基准</div><h3>332,830 行完整公式工作簿</h3><p>公式导出当前限制 100,000 行/200 组。用原附件和可靠 PostgreSQL 验证行数、金额、人数、耗时、峰值内存、文件大小及 Excel 首开/重算；未完成前保持显式拒绝，不静默截断或放宽上限。</p></article>
+<article class="item p0"><div class="tag">P0.6 · 外部业务/安全责任人</div><h3>财务口径、真实 AI 与商业发布批准</h3><p>签署实际收入与实收、退款、成本、毛利、ROI、自营集合及舍入规则；审批外部模型数据处理/出境并演练故障；完成生产密钥、TLS、备份恢复、SLA、渗透测试和商业许可证核验。审批前 AI 保持关闭。</p></article>
+</section>
+<section><h2>P1 · 代码层可靠性与可用性</h2>
+<article class="item p1"><div class="tag">P1.1 · Docker daemon 未运行</div><h3>镜像与 Compose 运行验收</h3><p>Docker CLI 可用但 daemon 不可连接，本机暂不能构建或启动。daemon 可用后验证镜像、健康检查、worker、清理服务与重启恢复；远端 CI 需仓库平台实际触发。</p></article>
+<article class="item p1"><div class="tag">P1.2 · 产品范围待确认</div><h3>自定义指标定义保存与复用</h3><p>定义当前只用于当次工作簿，不持久化到主分析页或跨会话定义库。需明确个人/组织共享、版本审批、删除和审计规则，再开发持久化。</p></article>
+<article class="item p1"><div class="tag">P1.3 · 需产品确认后开发</div><h3>大数据与高基数交互</h3><p>当前汇总按请求返回分组、证据使用分页；AG Grid SSRM/Pivot/Tree Data 等计划功能尚未实现。先以目标数据规模和典型交互决定是否投入服务端行模型，避免未经验证引入商业授权与运维负担。</p></article>
+</section>
+<section><h2>P2 · 范围扩展</h2>
+<article class="item p2"><div class="tag">P2.1 · 财务定义确认后</div><h3>扩展公式语言和缺失策略</h3><p>当前白名单仅支持现有指标/常数和加减乘除，最大 8 层；不接受任意 Excel 文本、字段引用、跨明细新聚合、按零替代或跳过缺失。每项扩展需独立财务黄金样例、注入测试和公式重算验证。</p></article>
+<article class="item p2"><div class="tag">P2.2 · 目标明确后</div><h3>分析及工作簿操作增强</h3><p>可评估历史分位异常、告警、证据期间切换、明细表结构变更后的公式扩展、模板版本和工作簿内定义管理；需先给出场景和验收指标。</p></article>
+</section>
+<section><h2>本轮执行结果</h2><table><thead><tr><th>项目</th><th>结果</th><th>剩余门禁</th></tr></thead><tbody><tr><td>源码与路线图基线</td><td>已完成；纠正文档过时状态</td><td>以当前代码/测试为准</td></tr><tr><td>导出错误脱敏</td><td>8 项专项后端测试通过</td><td>内部诊断仅保留服务端</td></tr><tr><td>Production deploy checks</td><td>零告警</td><td>真实域名、TLS/代理验收</td></tr><tr><td>全量本机回归</td><td>40 passed / 86.72%；Playwright 3 passed、1 skipped</td><td>原附件场景需配置隔离数据集</td></tr><tr><td>商业发布门禁</td><td>尚未通过</td><td>Excel、真实规模、业务/AI审批、容器和灾备</td></tr></tbody></table></section>
+<section><h2>发布判定原则</h2><p>本地质量门禁全部通过，只证明自动化覆盖范围内的代码状态。商用发布还需要 Microsoft Excel 结果、真实规模资源记录、财务口径签字、AI 数据处理批准和目标基础设施安全/灾备验证。任何一项未满足时，状态保持“未完成发布验收”。</p></section>
+</main><footer>本文件按核查日建立，执行结果以随后实际运行的命令和目标环境记录更新。</footer>
+</body>
+</html>