商贸管理系统原型开发
从商贸管理原型走向可运行业务系统的笔记，重点是交易链路、权限、导出中心和运行验证。
商贸系统不应停在原型草稿；近期产品化重点已经落到真实页面、CSV 导出、角色权限和本地/公开访问恢复。
# 商贸管理系统原型开发
## Context
这是一篇来源于近期 ChatGPT 会话的草稿，聚焦商贸管理系统的原型化开发思路。
## Notes
- 明确交易链路：订单、库存、财务、客户关系与履约节点。
- 原型阶段重点：
- 核心数据模型设计（客户、商品、订单、库存）
- 多角色权限与操作路径
- 报表与异常处理面板
- 后续迭代建议：补充流程图、字段规范、验收用例与 API 清单。
## What Has Become Product
近期更重要的变化是：系统开始从“原型想法”进入“可运行业务工具”。数据导出中心就是一个很好的切面。
- 前端需要有真实入口，而不是占位页。
- 后端 API 需要验证导出类型、用户身份和角色权限。
- CSV 下载要处理 Windows 友好的编码、文件名和响应头。
- 覆盖范围不能只做一个示例报表，应覆盖商品、客户、供应商、仓库、库存、销售、采购、应收、应付、财务流水和操作日志等核心实体。
- 验收不只看代码，还要跑构建、启动服务、请求真实接口、检查下载结果，并清理临时测试数据。
## Product Boundary
商贸系统的价值来自稳定业务流，而不是花哨 UI。后续继续用 [[codex-product-production-loop]] 的标准推进：
- 不重构既有业务流程，除非需求明确要求。
- 权限、单据状态、导出范围和审计日志要优先于视觉变化。
- 公开访问或 FRP 异常要先判断本地服务、端口映射和隧道状态，再改配置。
- README 可以记录运行和恢复路径，但应该保持简洁。
## Recent Update - 2026-W26
[[weekly-review-2026-w26]] keeps the trade-management lesson at the product-pattern level. The current garden evidence is about export coverage, permission boundaries, and runtime verification; deeper implementation claims still need manual review against the trade-management repository.
## Links
- ChatGPT 分享记录（来源）：https://chatgpt.com/share/6a2cf21c-b580-83e8-8cc0-5d422212be12
## Update Log
<!-- garden-auto:daily-maintenance 2026-06-18 -->
- 2026-06-18: Maintenance note added by Daily Garden Automation. Reasons: missing summary; health 40; no backlinks. Evidence: garden index 2026-06-18; public note trade-management-system-prototype.
- 2026-06-22: 补充从原型到产品的真实导出中心、权限和运行验证经验。
Open this garden note