TRACY手串进销存管理系统产品系统

1.行业场景
随着国潮文化和个性化消费的兴起，天然水晶、玉石、半宝石类手串饰品市场持续升温。手串行业具有以下典型特征：
1.1商品结构复杂：一件成品手串由多种规格的水晶、配饰、工具、包装材料组合而成，每种原料都有独立的库存和成本。
1.2业务模式多样：既有批量生产的标准款（大货款），也有客户定制的个性化单品（定制款），且大量采用线上（网购）和线下（实体店）混合销售。
1.3客户关系紧密：手串消费常伴随复购、转介绍，客户有等级划分（普通/VIP/VIP中P），且需记录佩戴手寸、禁忌等个性化信息。
1.4采购与供应商管理：原料采购频繁，需记录供应商、应付账款，控制库存成本。
1.5财务对账需求：存在现结与赊销（尾款待付）两种结算方式，需管理客户应收、供应商应付台账。
前该行业从业者多为中小型工作室、个人创业者或微商团队，普遍使用Excel或简单记账软件，难以实时掌握库存、成本、利润，更无法支持精细化客户运营和财务对账，效率低、易出错。
2.立项原因
本项目旨在为手串行业从业者（特别是中小型商家）提供一套轻量级、易部署、功能完整的进销存管理解决方案，具体解决以下核心痛点：
2.1库存混乱：原料和成品库存无法实时联动，销售后不能自动扣减原料库存，常因缺料延误交付。
2.2成本利润模糊：单品成本需手工核算，无法按订单维度分析毛利，定价缺乏数据支撑。
2.3客户管理缺失：客户信息分散，无消费记录和等级管理，难以开展精准营销和售后跟进。
2.4财务对账困难：应收应付台账依赖人工登记，尾款催收不及时，资金回笼慢。
2.5采购效率低：批量采购需手动录入，供应商账期管理混乱。
2.6操作繁琐：多系统切换，数据不互通，业务人员需重复录入。
本系统通过一体化流程设计，将商品管理、采购入库、销售出库、库存监控、客户管理、应收应付、数据分析集中在同一平台，实现全链路数字化管理，帮助商家降本增效。

2 主要功能描述
2.2.1 商品与库存管理
货品档案：管理原材料的基本信息，支持单个新增和Excel批量导入。
商品档案：管理成品手串，包含系列、编号、售价、理念文案、图片，并支持配方组成，成本价自动根据原料成本加权计算。
实时库存台账：展示每种原料的累计入库/出库、当前库存、加权平均成本、总成本/估值，并自动标注库存状态。
库存预警：单独页面显示所有“缺货”或“预警”原料，方便快速补货。
损耗登记：登记原料损耗，自动扣减库存，并记录损耗原因和操作人。
2.2.2 采购入库
采购单录入：通过Excel导入，系统自动识别多工作表，按标准表头解析数据，支持预览后批量入库。
自动更新库存：入库时按加权平均法计算新成本，累加入库量。
供应商应付自动生成：若结算方式为“尾款待付”，自动创建应付台账，记录欠款金额。
2.2.3 销售出库（核心亮点）
大货款销售
定制款销售
统一业务逻辑：两种模式共用客户信息、结算方式、销售区域等字段，提交时均执行：
扣减原料库存
生成销售订单
生成原料消耗明细，并计算每个原料的
更新客户累计消费额和订单数
若未现结，自动创建客户应收台账
尾款管理：在销售单页面集成尾款结算功能，支持“结清”和“尾款赠与”两种方式，更新订单状态和应收台账。
2.2.4 客户与供应商管理
客户档案：记录姓名、电话、等级、类型、性别、手寸、佩戴禁忌等
供应商档案：记录名称、联系人、电话、地址、累计采购、应付余额。
Excel批量导入：支持从标准模板导入，自动查重，跳过重复数据。
2.2.5 货款管理
客户应收台账
供应商应付台账
尾款结算
2.2.6 数据看板与报表
可视化看板
销售台账
采购台账
损耗台账
2.2.7 系统管理
用户管理：支持多用户（admin/operator/viewer角色），可启用/禁用、重置密码。
操作日志
数据导出\数据管理

个人职责与贡献
本项目全部代码由本人独立开发完成，包括：
数据库设计：设计15张业务表，定义关联关系和索引，满足全流程业务需求。
后端开发：实现所有Flask路由、模型方法、业务逻辑、装饰器、工具函数，代码超过3000行。
前端开发：设计所有页面模板（继承base.html），使用Bootstrap、jQuery编写交互逻辑，实现复杂表单、动态表格、弹窗、图表等。
测试与部署：完成功能测试、问题修复，并部署至生产环境（Nginx + Gunicorn + SQLite），实现24小时稳定运行。
技术难点与解决方案
在开发过程中，我遇到了多个技术挑战，并逐一找到了有效的解决方案。

多表数据一致性问题：销售出库涉及四到五张表的写入操作（Sale、GoodsSale、Stock、Customer、CustomerReceivable），必须确保所有操作全部成功，否则应完全回滚。我利用SQLAlchemy的事务机制，将所有数据库操作放在同一个session中，在最终提交前若发生任何异常则执行rollback，保证了业务数据的原子性和完整性。

定制款成本与售价的准确计算：定制款允许用户在前端自由组合原料并动态调整数量，后端需验证库存充足性并精确计算总成本和建议售价。我采用前后端双重计算策略：前端实时展示预估值提升用户体验，后端重新核算并比对，防止数据篡改；所有金额计算均使用Python的Decimal类型，避免浮点数精度损失。

Excel解析的兼容性问题：用户上传的Excel文件可能包含多个工作表，且格式不统一。我使用Pandas读取文件后，先校验每个工作表的表头是否与标准模板一致，再合并所有有效数据行，并自动过滤空行和无效记录；同时将日期等特殊字段转换为标准格式，确保解析过程稳健可靠。

库存状态的实时更新：库存状态（缺货/预警/正常）需随每一次出入库操作动态变化。我将状态判