flowchart TB
    subgraph SRC[前端入口]
        HOME["/ 门户首页"]
        PLAN["/plan 回货计划看板
Excel 本地解析 数据不上传"]
        PMC["/pmc 欠料总表 空态"]
        ERP["/erp ERP同步 空态"]
        SUP["/supplier 供应商填报 空态"]
        ADM["/feedback-admin 反馈汇总"]
        DOC["/doc 系统呈现 本页"]
    end
    subgraph SVC[服务层 Flask 网页服务.py]
        NG["nginx 反代
X-Real-IP 覆盖防伪造"]
        WAIT["waitress 127.0.0.1:18091
16线程 仅本机监听 pm2:evo-api"]
        AUTH["钥匙鉴权 ?k= / X-Access-Key
本机 127.0.0.1 免钥匙"]
        CRON["定时线程 每日07:30
ERP同步 未部署金蝶模块显式报错"]
    end
    subgraph DB[存储 全部已建 当前0行]
        MAIN[("SQLite 回货计划.db
14张表 零预设")]
        FILES["/fbfiles 反馈附件"]
    end
    subgraph CH[反馈处理通道 本地]
        POLL[本地轮询 新反馈/追评]
        TRAE["Trae 助手自动接收
15秒内打进输入框"]
        DO[评估->修改->部署]
        REPLY["POST api/feedback/reply 回写"]
    end
    HOME & PLAN & PMC & ERP & SUP & ADM & DOC --> WAIT
    NG --> WAIT
    AUTH --> WAIT
    WAIT --> MAIN
    CRON -.写快照.-> MAIN
    MAIN --> POLL
    POLL --> TRAE --> DO --> REPLY --> MAIN
    MAIN --> FILES
  

flowchart TB
    subgraph A["A. /plan 回货计划看板 已上线·数据不上传"]
        A1[用户拖拽 Excel 调货总表] --> A2[xlsx.full.min.js 浏览器本地解析]
        A2 --> A3[("localStorage 持久化
数据仅存本机浏览器")]
        A3 --> A4[表格渲染/编辑/导出]
    end
    subgraph B["B. /pmc 欠料总表 空态"]
        B1["带钥匙访问 /pmc?k=..."] --> B2["/api/bootstrap 钥匙鉴权"]
        B2 --> B3[("业务表返回 0 行")]
        B3 --> B4[前端无数据守卫 空态提示]
    end
    subgraph C["C. /erp ERP同步 骨架就绪·待对接"]
        C1[POST /api/erp/sync] --> C2[金蝶K3Cloud取数模块
独立部署 每日07:30]
        C2 -.未部署显式报错不静默.-> C3["erp_*快照表 batch隔离"]
    end
    subgraph D["D. 供应商协同 骨架就绪·待启用"]
        D1["/supplier-admin 生成token链接"] --> D2["/supplier 免登录填报 只看自己的行"]
        D2 --> D3["/api/supplier/save 逐格+批量"] --> D4[("order_rows 回复交期")]
    end
    subgraph E["E. 反馈通道 已闭环·唯一需求来源"]
        E1[任意页面反馈按钮
点选元素+附图] --> E2["POST /api/feedback + /upload"]
        E2 --> E3[("feedback表")]
        E3 --> E4["本地轮询->Trae
15秒内自动推送->reply回写"]
    end
  

erDiagram
    ERP_SYNC_META ||--|| ERP_SHORTAGE : "batch 快照"
    ERP_SYNC_META ||--|| ERP_INSTOCK : "batch 快照"
    ERP_SYNC_META ||--|| ERP_PO : "batch 快照"
    ERP_SYNC_META ||--|| ERP_PR : "batch 快照"
    ERP_SYNC_META ||--|| ERP_PPBOM : "batch 快照"
    SUPPLIERS ||--o{ ORDER_ROWS : "batch+sup_code"
    CUSTOM_COLS ||--o{ ORDER_ROWS_CUSTOM : "定制列定义"
    PLAN_BUYER ||--o{ ORDER_ROWS : "订单->采购员映射"
    INSTOCK_SEEN ||--o{ INSTOCK_LOG : "bill_no 防重+流水"
    ORDER_ROWS ||--o{ FEEDBACK : "行引用 refs"

    SUPPLIERS["供应商"] {
        text sup_code PK "供应商编码"
        text sup_name "供应商名称"
        text buyer "采购员"
        text token UK "免登录令牌"
        text batch "导入批次"
    }
    ORDER_ROWS["回货订单行"] {
        int id PK "行编号"
        text batch "调货批次"
        text sup_code FK "供应商编码"
        text order_no "订单单号"
        text mat_code "物料编码"
        real qty_need "需求数量"
        real qty_back "已回货数量"
        text reply_date "供应商回复交期"
        text reply_note "回复备注"
    }
    ORDER_ROWS_CUSTOM["订单行存档"] {
        int id PK "行编号"
        text batch "调货批次"
        text sup_name "供应商名称 存档快照"
        text buyer "采购员 存档快照"
    }
    CUSTOM_COLS["定制列定义"] {
        text name PK "定制列名"
        int seq "列显示顺序"
    }
    PLAN_BUYER["订单采购员映射"] {
        text order_no PK "生产订单"
        text buyer "采购员"
        text synced_at "同步时间"
    }
    FEEDBACK["反馈"] {
        int id PK "反馈编号"
        text page "来源页面"
        text refs "引用元素快照"
        text content "反馈内容"
        text reply "处理回复"
        text replied_at "回复时间"
        text files "附件清单"
        text uid "匿名身份 只能看自己的"
        text status "状态 待处理或待审核或开发中或已上线"
        text done_at "上线时间 亮红点提醒"
        text followups "追评记录"
    }
    INSTOCK_SEEN["已扣数入库单"] {
        text bill_no PK "已扣数入库单号"
        text run_at "执行时间"
    }
    INSTOCK_LOG["扣数流水"] {
        int id PK "流水编号"
        text bill_no "入库单"
        text order_no "生产订单"
        text mat_code "物料编码"
        real qty "扣减数量"
        int matched "是否匹配"
        text deduct "扣减明细 可溯源"
    }
    ERP_SHORTAGE["ERP欠料快照"] {
        int id PK "行编号"
        text batch "同步批次"
        text mo_no "生产订单"
        text mo_status "订单状态"
        text sub_code "子项物料"
        real unpicked_qty "未领数量"
        real stock_total "总仓库存"
        real lack_qty "实际欠料"
        real ws_stock "车间仓库存"
        real to_buy "需补充数量"
    }
    ERP_INSTOCK["ERP库存快照"] {
        int id PK "行编号"
        text batch "同步批次"
        text wh_type "总仓或车间仓"
        text mat_code "物料编码"
        real qty "库存数量"
    }
    ERP_PO["ERP采购订单快照"] {
        int id PK "行编号"
        text batch "同步批次"
        text bill_no "采购订单"
        text mat_code "物料编码"
        real remain_qty "剩余入库"
        text delivery_date "交货日期"
    }
    ERP_PR["ERP采购申请快照"] {
        int id PK "行编号"
        text batch "同步批次"
        text bill_no "采购申请"
        real remain_qty "剩余数量"
    }
    ERP_PPBOM["ERP用料清单快照"] {
        int id PK "行编号"
        text batch "同步批次"
        text mo_no "生产订单"
        text ppbom_no "用料清单编号"
        text sub_code "子项物料"
        real unpicked_qty "未领数量"
    }
    ERP_SYNC_META["ERP同步游标"] {
        text key PK "游标键 批次与时间"
        text value "游标值"
    }
  

flowchart TB
    subgraph U["反馈人"]
        A1["页面点选元素+填写反馈
可附图"]
        A2["我的反馈面板：免钥匙
状态徽标/回复/追评/上线红点"]
    end
    subgraph F["前端反馈组件"]
        B1["提交反馈+上传附件"]
        B2["每隔半分钟自动刷新
「我的反馈」处理进度"]
        B3["提交追评（补充说明）"]
    end
    subgraph S["服务端程序"]
        C1[("反馈台账
待处理/待审核/开发中/已上线")]
        C2["查全部反馈清单（需钥匙）"]
        C3["写回复+回复时间（需钥匙）"]
        C4["改处理状态（需钥匙）"]
        C5["撤销回复（需钥匙）"]
    end
    subgraph T["本地处理通道 AI助手Trae"]
        D1["自动发现新反馈/追评
（每15秒查一次线上清单）"]
        D2{"评估
是否适合修改"}
        D3["开发+部署上线
状态改已上线+记上线时间"]
    end
    subgraph G["总管理员 管理后台"]
        E1["汇总/筛选/搜索/改状态"]
        E2["回复/取消回复"]
    end
    A1 --> B1 --> C1
    C1 --> D1 --> D2
    D2 -->|适合| D3 --> C3
    D2 -->|需审核| E1 --> D3
    C3 & C4 & C5 --> C1
    C1 --> B2 --> A2
    A2 --> B3 --> C1
    E2 --> C5
    A1 --> S6["附件保存到服务器
专用附件目录"]