fnvtk/users
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor: restructure navigation and module layout

Browse Source 
Reorganize navigation and module structure based on new requirements.

Co-authored-by: null <4804959+fnvtk@users.noreply.github.com>
This commit is contained in:
v0
2026-01-31 04:32:36 +00:00
parent 22e725887a
commit b17b488f8e
105 changed files with 20530 additions and 3622 deletions
Download Patch File Download Diff File Expand all files Collapse all files

374
开发文档/需求文档-五部分汇总.md
View File

@@ -1,374 +0,0 @@
# 神射手系统 - 需求文档汇总（五部分）
> 更新时间：2026-01-31
> 来源：第一部分.html ~ 第五部分.html 原始需求截图
---
## 一、系统概述
### 1.1 产品定位
神射手是一个**AI数智员工系统**，面向私域运营场景，提供：
- 数据资产管理与价值评估
- 用户画像与标签体系
- AI智能分析与自动化执行
- 跨平台数据整合（微信、抖音、小红书等）
### 1.2 核心能力
| 能力 | 说明 |
|------|------|
| 数据采集 | 多渠道数据接入（API、CSV、WebHook） |
| 数据清洗 | 标准化、去重、格式校正 |
| RFM评分 | R（最近活跃）F（频率）M（金额）三维评估 |
| AI标签 | 情绪、意图、行为、生命周期标签自动生成 |
| 价值分层 | S/A/B/C/D 五级用户价值分层 |
| 智能执行 | 自动触达、任务编排、SOP执行 |
---
## 二、导航结构（5大模块）
```
神射手数据资产中台
├── 首页（概览）
│ ├── 数据总览卡片（用户资产、活跃用户、数据量、资产价值）
│ ├── 用户增长趋势图
│ ├── 价值分布饼图
│ ├── 实时动态流
│ └── 快速搜索入口
│
├── 数据中台
│ ├── 数据源管理
│ │ ├── 微信数据源
│ │ ├── 抖音数据源
│ │ ├── 小红书数据源
│ │ ├── CRM数据源
│ │ └── 自定义API
│ ├── 数据清洗
│ │ ├── 清洗规则配置
│ │ ├── 清洗任务监控
│ │ └── 清洗日志
│ ├── 标签管理
│ │ ├── 系统标签（预置）
│ │ ├── 自定义标签
│ │ └── 标签规则引擎
│ └── 数据质量
│ ├── 质量报告
│ └── 异常告警
│
├── 用户画像
│ ├── 用户列表
│ │ ├── 高级筛选（RFM/标签/状态）
│ │ ├── 批量操作
│ │ └── 导出功能
│ ├── 用户详情
│ │ ├── 基本信息
│ │ ├── 行为轨迹
│ │ ├── 标签画像
│ │ ├── RFM评分
│ │ └── AI洞察
│ ├── 群体分析
│ │ ├── 群体画像
│ │ ├── 群体对比
│ │ └── 群体趋势
│ └── 标签体系
│ ├── 用户价值标签
│ ├── 行为偏好标签
│ ├── 生命周期标签
│ └── 自定义标签
│
├── 价值评估
│ ├── RFM模型
│ │ ├── 评分配置（权重调整）
│ │ ├── 分层策略
│ │ └── 评分结果
│ ├── LTV模型
│ │ ├── 生命周期价值预测
│ │ └── 价值趋势
│ ├── 项目价值
│ │ ├── 项目价值排名
│ │ └── 项目ROI分析
│ └── 价值报告
│ ├── 周期报告
│ └── 导出分享
│
└── AI助手
├── 数据分析
│ ├── 智能问答
│ ├── 数据洞察
│ └── 报告生成
├── 趋势预测
│ ├── 用户增长预测
│ ├── 流失预警
│ └── 商机预测
├── 用户画像（AI增强）
│ ├── 自动标签生成
│ ├── 行为分析
│ └── 偏好识别
└── 精准推荐
├── 营销方案推荐
├── 目标群体推荐
└── 内容推荐
```
---
## 三、第一部分需求（数据概览 + 用户流池）
### 3.1 数据概览（上半部分）
| 指标 | 说明 | 数据来源 |
|------|------|----------|
| 用户资产总量 | 40亿+ | 全平台汇总 |
| 今日活跃用户 | 实时计算 | 行为日志 |
| 数据处理量 | 累计处理条数 | ETL统计 |
| 资产总价值 | 估算价值 | LTV模型 |
### 3.2 用户流池（下半部分）
- **流量来源分布**：微信、抖音、小红书、其他
- **用户状态分布**：高价值、活跃、沉默、流失预警、新增
- **实时数据流**：最近操作动态
---
## 四、第二部分需求（数据中台核心）
### 4.1 数据源管理
| 数据源 | 接入方式 | 状态 |
|--------|----------|------|
| 微信好友 | API | 已连接 |
| 抖音粉丝 | WebHook | 已连接 |
| 小红书 | CSV导入 | 待配置 |
| 企业CRM | 数据库直连 | 已连接 |
### 4.2 数据清洗规则
- 手机号格式校验（11位）
- 邮箱格式校验
- 重复数据合并
- 空值填充策略
- 异常值处理
### 4.3 标签体系
```
标签体系
├── 用户价值
│ ├── 高价值用户（月消费>500）
│ ├── 中价值用户（月消费100-500）
│ └── 低价值用户（月消费<100）
├── 活跃度
│ ├── 高活跃（7天内活跃）
│ ├── 中活跃（30天内活跃）
│ └── 低活跃（30天+未活跃）
├── 消费行为
│ ├── 复购用户
│ ├── 首购用户
│ └── 潜在用户
├── 兴趣偏好
│ ├── 电商
│ ├── 内容
│ └── 社交
├── 生命周期
│ ├── 新用户
│ ├── 成长期
│ ├── 成熟期
│ ├── 衰退期
│ └── 流失期
├── 地域分布
│ ├── 一线城市
│ ├── 二线城市
│ └── 其他
├── 设备偏好
│ ├── iOS
│ ├── Android
│ └── 其他
└── 社交属性
├── KOL
├── KOC
└── 普通用户
```
---
## 五、第三部分需求（用户画像详情）
### 5.1 用户详情页结构
```
用户详情页
├── 头部
│ ├── 头像 + 昵称
│ ├── 联系方式（脱敏）
│ ├── 价值等级（S/A/B/C/D）
│ └── 操作按钮（编辑/触达/加群）
├── RFM评分卡
│ ├── R评分（最近活跃）
│ ├── F评分（行为频率）
│ ├── M评分（累计金额）
│ └── 综合评分
├── 标签画像
│ ├── 系统标签
│ └── 自定义标签
├── 行为轨迹
│ ├── 时间线视图
│ └── 行为统计
├── 关联账号
│ ├── 微信号
│ ├── 抖音号
│ └── 其他平台
└── AI洞察
├── 用户画像总结
├── 下一步建议
└── 风险提示
```
### 5.2 群体分析
- 群体筛选条件组合
- 群体画像对比
- 群体趋势分析
- 群体导出与触达
---
## 六、第四部分需求（AI Agent智能系统）
### 6.1 AI Agent核心架构
```
AI Agent 智能系统
├── 输入层：用户交互
│ ├── 文字输入
│ ├── 语音输入
│ └── 预设指令
├── 理解层：意图识别
│ ├── NLU解析
│ ├── 意图分类
│ ├── 参数提取
│ └── 上下文理解
├── 决策层：智能分析
│ ├── 数据查询
│ ├── 趋势预测
│ ├── 异常检测
│ └── 推荐生成
├── 执行层：任务执行
│ ├── 数据导出
│ ├── 报告生成
│ ├── 消息推送
│ └── 任务编排
└── 输出层：结果呈现
├── 文字回复
├── 图表展示
└── 操作确认
```
### 6.2 支持的指令类型
| 类型 | 示例 |
|------|------|
| 查询类 | "查看高价值用户数量" |
| 筛选类 | "找出最近7天未登录的用户" |
| 分析类 | "分析本月用户流失原因" |
| 预测类 | "预测下个月的活跃用户数" |
| 执行类 | "给流失预警用户发送优惠券" |
| 报告类 | "生成本周数据分析报告" |
### 6.3 业务场景示例
```
场景：游戏用户时长大幅下滑
用户输入：
"帮我找到最近100个30岁以上、玩过主营等级、最近7天有登录的用户，导出到Excel"
AI处理流程：
1. 意图识别 → 筛选导出
2. 参数提取 → 年龄>30, 等级>主营, 活跃<7天
3. 数据查询 → 匹配823条
4. 确认操作 → 用户确认
5. 执行导出 → 生成Excel
执行结果：
- 符合条件用户：823人
- 导出文件：用户数据_20260131.xlsx
- 效率提升：104倍
```
---
## 七、第五部分需求（价值评估体系）
### 7.1 RFM模型配置
| 维度 | 权重 | 评分规则 |
|------|------|----------|
| R（Recency） | 35% | 1-5分，越近越高 |
| F（Frequency） | 30% | 1-5分，越频繁越高 |
| M（Monetary） | 35% | 1-5分，金额越大越高 |
### 7.2 价值分层
| 等级 | 综合分 | 占比 | 策略 |
|------|--------|------|------|
| S级 | 13-15 | 5% | VIP服务 |
| A级 | 10-12 | 15% | 重点维护 |
| B级 | 7-9 | 35% | 常规运营 |
| C级 | 4-6 | 30% | 激活唤醒 |
| D级 | 1-3 | 15% | 流失挽回 |
### 7.3 LTV预测
- 基于历史消费数据
- 结合行为频率
- 考虑生命周期阶段
- 输出未来12个月预测价值
---
## 八、技术实现要点
### 8.1 前端架构
- Next.js 14 (App Router)
- React 18
- TypeScript
- Tailwind CSS
- shadcn/ui组件库
- Recharts图表库
### 8.2 后端架构
- Next.js API Routes
- 数据库：MySQL/MongoDB
- 缓存：Redis
- AI：AI SDK（OpenAI/自研模型）
### 8.3 API接口规范
```
/api/users - 用户管理
/api/rfm/* - RFM评分
/api/tags/* - 标签管理
/api/data-source/* - 数据源管理
/api/ai/* - AI能力
/api/report/* - 报告生成
```
---
## 九、开发里程碑
| 阶段 | 内容 | 状态 |
|------|------|------|
| M1 | 首页概览 + 导航框架 | 进行中 |
| M2 | 数据中台（数据源、标签） | 待开始 |
| M3 | 用户画像（列表、详情） | 部分完成 |
| M4 | 价值评估（RFM、LTV） | 待开始 |
| M5 | AI助手（分析、预测） | 待开始 |
| M6 | 系统优化与测试 | 待开始 |
---
## 十、附录
### 10.1 术语表
| 术语 | 说明 |
|------|------|
| RFM | Recency-Frequency-Monetary模型 |
| LTV | Life Time Value，用户生命周期价值 |
| KOL | Key Opinion Leader，关键意见领袖 |
| KOC | Key Opinion Consumer，关键意见消费者 |
| SOP | Standard Operating Procedure，标准操作流程 |
### 10.2 参考文档
- PRD文档：《神射手系统》产品需求文档 (PRD) V1.0
- 技术选型：技术选型.pdf
- 执行路径：执行路径.pdf
- 需求池：木：需求池管理_存客宝.csv