# 项目经验库：知己与类似项目（卡若AI 全栈开发参考）

> 知己项目在开发过程中沉淀的**核心代码结构、分销机制、管理机制、AI 向量化**及 Skill 开发经验，供卡若AI 开发类似项目时直接参考。  
> 主责吸收：**火炬（全栈开发）**；协同：水泉（项目管理）、金盾（存客宝）、土基（分销）。

---

## 一、分配与协同

| 亮点 | 主责 | 协同 | 已落地 |
|:---|:---|:---|:---:|
| 开发文档 10 目录制 | 火炬 | 水泉 | ✅ 项目开发能力_来自知己 |
| 项目截图自动化 | 火炬 | - | ✅ 全栈开发、项目开发能力 |
| 多 Agent 板块拆分 | 水泉 | 火炬 | ✅ 多Agent与板块拆分 |
| 存客宝获客整合 | 金盾 | 火炬 | ✅ 项目开发中整合存客宝获客功能 |
| 分销机制 | 火炬 | 土基 | 本 reference |
| 管理机制 | 水泉 | 火炬 | ✅ 项目开发能力 |
| AI 向量化 / RAG | 火炬 | - | 本 reference + 全栈开发 SKILL |

---

> **全栈开发 Skill**：`04_卡火（火）/_团队成员/火炬/全栈开发/SKILL.md` — 开发类似项目时自动激活。

---

## 二、核心代码结构（知己）

```
知己开发/
├── app/                    # Next.js App Router
│   ├── page.tsx            # SPA 主入口（activeTab 管理）
│   ├── api/                # API Routes
│   │   ├── booking/        # 预约订单（手机号+支付+存客宝触发）
│   │   ├── cunkebao/       # 存客宝任务、回调
│   │   ├── chat/           # AI 对话（RAG）
│   │   ├── distribution/   # 分销注册、佣金、提现
│   │   └── admin/          # 管理后台 API
│   └── admin/              # 管理后台页面
├── components/             # 页面组件
│   ├── home-page, chat-page, consultant-page, profile-page
│   ├── distribution-page   # 分销中心
│   └── bottom-nav          # 底部导航
├── lib/
│   ├── mongodb.ts          # MongoDB 连接
│   ├── rag.ts              # RAG 检索引擎（向量化+检索）
│   ├── cunkebao.ts         # 存客宝线索上报
│   ├── distribution/       # 分销服务（绑定、佣金、提现）
│   ├── profit-sharing/     # 空中分账
│   └── payment/            # 支付模块
└── scripts/
    ├── screenshot-ui.mjs   # UI 全量截图
    └── vectorize-knowledge.mjs  # 知识库向量化
```

---

## 三、分销机制（知己实现）

- **规则**：一级 20%、二级 10%；30 天绑定；7 天后结算；最低提现 10 元。
- **核心**：`lib/distribution/service.ts`（申请分销员、绑定推荐、佣金计算、提现）。
- **空中分账**：`lib/profit-sharing/service.ts`（按商品类型分账：咨询师 60%、平台 40% 等）。
- **API**：`app/api/distribution/`、`app/api/referral/bind/`。
- **类似项目**：复制 distribution + profit-sharing 目录，改比例与集合名即可。

---

## 四、管理机制（已沉淀）

- **端口管理**：启动前 `lsof -i :端口` 检查，占用则清理。
- **附件管理**：截图/设计稿 → `开发文档/10、项目管理/附件/` 并登记索引。
- **经验沉淀**：踩坑/方案 → `references/experience-log.md`。
- **复盘格式**：目标&结果、过程、反思、总结、下一步。  
→ 见 `项目开发能力_来自知己`

---

## 五、AI 向量化 / RAG（知己实现）

- **RAG 检索引擎**：`lib/rag.ts`  
  - OpenAI Embeddings（text-embedding-3-small，1536 维）  
  - MongoDB 存储向量；余弦相似度检索；未配置 Key 时用占位向量（开发可跑通）
- **知识库管理**：`app/admin/knowledge/`（导入、向量化、检索）。  
- **向量化脚本**：`scripts/vectorize-knowledge.mjs`（批量生成 embedding 写回库）。  
- **类似项目**：复制 rag.ts + 知识库 API + vectorize 脚本，改集合名与分类即可。

---

## 六、已吸收的 reference 一览

| 文档 | 用途 |
|:---|:---|
| 项目开发能力_来自知己 | 10 目录、端口、附件、截图、经验、复盘 |
| 项目开发中整合存客宝获客功能 | 获客型项目：指定 Key、线索上报、添加好友 |
| 十目录与五行界定 | 十目录界定、五行映射、多 Agent 拆分输入 |
| **本 reference** | **知己核心代码、分销、AI 向量化、经验分配** |

---

*主责：火炬（全栈开发）；协同：水泉、金盾、土基。开发类似项目时优先读本 reference + 上表文档。*