## AIPlanetHub 项目介绍

**AIPlanetHub**（仓库名 VisitorHub）是 [AIPlanet](https://ai.aiplanet.me) 的增长与转化追踪中台，部署在 `ad.aiplanet.me`，与主站 `ai.aiplanet.me` 协同，覆盖从投放曝光到注册、充值的全链路数据闭环。

### 解决什么问题

多渠道推广时，团队往往难以回答：流量从哪来、哪条文案有效、谁最终注册或付费。AIPlanetHub 把这些问题产品化：为每条推广文案生成可追踪短链，记录访问与设备信息，再通过 Business API 把主站业务行为回写到同一访客画像，在后台形成可分析的漏斗。

### 核心能力

**短链与渠道归因**
支持微信、小红书、抖音、闲鱼、哔哩哔哩、知乎等十余个渠道，短链形如 `https://ad.aiplanet.me/?s=w5`（字母表渠道、数字表文案 ID）。用户点击后记录来源、文案、设备、语言等信息，并 302 跳转到预设落地页（如 `https://ai.aiplanet.me/?ref=N`）。

**虚拟用户与转化追踪**
通过 Cookie `vh_vid` 跨次访问识别同一访客；主站在注册、创建 API Key、充值、兑换等节点调用 `/api/v1/business/events` 上报，系统把业务转化与投放来源关联，支撑渠道漏斗、核心指标与效果预估。

**管理后台**
提供 React 新版控制台（`/api/v1/admin/app`）与经典 HTML 后台并存。功能包括链接/文案管理、访问统计、渠道占比、虚拟用户画像、付费推广、定价对比，以及基于 Tool Calling 的 **AI 分析助手**，辅助解读数据。Help 页还集成 RAG 智能客服，解答接入与使用问题。

**销售门户**
面向一线销售的独立 SPA：密钥登录、每日任务填报（开发/推广/测试等类型）、推广任务可绑定渠道与短链、查看今日访问/注册/充值成效，以及「我的链接」自助创建与管理投放短链，备注自动关联销售姓名，与后台逻辑一致。