VANWELL
南通万誉服饰有限公司 FACTORY OS
3
徐洋 老板 · BOSS
2026 · WEEK 21 · FRIDAY

早上好,徐洋。

"IE Dev 把衣服做对 · MES 把大货跑顺 · Finance 把工资和成本算清。"
My Perspective · 我的视角
PHASE 1 · 2026 Q2 · CURRENT
MCP-ready 准备 YOU ARE HERE
系统跑稳 + 业务规则下沉到 RPC + 接口目录化,**不**正式开发 MCP Server
  • 6 个核心 RPC 上线(含 v1.2.10 list_material_orders_with_progress)
  • docs/API_RPCS.md v1.3 接口目录 + schema 变更追踪
  • styles_hub + 工序工价预览页
  • v1.2.11 卷处理 vs 放缩 业务概念分离
  • 业务员真实试用反馈闭环验证(Yang 真人测试拦截 UX)
  • IE Excel 模板攒种子数据
PHASE 2 · 2026 Q3
MCP Server 正式开发
起 Node.js MCP Server · 工序工价模块上线 · 用户登录系统
  • vanwell-mcp-server 激活(starter kit 已就绪)
  • operations + style_operations 模板表
  • 工价审批状态机 + 审计
  • 用户登录 + 角色权限矩阵
  • 接 Claude Desktop / Cursor 测试
PHASE 3-4 · 2026 Q4 - 2027 Q1
AI Agent 接入真实业务
task_operations + 员工报工 + 计件工资 + AI 自动日报/异常告警
  • 大货实际工序流转 (task_operations)
  • 员工扫码报工 + 工资计算
  • AI 自动日报(generate_daily_briefing)
  • 异常告警 (get_anomalies)
  • Webhook 事件总线
⚡ API & AI 能力 · 数字化主干
所有核心数据可被 AI Agent / MCP / 外部系统调用 · v1.2.7 起 API-First 为硬性约束 · 完整 RPC 接口目录 → docs/API_RPCS.md
🔌 REST × 11
表自动暴露(Supabase PostgREST)
v1.3.2 · 共 26 表:styles(+brand_id/customer_id) · suppliers(+category) · production_tasks(+13 v1.3 + 6 cost) · material_orders · fabric_rolls · fabric_inspections · inspection_defects · inspection_defect_images · fabric_shrinkage_tests · defect_types · style_skus · brands · customers · settlement_parties · business_departments · seller_entities · factories · outsourced_works · import_batches · employees · equipment · (Phase 2-4 += 6)
🤖 RPC × 6
业务逻辑下沉 SQL(v1.2.7)
  • get_dashboard_summary()
  • derive_style_stage()
  • compute_style_completeness()
  • get_styles_needing_attention()
  • evaluate_fabric_inspection()
📁 Storage × 2
文件 bucket(CDN 公开)
style-images(款式图片)· fabric-quality-images(验布缺陷照片)· 浏览器端压缩后上传
🧠 MCP × Phase 2
AI 工具封装(规划中)
独立 Node.js MCP Server,把 RPC 包装成 Claude/GPT 可直接调用的工具 schema · Phase 2 启动 Gate 后开建
已上线 · M1(v1.3.2)
下一阶段 · M2–M3
未来 · M4–M5
🔌 REST
🤖 RPC
点击绿色节点可进入对应模块
LANE / PHASE
PHASE A
IE Dev 前置
Sample & Engineering
PHASE B · v1.3.2 ✅
业务上游
Order · Material · Receiving
PHASE C
车间执行
Floor Execution
PHASE D
财务后置
Cost & Payroll
LANE 01
业务订单流
Order Flow
客户开发款
style brief
出货
shipments
订单毛利
order_margin
LANE 03
数据对象流
Data Object Chain
dev_project_id
+ sample_round_id
style_no
→ production_task_id
material_order_id
→ fabric_roll_id
process_log_id
→ qc_id
shipment_id
→ cost_id
LANE 04
工艺 / IE / 产能流
IE & Capacity
Phase 2
工序库
operations · 全公司字典
M4
设备 / 工人技能
machines · skills
M4
瓶颈调度
capacity planning
实际 vs 标准工时
SAM 校准报表
LANE 05
成本 / 工资 / 财务流
Cost & Payroll
开发成本估算
dev cost estimate
面料 / 辅料成本
material_cost
Phase 2
工序工价表
style_operations · 财务审批
IE 提报工价 → 财务审批 → 状态机:draft / submitted / approved / rejected。
只有 approved 才能被大货任务复制使用。
表: style_operations + style_operation_history(审计)
IE · 财务
Phase 4
员工计件报工
employee_work_logs
员工扫码报工。每条 = 某员工某天某工序完成多少件。
工价用报工时快照,模板再改不影响历史工资。
表: employee_work_logs
员工 · 车间主任 · 财务
Phase 4
计件工资汇总
piecework_records (视图)
Phase 4+
订单人工成本
task_operations 聚合
Phase 4+
毛利分析
finance_dashboard
想法暂存区 · Inbox
新想法先扔这里,确认后再决定归入哪条泳道
0 / 暂存
FACTORY OS v1.3.2 · 2026.05.27 · Phase 1A SQL + 1B-γ 前端接 DB + 2 C-MVP Excel Agent LLM + 1C 清理收尾 全部完成
返回工作台
变更日志 · Changelog
Phase 2/3/4 路线 2026 Q3 - Q4 - 2027 Q1
工序工价 / IE 标准 → 大货实际流转 → 员工计件工资
  • Phase 2(2026 Q3):operations 工序库 + style_operations 模板 CRUD + 状态机 + 工价审计
  • Phase 3(2026 Q4):task_operations 大货实际流转 + 快照机制 + 临时调整 + 外发
  • Phase 4(2027 Q1):employee_work_logs 报工 + 计件工资 + 月度对账 + 工资条
  • 启动 Gate 6+3 条详见 v1.3_工序工价模块_规划.md
v1.3.2 ✅ 2026-05-27 大货全链路 · 真读写 DB
Phase 1A SQL + Phase 1B-γ 前端接入 + Phase 2 C-MVP + Phase 1C 清理 全部完成
  • 大货任务 production_tasks · 全链路 mock → DB:列表 / 4 维度下拉 / 款号 / SKU×size 矩阵 / 6 大成本 / 外协合同 / 工厂(factories 主数据)
  • Excel Agent · production_tasks_import.html 真接 Kimi LLM(moonshot-v1-8k via Edge Function · max_tokens 8192 · JSON 提取 + Mock fallback) · 6 个真实款一次提取
  • master_data.html · 8 tab 统一基础资料(供应商按 fabric/accessory/secondary_processing 分类 · 工厂按 cmt_factories/outsource_factories/overseas_factories · 客户 · 品牌 · 结算方 · 业务部门 · 员工 · 设备)
  • factories 表新建 · 6 家自有/合作工厂主数据 · production_tasks.html 工厂字段 datalist 联想
  • styles 加 brand_id / customer_id FK · 9 个老款全自动回填(模糊匹配+全角/半角归一化)· 测试款 D6331BTS70-CR 归档
  • 外协 outsourced_works 真写库 · saveOw/deleteOw 走 sb.from · openTaskModal 自动加载 · total_amount 自动算
  • production_tasks + 6 大成本字段(material/accessory/sewing/secondary_processing/management/import_export_cost)· view v_production_tasks_with_cost_total
  • 中英文 enum 统一 · 7 个 CHECK 收紧到只允许英文 · 老数据 UPDATE 迁移(~20 行)
  • employees / equipment 表新建 · 给员工 + 设备主数据预留
  • suppliers 加 category 列(fabric/accessory/secondary_processing)· material_orders 按物料类型自动过滤供应商
  • F1 重构 · 9 个 SQL 文件(phase2_factories / phase2_status_pending_review / phase2b_master_data_expand / phase2c_styles_fk / phase2d_production_tasks_costs / phase2e_cleanup_dirty_styles / phase2f_enum_unify)+ Edge Function v12
v1.1 收尾 待办 面料质检相关
v1.1 收尾清单 · 仍待办
  • 缸差 / 匹差表 · 同款同色多卷之间的颜色对照
  • 边中差 / 九宫格检查 · 单卷左中右 / 9 块颜色差异(客户硬性要求)
  • 撞色家庭洗涤试验 · 不同色布同洗测试串色
  • 残余面料明细统计 · 每款结束后剩布统计与复用追溯
  • "合格才能大生产"系统级卡点 · 未验布合格的卷不能被裁剪 (当前仅建议)
  • 删除旧的 V7 fabric_inspections.html (已被替换)✓ 2026.05.26 已删(修 inspected_at 报错)
  • PDF 中文字体嵌入(思源黑体),修复字号渲染
  • 缩率测试编辑模式完善(回填字段)
  • fabric_rolls 关联任务字段在卷信息卡显示
  • saveShrinkage 字段映射完善
  • 缩率 modal 款号下拉接 Supabase
  • 放缩时间记录字段 (SOP 要求,当前靠现场看板手写)✓ v1.2.11 已完成
v1.1 2026.05.26 业务概念分离 · 试用反馈闭环
  • v1.2.11 · 卷处理 vs 放缩 概念分离(Yang 业务澄清驱动):
    • 松布 ≠ 放缩:验布流程已含松布;放缩是验布/松布完成后的独立静置阶段
    • schema:fabric_inspections.inspection_modeprocess_type(值 inspection / loosening)
    • UNIQUE(fabric_roll_id) 约束 — 一卷只能有一条卷处理记录
    • fabric_rolls 加 6 个 relax_* 字段(放缩状态/小时/起止/位置/备注)
    • 前端拦截:已处理卷选中即显示橙色横幅 + "切换到编辑"按钮 + UNIQUE 23505 兜底
  • v1.2.10 · 采购员视角 RPC:list_material_orders_with_progress() 跨 4 表聚合(material_orders + fabric_rolls + production_tasks + fabric_inspections)→ 工厂分布 + 验布进度。材料列表页加 2 列
  • SOP 第⑦放缩:从 "Phase 2 占位" 升级为读 relax_status 实时分布(进行/完/跳/未)
  • API_RPCS.md v1.3:加 §9 schema 变更追踪,v1.2.11 全部 schema 改动文档化
  • 教训 36:RENAME COLUMN 时旧 CHECK 公式不变 → 必须先 DROP · migration 必须 idempotent · 经历 23514 → 42703 → 42P07 三轮报错才完全收敛
  • 教训 37:业务概念混淆时 schema 也会混淆 — 修字段前先画 ER 图 + 状态流转图;UNIQUE 是 DB 层落地业务规则的利器,但前端必须给友好引导
  • 试用反馈闭环验证:Yang 真人测试拦截横幅 → 截图确认显示 ✓ 切换编辑 ✓ 取消选卷 ✓ 业务规则提示 ✓
  • GitHub:补齐 docs/ + migrations/ 文件夹历史 + 41 commits
  • API & AI 能力:RPC 数 5 → 6(新增 list_material_orders_with_progress)
  • hotfix · 删除旧 V7 fabric_inspections.html:GitHub 残留旧页面被 Vercel 部署,其引用 v1.2.11 已重命名的 inspected_at(现 inspect_date)→ 报 column fabric_inspections.inspected_at does not exist。删除后 Vercel 重新部署修复。教训补强:**重命名字段后必须同步清理 GitHub 残留旧页面**(V10 起的待办拖到 V12 才落地,血泪)
  • v1.3 数据模型 RFC v0.2 + 数据模型预览页上线(2026-05-26 晚):SKU 双码 + 4 经营分析维度(brands/customers/settlement_parties/business_departments)+ 销售额简化链路(unit_price_at_task × total_quantity)+ 外协 outsourced_works(4 type × 4 pricing)+ 6 大类成本口径(material/accessory/sewing/secondary_processing/management/import_export + outsourced)· 预览页 v1.3_model_preview.html 用 mock 数据展示 8 大关系 · 等 D1-D20 决策清单 Yang 确认通过后才写 SQL(教训 37 红线)
  • v1.3 大货任务正式化 + Excel 导入子页 + 订单变更管理(2026-05-26 深夜):production_tasks_v1.3_preview.htmlproduction_tasks.html 正式升级 · 原版备份为 production_tasks_v1.2_backup.html · excel_agent_v1.3_preview.htmlproduction_tasks_import.html 归到大货任务模块 · 大货任务详情加 📜 订单变更管理(10 种 change_type + 部门通知矩阵 + append-only)· Excel 导入支持三模式(MOCK / DRY RUN 真接 SheetJS / REAL LLM TEST)· Phase 1A SQL 完整交付包就绪(backup/migration/verify/rollback · 零 DROP · 等 Yang 执行)
v1.0 2026.05.25 ★ Phase 1 收尾里程碑
  • Phase 1/2/3 顶部进度条上线(全局视觉锚点 · 当前阶段金色高亮)
  • 新增 docs/API_RPCS.md v1.1 · MCP-ready 接口目录(5 当前 + 12 计划 RPC)
  • API 能力面板加链接到 API_RPCS.md
  • MCP Server skeleton 重定位为 Phase 2 待启动,不投入维护
  • SOP_面料仓库作业流程_v2.html · 重做 2023.10 流程图(打印贴墙 + 系统映射 + Phase 标识)
  • 交接摘要升 V11 · 对齐新 3 阶段框架(MCP-ready → MCP Server → AI Agent)
  • 原则锁定:**新业务逻辑优先写 RPC 不散在前端**(教训 30+31)
  • Phase 1 焦点:试点反馈 + 系统跑稳 + 不堵死 AI Agent 接入
v0.9 2026.05.25
  • API-First 升级为「所有后续开发的硬性约束」(API-First_MCP架构标准 v1.1)
  • 顶部加「⚡ API & AI 能力」面板:11 REST + 5 RPC + 2 Storage + Phase 2 MCP 一目了然
  • 已联网模块加 🔌 REST / 🤖 RPC 徽章:款式管理 + 大货任务 + 面料卷入库 + 面料质检
  • SOP v1.1 加 §11「新功能开发强制 7 项清单」+ DoD PR 自检模板
  • 教训库新增第 30 条:API-First 不是建议是底线
  • 跨文档同步从 5 处变 5 处(技术债 / 本 blueprint / SOP / API 标准 / 交接摘要)
v0.8 2026.05.25
  • API-First & MCP 架构标准 v1 上线(API-First_MCP架构标准_v1.md)
  • 定义 5 大北极星原则:业务逻辑下沉到 SQL · 每表自带 REST · 跨表流走 RPC · MCP = RPC + schema · 审计先行
  • RPC 命名规范:get_* / compute_* / derive_* / record_* / execute_*
  • 建 5 个核心 RPC:derive_style_stage / compute_style_completeness / get_styles_needing_attention / get_dashboard_summary / evaluate_fabric_inspection
  • SOP 第 10 节扩为「变更同步 5 处」,加 API 标准引用
  • 权限模型规划:anon / employee / business / ie / qc / finance / floor_lead / admin · Phase 2 实施
  • AI Agent 集成示例 + MCP 工具 schema 模板写入标准
  • 待办路线图:Phase 2 起 MCP Server(Node.js)+ OpenAPI + 角色权限
v0.7 2026.05.25
  • v1.2 系列 上线:款式管理大改造(基础信息 → AI-Ready 字段 + 阶段总览)
  • v1.2.0:styles 表 +14 字段(品类/面料类型/成分/工艺标签/风险/难度/历史问题 等)
  • v1.2.1:colorways JSONB(同款多色,不再一色一行)+ 老数据自动迁移
  • v1.2.2:责任部门 badge(业/IE/品)+ 表格录入完整度列(业✓ IE✗)
  • v1.2.3:Phase 2 工序工价入口占位(每行 ⚙ 按钮)
  • v1.2.4:款式图片(多图/主图/拖拽/粘贴/Lightbox)+ Supabase Storage style-images bucket
  • v1.2.5:子模块导航(款式管理 = 基础信息 + 工序工价)+ 父级面包屑
  • v1.2.6:styles_hub.html 总览页(阶段推导 + 5 张汇总卡 + 下一步建议)+ ?edit 深链
  • style_operations.html v0.4:4 层架构图(styles → style_ops → task_ops → work_logs)+ 模板/实际铁律 + Phase 路线图
  • Lane 1 业务订单流:styles 节点更新为 hub 入口,关联表 styles_hub + styles + style_operations
  • Lane 4 工艺/IE:新增「款式工序模板」preview 节点 + 「大货实际工序流转」future 节点(Phase 3)
  • Lane 5 财务流:工序单价表 → style_operations · 员工计件 → employee_work_logs · 表名对齐
  • 新增 SQL 迁移:v1.2_styles_ai_ready.sql · v1.2.1_colorways.sql · v1.2.4_images.sql
  • 新增文档:v1.3_工序工价模块_规划.md(RFC v0.2 · 4 层架构)· 款式管理_录入责任分工_v1.md
v0.6 2026.05.25
  • v1.1 面料质检模块上线(替代原 V7 验布管理)
  • Lane 2 实物流:合并"验布 + 松布"两节点为「面料质检」(M1 试点)
  • 支持仅松布 / 松布+四分制验布 两种模式切换
  • 26 项缺陷字典灌入 defect_types(A 组 18 长度计分 + B 组 8 直接扣 4)
  • 评分阈值改 20/40 (A/B/C),底层枚举保留 accepted/pending_review/rejected
  • 新增字段:inspection_mode / actual_yards / actual_width_inch / actual_weight_kg / actual_gsm / hard_indicators (JSONB)
  • 新建表:inspection_defect_images (缺陷照片) + fabric_shrinkage_tests (缩率测试)
  • fabric_rolls 加标签打印(40×80mm 不干胶 + 二维码 + 佳博 9024D)
  • fabric_quality 支持扫码(摄像头 + 扫码枪 USB/蓝牙)
  • 退货 PDF 报告自动生成(C 类 OR 硬指标触发)
  • 抽样规则版本号 V1_2026_05 = 10%, ≥1000 码不少于 1000
  • 路径 B 重构:DROP 旧表重建,字段命名统一,清掉 14 条模拟数据
v0.5 2026.05.23
  • 加入口防御:blueprint 只能从 index 工作台进入
  • 顶栏加"返回工作台"按钮,与 index 双向跳转
v0.4 2026.05.22
  • 升级为 MES 系统首页,作为中央枢纽页
  • 新增 5 角色视角切换(老板/业务/仓库/IE/财务)
  • 新增双 Tab:全景视图 / 工作台(工作台留壳)
  • 绿色节点可点击跳转模块(suppliers.html 接入)
  • 新增 Inbox 想法暂存区,localStorage 存储
  • 新增右上角变更日志抽屉
  • 顶栏接入真实盾牌 logo
v0.3 2026.05.22
  • 建立 5 泳道 × 4 阶段的全景图骨架
  • 新增 Lane 5 财务/工资/成本泳道
  • 定义三态颜色:绿(M1)/ 黄(M2-M3)/ 灰(M4-M5)
  • 三视图过滤:全部 / 当前试点 / 下一阶段 / 未来
v0.2 2026.05.20
  • 确定 IE Dev → Bulk MES → Finance 三大系统域
  • 明确 M1 试点边界:production_tasks / material_orders / fabric_rolls
v0.1 2026.05.18
  • suppliers.html 首版上线,定型 MES 设计系统
  • 视觉规范 V1.0 发布