# compassai

**Repository Path**: git4rocking/compassai

## Basic Information

- **Project Name**: compassai
- **Description**: 智能保顾平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-19
- **Last Updated**: 2026-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CompassAI / 智能保顾

CompassAI 是一款面向 C 端客户的智能保险顾问 APP 原型，目标是通过对话式需求收集、保障缺口分析、产品匹配、方案生成和投保衔接，为客户提供一体化保险服务。

## 文档入口

- [需求分析文档](docs/requirements-analysis.md)
- [推荐架构方案](docs/recommended-architecture.md)
- [模块设计文档](docs/module-design.md)
- [多智能体编排设计](docs/agent-orchestration-design.md)
- [数据库设计](docs/database-design.md)
- [产品库维护与审核设计](docs/product-catalog-maintenance-design.md)

## 当前技术方向

- C 端 APP：React Native + Expo。
- 管理后台：React + TypeScript。
- 业务主后端：Java + Spring Boot。
- AI 服务：Python + FastAPI。
- 数据库：PostgreSQL。
- 缓存与队列：Redis 起步，后续按需要引入 RabbitMQ/Kafka。

## 本地运行

推荐使用统一脚本管理本地开发服务：

```bash
./scripts/dev-services.sh start
./scripts/dev-services.sh status
./scripts/dev-services.sh stop
```

脚本会管理：

- 业务主后端：`http://localhost:8881`
- AI 服务：`http://localhost:8882`
- 管理后台服务端预留：`http://localhost:8883`
- 管理控台：`http://localhost:8001`
- 移动端原型：`http://localhost:8002`

日志输出到 `.dev/logs/`。

移动端原型：

```bash
cd apps/mobile
npm run web
```

当前登录会调用业务主后端的模拟认证接口，验证码固定为 `123456`，密码登录需输入至少 6 位密码。

业务主后端：

```bash
cd services/core-api
mvn -s settings.xml -Dmaven.repo.local=.m2/repository spring-boot:run
```

默认端口：`8881`。当前使用 PostgreSQL 保存用户、会话、画像和本体数据。

已提供的原型接口：

- `POST /api/app/auth/code-login`
- `POST /api/app/auth/password-login`
- `POST /api/app/auth/wechat-login`
- `GET /api/products`
- `GET /api/admin/products`
- `POST /api/admin/products`
- `PUT /api/admin/products/{id}`
- `DELETE /api/admin/products/{id}`

管理控台：

```bash
cd apps/admin
npm install
npm run dev
```

默认端口：`8001`。模拟账号：`admin / admin123`。

AI 服务：

```bash
cd services/ai-service
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8882
```