# super.winnie · FlexDock 用工调度系统

仓储用工（补人）调度与供应商协同系统。雇主端（仓经理）填用人需求 → 系统按供应商等级自动推送 → 供应商端接单回填送人。

> 当前为**前端原型阶段**：界面可点、逻辑可演示，数据为示例，**尚未接入 RMS 宽表**。
> 真实系统中前端只调 API 服务层，不直连宽表（见 `docs/api-spec.html`）。

---

## 快速开始

双击 **`index.html`** 打开项目首页，从那里进入各个模块。

如果某个页面打开是空白，别直接双击，改用：右键 → 打开方式 → **Chrome / Edge**，或先打开浏览器再把文件拖进窗口。所有原型都是单文件、零依赖，断网也能跑（仅字体会退化为系统字体）。

---

## 目录结构

```
super.winnie/
├── index.html                  项目首页（入口，串起所有模块）
├── README.md                   本说明
│
├── app/                        可点击的前端原型（单文件 HTML，浏览器直接开）
│   ├── employer-console.html   雇主端：仓经理填需求 + 按等级自动推送（中/EN）
│   ├── vendor-portal.html      供应商端：接单 + 回填 + 叉车证确认 + 卡点原因（中/EN）
│   └── internal-dashboard.html 内部总览：双视图（内部 / 供应商）权限边界演示
│
├── src/                        给开发接着写的源码起点
│   └── flexdock-demo.jsx       React 版（需 React 环境构建）
│
├── docs/                       流程与接口文档
│   ├── process-flow.png        补人流程图（落地版，最终）
│   ├── process-flow.mermaid    流程图可编辑源（Mermaid）
│   ├── api-spec.html           供应商 ↔ WMS 接口文档（中英）
│   └── diagrams/               流程图历史版本
│       ├── flow-v1.png             初版
│       ├── flow-optimized.png      优化版（含预测/SLA/工人确认等）
│       ├── flow-horizontal.png     横版
│       └── flow-mermaid.html       Mermaid 网页渲染
│
├── trackers/
│   └── vendor-quality-tracker.xlsx  供应商供人质量追踪表（系统上线前用）
│
└── assets/screenshots/         界面截图
    ├── employer-routing.png    雇主端 · 自动推送方案
    ├── employer-grades.png     雇主端 · 供应商等级
    ├── employer-EN.png         雇主端 · 英文
    ├── vendor-zh.png           供应商端 · 中文
    ├── vendor-EN.png           供应商端 · 英文
    └── vendor-bottleneck.png   供应商端 · 卡点原因
```

---

## 两端怎么衔接

```
雇主端 employer-console            供应商端 vendor-portal
─────────────────────             ─────────────────────
① 仓经理填用人需求         ┐
② 按等级/评分自动推送      ├──推送──▶  ③ 供应商接单
   (紧急跳过仓经审批)      ┘            ④ 回填人员 + 叉车证 yes/no
                                       ⑤ 填不满 → 写卡点原因(≥30字)
                          ◀──回传──     ⑥ 报到 / 考勤（同接口回 WMS）
```

供应商评分（满足率/到场率/no-show/叉车证合规）决定其等级，等级又决定下一轮派单优先级，形成闭环。

---

## 设计约定

- **权限边界**是核心：供应商只见本公司数据，薪资/成本/其他供应商数据上锁。隔离须在 **API 层强制**，不能只靠前端隐藏。
- 雇主端 = 深色主题；供应商端 = 青色主题；颜色一眼区分身在哪一端。
- 中 / EN 双语：供应商在本地用 English，内部看中文。

## 路线图（下一步）

1. 在 RMS 宽表与前端之间搭 **API 服务层**（前端永不直连宽表）。
2. 行级权限 / 多租户：每家供应商数据隔离。
3. 先把 **回填 + 考勤** 两个高频场景做成接真数据的可用版。
4. 叉车证接口加 **证号 + 有效期**，让 WMS 自动判过期。
```
```