177 lines
4.0 KiB
Markdown
177 lines
4.0 KiB
Markdown
# iConsulting - 香港移民在线咨询系统
|
|
|
|
基于 Claude Agent SDK 的智能在线客服系统，专注于提供香港移民咨询服务。
|
|
|
|
## 功能特性
|
|
|
|
- **智能咨询**: 基于 Claude Agent SDK 的自然语言对话
|
|
- **付费评估**: 移民资格评估服务，支持支付宝/微信/信用卡
|
|
- **知识增强**: RAG + Neo4j 知识图谱
|
|
- **自我进化**: 从对话中学习，根据管理员指令调整
|
|
- **长期记忆**: 基于时间线的知识图谱记录
|
|
- **多端支持**: PC Web / H5 响应式设计
|
|
|
|
## 支持的移民类别
|
|
|
|
1. **优才计划 (QMAS)** - 行业翘楚、精英人士
|
|
2. **专才计划 (GEP)** - 专业人才
|
|
3. **留学IANG** - 非本地毕业生
|
|
4. **高才通 (TTPS)** - 高端人才
|
|
5. **投资移民 (CIES)** - 投资者
|
|
6. **科技人才 (TechTAS)** - 科技领域人才
|
|
|
|
## 技术架构
|
|
|
|
```
|
|
├── 前端 (Clean Architecture)
|
|
│ ├── React 18 + TypeScript
|
|
│ ├── TailwindCSS + Radix UI
|
|
│ └── Zustand + React Query
|
|
│
|
|
├── 后端 (DDD + Hexagonal + 微服务)
|
|
│ ├── NestJS
|
|
│ ├── Claude Agent SDK
|
|
│ └── TypeORM
|
|
│
|
|
└── 基础设施
|
|
├── PostgreSQL + pgvector (RAG)
|
|
├── Neo4j (知识图谱)
|
|
├── Redis (缓存)
|
|
└── Kafka (消息队列)
|
|
```
|
|
|
|
## 项目结构
|
|
|
|
```
|
|
iconsulting/
|
|
├── packages/
|
|
│ ├── shared/ # 共享类型、常量、工具
|
|
│ ├── web-client/ # 用户端 Web 应用
|
|
│ ├── admin-client/ # 管理端 Web 应用
|
|
│ └── services/ # 后端微服务
|
|
│ ├── api-gateway/ # API 网关
|
|
│ ├── user-service/ # 用户服务
|
|
│ ├── conversation-service/ # 对话服务 (核心)
|
|
│ ├── knowledge-service/ # 知识服务
|
|
│ ├── payment-service/ # 支付服务
|
|
│ ├── admin-service/ # 管理服务
|
|
│ └── evolution-service/ # 进化服务
|
|
│
|
|
├── infrastructure/
|
|
│ └── docker/ # Docker 配置
|
|
│
|
|
├── DEVELOPMENT_GUIDE.md # 详细开发指导
|
|
└── README.md
|
|
```
|
|
|
|
## 快速开始
|
|
|
|
### 1. 安装依赖
|
|
|
|
```bash
|
|
# 安装 pnpm (如果没有)
|
|
npm install -g pnpm
|
|
|
|
# 安装项目依赖
|
|
pnpm install
|
|
```
|
|
|
|
### 2. 启动基础设施
|
|
|
|
```bash
|
|
# 启动 Docker 容器 (PostgreSQL, Neo4j, Redis, Kafka)
|
|
pnpm docker:dev
|
|
```
|
|
|
|
### 3. 配置环境变量
|
|
|
|
```bash
|
|
# 复制环境变量示例文件
|
|
cp .env.example .env
|
|
|
|
# 编辑 .env 文件，填入必要的配置
|
|
# 特别是 ANTHROPIC_API_KEY
|
|
```
|
|
|
|
### 4. 运行数据库迁移
|
|
|
|
```bash
|
|
pnpm db:migrate
|
|
```
|
|
|
|
### 5. 启动开发服务器
|
|
|
|
```bash
|
|
# 启动所有服务
|
|
pnpm dev
|
|
```
|
|
|
|
访问:
|
|
- 用户端: http://localhost:5173
|
|
- 管理端: http://localhost:5174
|
|
- API: http://localhost:3000
|
|
|
|
## 环境变量
|
|
|
|
关键配置项:
|
|
|
|
```env
|
|
# Claude API
|
|
ANTHROPIC_API_KEY=sk-ant-xxx
|
|
|
|
# 数据库
|
|
POSTGRES_HOST=localhost
|
|
POSTGRES_PORT=5432
|
|
POSTGRES_USER=iconsulting
|
|
POSTGRES_PASSWORD=your_password
|
|
POSTGRES_DB=iconsulting
|
|
|
|
# Neo4j
|
|
NEO4J_URI=bolt://localhost:7687
|
|
NEO4J_USER=neo4j
|
|
NEO4J_PASSWORD=your_password
|
|
|
|
# 支付 (支付宝/微信)
|
|
ALIPAY_APP_ID=xxx
|
|
WECHAT_APP_ID=xxx
|
|
```
|
|
|
|
完整配置请参考 `.env.example`
|
|
|
|
## 开发指南
|
|
|
|
详细的开发指导请参考 [DEVELOPMENT_GUIDE.md](./DEVELOPMENT_GUIDE.md)
|
|
|
|
## 开发进度
|
|
|
|
### 已完成
|
|
|
|
- [x] 项目架构设计
|
|
- [x] 开发指导文档
|
|
- [x] Monorepo 配置
|
|
- [x] 共享类型定义
|
|
- [x] Docker 基础设施配置
|
|
- [x] 数据库 Schema
|
|
- [x] 对话服务 (Claude Agent SDK 集成)
|
|
- [x] 用户端前端基础框架
|
|
|
|
### 进行中
|
|
|
|
- [ ] 用户服务
|
|
- [ ] 知识服务 (RAG + Neo4j)
|
|
- [ ] 支付服务
|
|
- [ ] 管理服务 (自我进化)
|
|
- [ ] 管理后台前端
|
|
|
|
## 贡献指南
|
|
|
|
1. Fork 本仓库
|
|
2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
|
|
3. 提交更改 (`git commit -m 'Add some amazing feature'`)
|
|
4. 推送到分支 (`git push origin feature/amazing-feature`)
|
|
5. 创建 Pull Request
|
|
|
|
## 许可证
|
|
|
|
私有项目，保留所有权利。
|