DrsakuraandClaude Opus 5
f32a2daaef
订单上原本只有「卖给客户多少钱」，而一张单真实花出去的还有寄样品的快递费、 印吊卡的费用、商检报关拖车。不记下来就算不出这单赚没赚 —— 小单子几百块 杂费能把毛利吃掉一截。 · 新表 order_expenses，一张订单挂多笔：类型/金额/币种/日期/收款方/单号/ 已付未付/备注。单独成表而不是往 orders 加列，因为杂费是多笔不定项的， 寄三次样品就是三条快递费，各有单号；塞进 orders 只能存一个合计，事后 对不出「这 800 块是哪来的」。 · 跨币种强制填汇率并存快照。杂费基本是人民币、订单常是美元；不存快照的话 汇率一变历史订单毛利跟着变，账永远对不上。同币种强制按 1，防止前端传个 7.2 把美元支出又乘一遍。 · 新权限点 order.expense，不复用 order.edit。掏钱寄样品的是销售业务员， 而销售业务组只有 order.view —— 挂在 order.edit 上要么他记不了账，要么 为了让他记账得把「改订单金额」一起给他。启动时 syncNewPermissions() 会自动把这个新点补给四个默认组。 · 订单列表加「杂费」列（合计 + 未付）。SUM 外层再 ROUND 一次：不加会漏出 348.15999999999997 这种浮点尾巴直接显示在页面上。 · 金额逐行取两位再相加，保证明细几行加起来等于合计。 Co-Authored-By: Claude Opus 5 <[email protected]>
外贸供应链管理系统
一个专为外贸企业设计的供应链与客户管理系统。
功能模块
工作台
- 工作日历：日程安排、节日标注、今日待办
- 汇率计算器与时区时钟
- AI 助手（可接入自有模型）
业务管理
- 询盘管理 - 询盘登记、明细与跟进
- 客户报价单管理 - 报价单编制、英文大写金额
- PI合同管理 - PI 合同台账、收款条件
- 订单管理 - 订单跟踪与状态管理
客户管理
- 我的客户 - 客户信息、联系人、跟进记录
- 新客开发 - 线索登记、AI 智能分析
- 客户公海 - 未分配客户的领取与分配
采购管理
- 采购单管理 - 采购单登记与跟踪
- 产品管理 - SKU/SPU 两层管理、包装参数、阶梯价格、产品图片
- 供应商管理 - 供应商档案与采购价
- 合同清洗中心 - 合同文件导入、解析与校对
系统管理
- 用户管理 - 账号、角色与启停用
- 权限组管理 - 角色 → 权限组 → 权限点三级授权
- 系统日志 - 登录、改密与数据变更审计
技术栈
后端
- Node.js + Express
- SQLite + better-sqlite3-multiple-ciphers
前端
- React 18
- React Router
- Vite
- 原生 CSS
快速开始
安装依赖
# 后端
cd backend
npm install
# 前端
cd frontend
npm install
启动开发环境
# 启动后端服务器（终端1）
cd backend
npm start
# 启动前端开发服务器（终端2）
cd frontend
npm run dev
访问系统
- 前端开发地址: http://127.0.0.1:5300
- 后端 API 地址: http://127.0.0.1:4300
默认账号
- 用户名:
admin - 密码:
admin123
⚠️ 首次登录后请立即修改密码！
项目结构
happy-export/
├── backend/ # 后端
│ ├── db/ # 数据库
│ │ ├── schema.sql # 数据库结构
│ │ └── db.js # 数据库连接
│ ├── lib/ # 工具库
│ ├── routes/ # API 路由
│ ├── data/ # 数据存储目录
│ ├── uploads/ # 上传文件
│ ├── server.js # 服务器入口
│ └── package.json
├── frontend/ # 前端
│ ├── src/
│ │ ├── components/ # 组件
│ │ ├── pages/ # 页面
│ │ ├── services/ # API 服务
│ │ ├── styles/ # 样式
│ │ ├── App.jsx # 主应用
│ │ └── main.jsx # 入口文件
│ ├── index.html
│ ├── vite.config.js
│ └── package.json
├── docs/ # 文档
└── README.md
数据库与配置
SQLite 单文件存储：
- 数据库文件：
backend/data/trade.db - 首次启动时自动建表
- 支持备份和迁移
- 数据目录与上传文件已在
.gitignore中排除，不会入库
已知限制：数据库当前未加密。 驱动选用的是
better-sqlite3-multiple-ciphers（本身具备 SQLCipher 能力），但代码尚未设置加密密钥，trade.db以明文存放。 部署到共享主机或不可信环境前，请自行启用磁盘加密。
后端可识别的环境变量（全部有代码默认值，不设置也能跑）：
| 变量 | 默认值 | 说明 |
|---|---|---|
DATA_DIR |
backend/data |
数据库与汇率缓存所在目录 |
PORT |
4300 |
后端监听端口 |
CONTRACT_RETENTION_DAYS |
7 |
合同导入原文件的保留天数 |
HAPPY_UPDATE_REPO |
Drsakura/happy-export |
在线更新检查所用的 GitHub 仓库 |
注意：后端没有引入 dotenv，不会自动读取
.env文件。 请通过系统环境变量、启动脚本或容器编排来设置上述变量。
开发计划
Phase 1 至 Phase 3 已完成；Phase 4、Phase 5 部分完成，未完成项保留为待办。
Phase 1：基础框架 ✅
- 项目结构搭建
- 数据库设计
- 前后端基础框架
- 工作台页面
Phase 2：供应商与产品管理 ✅
- 迁移 SKU Manager 功能
- 阶梯价格管理
- 合同解析引擎
- 产品图片管理
Phase 3：客户 CRM
- 客户详细页面
- 联系人管理
- 跟进活动时间线
- 商机管道视图（
deals表已建，前端界面待实现）
Phase 4：订单管理
- 订单创建和编辑
- 订单状态管理
- 订单备注系统
- PDF 导出
Phase 5：自动获客
- AI 智能分析
- 线索转化（客户公海领取）
- 集成 GoodJob 获客引擎
- 数据源适配
许可证
本项目采用 GNU Affero 通用公共许可证 v3.0（AGPL-3.0）。
你可以自由使用、修改和分发，但需要遵守 AGPL-3.0 的核心义务： 如果你修改后的版本通过网络对外提供服务，必须向使用者公开你的完整源代码， 并以同样的许可证授权。完整的条款见 LICENSE。
作者
Wayne