feat: red flush

docs/plant/business-function-architecture-simple.puml

@@ -0,0 +1,55 @@
+@startuml
+title Flower ERP 业务功能架构简图
+
+skinparam shadowing false
+skinparam defaultFontName Noto Sans CJK SC
+skinparam backgroundColor #FFFFFF
+skinparam ArrowColor #5B6472
+skinparam ArrowThickness 1.3
+skinparam componentStyle rectangle
+skinparam rectangle {
+  FontName Noto Sans CJK SC
+  BorderColor #516174
+  RoundCorner 8
+}
+skinparam package {
+  FontName Noto Sans CJK SC
+  BorderColor #516174
+  BackgroundColor #F8FAFC
+}
+
+top to bottom direction
+
+rectangle "外部系统与前端入口\n明道云 / 好布业财务 / 企业微信 / 管理后台 / 移动端" as Entry #F5F7FA
+
+rectangle "Flower ERP 业务平台" as Platform #EAF3FF {
+  rectangle "基础资料中心\n商户、客户、供应商、产品、仓库、员工、车辆" as MasterData #FFFFFF
+
+  rectangle "业务经营中心\n采购、销售、退货、预订单、收付款、往来余额" as Business #F2F8FF
+
+  rectangle "生产履约中心\n开版、印花订单、工序推进、MES 设备指派" as Production #FFF8EF
+
+  rectangle "库存物流中心\n出入库、库存台账、销售品、出货单、送货单" as StockLogistics #F7FBF4
+
+  rectangle "协同运营中心\n流程引擎、任务协同、通知中心、费用、日结" as Collaboration #F8F5FF
+}
+
+rectangle "运行与数据支撑\n异步任务、文件图片、审计日志、外部同步" as Support #F5F7FA
+
+Entry --> Platform : 业务录入 / 外部同步 / 消息触达
+MasterData --> Business : 基础资料支撑经营单据
+Business --> Production : 销售需求驱动生产履约
+Production --> StockLogistics : 生产成果进入发货履约
+Business --> StockLogistics : 采购销售触发库存变化
+Business --> Collaboration : 审批、对账、统计与提醒
+Production --> Collaboration : 流程推进与任务协同
+StockLogistics --> Collaboration : 发货通知与物流跟进
+Platform --> Support : 定时、异步、图片、审计支撑
+
+note right of Platform
+  汇报口径：
+  展示业务能力版图与主链路，
+  不展开具体技术实现。
+end note
+
+@enduml

docs/plant/business-function-architecture.puml

@@ -0,0 +1,137 @@
+@startuml
+title Flower ERP 业务功能架构图
+
+skinparam shadowing false
+skinparam defaultFontName Noto Sans CJK SC
+skinparam backgroundColor #FFFFFF
+skinparam ArrowColor #5B6472
+skinparam ArrowThickness 1.2
+skinparam componentStyle rectangle
+skinparam rectangle {
+  FontName Noto Sans CJK SC
+  BorderColor #516174
+  RoundCorner 8
+}
+skinparam package {
+  FontName Noto Sans CJK SC
+  BorderColor #516174
+  BackgroundColor #F8FAFC
+}
+skinparam note {
+  FontName Noto Sans CJK SC
+  BackgroundColor #FFF7E6
+  BorderColor #B7791F
+}
+
+left to right direction
+
+rectangle "Flower ERP 业务平台" as Platform #EAF3FF {
+
+  package "基础资料中心" as MasterData #F6F8FB {
+    rectangle "商户 / 客户 / 供应商" as MDParty #FFFFFF
+    rectangle "产品 / 品类 / 仓库" as MDProduct #FFFFFF
+    rectangle "员工 / 角色 / 可见页面" as MDStaff #FFFFFF
+    rectangle "车辆 / 银行账户 / 快捷输入" as MDOther #FFFFFF
+  }
+
+  package "业务经营中心" as Business #F2F8FF {
+    rectangle "采购管理\n采购单 / 采购退货" as Purchase #FFFFFF
+    rectangle "销售管理\n预销售 / 销售单 / 销售退货" as Sales #FFFFFF
+    rectangle "资金往来\n付款单 / 收款单" as Cash #FFFFFF
+    rectangle "往来余额\n客户应收 / 供应商应付 / 余额流水" as Balance #FFFFFF
+    rectangle "外部对账\n好布业财务同步" as ExternalFinance #FFFFFF
+  }
+
+  package "库存物流中心" as StockLogistics #F7FBF4 {
+    rectangle "库存管理\n现存量 / 库存快照" as Inventory #FFFFFF
+    rectangle "出入库执行\n入库 / 出库 / 调拨 / 红冲" as StockFlow #FFFFFF
+    rectangle "销售品管理\n待分配销售品 / 合卷 / 重建" as SalesItem #FFFFFF
+    rectangle "发货管理\n出货单 / 送货单 / 送达照片" as Shipment #FFFFFF
+  }
+
+  package "生产履约中心" as Production #FFF8EF {
+    rectangle "开版管理\n开版订单 / 样品 / 客户反馈" as PlateOrder #FFFFFF
+    rectangle "印花订单\n生产订单 / 款式明细" as PrintingOrder #FFFFFF
+    rectangle "工序推进\n批量推进 / 工艺参数 / 进度" as ProcessAdvance #FFFFFF
+    rectangle "MES 生产指派\n设备 / 产能 / 指派状态" as MES #FFFFFF
+  }
+
+  package "协同运营中心" as Collaboration #F8F5FF {
+    rectangle "流程引擎\n流程 / 节点 / 状态记录" as Stateflow #FFFFFF
+    rectangle "任务协同\n任务 / 参与者 / 回复 / 完成" as Mission #FFFFFF
+    rectangle "通知中心\n事件路由 / 模板 / 企业微信" as Notifier #FFFFFF
+    rectangle "费用与日结\n支出记账 / 成本汇总 / 日结配置" as CostSettlement #FFFFFF
+  }
+
+  package "对外能力与运行支撑" as Integration #F5F7FA {
+    rectangle "API 入口\n移动端 / 前端 / 管理后台" as API #FFFFFF
+    rectangle "文件与图片\n七牛云 / 上传 / 图片检索" as FileImage #FFFFFF
+    rectangle "外部系统同步\n明道云 / 外部生产订单 / TIIA" as ExternalSync #FFFFFF
+    rectangle "异步任务\n同步 / 通知 / 审计 / 定时任务" as AsyncJobs #FFFFFF
+  }
+}
+
+API --> MasterData : 基础资料维护
+API --> Business : 单据录入与审批
+API --> Production : 生产过程操作
+API --> StockLogistics : 库存与发货操作
+API --> Collaboration : 协同与统计查询
+
+MasterData --> Business : 客户、供应商、产品、仓库、员工
+MasterData --> Production : 客户、产品、员工、设备基础
+MasterData --> StockLogistics : 产品、仓库、客户、车辆
+MasterData --> Collaboration : 商户、员工、权限范围
+
+Purchase --> StockFlow : 审批后触发入库/退货出库
+Sales --> StockFlow : 销售出库/销退入库
+Purchase --> Balance : 形成供应商应付
+Sales --> Balance : 形成客户应收
+Cash --> Balance : 收付款冲减余额
+ExternalFinance --> Cash : 外部收付款同步
+ExternalFinance --> Balance : 对账依据补充
+
+PlateOrder --> Stateflow : 开版流程跟踪
+PrintingOrder --> Stateflow : 印花任务工序流转
+PrintingOrder --> ProcessAdvance : 批量推进生产节点
+PrintingOrder --> SalesItem : 生产明细生成可发货销售品
+MES --> PrintingOrder : 生产对象指派到设备
+
+Inventory <-- StockFlow : 更新库存台账
+StockFlow --> Inventory : 形成库存快照
+SalesItem --> Shipment : 组建出货单
+Shipment --> Notifier : 出货事件通知
+
+Mission --> Notifier : 任务事件通知
+Mission --> Production : 关联开版/印花对象
+Mission --> Shipment : 关联发货对象
+CostSettlement --> Production : 采集生产相关成本
+CostSettlement --> StockLogistics : 采集库存/物流相关成本
+CostSettlement --> Notifier : 日结结果通知
+
+ExternalSync --> MasterData : 同步产品、客户
+ExternalSync --> PlateOrder : 明道云开版暂存/导入
+ExternalSync --> PrintingOrder : 外部生产订单快照
+ExternalSync --> FileImage : 图片上传与 TIIA 检索
+FileImage --> PlateOrder : 开版图与图库
+FileImage --> PrintingOrder : 产品图片
+AsyncJobs --> ExternalSync : 定时同步
+AsyncJobs --> Notifier : 异步投递
+AsyncJobs --> StockFlow : 异步生成库存记录
+AsyncJobs --> CostSettlement : 定时日结
+
+note top of Platform
+  本图用于向上汇报，表达业务能力版图与模块协作关系；
+  不展示数据库、容器、框架等技术实现细节。
+end note
+
+note right of Business
+  经营闭环：
+  单据审批 -> 库存变化 -> 往来余额 -> 收付款/对账。
+end note
+
+note bottom of Production
+  履约闭环：
+  开版 -> 印花生产 -> 工序推进 -> 销售品 -> 发货。
+end note
+
+@enduml

docs/plant/business-module-object-catalog.puml

@@ -0,0 +1,146 @@
+@startuml
+title Flower ERP 模块功能对象图（目录版）
+
+skinparam shadowing false
+skinparam defaultFontName Noto Sans CJK SC
+skinparam backgroundColor #FFFFFF
+skinparam object {
+  FontName Noto Sans CJK SC
+  BackgroundColor #FFFFFF
+  BorderColor #4B5563
+}
+skinparam package {
+  FontName Noto Sans CJK SC
+  BorderColor #64748B
+  BackgroundColor #F8FAFC
+}
+
+left to right direction
+
+package "入口与主数据" as P1 #F6F8FB {
+  object "API / Admin" as ApiEntry {
+    api/backend 基础资料后台
+    api/v1 核心业务接口
+    api/v2 新版业务接口
+    admin 管理后台
+    auth 登录与员工身份
+    SSE 实时推送
+  }
+
+  object "basic_info" as BasicInfo {
+    商户 / 多租户
+    客户 / 供应商
+    产品 / 品类 / 仓库
+    员工 / 角色 / 页面权限
+    车辆 / 银行账户 / 快捷输入
+  }
+}
+
+package "经营与库存" as P2 #F2F8FF {
+  object "business" as Business {
+    采购 / 采购退货
+    销售 / 销售退货
+    预销售 / 预采购
+    收款 / 付款
+    客户应收 / 供应商应付
+    余额流水 / 对账 / 红冲
+  }
+
+  object "stock" as Stock {
+    出入库记录
+    出入库明细
+    库存现存量
+    库存快照
+    库存冻结
+    调拨 / 红冲 / 冲抵
+  }
+
+  object "cost" as Cost {
+    支出类目
+    支出明细
+    凭证图片
+    成本汇总
+    成本采集端口
+  }
+}
+
+package "生产与交付" as P3 #FFF8EF {
+  object "printing" as Printing {
+    开版订单
+    开版图 / 样品 / 客户反馈
+    印花订单
+    印花款式明细
+    工序批量推进
+    外部订单快照
+    生产完成通知
+  }
+
+  object "stateflow" as Stateflow {
+    状态参数
+    流程模板
+    流程节点
+    业务对象
+    流转记录
+    节点参数记录
+  }
+
+  object "mes" as MES {
+    设备分类
+    设备管理
+    产能信息
+    生产指派
+    指派状态流转
+  }
+
+  object "shipment" as Shipment {
+    销售品
+    出货单
+    送货单
+    送达照片
+    销售品变更 / 重建
+    外部成品表
+  }
+}
+
+package "协同与集成" as P4 #F8F5FF {
+  object "mission" as Mission {
+    任务分类
+    任务
+    参与者
+    回复
+    完成 / 重开 / 取消
+    关联任意业务对象
+  }
+
+  object "notifier" as Notifier {
+    通知器
+    通知路由
+    事件匹配
+    模板渲染
+    企业微信 webhook
+    message_api
+    未回复提醒
+  }
+
+  object "settlement" as Settlement {
+    日结配置
+    统计模块选择
+    通知渠道配置
+    商户日结任务
+  }
+
+  object "外部与异步支撑" as Support {
+    明道云同步
+    好布业财务同步
+    腾讯云 TIIA
+    七牛云文件图片
+    Celery 定时与异步任务
+    API 审计日志
+  }
+}
+
+P1 -[hidden]right- P2
+P2 -[hidden]right- P3
+P3 -[hidden]right- P4
+
+@enduml

docs/plant/business-module-object-map.puml

@@ -0,0 +1,227 @@
+@startuml
+title Flower ERP 模块功能对象图
+
+skinparam shadowing false
+skinparam defaultFontName Noto Sans CJK SC
+skinparam backgroundColor #FFFFFF
+skinparam ArrowColor #6B7280
+skinparam ArrowThickness 1
+skinparam object {
+  FontName Noto Sans CJK SC
+  BackgroundColor #FFFFFF
+  BorderColor #4B5563
+}
+skinparam package {
+  FontName Noto Sans CJK SC
+  BorderColor #64748B
+  BackgroundColor #F8FAFC
+}
+skinparam note {
+  FontName Noto Sans CJK SC
+  BackgroundColor #FFF7E6
+  BorderColor #B7791F
+}
+
+left to right direction
+
+package "访问入口层" as EntryLayer #F5F7FA {
+  object "API / Admin\n访问入口" as ApiEntry {
+    api/backend: 基础资料后台接口
+    api/v1: 核心业务接口
+    api/v2: 新版业务接口
+    admin: 管理后台
+    auth: 登录与员工身份校验
+  }
+
+  object "SSE\n实时通道" as SSE {
+    事件推送
+    连接状态
+    测试推送
+  }
+}
+
+package "基础资料层" as MasterLayer #F6F8FB {
+  object "basic_info\n基础资料" as BasicInfo {
+    商户 / 多租户
+    客户 / 供应商
+    产品 / 品类
+    仓库 / 仓库模式
+    员工 / 员工类型 / 用户档案
+    前端页面权限
+    车辆 / 车次 / 银行账户
+    快捷输入 / 商户设置
+  }
+
+  object "api_man\n后台资料接口" as ApiMan {
+    产品维护
+    仓库维护
+    客户维护
+    供应商维护
+    员工维护
+    车辆与账户维护
+  }
+}
+
+package "经营单据层" as BusinessLayer #F2F8FF {
+  object "business\n业务单据" as Business {
+    采购单 / 采购退货单
+    销售单 / 销售退货单
+    预销售单 / 预采购单
+    收款单 / 付款单
+    客户应收 / 供应商应付
+    余额变动流水
+    客户对账单
+    红冲 / 作废 / 审批
+  }
+
+  object "stock\n库存管理" as Stock {
+    出入库记录
+    出入库明细
+    库存现存量
+    库存快照
+    库存冻结
+    调拨单
+    红冲 / 冲抵
+    严谨 / 宽进宽出 / 严进严出
+  }
+
+  object "cost\n成本费用" as Cost {
+    支出类目
+    支出明细
+    凭证图片
+    按类目汇总
+    成本采集端口
+  }
+}
+
+package "生产履约层" as ProductionLayer #FFF8EF {
+  object "printing\n开版与印花" as Printing {
+    开版订单
+    开版图 / 样品 / 客户反馈
+    印花订单
+    印花款式明细
+    工序批量推进
+    工艺参数补充
+    外部订单快照同步
+    生产完成通知
+  }
+
+  object "stateflow\n流程引擎" as Stateflow {
+    状态参数
+    状态节点
+    流程模板
+    流程节点
+    业务对象
+    流转记录
+    节点参数记录
+  }
+
+  object "mes\nMES 生产指派" as MES {
+    设备分类
+    设备管理
+    峰值产能
+    生产指派
+    指派状态流转
+    指派对象关联
+  }
+}
+
+package "物流交付层" as DeliveryLayer #F7FBF4 {
+  object "shipment\n发货交付" as Shipment {
+    销售品
+    销售品变更记录
+    销售品重建记录
+    出货单
+    送货单
+    送达照片
+    外部成品表
+    出货状态流转
+  }
+}
+
+package "协同运营层" as OperationLayer #F8F5FF {
+  object "mission\n任务协同" as Mission {
+    任务分类
+    任务
+    任务参与者
+    任务回复
+    任务完成 / 重开 / 取消
+    回复驳回
+    关联任意业务对象
+  }
+
+  object "notifier\n通知中心" as Notifier {
+    通知器
+    通知路由
+    事件匹配
+    模板渲染
+    企业微信 webhook
+    message_api 渠道
+    未回复任务提醒
+  }
+
+  object "settlement\n日结统计" as Settlement {
+    日结配置
+    统计模块选择
+    通知渠道配置
+    商户日结任务
+    开版 / 印花日结口径
+  }
+}
+
+package "集成与支撑层" as SupportLayer #F5F7FA {
+  object "api_v1.tasks\n异步与同步任务" as Tasks {
+    数据库备份
+    明道云产品同步
+    明道云客户同步
+    明道云开版暂存同步
+    外部印花订单同步
+    外部图片回填
+    腾讯云 TIIA 上传
+    API 审计日志写入
+  }
+
+  object "business.tasks\n经营异步任务" as BusinessTasks {
+    采购审批后入库
+    销售审批后出库
+    退货审批后出入库
+    好布业财务定时同步
+  }
+
+  object "外部服务" as ExternalSystems {
+    明道云
+    好布业财务系统
+    腾讯云 TIIA
+    七牛云存储
+    企业微信 / message_api
+  }
+}
+
+ApiEntry ..> BasicInfo
+ApiEntry ..> Business
+ApiEntry ..> Printing
+ApiEntry ..> Shipment
+ApiEntry ..> Mission
+ApiEntry ..> MES
+ApiEntry ..> Cost
+
+ApiMan ..> BasicInfo
+Business ..> Stock
+Business ..> BusinessTasks
+Printing ..> Stateflow
+Printing ..> Shipment
+MES ..> Printing
+Shipment ..> Notifier
+Mission ..> Notifier
+Settlement ..> Notifier
+Tasks ..> ExternalSystems
+BusinessTasks ..> ExternalSystems
+Tasks ..> BasicInfo
+Tasks ..> Printing
+
+note bottom
+  读图方式：每个对象代表一个业务模块，内部列出主要功能。
+  虚线只保留关键依赖，避免把图变成技术调用链。
+end note
+
+@enduml