这是一个面向销售侧数据开发的本地单机 Web 控制台。它把指标口径、来源可信度、推进任务、测试证据、代码扫描和 Codex 任务包放在同一条项目主线上。
- 指标来源分为:业务原始口径、开发推测口径、开发新增口径、AI 提取/归纳。
- 指标生命周期与来源分类独立维护:草案、待澄清、已确认、已实现、已验收。
- 导入 Excel/CSV、Word、PDF、Markdown 和文本文件,保留文件哈希与解析快照。
- 扫描 SQL、配置和 Markdown,输出表、指标别名和文件行号线索。
- 管理推进任务、阻塞原因、质量用例、预期/实际结果与证据路径。
- 开发工作台登记代码资产,创建 Codex 开发运行,生成执行包并回写变更文件、差异和测试结果。
- 生成口径澄清、影响分析、开发、测试和阶段总结任务包,可复制给 Codex。
- 支持可选的 OpenAI 兼容模型 API、项目备份和自包含项目总体说明 HTML。
控制台不会连接业务数据库、提交 Git 或触发调度。Codex 只有在用户选择“当前工作区”执行模式时,才会按指定目标目录修改本地文件。
导入 CSV、Excel、DOCX、PDF、Markdown 或 TXT 时,可勾选“我声明本次来源文件已定稿”,也可选择用已配置的 OpenAI 兼容模型辅助提取。原件、SHA-256 和表格行、sheet、段落、PDF 页行或文本行定位会一并保存。只有定稿声明、定义和粒度明确、所有已提取的非空字段均可逐字段核验、无冲突且没有 TBD /“待确认”等标记的候选才会自动成为 source-confirmed;其他候选会显示原文与现行口径差异,需填写实际确认人和依据后人工确认,或拒绝。AI 不负责声明文件定稿,引用不在原文中的字段会被丢弃。
在“模型与血缘”登记 ODS、DIM、DWD、DWS、ADS 模型及字段、依赖、字段映射和指标关联。SQL 扫描只生成带 scan_id、路径和行号的待核验表级线索;人工确认后才进入正式上下游。开发完成度按每个当前指标的 3 个证据点计算:关联目标模型、已确认源字段到目标字段映射、关联代码资产,各占三分之一。指标关联绑定具体版本;产生新版本后须重新关联目标模型,模型级字段映射仍保留,由负责人判断是否适用于新版口径。任务完成率单独显示。
- 在“导入与扫描”中扫描项目目录,代码文件会登记到“开发工作台”。
- 新建开发运行,填写目标目录、执行模式、关联指标/任务和验收条件。
- 生成执行包并复制给 Codex。Codex 先阅读“已确认事实”和“执行边界”,再在指定目录完成开发。
- 在开发工作台点击“开始执行”记录运行状态;Codex 完成后回写变更文件、差异摘要和测试结果。
执行模式含义:
只读分析:只分析和生成建议。隔离草稿:在隔离目录或分支中生成草稿,人工审阅后合并。当前工作区:允许 Codex 修改指定的本地工作区,适合你明确授权的开发任务。
平台不会自动执行任意脚本。生产库、调度、远程推送和业务口径确认仍然需要人工处理。
需要 Python 3.11+、Node.js 18+。如果要点击“启动 Codex”,本机还需要可调用的 codex 命令并完成登录。
cd outputs/data-project-console
python -m pip install -r backend/requirements.txt
Start-Process powershell -ArgumentList '-NoProfile','-Command',"$env:PYTHONPATH='backend'; python -m uvicorn app.main:app --host 127.0.0.1 --port 8000"
cd frontend
npm install
npm run dev浏览器打开 http://127.0.0.1:5173。
也可以双击根目录的 start.cmd 启动,或运行 start.ps1。它会检查已有服务,只在需要时以后台进程启动后端和前端,并等待两个地址都可访问。停止服务可以双击 stop.cmd,或运行 stop.ps1;关闭浏览器不会影响后台服务。
在启动后端前设置:
$env:CONSOLE_AI_BASE_URL = 'https://your-openai-compatible-endpoint/v1'
$env:CONSOLE_AI_API_KEY = '只保存在本地环境变量,不写入控制台数据库'
$env:CONSOLE_AI_MODEL = 'your-model'发送模型前,页面会先展示完整任务包。模型输出只会进入 AI 草案,不会自动改变指标正式状态。
默认保存在 data/,也可以通过 CONSOLE_DATA_DIR 指定:
console.sqlite3:结构化项目事实与审计事件uploads/:原始口径文件scans/:扫描快照evidence/:测试证据预留目录exports/:项目总体说明 HTMLbackups/:项目备份 ZIP
cd outputs/data-project-console
$env:PYTHONPATH='backend'
python -m pytest backend/tests -q
cd frontend
npm run build