100 lines
4.5 KiB
Markdown
100 lines
4.5 KiB
Markdown
|
# 项目经验库：知己与类似项目（卡若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 + 上表文档。*
|