一、系统简介与五个岗位
本系统是一套面向宠物供应链（批发 / 渠道）的私有化 ERP，部署在你自己的服务器上，数据完全归你所有。系统按岗位划分五个角色，每个角色登录后只看到自己该做的菜单：
销售 sales
下单、查自己的订单、看销售看板、发起退货
内勤 office
审核订单、审批退货（一级）、客户管理、全部订单导出
仓库 wh
出库、退货入库、商品与效期管理、打印模板
管理员 admin
全部订单、数据看板、退货审批（二级）、用户与授权管理
财务 finance
应收总览、应收账款、回款登记、客户对账单
核心业务流程：销售下单 → 内勤审核（定价/折扣）→ 仓库出库 → 完成。
退货流程：销售发起退货 → 内勤审批（一级）→ 管理员审批（二级）→ 仓库入库回增库存。
二、部署前准备（服务器与域名）
2.1 服务器配置
| 项目 | 最低要求 | 建议 |
|---|
| 操作系统 | Ubuntu 22.04 / 24.04（Debian 系） | Ubuntu 22.04 LTS |
| CPU / 内存 | 1 核 1G | 2 核 2G（轻量应用服务器即可） |
| 硬盘 | 20G 系统盘 | 40G 以上（留备份空间） |
| 带宽 | 2 Mbps | 3~5 Mbps |
| 数据库 | 无需单独安装。系统内置 SQLite 文件数据库，无独立数据库进程，对配置要求极低 |
说明：系统采用嵌入式数据库，不依赖 MySQL/PostgreSQL，因此 2 核 2G 的轻量服务器即可稳定运行数十人规模的团队。
2.2 域名（建议有，可选）
- 准备一个你自己的域名（如
mypet.com）。主域名本身就是 ERP 通用入口，无需额外 "erp" 子域名。
- 部署前请把该域名的 A 记录解析到服务器的公网 IP。
- 若暂时没有域名，也可只用服务器 IP 访问（安装脚本会生成自签证书，浏览器提示"不安全"时点"继续"即可）。
解析未生效会导致什么？不影响安装，但免费 HTTPS 证书申请会失败。脚本会自动退回 HTTP 访问，等域名解析生效后，运行一条命令即可补签证书（见 FAQ）。
三、上传与一键安装
你拿到的交付文件是 client-delivery.tar.gz。整个过程只需一条安装命令，其余全自动（安装 Node、依赖、进程守护、Nginx、HTTPS 证书、每日备份）。
3.1 把文件上传到服务器（推荐用 FinalShell）
如果你不熟悉命令行，推荐使用图形化 SSH 工具 FinalShell（免费、国产、支持鼠标拖拽上传）：
- 下载安装 FinalShell，新建连接，填写服务器 IP、端口 22、用户名 root、密码。
- 连接成功后，左边是服务器文件树。把电脑上的
client-delivery.tar.gz 直接拖到服务器 /root/ 目录。
- 右下角打开"命令行"窗口，继续下面的步骤。
也可以用 Xshell / Termius 等任意 SSH 工具，或 scp 命令上传，方式不限，只要把文件放到服务器的 /root/ 即可。
3.2 解压与配置域名
在服务器命令行中依次执行：
# 1) 进入 root 目录并解压
cd /root
tar xzf client-delivery.tar.gz
# 解压后得到两个同级目录：order-system/ 和 release/
# 2) 进入安装目录，生成配置文件
cd /root/release
cp install.conf.example install.conf
# 3) 编辑配置，填入你的域名（没有域名可先填服务器 IP）
nano install.conf
# 把 DOMAIN="esellpro.top" 改成你自己的域名，例如：DOMAIN="mypet.com"
# 改完按 Ctrl+O 保存，Ctrl+X 退出
3.3 一键安装
sudo bash install.sh
脚本会问你"域名是否已解析到本机 IP"，默认 y 回车即可（若只有 IP 没有域名，输入 n）。之后全程自动，看到"安装完成"即成功。
装好后系统已自动：安装 Node.js 22、编译数据库驱动、用 pm2 守护进程（开机自启）、配置 Nginx 反向代理、申请 HTTPS 证书（如有域名）、设置每天 03:00 自动备份数据库。
四、登录入口说明
假设你的域名是 mypet.com，系统提供以下访问地址（把 mypet.com 换成你的域名）：
| 用途 | 地址 | 说明 |
|---|
| 通用入口 | https://mypet.com | 所有员工都从这里登录，输入各自账号密码，系统自动进入对应岗位界面 |
| 销售入口 | https://sales.mypet.com | 已锁定为销售角色 |
| 内勤入口 | https://office.mypet.com | 已锁定为内勤角色 |
| 仓库入口 | https://wh.mypet.com | 已锁定为仓库角色 |
| 管理员入口 | https://gl.mypet.com | 已锁定为管理员角色 |
| 财务入口 | https://fin.mypet.com | 已锁定为财务角色 |
建议：给每位员工发"通用入口"即可，登录后自动进入自己的岗位；也可把对应角色子域名设为该岗位的书签。
五、授权激活（必须先做）
重要：请先激活授权，再开通员工账号。系统出厂为空库，仅有一个管理员账号。在未激活授权的情况下，后台无法新增任何员工账号（会被提示"已达授权用户数上限"）。请先拿到服务商给你的授权文件（*.key），完成激活后，再开各部门账号。
- 用管理员账号登录：访问通用入口
https://mypet.com，账号 admin / 密码 123456。
- 左侧菜单进入 授权管理。
- 点击"上传授权文件"，选择服务商发给你的
*.key 文件，确认上传。
- 页面显示"已授权"，并列出：授权客户、用户数上限、到期日，即表示激活成功。
两种激活方式（由服务商告知用哪种）：
① 离线授权文件（常用）：上传 *.key 文件，如上。
② 在线激活码：在"授权管理"输入服务商给的授权码，点击在线激活（需服务器能联网到激活服务）。
授权到期后续费：拿到服务商发的新 *.key 后，再次到"授权管理"上传即可覆盖，已有账号和数据不受影响。
六、管理员开通员工账号
授权激活后，管理员为各部门开通账号（销售 / 内勤 / 仓库 / 财务）。没有内勤账号，订单审核与退货一级审批将无法进行，请务必至少开通一名内勤。
- 管理员登录后，左侧菜单进入 用户管理。
- 点击"新增用户"，填写：姓名、登录账号、密码、选择角色（销售 / 内勤 / 仓库 / 财务 / 管理员）。
- 保存后，该员工即可用其账号从通用入口登录，自动进入对应岗位界面。
岗位配置提醒：订单审核、退货一级审批仅内勤（office）可操作；退货二级审批仅管理员（admin）可操作。小团队至少要有 1 名内勤 和 1 名管理员，业务才能跑通。
初始管理员 admin/123456 建议登录后修改密码。停用员工可在"用户管理"中停用其账号。
七、销售岗位教程
登录后左侧菜单：去下单 我的订单 销售看板 退货管理
1) 去下单 —— 给客户开单
- 点"去下单"，先选择或填写客户（老客户搜索选择，新客户可现场新建）。
- 点"添加商品"，搜索商品（品牌默认折叠，搜索时自动展开），选择商品并填写数量。
- 点"提交订单"。订单进入"待审核"状态，等待内勤审核定价。
销售只需填数量和客户，单价与折扣由内勤在审核时确定，无需销售操心价格。
2) 我的订单 —— 跟踪自己的订单
- 查看自己名下所有订单及状态：待审核 / 已审核 / 已出库 / 已完成 / 已驳回 / 已取消。
- 状态为"待审核"的订单：可编辑、取消、删除。
- 订单"已出库 / 已完成"后，可点"发起退货"进入退货流程。
3) 销售看板
- 查看个人业绩、畅销产品 TOP5、今日/明日拜访安排（按跑区）。
4) 退货管理
- 查看自己发起的退货进度：待内勤审批 → 待管理员审批 → 待入库 → 已入库 / 已驳回。
八、内勤岗位教程
登录后左侧菜单：待审核 退货审批 全部订单 客户管理
1) 待审核 —— 审核销售订单（核心）
- 点"待审核"，查看待处理的销售订单。
- 打开订单，确认商品与数量；可在审核时修改单价、数量、折扣（系统自动算出金额）。
- 无误点"通过"；有问题点"驳回"并填写原因，订单退回销售。
订单审核是必经环节。审核通过后订单才进入仓库待出库队列。
2) 退货审批 —— 退货一级审批
- 点"退货审批"，查看销售发起的退货（状态：待内勤审批）。
- 核对退货商品与数量，点"通过"转交管理员二级审批；或"驳回"并填原因。
3) 全部订单
- 查看系统内所有订单，可按状态筛选。
- 支持导出 CSV：按品牌 / 业务员 / 日期 / 省市级区筛选后导出（UTF-8，Excel 可直接打开）。
4) 客户管理
- 新增 / 编辑 / 停用客户；维护客户名称、联系人、电话、地址、渠道、账期等。
- 客户状态（活跃 / 沉睡 / 流失）由系统每日凌晨自动更新，无需手动维护。
九、仓库岗位教程
登录后左侧菜单：待出库 待退货 商品管理 效期管理 已下架 打印模板
1) 待出库 —— 订单发货
- 点"待出库"，查看已通过内勤审核的订单。
- 核对商品数量，点"出库"——系统自动扣减库存，订单状态变为"已出库"。
- 可点"打印单据"生成出库单（按打印模板版式）。
2) 待退货 —— 退货入库
- 点"待退货"，查看已通过两级审批、等待入库的退货。
- 确认实物无误后点"入库"——系统自动回增库存，退货状态变为"已入库"。
3) 商品管理
- 维护商品信息：名称、品牌、规格、单位、目录价、库存。
- 支持效期批次管理；可上架 / 下架商品。
4) 效期管理 / 已下架 / 打印模板
- 效期管理：查看临期商品预警。
- 已下架：管理已下架商品。
- 打印模板：设置出库单 / 对账单的打印版式（销售公司标题、门店信息、明细、签字栏等）。
十、管理员岗位教程
登录后左侧菜单：全部订单 数据看板 退货审批 客户管理 用户管理 授权管理
- 全部订单：同内勤的全部订单视图，可筛选与导出。
- 数据看板：全局业务数据总览（销售额、订单量、客户分布等）。
- 退货审批：退货二级审批（待管理员审批）。通过后退给仓库入库；驳回则结束。
- 客户管理：同内勤的客户管理。
- 用户管理：开通 / 编辑 / 停用各部门账号（见第六章）。
- 授权管理：上传授权文件激活系统、查看授权状态（见第五章）。
管理员拥有内勤的全部权限，可代为处理客户与订单；但订单审核（仅内勤）与退货一级审批（仅内勤）仍建议由内勤负责，管理员主要负责退货二级审批与系统管理。
十一、财务岗位教程
登录后左侧菜单：应收总览 应收账款 回款登记 客户对账单
- 应收总览：全局应收账款总额、逾期金额等核心指标。
- 应收账款：按客户维度汇总应收，展开可见订单明细；账期到期日 = 审核通过日 + 账期天数，逾期自动标记。
- 回款登记：客户打款后，在此登记回款，系统冲减应收。
- 客户对账单：生成某客户的往来对账单，可打印或导出，用于与客户核账。
应收口径：审核通过且已出库（含已完成）的订单金额 - 已入库退货金额 = 该客户应收。删除客户会导致其应收从报表消失，建议改用"停用"而非删除。
十二、常见问题（FAQ）
Q1. 打开页面提示"不安全 / 证书风险"？
多为域名还没解析到服务器，证书申请失败，系统用了自签证书。点"高级 → 继续访问"即可。等域名解析生效后，在服务器运行 sudo certbot --nginx 补签，之后就显示正常小绿锁。
Q2. 后台新增员工提示"已达授权用户数上限"？
说明还没激活授权（见第五章）。先由管理员上传服务商给的 *.key 授权文件激活，再开账号。
Q3. 忘记管理员密码怎么办？
初始管理员为 admin/123456。若已修改且忘记，需联系服务商通过服务器重置（或重新部署初始化）。建议登录后立即修改密码并妥善保管。
Q4. 订单卡在"待审核"没人处理？
订单审核仅内勤可操作。确认是否已开通内勤账号，并通知内勤登录处理。
Q5. 退货一直"待内勤审批"？
退货一级审批仅内勤、二级仅管理员。确认内勤已审一级、管理员已审二级，才会到仓库入库。
Q6. 数据会丢吗？如何备份？
系统每天 03:00 自动备份数据库到 /var/backups/erp/（保留 7 天）。如需恢复，把对应日期的 *.db 复制回 /opt/order-system/server/data/ 并重启服务即可。
十三、日常运维命令（附录）
通过 SSH 登录服务器后，常用管理命令：
# 查看系统运行日志
pm2 logs order-system
# 重启服务（更新代码后执行）
pm2 restart order-system
# 手动备份数据库
/usr/local/bin/erp-backup.sh
# 证书失效后补签（域名已解析时）
sudo certbot --nginx
# 查看服务是否在运行
pm2 status
如需更新系统版本：把新的 order-system 目录上传覆盖到 /opt/order-system/，然后执行 pm2 restart order-system 即可。
客服 QQ：93723491 ｜ 本说明书随交付包发送给客户，如有流程调整以最新版为准。