亚马逊卖家从选品到订单履约的数据化经营平台

建设目标

把亚马逊卖家日常运营中分散在 Excel、ERP、广告后台、物流后台、供应商聊天记录里的关键数据统一到一个系统中，形成可查询、可追踪、可分析的经营闭环。

产品原则

• 先沉淀核心业务数据，再逐步接入自动化接口。
• 每个 SKU 必须能追溯从立项到售后的完整记录。
• 利润、库存周转、广告效率优先于单纯销售额。
• 保留人工录入入口，避免接口不可用时业务中断。

已落地页面

• 经营看板、验收中心、CSV 导入、CSV 导出、数据采集、SP-API 接入测试、项目文档。
• 选品管理、竞品监控、关键词排名、合规认证、商品管理、商品详情、商品新建、商品编辑、调价审批。
• 上架任务、供应商管理、供应商详情、报价、样品、沟通记录。
• 采购单、采购详情、库存快照、补货建议、FBA 发货、订单、订单详情。
• 售后退货、平台索赔、评价口碑、广告日报、广告关键词、促销活动、财务日报、财务结算、费用规则、预警任务、SOP 协作、操作日志、报表中心。

已落地 DuckDB 表

• 基础表：stores、products、skus、suppliers、supplier_quotes、supplier_samples、supplier_contact_logs。
• 经营表：purchase_orders、purchase_order_items、inventory_snapshots、fba_shipments、sales_orders、sales_order_items。
• 运营表：product_research、competitor_watches、keyword_ranks、compliance_certs、listing_tasks、return_cases、claim_cases、product_reviews、ad_daily_reports、ad_keywords、promotion_campaigns。
• 财务表：product_prices、price_change_logs、finance_daily_reports、finance_settlements、fee_rules。
• 治理表：data_collection_jobs、alerts、sop_tasks、operation_logs、report_snapshots。

已落地 API

• POST /api/dashboard/、/api/acceptance/、/api/crud-test/、/api/data-collection/、/api/sp-api-test/、/api/research/、/api/competitors/、/api/keyword-ranks/、/api/compliance/。
• POST /api/products/、/api/suppliers/。
• POST /api/purchase-orders/、/api/inventory/、/api/replenishment/、/api/fba-shipments/、/api/orders/。
• POST /api/return-cases/、/api/claim-cases/、/api/product-reviews/。
• POST /api/advertising/、/api/advertising/keywords/、/api/promotions/。
• POST /api/finance/、/api/finance/settlements/、/api/finance/fee-rules/。
• POST /api/price-approvals/、/api/alerts/、/api/sop-tasks/、/api/operation-logs/、/api/reports/。

当前验收重点

• 所有新增和状态流转动作走 POST。
• 前端表单提交由基础模板局部刷新页面主体。
• 图表统一使用前端 ECharts 渲染，验收中心会检查图表容器、echarts.init 和 setOption 契约。
• 业务写入统一经过 public/utils/db.py 的 DuckDBCenter。
• 商品详情包含 SKU 360、定价测算、财务利润趋势、广告关键词、售后、索赔、合规和运营日志。
• 供应商详情包含履约摘要、采购订单、报价、样品、沟通、预警和操作日志。
• 采购单详情包含付款进度、收货率、待质检行、履约信号和采购操作日志。
• 订单详情包含利润拆分、利润率、退货、索赔、服务信号和订单操作日志。
• 自动化验收命令：python manage.py test seller。
• 自动化测试覆盖验收中心、所有模块页面、POST API、HTTP CRUD 测试接口、CSV 导出、代表性写入状态流、核心详情页业务字段、ECharts 图表契约和 SP-API LWA 测试安全边界。

5.1 选品中心

选品中心用于沉淀每一个产品机会，从发现、调研、打分、评审到立项，避免选品只停留在聊天记录或临时表格中。

• 产品机会池：记录产品名称、类目、站点、目标价格带、目标人群、需求场景、发现来源、负责人、当前状态。
• 关键词调研：记录主关键词、长尾词、搜索量、竞争强度、CPC 估算、季节性、转化意图。
• 竞品分析：记录 ASIN、品牌、售价、评分、评论数、月销量估算、BSR、变体数量、卖点、差评痛点。
• 机会评分：按需求强度、竞争难度、利润空间、供应链可控性、合规风险、差异化空间打分。
• 立项评审：支持提交评审、评审意见、通过/驳回、待补充资料、转采购打样。
• 附件资料：支持保存竞品截图、调研表、供应商报价单、合规认证、包装参考图。

5.2 利润测算

利润测算要服务于选品和运营，不只计算单件利润，还要能推演广告、退货、汇率和仓储变化后的利润安全边界。

• 成本项：采购单价、包装费、质检费、国内运费、头程运费、关税、平台佣金、FBA 配送费、仓储费。
• 运营项：售价、折扣、Coupon、广告 ACOS、站外推广费、退货率、退款损失、售后补偿。
• 财务项：币种、汇率、结算周期、回款金额、资金占用天数、采购预付款比例。
• 输出项：毛利、净利、毛利率、净利率、盈亏平衡售价、盈亏平衡 ACOS、安全售价区间。
• 版本管理：每次测算保存版本，用于对比选品阶段预测利润和实际销售利润。

5.3 供应商与采购

供应链模块覆盖供应商从建档、报价、打样、采购、生产、付款到质检的全过程。

• 供应商档案：公司名、联系人、联系方式、地区、主营品类、账期、最小起订量、合作状态。
• 报价管理：不同供应商、不同数量阶梯、不同包装方案、不同交期的报价对比。
• 样品管理：样品申请、寄出日期、收到日期、样品费用、检测结论、整改意见。
• 采购订单：采购 SKU、数量、单价、币种、付款节点、交期、收货仓、采购状态。
• 生产跟进：下单、备料、生产、质检、装箱、出厂、发货各节点时间和异常备注。
• 付款记录：定金、尾款、额外费用、付款截图、发票、未付款余额。

5.4 商品与 Listing

商品模块作为系统主数据核心，必须能把内部 SKU、供应商 SKU、平台 SKU、ASIN、FNSKU 和 Listing 内容关联起来。

• 商品档案：产品线、品牌、型号、规格、颜色、尺寸、重量、包装尺寸、生命周期状态。
• SKU 关系：内部 SKU、MSKU、ASIN、父 ASIN、FNSKU、供应商货号、条形码。
• Listing 内容：标题、五点描述、长描述、Search Terms、A+ 页面、主图、附图、视频。
• 合规资料：认证类型、证书编号、有效期、负责人、审核状态、平台合规备注。
• 上架流程：待编辑、待审核、已提交、已上架、需修改、已下架。
• 版本记录：每次标题、价格、图片、关键词变更都保存记录，便于复盘转化率变化。

5.5 库存与补货

库存模块要同时处理本地仓、海外仓、FBA 可售、FBA 预留、在途和采购未发货库存。

• 库存分层：本地可用、本地锁定、海外仓、FBA 可售、FBA 预留、FBA 不可售、在途、待生产。
• 库存流水：采购入库、调拨出库、FBA 发货、销售扣减、退货入库、盘盈盘亏、报废。
• 已开发实现：FBA 发货可 POST 确认出库，自动扣减本地库存、增加 FBA 在途、写入库存流水并推进货件状态。
• 已开发实现：FBA 货件可 POST 上架入仓，自动减少在途库存、增加 FBA 可售库存、写入库存流水并将货件状态改为 received。
• 补货建议：基于日均销量、备货周期、头程周期、安全库存、目标覆盖天数计算建议补货量。
• 预警规则：预计断货天数小于阈值、库龄过长、库存金额过高、FBA 不可售异常增长。
• 批次管理：批次号、采购单、生产日期、入库日期、到仓日期、单件成本。

5.6 销售与订单

订单模块负责把销售事实沉淀到 SKU、站点、店铺和订单维度，并为利润核算提供基础。

• 订单同步：订单号、店铺、站点、购买时间、支付时间、订单状态、履约方式。
• 订单明细：ASIN、MSKU、数量、售价、促销折扣、税费、配送费、平台费用。
• 售后处理：退款、退货、换货、索赔、差评、买家消息、处理人、处理结果。
• 订单利润：销售收入、商品成本、FBA 费、佣金、广告分摊、退款损失、净利润。
• 异常订单：取消、未付款、配送失败、退款金额异常、利润为负、重复订单。
• 已开发实现：订单可 POST 发货，自动扣减 FBA 可售库存、写入 sales_ship 库存流水，并将订单状态改为 Shipped。
• 已开发实现：退货案例可 POST 入库，可售退货增加本地库存，不可售退货增加不可售库存，并写入 return_receive 库存流水。

5.7 广告与运营

广告模块既要保存数据，也要帮助运营判断广告是否带来真实利润，而不是只看广告销售额。

• 广告层级：Portfolio、Campaign、Ad Group、Target、Keyword、Search Term。
• 核心指标：曝光、点击、CTR、CPC、花费、订单量、广告销售额、CVR、ACOS、ROAS。
• 利润关联：广告花费分摊到 SKU 和日期，结合总销售额计算 TACOS 和净利润。
• 运营动作：加词、否词、调价、调预算、开关 Campaign、记录操作原因和预期。
• 复盘机制：操作前后 3 天、7 天、14 天指标对比，判断操作是否有效。

5.8 财务与利润

财务模块关注可经营利润和现金流，不替代专业财务软件，但要能给老板及时判断业务健康度。

• 收入：商品销售收入、运费收入、促销前后收入、退款冲减、平台赔付。
• 成本：采购成本、头程成本、平台佣金、FBA 费、仓储费、广告费、退货损失。
• 现金流：采购付款、物流付款、平台回款、广告扣费、退款、税费、其他调整。
• 利润口径：SKU 毛利、订单净利、店铺净利、产品线净利、站点净利。
• 手工调整：支持录入无法自动获取的费用，并关联店铺、SKU、日期和费用类型。

5.9 数据导入导出

在 API 完全稳定之前，导入导出是系统能快速落地的关键能力。

• 导入类型：SKU 模板、供应商模板、采购单、库存盘点、订单报告、广告报告、费用报告。
• 字段映射：允许用户把上传文件列名映射到系统字段，保存常用映射方案。
• 数据校验：必填项、数字格式、日期格式、币种、重复单号、未知 SKU、负库存。
• 导入结果：成功行数、失败行数、失败原因、可下载错误报告。
• 导出类型：经营日报、库存报表、利润报表、采购跟进表、选品评审表。

5.10 预警与任务

预警模块把“需要人处理的事情”推到前台，减少运营人员每天到处查后台。

• 库存预警：断货、库存过高、在途延迟、不可售过高、库龄过长。
• 销售预警：销量骤降、转化率下降、价格异常、Buy Box 丢失、Listing 下架。
• 广告预警：花费超预算、ACOS 超阈值、点击无转化、预算提前耗尽。
• 售后预警：差评新增、退货率上升、退款金额异常、客服工单超时。
• 任务流转：生成任务、分配负责人、设置截止时间、处理备注、完成确认。

工作台首页

• 顶部展示今日销售额、今日订单、今日广告花费、库存预警数、待处理任务数。
• 中间展示销售趋势、利润趋势、广告 ACOS、库存健康度。
• 右侧展示待办任务、系统预警、采集失败记录和最近运营动作。
• 支持按店铺、站点、产品线、负责人筛选。

选品池页面

• 列表字段：机会名称、类目、站点、目标售价、预计月销、评分、风险、负责人、状态。
• 支持新增机会、批量导入、评分排序、状态筛选、提交评审。
• 详情页包含竞品、关键词、利润测算、附件、评审记录。
• 通过评审后可一键生成产品档案和采购打样任务。

商品 SKU 页面

• 列表字段：内部 SKU、MSKU、ASIN、产品线、站点、售价、生命周期、库存、负责人。
• 详情页包含 Listing 内容、利润、库存、订单、广告、运营日志。
• 支持 SKU 合并视图，把同产品不同站点或不同变体放在一起看。
• 支持导出 SKU 台账，作为供应链和财务对账基础。

采购跟进页面

• 按采购单展示供应商、SKU、数量、金额、交期、当前节点、逾期天数。
• 支持节点更新、付款记录、质检记录、附件上传、异常备注。
• 采购单入库后自动生成库存流水和成本批次。
• 支持按供应商统计交期准时率、质量问题次数和采购金额。
• 已开发实现：采购单详情计算采购数量、已收数量、收货率、待收数量、付款率、未付金额、待质检行和履约信号。
• 已开发实现：采购单状态变更写入 operation_logs，并在采购详情页展示采购操作日志。
• 已开发实现：采购单明细可 POST 收货，自动更新已收数量、写入 inventory_movements，并追加库存快照影响本地库存。

库存补货页面

• 列表字段：SKU、FBA 可售、本地库存、在途、日均销量、可售天数、建议补货。
• 支持查看补货计算公式和关键参数，避免黑盒建议。
• 支持生成补货计划，关联采购单或 FBA 发货计划。
• 支持库存预警、库龄分析、不可售库存处理记录。
• 已开发实现：补货建议可 POST 生成库存预警，按 urgent/soon 创建 high/medium 预警，并对同 SKU 未解决库存预警去重。

订单与售后页面

• 订单列表支持订单号、SKU、ASIN、状态、日期、利润、退款状态搜索。
• 订单详情展示金额拆分、费用拆分、履约状态、售后记录。
• 售后工单支持分配客服、记录处理过程、上传截图、标记完成。
• 异常订单自动标记，例如负利润、重复退款、退款比例过高。
• 已开发实现：订单详情计算商品销售额、平台费、FBA 费、广告分摊、订单利润、利润率、退款金额、索赔金额和服务信号。
• 已开发实现：订单详情聚合订单明细、退货案例、索赔案例和订单操作日志。

广告分析页面

• 支持 Campaign、Ad Group、Keyword、Search Term 多层级查看。
• 指标包含花费、点击、订单、广告销售、ACOS、ROAS、TACOS。
• 支持记录运营动作，并查看动作前后指标变化。
• 支持导出关键词表现和建议否词清单。

经营看板页面

• 老板看板：销售额、净利润、现金流、库存金额、广告效率、产品排行。
• 运营看板：转化率、广告、自然订单、退货率、Listing 变更影响。
• 供应链看板：采购金额、交期、在途、断货风险、库龄。
• 支持保存筛选条件，按日、周、月切换。

10.1 商品列表

• 核心字段：商品图、商品名称、内部 SKU、MSKU、ASIN、父 ASIN、站点、店铺、品牌、产品线、类目、负责人。
• 经营字段：当前售价、目标售价、最低利润价、近 7 天销量、近 30 天销量、毛利率、净利率、广告 ACOS、TACOS。
• 库存字段：FBA 可售、本地库存、在途库存、可售天数、建议补货量、断货风险等级。
• 状态字段：开发中、打样中、待上架、已上架、推广期、稳定期、清仓、暂停、已淘汰。
• 筛选条件：店铺、站点、类目、产品线、负责人、生命周期、库存风险、利润风险、广告风险。
• 批量操作：批量改负责人、批量打标签、批量导出、批量生成补货计划、批量进入清仓评估。

10.2 商品详情页总览

• 顶部固定信息：商品图、商品名、SKU、ASIN、站点、售价、状态、负责人、更新时间。
• 顶部快捷动作：编辑商品、调整价格、创建采购单、创建补货计划、记录运营动作、下架/清仓、导出详情。
• 关键指标：今日销售、7 日销售、30 日销售、净利润、毛利率、库存可售天数、ACOS、退货率、评分。
• 风险提示：断货风险、利润过低、广告超支、退货率异常、Listing 被抑制、合规资料缺失。
• 趋势图：销量、销售额、净利润、广告花费、自然订单占比、库存余量。
• 最近动态：改价、改图、改标题、补货、广告调整、差评、退款、采购延期。
• 已开发实现：SKU 360 聚合 prices、inventory、supplier_quotes、orders、ads、ad_keywords、promotions、finance_reports、finance_settlements、returns、claims、reviews、fba_shipments、compliance_certs、keyword_ranks、competitors、fee_rules、sop_tasks、operation_logs。
• 已开发实现：定价测算读取默认供应商报价、当前价、目标价、最低利润价、佣金规则、FBA 费和目标 ACOS，输出预估利润、毛利率、盈亏平衡售价和价格信号。

10.3 定价功能

• 价格类型：当前售价、建议售价、最低利润价、目标利润价、促销价、清仓价、会员价、站外折扣价。
• 价格来源：人工设置、利润测算、竞品监控、活动计划、清仓策略、平台同步。
• 定价参数：采购成本、头程成本、FBA 费、佣金率、广告 ACOS、退款率、汇率、目标利润率。
• 定价结果：盈亏平衡价、目标利润价、最低可接受价、建议促销价、价格风险等级。
• 价格审批：低于最低利润价必须审批；清仓价必须填写原因；批量改价必须生成审批记录。
• 价格历史：记录每次价格变化、操作人、原因、变更前后价格、变更后销量与利润影响。
• 已开发实现：调价审批通过后自动写入 product_prices 当前价，商品列表和 SKU 360 定价测算按最新价格记录读取，重复审批不会重复写价。

10.4 定价计算规则

• 单件总成本 = 采购成本 + 包装费 + 头程分摊 + 关税分摊 + FBA 费 + 平台佣金 + 其他固定费用。
• 预估广告费 = 售价 * 目标 ACOS，或按历史广告费 / 销售件数分摊。
• 预估退款损失 = 售价 * 退款率 * 退款损失系数。
• 盈亏平衡售价 = 固定成本 / (1 - 佣金率 - 目标 ACOS - 退款损失率)。
• 目标利润售价 = (固定成本 + 目标单件利润) / (1 - 佣金率 - 目标 ACOS - 退款损失率)。
• 清仓建议：库龄高、可售天数高、近 30 天销量低、广告无效时，允许低于目标利润价但需保留审批。

10.5 商品状态流转

• 选品机会：仅保存调研数据，不进入正式库存和订单。
• 开发中：产品已立项，正在打样、测算或找供应商。
• 待上架：SKU、Listing、图片、合规、首批采购基本完成。
• 推广期：新品上架后重点观察广告、转化、评价和库存消耗。
• 稳定期：进入常规补货、广告优化和利润监控。
• 清仓期：停止或减少采购，按清仓价、促销和广告策略处理库存。
• 淘汰：停止补货和推广，仅保留历史订单、利润和复盘记录。

10.6 商品详情关键按钮

• 编辑：修改基础信息、规格、标签、负责人和生命周期。
• 调价：打开定价弹窗，展示利润测算、竞品价、历史价和审批规则。
• 补货：根据库存和销量生成补货建议，可转采购单或 FBA 发货计划。
• 采购：快速创建采购单，自动带出供应商、最近采购价和 MOQ。
• 运营记录：记录改图、改标题、调广告、做促销、站外推广等动作。
• 预警处理：处理断货、利润、广告、评价、合规、入仓差异等风险。

11.1 供应商列表

• 核心字段：供应商名称、简称、联系人、电话、微信、邮箱、地区、主营类目、合作状态、负责人。
• 经营字段：合作 SKU 数、累计采购金额、最近采购日期、未付款金额、未交付采购单数。
• 履约字段：平均交期、准时交付率、质检通过率、异常次数、售后配合评分。
• 筛选条件：合作状态、主营类目、地区、负责人、评分等级、是否黑名单、是否有逾期采购单。
• 批量操作：批量分配负责人、批量打标签、批量导出、批量停用、批量发起复评。

11.2 供应商详情页

• 顶部信息：公司名、合作状态、评分、联系人、主营类目、账期、付款方式、最近采购。
• 快捷动作：新增报价、申请样品、创建采购单、上传合同、记录沟通、发起复评、拉黑。
• 关键指标：累计采购额、采购单数量、准时交付率、质检通过率、平均交期、异常金额。
• 风险提示：证照缺失、合同过期、采购逾期、质量异常、付款异常、价格高于历史均值。
• 最近动态：报价更新、样品结果、采购节点、付款记录、质检异常、合同变更。
• 已开发实现：供应商详情聚合报价、样品、采购订单、沟通记录、未处理预警和操作日志。
• 已开发实现：履约摘要计算报价数、默认报价数、样品通过率、采购单数、活跃采购单、累计采购额、未付金额、预警数量、待跟进沟通和风险信号。

11.3 供应商状态流转

• 待开发：只保存基础线索，未报价或未验证。
• 已联系：已有沟通记录，正在获取报价或样品。
• 打样中：已申请样品，等待样品或检测结果。
• 可合作：报价、样品、资质基本通过，可以下采购单。
• 合作中：已有正式采购订单和履约记录。
• 暂停合作：存在质量、交期、价格或沟通风险，暂不新增采购。
• 黑名单：严重质量、欺诈、侵权、交付或付款风险，禁止创建采购单。

11.4 报价管理规则

• 同一 SKU 可保存多个供应商报价，支持按数量阶梯、包装方案和交期比较。
• 报价必须带币种、生效日期、有效期、MOQ、交期和是否含税。
• 默认报价只能有一个，创建采购单时优先带出默认报价。
• 报价过期后不能直接用于采购单，必须确认或复制成新报价。
• 采购价高于最近默认报价超过阈值时，需要填写原因或审批。

11.5 供应商评分

• 价格评分：同 SKU 多供应商价格对比、涨价频率、报价稳定性。
• 质量评分：质检通过率、不良率、退货原因关联、客户差评关联。
• 交期评分：准时交付率、平均延迟天数、紧急订单配合度。
• 响应评分：报价响应、异常处理、售后配合、资料配合速度。
• 综合评分 = 价格 * 权重 + 质量 * 权重 + 交期 * 权重 + 响应 * 权重 + 售后 * 权重。

11.6 供应商字段组

• 身份字段：supplier_code, company_name, short_name, tax_id, status, rating_level。
• 联系字段：contact_name, phone, wechat, email, address, website。
• 交易字段：payment_terms, payment_method, bank_account, invoice_type, currency。
• 能力字段：main_categories, monthly_capacity, moq_policy, sample_policy, lead_time_days。
• 风控字段：license_file, contract_expire_date, blacklist_reason, risk_level。

老板视角

• 总销售额、订单量、净利润、毛利率。
• 广告花费、ACOS、TACOS、广告销售占比。
• 库存金额、在途金额、可售天数、断货风险。
• 站点、店铺、产品线、SKU 多维度排名。

运营视角

• Listing 转化率、点击率、自然订单占比。
• 关键词表现、广告活动表现、预算消耗。
• 差评、退货、退款、客服问题趋势。
• 补货提醒、价格异常、排名波动提醒。

采集来源优先级

• 第一阶段：Excel/CSV 导入，先解决数据结构和业务流转。
• 第二阶段：接入 Amazon Selling Partner API，同步订单、库存、费用和 Listing 基础数据。
• 第三阶段：接入 Amazon Ads API，同步广告 Campaign、Keyword、Search Term 和日报。
• 第四阶段：接入物流、海外仓或财务数据源，补齐成本和现金流。

定时任务

• 每小时：订单增量同步、库存快照更新、异常订单检测。
• 每天凌晨：销售日报汇总、广告日报汇总、利润重算、库存可售天数计算。
• 每天上午：生成待办预警，包括断货、广告超支、销量下降、退货率异常。
• 每周：生成 SKU 周报、广告复盘、采购交期报告、选品进度报告。
• 每月：生成利润月报、库存资金占用、产品生命周期评估。

核心计算公式

• 毛利 = 销售收入 - 商品成本 - 平台佣金 - FBA 配送费。
• 净利 = 毛利 - 广告费 - 退款损失 - 仓储费 - 其他分摊费用。
• 毛利率 = 毛利 / 销售收入。
• ACOS = 广告花费 / 广告销售额。
• TACOS = 广告花费 / 总销售额。
• 可售天数 = 当前可售库存 / 最近 N 天日均销量。
• 建议补货量 = 目标覆盖天数销量 - 可售库存 - 在途库存 + 安全库存。

数据质量规则

• 未知 SKU 不直接入正式订单表，进入待匹配队列。
• 同一订单号和同一订单明细不能重复入库。
• 广告花费、订单金额、退款金额必须带币种。
• 库存不能无原因变成负数，必须记录流水类型和关联单据。
• 采集失败要记录接口、参数、错误原因、重试次数和下次重试时间。

审计要求

• 重要字段变更必须记录修改前、修改后、修改人、修改时间和修改原因。
• 重要操作包括改价、改成本、改库存、导入数据、删除记录、关闭预警。
• 删除建议采用软删除，保留 deleted_at 和 deleted_by。
• 导入任务、采集任务和批量操作必须记录任务日志。

数据可见性

• 普通成员只能看到自己负责或被授权的店铺、产品线、SKU。
• 采购人员默认不看完整利润，只看采购和库存相关数据。
• 客服默认不看供应商采购价和广告投放成本。
• 老板和财务可查看跨店铺汇总利润与现金流。

服务层建议

• ProductService：处理 SKU、ASIN、Listing 相关业务。
• InventoryService：处理库存余额、流水、快照和补货计算。
• ProfitService：处理订单利润、SKU 利润、费用分摊。
• ImportService：处理上传文件、字段映射、导入校验。
• AmazonApiService：封装 SP-API 和 Ads API，避免业务代码直接调用外部接口。

异常处理

• 接口返回统一错误结构，包含 code、message、detail、request_id。
• 外部 API 限流时进入延迟重试队列，不阻塞用户页面。
• 批量导入部分失败时允许成功数据入库，失败数据生成错误报告。
• 关键计算任务失败时保留上一版有效结果，并提示数据可能未更新。

15.1 竞品监控中心

• 监控竞品 ASIN 的售价、Coupon、评分、评论数、BSR、变体数、主图变化。
• 记录竞品卖点、差评痛点、图片风格、A+ 页面结构、促销节奏。
• 支持把竞品加入观察列表，按每日、每周生成变化报告。
• 竞品价格低于本品价格阈值时生成价格竞争预警。
• 竞品评论快速增长时提示运营复盘其促销或站外动作。

15.2 关键词排名与 SEO

• 维护核心词、长尾词、品牌词、防守词、竞品词和否定词词库。
• 记录关键词自然排名、广告排名、搜索量、CPC、转化率和归属 SKU。
• Listing 标题、五点、Search Terms 与关键词覆盖度检查。
• 关键词排名下降、曝光下降、点击无转化时生成优化任务。
• 支持关键词分组：引流词、转化词、利润词、测试词、淘汰词。

15.3 智能定价与促销

• 维护最低利润价、目标利润价、清仓价、活动价、竞品跟随价。
• 按库存天数、竞品价格、广告 ACOS、毛利率建议调价方向。
• 记录 Coupon、Prime Exclusive Discount、Deal、站外折扣活动。
• 促销前后对比销售、利润、排名、库存消耗和广告效率。
• 设置调价审批，避免运营误操作导致亏损或价格异常。

15.4 评价与口碑管理

• 记录 Review、Rating、Feedback、QA、买家消息和售后标签。
• 按 SKU 统计评分趋势、差评原因、退货原因和质量问题。
• 差评新增时生成客服任务，记录处理动作和结果。
• 把差评原因反向关联到产品改良、包装改良和供应商质量评分。
• 沉淀常用客服话术和售后 SOP，支持按问题类型检索。

15.5 物流与 FBA 发货

• 管理 FBA 发货计划、箱规、装箱单、Shipment ID、货代、渠道和预计到仓日期。
• 记录头程费用、报关费用、保险费、尾程费用并分摊到 SKU 成本。
• 跟踪待发货、已出厂、已提货、已开船、清关中、派送中、已签收、已上架。
• 支持异常节点：延误、查验、丢件、破损、上架差异、箱唛错误。
• 入仓差异自动生成待处理任务，关联索赔或库存调整。

15.6 平台索赔与异常处理

• 管理 FBA 丢失、损坏、入仓差异、退款未退货、平台多扣费等索赔机会。
• 记录索赔类型、关联订单或 Shipment、证据材料、提交时间、处理状态。
• 索赔状态包括待核查、可索赔、已提交、待回复、已赔付、被拒绝、放弃。
• 统计索赔金额、成功率、平均处理周期和未处理金额。
• 索赔任务可分配给专人，并设置超时提醒。

15.7 合规与认证管理

• 管理产品认证、测试报告、商标、专利、版权、包装标签、说明书版本。
• 按站点记录合规要求，如美国、加拿大、英国、欧盟、日本不同规则。
• 证书到期提醒、缺失资料提醒、平台审核资料包一键归档。
• Listing 受限、危险品审核、类目审核、品牌备案资料跟进。
• 侵权风险记录：外观、关键词、图片、品牌词和竞品投诉历史。

15.8 财务对账与结算

• 导入 Amazon Settlement 报告，核对订单收入、退款、费用、广告扣费和平台赔付。
• 按结算周期生成店铺回款表、费用明细表、SKU 利润调整表。
• 支持费用归类：佣金、配送、仓储、长期仓储、退款管理费、促销费、订阅费。
• 核对平台应收、实际回款、广告扣费和手工费用，生成差异清单。
• 支持币种汇率、结算汇率、采购汇率分开记录。

15.9 报表中心

• 内置日报、周报、月报、采购报表、库存报表、广告报表、利润报表。
• 支持自定义报表字段、筛选条件、排序方式和导出格式。
• 支持定时发送报表到负责人邮箱或企业微信机器人。
• 报表可以保存模板，按老板、运营、采购、财务不同视角展示。
• 每张报表展示数据更新时间和数据来源，避免误用过期数据。

15.10 团队 SOP 与任务协作

• 把上架、补货、广告优化、售后、索赔、采购跟进做成标准流程模板。
• 任务支持负责人、协作人、截止时间、优先级、附件、评论和完成证明。
• 任务可从预警、订单异常、库存异常、采购异常自动生成。
• 支持运营日志沉淀，便于新人接手 SKU 时理解历史动作。
• 按人统计待办数、超时数、完成数和关键任务处理时长。

15.11 移动端与轻量提醒

• 移动端优先展示今日销售、利润、广告花费、库存预警和待办任务。
• 支持手机处理简单任务：确认采购节点、关闭预警、回复工单备注。
• 重要预警通过企业微信、钉钉或邮件推送。
• 移动端不承载复杂建档和大表格编辑，只做查询、确认和提醒。
• 关键页面提供扫码快速打开 SKU、采购单、Shipment 或售后工单。

15.12 AI 辅助能力

• 根据竞品卖点、差评和关键词，生成 Listing 标题、五点和描述草稿。
• 对差评、退货原因、客服消息做自动分类和摘要。
• 根据销售、广告、库存和利润数据生成周报说明和异常解释草稿。
• 辅助选品评分，提示潜在合规风险、利润风险和竞争风险。
• AI 输出必须保留人工审核和版本记录，不直接自动发布到平台。

业务验收

• 一个 SKU 能完整查看选品记录、供应商、采购、库存、Listing、订单、广告、利润。
• 商品详情页必须包含基础信息、变体站点、Listing、定价、成本利润、库存、订单、广告、售后、合规和操作日志。
• 商品调价必须能展示盈亏平衡价、目标利润价、最低利润价、竞品价、价格历史和审批状态。
• 供应商详情页必须包含基础资料、报价、样品、采购、质检、付款、合同、沟通记录和绩效评分。
• 创建采购单时必须能从供应商默认报价带出 MOQ、采购价、币种、交期和供应商货号。
• 采购单入库后能自动形成库存流水，并影响库存余额。
• 订单导入后能关联 SKU，并计算基础订单利润。
• 广告导入后能按日期、SKU、Campaign 展示花费和 ACOS。
• 库存低于阈值时能生成补货预警和建议补货量。
• 老板能在一个看板看到销售、利润、广告、库存和预警。
• 竞品、关键词、评价、索赔、合规、物流和财务对账都有独立入口和负责人。
• 关键异常能自动生成任务，并能追踪处理人、截止时间和处理结果。

技术验收

• 核心表具备 created_at、updated_at、created_by、updated_by。
• 重要业务操作有 OperationLog 记录。
• 导入任务能返回成功行数、失败行数和失败原因。
• 接口和页面均按权限控制数据可见范围。
• 看板查询在常规数据量下响应时间可接受，必要时使用汇总表。
• 采集任务失败不会导致页面不可用，用户能看到失败原因。

MVP 不做范围

• 不先做复杂 AI 自动选品，先做数据沉淀和评分规则。
• 不先做全自动调价，先做价格记录、利润测算和异常提醒。
• 不先替代专业财务系统，先做经营利润和现金流视角。
• 不先追求所有站点接口完整接入，先支持手工导入和核心站点。

测试重点

• SKU、ASIN、MSKU、FNSKU 关联关系不能错。
• 库存流水和库存余额必须一致，可追溯。
• 利润计算要用固定测试样例验证，避免费用漏算。
• 导入重复文件不能制造重复订单或重复广告数据。
• 权限测试要覆盖不同角色查看同一页面的差异。