客户管理系统（融合AI辅助）产品系统Vibe Coding

1.1 业务背景
在公路货运 / 物流承运行业中，承运方与每个收货客户之间通常约定一户一价的计费方式：

阶梯计价：运费单价随货物吨位变化，例如"不足 1 吨 100 元/吨、1~10 吨 200 元/吨、10 吨以上 300 元/吨"；
附加费用：小批量货物加收提送费、卸货费，大批量货物加收超重费、包装费等，条件五花八门；
保底收费：即便货量极小，也有最低起步价约束（如"单票不低于 200 元"）。
不同客户的价格体系互不相同，且会随合作条件调整。传统作业模式下，这些价格规则散落在业务员的 Excel 表格、纸质合同甚至个人记忆中，报价环节完全依赖人工查表和手工计算。

1.2 立项原因（痛点）
1）计价规则复杂、易算错 阶梯命中、多条附加费叠加、起步价兜底等规则组合后，人工心算/Excel 手算极易出错，错一单就是真金白银的损失
2）价格资料分散、难维护 各客户价格表以 Excel 文件形式散落在各处，格式不一，更新不同步，新人接手成本高
3）报价效率低 客户询价需要业务员翻表计算再回复；月结对账时需对成百上千条运单逐条计价，耗时数小时甚至数天
4）规则录入门槛高 把历史 Excel 价格表逐条手工录入系统工作量巨大，是同类系统落地的最大阻力

1.3 项目目标
建设一套轻量级的客户报价管理系统，实现：

价格规则资产化——客户档案与其完整定价规则（阶梯价 + 附加费 + 起步价）集中入库、统一维护；
报价计算自动化——输入客户与吨数，系统按规则秒级算出报价明细，杜绝人工计算错误；
批量作业规模化——支持整份运单 Excel 一键批量计价，替代对账场景下的人工逐条核算;
历史资料智能迁移——借助大语言模型（LLM）自动解析任意格式的存量 Excel 价格表，大幅降低数据录入成本。

本项目是一站式智能报价系统，涵盖客户管理、报价引擎与系统设置三大模块。

客户管理是核心基础。支持客户档案的增删改查、批量删除及名称模糊搜索，并通过名称唯一性双重校验保障数据规范。每个客户可独立配置阶梯计价规则（自动校验区间连续无重叠，确保报价精准无遗漏）、多条自定义附加费（支持多种运算符，兼容历史数据），以及最低起步价（触发时明确标注，计价透明）。同时提供 Excel 智能导入功能，借助 LLM 自动解析任意格式的价格表，经人工复核确认后即可生成正式档案，实现"机器抽取 + 人工把关"的高效闭环。

报价模块提供单笔与批量（批量报价可以用于线下对账）两种模式。单笔报价输入客户与吨数即可实时返回完整费用明细（含基础运费、附加费、起步价判定等），全程采用高精度计算确保金额零误差。批量报价支持上传 Excel 模板异步处理，自动追加报价结果列并保留错误行备注，方便一次性排查所有异常，结果可直接用于对账打印。

系统设置提供可视化的 LLM 参数配置（API 地址、密钥、模型、提示词等），API Key 自动脱敏展示并支持连通性测试，保障智能导入功能稳定可用。

我负责项目的设计和实现（使用AI辅助编程）。

技术亮点

(1) 富领域模型 + 构造期不变式校验

价格分层与附加费规则封装为不可变值对象，所有业务不变式（区间连续无重叠、起点为 0、仅末档无上界、金额非负等）在构造期一次性强校验。任何路径（新建、编辑、导入、DB 读取）构建对象必经此防线，非法规则无法进入计算环节，"报价必然命中且仅命中一档"由类型系统保证。


(2) LLM 赋能的非结构化数据迁移

针对存量 Excel 格式千差万别的痛点，采用 Excel → Markdown → LLM 结构化抽取 → 同名聚合 → 待确认落库管道，配合人工复核平衡效率与准确性。LLM 的地址、密钥、模型、提示词全部运行时可配置，兼容任意 OpenAI 风格 API，不锁定厂商。

(3) 异步任务模式处理批量计算

批量报价采用 taskId + 进度轮询 + 结果下载 异步模式：上传即返回，线程池后台逐行计算并更新进度，异常行不中断整体任务。前端进度条实时反馈，大文件处理体验流畅。