企业业务数据查询平台产品系统Vibe Coding

制造业多厂区场景下，业务数据分散在 ERP、MES、WMS、SRM 四五套系统里，口径各不相同，业务方查一张采购单要跨三个系统、导一次数据得提需求等 IT。本项目立项于解决这一断点：把分散的数据收拢成一套入口、多业务域的统一查询平台——业务方自助查询、自助导出，权限按人逐请求收口，查了什么全程留痕。场景覆盖采购进度、库存与呆滞、生产完工入库、工单齐套、销售履约、品质检验与供应商对账等日常高频查询。

一套面向制造企业的多业务域数据查询平台，8 个业务域、13 个业务页签（采购 / 仓库 / 生产 / 研发 / 计划 / 销售 / 品质 / 财务），一个入口统一受理跨系统查询。


核心能力：

1. 统一入口 + 全局据点筛选：顶栏选一次据点，全站 13 个页签通用；「一个都没勾」定义为完全不干预、保留各页签默认据点，不等同于「不限据点」——这一条是真实平台上最容易踩的坑，界面上明确写出来了。

2. 两段式取数：只读生产库建不了索引，采用「窄列扫描取单头 → 按单号分批走主键索引取明细 → 名称分批主键 IN 回填（绝不 join 大表）→ 附属数据失败静默降级」的访问路径；看板类改为在库内 GROUP BY 聚合后返回，不把几万行拉回应用层再统计。

3. 口径卡常驻标题下方：已收量按「单号 + 行号」精确匹配、未交量 = 订购 − 已收、逾期天数 = 今天 − 第一段交期、工单齐套率按行不按量。口径写在数据旁边，不藏进文档。

4. 权限服务端收口：中间件逐请求夹紧据点条件，前端隐藏与手动改参数都不构成权限；受限账号返回行数只会变少，不会变多。

5. 查询审计：每次查询逐条留痕（时间 / 身份 / 页签 / 条件原文 / 返回行数 / 耗时 / 生效据点 / 是否被夹紧），只记数据查询接口、不记下拉框这类噪声，写入尽力而为、日志挂了不影响查询，可导出 CSV。

6. 数据库保护四道防线：45s 语句超时、并发闸门 2（其余排队 20s）、45s 结果缓存、连接池排队 15s —— 保证任何一个人的误操作都拖不垮生产库。

7. 列控制与可用性：点表头三态排序、拖拽换位、右缘拉宽，列序与列宽记在浏览器本地并可一键重置；常用方案把「模块 + 动态表单字段」整套存下来，一键跳转、带条件、自动查询。

8. 演示可现场验证：切换到受限身份后，页面明确提示「服务端已按你

一套面向制造企业的多业务域数据查询平台，8 个业务域、13 个业务页签（采购 / 仓库 / 生产 / 研发 / 计划 / 销售 / 品质 / 财务），一个入口统一受理跨 ERP / MES / WMS / SRM 的跨系统查询。以下按「怎么实现的」逐条说明。

一、整体架构
前端零框架单文件实现（零 CDN、零构建）；后端 Python + FastAPI，直连 ERP Oracle 只读账号，并对各业务系统的只读查询接口做代理层。每个业务页签 = 一个数据源 + 一组条件 + 一张表 + 一段口径说明，页签之间只共享入口、认证、据点口径与表头交互四件事。

二、全局据点筛选：顶栏一处选，全站通用
实现方式：顶栏多选组件自动登记到各页签的筛选控件，选项走访问器广播，因此 13 个页签各自的条件组件零改动就能跟随全局选择。
一条铁律写进了产品逻辑：全局一个据点都没勾 = 完全不干预（各页签保留自己的默认据点），绝不等同于「不限据点」—— 因为后端收到空的据点条件就是全据点，既慢又越权。这一条是整个平台最容易踩的坑，所以直接写在界面上。

三、两段式取数：只读生产库建不了索引，只能靠访问路径
第一步窄列扫描取单头（只取用得到的列，先截断行数）；第二步按单号集合分批走主键索引取单身；品名、供应商、采购员、部门一律分批主键 IN 查询回填，绝不 join 大表；已收量单独分批取，取不到时静默降级、不影响主查询。
看板类另走一条路：明细先在数据库里 GROUP BY 聚合完再返回，不把几万行拉回应用层再统计 —— 这一改把供应商看板从 15.7s 降到 5.4s。

四、口径卡常驻标题下方
已收量按「单号 + 行号」精确匹配；未交量 = 订购 − 已收；逾期天数 = 今天 − 第一段交期；工单齐套率按行不按量。
为什么重要：按单汇总会把整单收货量重复算到每一行，未交量直接算错 ——