dtc-report

# DTC 经营分析报告生成技能 ## 触发场景 当用户需要生成 DTC 业务经营分析报告时使用此技能，包括： - "生成 DTC 经营分析报告" - "生成 DTC 预实分析报告" - "生成 DTC Q1/季度/年度经营分析" - "生成 DTC 月度经营分析" - "看看 DTC 的经营情况" ## 完整报告结构 ### 第一部分：经营概览（可视化） #### 1.1 核心指标卡片 - **收入**：实际数、预算数、达成率 - **毛利**：实际数、预算数、达成率 - **毛利率**：实际、预算、差异 pp #### 1.2 业务量概览 - **各段箱量**（B 段、C 段、D 段）：实际数、预算数、环比、环比增长 - **出库件数**：实际数、预算数、环比、环比增长 #### 1.3 业务量预算完成率 - 各段箱量预算完成率 - 出库件数预算完成率 --- ### 第二部分：预实情况对比 | 模块 | 数据维度 | 指标 | |------|---------|------| | 2.1 箱量预实对比 | **当月** + **当年累计** | B/C/D段箱量、实际、预算、达成率、同比、同比增长 | | 2.2 出库件数预实对比 | **当月** + **当年累计** | 实际、预算、达成率、同比、同比增长 | | 2.3 收入预实对比 | **当月** + **当年累计** | B/C/D段收入（万元）、实际、预算、达成率、同比、同比增长 | | 2.4 毛利预实对比 | **当月** + **当年累计** | B/C/D/电商集拼/其他毛利（万元）、实际、预算、达成率、同比、同比增长 | | 2.5 单箱指标 | **当月** + **当年累计** | B 段和 C 段的单箱收入、单箱毛利 | > ⚠️ **v1.2.0 已集成 AI 自动分析** --- ### 🆕 新增：AI 深度分析（v1.2.0） #### 自动识别异常波动 - 预算达成率 < 70% 的业务段 - 同比下降 > 30% 的业务段 - 毛利预算达成不足 #### 根因分析 - **箱量因素**：客户流失、市场需求、竞争加剧 - **价格因素**：价格战、客户议价、产品结构 - **客户因素**：关键大客户流失或减少合作 - **销售因素**：销售团队业绩波动 #### 行动建议 - **短期措施**（1 个月内）：应急方案 - **中期方案**（1-3 个月）：改善计划 - **长期机制**（3 个月以上）：制度建设 每条建议明确： - 责任部门/人员 - 时间节点 - 预期效果 - 衡量指标 --- ### 第三部分：分月趋势分析 #### 3.1 箱量和出库件数月度趋势 - 分月展示各段箱量、出库件数 - 折线图展示半年或一年数据（图上显示每月数据） - 标注数据来源 #### 3.2 收入毛利月度趋势 - 分月展示 B/C/D/电商集拼/其他的收入毛利 - 折线图展示 - 标注数据来源 > ⚠️ **趋势分析需要搭配文字分析** --- ### 第四部分：客户与销售 #### 4.1 客户开发数 - 当月和当年累计 B/C/D段客户数 - 总客户开发合计数（去重） #### 4.2 分销售 D 段客户开户数 - 当月和当年累计 D 段客户数 - 按销售统计 #### 4.3 前十大客户贡献 - 数据来源：所有业务收入明细（非订单维度） - 排除 35 家内部公司 #### 4.4 前十大销售贡献 - 数据来源：所有业务收入明细（非订单维度） #### 4.5 前十大销售贡献的 D 段箱量排名 --- ### 第五部分：海外仓分析 #### 5.1 仓库分布结构 - 地图可视化 #### 5.2 入库柜量和出库件数分布 - 当月和当年：美国、英国、欧洲、加拿大、其他 #### 5.3 美国入库柜量分布 - 当月和当年累计：美东自营仓、美西自营仓、美国第三方仓 - 自营仓入库柜量趋势折线图（分仓库） #### 5.4 美国出库件数分布 - 当月和当年累计：美东自营仓、美西自营仓、美国第三方仓 - 自营仓出库件数柱形图（分仓库） #### 5.5 Top10 亏损客户 - 条形图（横向），按毛利排序 --- ### 第六部分：关键发现 #### 6.1 亮点 #### 6.2 关注点 --- ### 附录：数据来源 + 统计口径 + 折算规则 | 数据项 | 数据来源文件 | 关键字段 | 说明 | |--------|------------|---------|------| | 收入/成本/毛利 | 经营管理报表 | 一级科目、月份列 | 管报直接取数 | | B 段箱量 | DTC 明细表 - 全链路视角 | 订单服务项、未去重集装箱箱量 | A+B、A+B+C 归为 B 段 | | C 段箱量 | DTC 明细表 - 全链路视角 | 订单服务项、未去重集装箱箱量 | C、C+D 归为 C 段 | | D 段箱量 | DTC 业务费用根据客户仓库统计表 | 业务月份、入库箱量 | 月末按天数折算 | | 入库柜量 | DTC 业务费用根据客户仓库统计表 | 仓库位置、入库箱量 | 1 柜=2TEU | | 出库件数 | DTC 业务费用根据客户仓库统计表 | 仓库位置、出库总件数 | - | | 客户开发数 | 所有业务收入明细 | 客户名称、业务段 | 需去重 | | 亏损客户 | 所有业务收入明细 + 仓库统计表 | 客户名称、毛利 | 按毛利排序 | **折算规则：** - D 段箱量：如数据截止到 30 日，3 月按 31/30 折算 - 入库柜量：1 条柜 = 2 TEU = 2 箱量 **统计口径：** - B 段箱量：全链路表未去重集装箱箱量 - C 段箱量：全链路表未去重集装箱箱量 - D 段箱量：客户仓库统计表入库箱量（TEU） - 出库件数：客户仓库统计表出库总件数 - 自营仓：需确认仓库类型字段或根据仓库供应商判断 --- ## 脚本使用说明 ### 主脚本：`generate_report.py` ```bash python scripts/generate_report.py --period 2026-03 --output reports/ ``` **参数：** - `--period`: 报告期间（如 2026-03、2026-Q1、2026） - `--output`: 输出目录 - `--format`: 输出格式（html、md、xlsx） ### 数据读取脚本 - `read_mgmt_report.py`: 读取管报数据（收入、成本、毛利） - `read_volume.py`: 读取箱量数据（B/C/D段，含 D 段折算） - `read_budget.py`: 读取预算数据 - `read_customer.py`: 读取客户和销售数据 - `read_warehouse.py`: 读取海外仓数据 --- ## 输出格式 ### HTML 报告（推荐） - 专业样式，适合演示和分享 - 包含交互式图表（如支持） - 响应式设计 ### Markdown 报告 - 简洁版本 - 适合快速查看 ### Excel 报告 - 数据明细 - 适合进一步分析 --- ## 注意事项 1. **数据时效性** - 管报数据通常滞后 1-2 个月 - 业务数据（箱量）更新更及时 - 报告中需标注数据截止日期 2. **口径一致性** - B/C 段箱量来自全链路表（未去重） - D 段箱量来自客户仓库统计表（入库箱量） - 财务数据来自管报 3. **特殊处理** - D 段月末数据需要天数折算 - 客户数需要去重统计 - 内部公司需要排除（前十大客户排名） --- ## 示例 ```bash # 生成 3 月月度报告 python scripts/generate_report.py --period 2026-03 # 生成 Q1 季度报告 python scripts/generate_report.py --period 2026-Q1 # 生成年度报告 python scripts/generate_report.py --period 2025 ``` --- ## 相关文件 - `scripts/generate_report.py`: 主报告生成脚本 - `references/data_rules.md`: 详细取数规则 - `references/report_template.md`: 报告格式模板 - `assets/report_template.html`: HTML 报告模板