制造业管材按节报价系统-复合材料管材报价系统

1、立项背景和目标：制造业客户生产多节套接式碳纤维/玻纤管材（伸缩杆结构），每节在锥形模具上卷制7层预浸料固化成型，报价需逐节计算下料长度、逐层展开面积乘材料单价，再叠加夹子、人工与成本/利润系数，且末节、次末节有独立铺层规则，另有"防脱出加强"专用规格。此前全靠老师傅在Excel里手工核价，算一单约半小时、易错且新人无法接手。目标是把这套经验系统化：输入总长、节数、材料等级、夹子类型，秒级输出整单逐节明细报价，已交付上线。
2、核心功能模块：①报价计算——按节逐层核算材料、人工与夹子成本，输出逐节明细与整单总价；②数据驱动规则引擎——铺层规则、模具周长、夹子价格、成本/利润系数、特殊规格全部做成后台可维护的数据表，客户新增产品型号无需修改代码；③后台管理——规则表、材料价格、模具参数全套增删改查，特殊数据支持热加载即时生效；④历史报价——分页筛选、详情查看、CSV导出、参数变更后一键重算；⑤账号与权限——JWT认证、邀请码注册、RBAC角色权限、操作日志留痕；⑥统一错误提示——错误码+解决方案字段贯穿前后端，业务人员可自助排错。
3、业务流程：业务员登录后录入总长/节数/材料等级/夹子类型→系统按节计算下料长度→逐层匹配铺层规则计算展开面积与材料成本→叠加夹子与系数生成逐节报价明细→确认后保存入库→管理员在后台维护规则与价格，新型号即录即用；历史报价可随时筛选、导出或按新参数重算。

1、整体架构：Flask REST API + React 19 SPA（Vite构建、Ant Design组件库）+ SQLite，前后端合计约9000行、66个REST接口、12张业务表、约12个功能页面；SQLAlchemy ORM抽象数据层，规则与价格数据全部入库。
2、独立完成需求分析、领域建模、前后端开发、部署与文档交付全流程，约26人天：①核心设计——将计价规则抽象为可配置数据表（铺层矩阵、特殊规格、系数覆盖表），计算层纯函数化并与编排层分离，规则可配置、计算可测试，交付物从"程序"升级为"客户可自行维护的系统"；②工程化——统一错误契约（错误码+解决方案）贯穿前后端，JWT认证+RBAC+操作日志，前端实现二级联动、跨字段钳制校验与桌面/移动双适配；③文档交接——输出技术文档（含架构时序图与工时估算）、运行部署指南、排障FAQ三份文档，客户IT可自主部署运维，规则变更无需返场改代码。
3、难点与解决：一是计价规则分支密度极高——7层铺层逐层展开、末节/次末节独立规则、防脱出专用规格、夹子系数覆盖等多层条件嵌套，直接写死在代码里必然失控；解法是把全部规则数据化入库+计算纯函数化，新增型号只增数据不改代码。二是"防脱出为否时使用特殊夹子规格"等例外逻辑容易漏算——通过规则表优先级设计与跨字段联动校验兜住例外分支。三是业务人员非技术背景——用错误码+中文解决方案字段替代报错堆栈，配合三份文档实现零培训上手。