一、系统概述
1.1 系统简介
Amazon Clothing ERP 是面向亚马逊服装卖家的垂直型跨境 ERP，重点解决服装行业痛点：大量颜色 + 尺码多变体 SKU、各国尺码转换（US/EU/UK）、面料资料管理、服装图片批量管理、多站点同步刊登、FBA 补货。系统通过亚马逊 SP-API 授权，拉取店铺订单、库存、广告、Listing 数据，实现服装业务线上统一管理，替代 Excel 手工维护变体、库存、成本表。
1.2 前置准备
1. 亚马逊卖家后台账号，开通 SP-API 开发者授权
2. 服装产品基础资料：款号、面料、成分、尺码表、色卡、白底图 / 场景图、UPC/EAN 码
3. 供应商信息、头程物流渠道、采购成本、平台佣金、广告费率
1.3 登录与基础设置
1. 浏览器访问系统 Web 地址，输入管理员账号密码登录
2. 【系统设置】→【店铺授权】，添加亚马逊各站点店铺（北美 / 欧洲 / 日本等），填入 SP-API Client ID、密钥
3. 【基础参数配置】
· 服装变体规则：开启尺码映射（US S/M/L ↔ EU 36/38），配置颜色属性词
· 成本模板：预设面料、工费、头程、平台佣金、广告分摊成本项
· 用户权限：创建运营、仓库、财务子账号，区分数据查看 / 刊登 / 改价权限
4. 【数据初始化】批量导入现有服装 SPU/SKU、库存、在途采购单
二、核心功能模块（服装类目专属）
模块 1：服装产品管理（PDM，核心特色）
专门适配服装多变体体系，SPU（基础款）→SKU（颜色 + 尺码子变体）
1. SPU 档案：录入款名、面料、成分、洗水标、尺码对照表、版型、季节、品牌，支持上传面料细节图、吊牌图
2. 变体批量构建：一键生成颜色 + 尺码矩阵 SKU，自动分配 SKU 编码，支持批量导入色卡图片，批量挂载到各子 ASIN
3. 图片素材库：统一管理服装白底主图、细节图、模特图，支持图片分组，刊登时一键分配给不同变体；图片查重、尺寸校验（亚马逊 1000×1000px）
4. Listing 刊登草稿：AI 生成标题、五点描述，自动检测字符上限、禁用词；多站点模板，自动翻译小语种，批量提交上新 / 更新 Listing；变体父子 ASIN 批量搭建、批量改价格 / 库存
5. 产品合规：服装类目关键词风控、侵权图片筛查、纺织品合规标签资料存档
模块 2：订单管理 OMS
1. 自动拉取亚马逊 FBA/FBM 订单，订单自动合并、异常订单拦截（地址异常、高风险退款单）
2. 订单明细：绑定服装 SKU 款号，查看买家购买尺码颜色；自动同步亚马逊退款、退货单
3. FBM 自发货：拣货单、面单打印，物流单号回传亚马逊
模块 3：库存与 FBA 管理 WMS（服装重点）
1. 多仓统一视图：国内仓、FBA 各海外仓、头程在途库存，实时库存数量
2. 服装库存预警：按尺码单独设置安全库存，某个颜色尺码断码自动提醒
3. FBA 货件管理：创建 FBA 发货计划，分箱，生成装箱单；跟踪头程物流，货件入库后自动更新 FBA 库存
4. 库存周转报表：看每个服装款的动销，滞销 SKU 统计（长期不动销的颜色尺码）
模块 4：采购与供应链 SCM
1. 按服装 SPU 生成采购计划：结合销量、库存、在途自动建议采购数量
2. 采购单管理：向工厂 / 面料商下单，记录面料采购、成衣加工费；跟踪生产进度、质检、入库
3. 供应商档案，采购价格历史记录，面料 BOM 管理
模块 5：广告与运营数据看板
1. 自动同步亚马逊广告数据（SP/SB/SBV），按服装款号聚合广告花费、ACoS
2. 经营仪表盘：销售额、订单量、各款式销量排行、爆款 / 滞销款
3. 服装变体维度数据分析：不同颜色、尺码的销量占比，判断哪些尺码热销
模块 6：财务 & 利润核算
1. 单 SKU 利润自动计算：面料成本 + 加工费 + 头程 + 平台佣金 + 广告分摊 + 退货损耗
2. 批量利润报表，按款 / 站点 / 时间段导出；VAT、费用归集，支持导出对账 Excel
3. 退货成本统计：服装退货损耗核算
模块 7：客服 & 日志
买家消息、退货工单；完整操作日志，记录谁修改了 Listing、价格、库存，方便运营审计
三、系统优缺点
✅ 优点（服装卖家针对性优势）
1. 服装变体矩阵管理能力强：颜色 + 尺码批量生成 SKU，多站点尺码自动映射，解决服装卖家最大痛点，不用 Excel 维护大量变体
2. 素材图库一体化：服装图片集中管理，批量给变体分配图片，刊登效率大幅提升
3. FBA 分尺码库存预警，精准识别断码、滞销尺码，减少库存积压（服装类目滞销风险极高）
4. 全链路成本精细核算，把面料、工费、退货损耗计入利润，比通用 ERP 更贴合服装行业
5. 多店铺隔离，子账号权限精细化，多人协同运营，操作留痕，降低误刊登风险
6. API 自动同步亚马逊数据，减少人工复制粘贴，降低错填尺码、颜色的刊登事故
❌ 缺点
1. 垂直服装 ERP，非通用进销存；不适合 3C、家居等非服装类目
2. 大量变体 SKU 时，数据库压力上升，大批量刊登任务会排队，网络差时 SP-API 同步会延迟
3. 依赖亚马逊 SP-API 接口，亚马逊平台接口限流、维护时，系统数据会暂时无法更新
4. 自建版本需要服务器运维能力；商用订阅版按 SKU / 店铺数量收费，大 SKU 集群成本较高
5. 面料 BOM、生产排产功能有限，只适合跨境成衣卖家，不适合大型服装工厂深度生产制造
6. 图片 AI 处理能力有限，复杂模特图修图仍需外部工具
四、保姆级部署教程（Docker 容器一键部署，推荐自建开源版）
技术栈：Python + MySQL8 + Redis + Nginx，Docker Compose 编排，适合中小服装卖家私有化部署 ⚠️ 重要提示：本部署方案用于私有本地 / 云服务器部署，商用上线前务必完成亚马逊 SP-API 开发者资质申请
4.1 硬件 & 服务器选型
· 小规模（店铺≤3，SKU<5000）：2 核 4G 云服务器，SSD 100G，Ubuntu22.04 / CentOS 7.9
· 中大规模（店铺≥5，SKU 上万）：4 核 8G，SSD 300G，独立 MySQL 数据库实例
· 网络要求：服务器网络可访问亚马逊 SP-API，开放 80/443 端口，防火墙设置 IP 白名单
4.2 前置环境安装
1. 登录服务器，更新系统
apt update && apt upgrade -y
1. 安装 Docker & Docker Compose
#安装docker
curl -fsSL https://get.docker.com | sh
systemctl start docker && systemctl enable docker
#安装docker-compose
apt install docker-compose -y
4.3 拉取项目代码，配置环境变量
git clone https://github.com/iceking8/Amazon-clothing-ERP.git
cd Amazon-clothing-ERP
编辑docker-compose.yml，修改关键配置：
environment:
- ERP_SECRET_KEY=【自定义高强度密钥】
- ERP_INIT_ADMIN_USER=admin
- ERP_INIT_ADMIN_PASSWORD=【自定义管理员初始密码】
- DB_URI=mysql+pymysql://root:数据库密码@mysql:3306/amz_clothing_erp
4.4 启动容器，初始化数据库
docker-compose up -d --build
等待容器构建完成，自动初始化数据表（服装 SPU/SKU、变体、店铺表）
等待约 2~5 分钟，执行docker-compose logs -f查看日志，看到application start success即启动成功
4.5 访问系统 & 亚马逊 API 授权
1. 浏览器访问 http://服务器IP:8000，使用上面设置的 admin 账号登录
2. 进入【系统设置】→【亚马逊店铺授权】
3. 前往亚马逊开发者后台，创建 SP-API 应用，获取：Client ID、Client Secret、Refresh Token，填入系统
4. 点击测试连接，显示连接成功即完成店铺绑定
4.6 初始化基础数据（业务配置）
1. 导入服装尺码映射模板（US/EU/UK 尺码对照表）
2. 批量导入历史 SKU、库存（支持 Excel 模板导入）
3. 配置成本模板、仓库、物流渠道
4. 创建运营 / 财务子账号，分配权限
4.7 测试试运行（上线前必做）
1. 测试拉取订单、库存，核对与亚马逊后台数据是否一致
2. 新建 1 个服装 SPU，创建颜色尺码变体草稿，测试小批量刊登测试款
3. 测试 FBA 货件创建、采购单创建、利润报表导出
4. 设置定时自动备份数据库（建议每日凌晨自动备份）
4.8 生产上线 & 运维
1. Nginx 反向代理 + SSL 证书，配置域名 https 访问（生产环境必须）
2. 定时任务：系统自动同步亚马逊数据（订单、库存、广告），默认每 30 分钟拉取
3. 日常运维：定期查看容器日志，监控服务器内存；数据库异地备份，防止数据丢失
4.9 常见部署踩坑
1. 亚马逊 API 连接失败：检查服务器网络是否能访问亚马逊 API，Refresh Token 过期，重新获取授权
2. 大批量变体导入报错：Excel 模板格式错误，尺码 / 颜色属性词不符合亚马逊规范
3. 服务器内存溢出：SKU 数量巨大时升级服务器内存，关闭不必要的后台同步任务
4. 图片上传失败：检查服务器磁盘空间，文件上传大小限制
五、日常使用简易流程（服装卖家标准工作流）
1. 产品开发：新建服装 SPU，录入面料、尺码，上传图片，生成颜色尺码 SKU 变体矩阵
2. 刊登：创建 Listing 草稿，校验合规，提交到亚马逊多站点
3. 运营：查看看板，监控销量、ACoS；断码预警，创建 FBA 补货采购单
4. 订单：自动拉取订单，FBA 订单无需手动处理；FBM 订单打印面单发货
5. 财务：月末导出利润报表，核算每个服装款式盈亏，统计退货损耗
六、安全与免责提示
1. 亚马逊 SP-API 账号密钥、Refresh Token 属于敏感信息，不要泄露，服务器做好访问白名单
2. 自建版本适合内部业务使用，商用对外售卖需要遵守亚马逊开发者协议
3. 本系统仅做业务数据管理，不保证亚马逊 Listing100% 审核通过，服装纺织品合规仍需卖家自行把控