1.立项原则：解决图书抖店老板的三个核心痛点——订单数据散在抖店后台看不到全貌、客户身份抓不到没法做私域复购、做完活动不知道效果如何。把抖店订单拉到本地，做经营总览 + 客户八类 RFM 分层，让老板「看一眼就知道今天要做什么」。
2. 行业场景：面向童书绘本 / 教辅 / 文学小说 / 经管励志等中小图书抖店商家。无授权也能用 mock 数据跑通完整驾驶舱，接入 AppKey/Secret 后自动拉真实订单分析；并内置私域方法论（关系飞轮 / 超级用户增长 / 小群效应），把数据洞察翻译成可执行的运营动作。
1. 项目有哪些具体功能模块：
① 经营总览（GMV、支付订单、客单价、可运营客户、复购率、退款/关闭）
② 品类结构（按图书品类拆解 GMV 占比）
③ 客户私域 RFM 分析（八类分层、复购率、流失预警、客户标签）
④ 增长目标拆解（当前值 vs 目标的差距条，4 项订单侧指标已通，3 项私域指标待埋点）
⑤ 活动效果追踪（实测 GMV / 订单 vs 目标）
⑥ 私域诊断（包裹卡扫码率 / 社群转化 / 转介绍，绿色=已通，灰色=待埋点）
⑦ 配套落地页：包裹卡扫码页 / 私域运营中心（7 大能力模块）
2. 项目的主要功能描述：
把抖音店铺订单数据拉到本地，自动算出经营指标 + 客户八类分层，并接入私域方法论（关系飞轮 / 超级用户增长 / 小群效应）指导落地动作。老板「看一眼就知道今天该做什么」。
1. "我"负责哪些具体任务：
独立完成全流程——需求拆解（从「抖店数据散、客户抓不到、私域没动作」三个痛点倒推功能）、架构设计（前后端零依赖、单文件 HTML 看板）、编码（Node 内置 http 服务 + 抖店 API 签名 + RFM 纯函数分析 + 自绘 SVG 看板）、一键启动脚本（Windows bat / macOS sh）、可移植打包（拷到任意电脑双击即跑）、文档撰写（README、报告、专家评审纪要）。
2. 项目使用了哪些技术栈、架构，实现上亮点、难点：
技术栈：Node.js（>=18，ESM）+ 纯内置模块（http / crypto / fs / fetch），前端 HTML + CSS + 自绘 SVG，零第三方依赖。
架构亮点：① 无任何外部 CDN/框架/图表库，离线可用；② RFM 分析与看板解耦，纯函数 + JSON 数据流；③ 抖店 API 自实现 hmac-sha256 签名；④ 一键启动脚本三层 node 路径探测 + 端口冲突自动顺延 + 后台窗口模式（关窗不掉线）。
实现难点：① 抖店订单不含买家 open_id（仅小程序订单有），需走会员通 SPI还原人粒度——已通过字段优先级回退（doudian_open_id → open_id → buyer_id → post_addr.encrypt_detail.open_id → order_id）保证客户分析不丢；② Windows bat 在 GBK 代码页下的中文乱码（"嬁鍏抽棴"），全程改纯 ASCII；③ 桌面 cmd 无 PATH 找不到 node，bat 内置三层路径探测（runtime 内联 / WorkBuddy managed / 系统 PATH）保证任意机器可启。
评论