# 兴邦金租 AI Native 智能决策系统 - 5分钟快速上手

## 🎯 最快启动方式

### Windows用户
```bash
start_xingbang.bat
```

### Linux/Mac用户
```bash
chmod +x start_xingbang.sh
./start_xingbang.sh
```

**就这么简单！** 脚本会自动：
- ✅ 检查Python环境
- ✅ 创建虚拟环境
- ✅ 安装依赖
- ✅ 初始化数据目录
- ✅ 启动后端服务

## 📖 访问系统

启动成功后，打开浏览器访问：

- **API文档**: http://localhost:8002/docs
- **前端界面**: http://localhost:3000/xingbang-unified（需单独启动前端）

## 🧪 快速测试

打开新终端，运行测试脚本：

```bash
python test_xingbang.py
```

测试输出示例：
```
✅ 后端服务运行中
✅ 主审员画像: 4 人
✅ 团队经验: 156 个历史案例
✅ 助手6 测试通过
   推荐主审员: 王芳
   综合评分: 80.9
```

## 🎯 试用功能

### 1. 查询主审员画像

```bash
curl http://localhost:8002/api/xingbang/unified/data/reviewers
```

### 2. 测试主审员智能分配

```bash
curl -X POST http://localhost:8002/api/xingbang/unified/assistant6/allocate \
  -H "Content-Type: application/json" \
  -d '{
    "project_industry": "光伏设备制造",
    "project_amount": 5000,
    "project_complexity": 3
  }'
```

### 3. 查看团队经验库

```bash
curl http://localhost:8002/api/xingbang/unified/data/team-experience
```

## 📚 下一步

- **完整功能**: 参考 `PROJECT_OVERVIEW.md`
- **部署到生产**: 参考 `DEPLOYMENT_GUIDE.md`
- **实施细节**: 参考 `IMPLEMENTATION_REPORT.md`

## ⚙️ 配置ERP连接（可选）

如果需要连接实际ERP数据库：

1. 复制环境变量模板：
```bash
cp backend/.env.example backend/.env
```

2. 编辑 `backend/.env`，填写ERP连接信息：
```ini
ERP_DB_HOST=your_erp_host
ERP_DB_PORT=5432
ERP_DB_NAME=xingbang_erp
ERP_DB_USER=readonly_user
ERP_DB_PASSWORD=your_password
ERP_DB_SSL_MODE=require
```

3. 重启后端服务

**注意**: 不配置ERP时，系统会自动使用Mock数据，功能完全可用。

## 🐳 Docker部署（生产环境）

```bash
# 1. 配置密钥
mkdir -p secrets
echo "your_erp_password" > secrets/erp_db_password.txt
echo "your_deepseek_key" > secrets/deepseek_api_key.txt

# 2. 启动容器
docker-compose up -d

# 3. 查看日志
docker-compose logs -f
```

## ❓ 常见问题

**Q: 端口8002被占用怎么办？**  
A: 编辑 `backend/.env`，修改 `BACKEND_PORT=8002` 为其他端口

**Q: 没有DeepSeek API Key可以用吗？**  
A: 部分助手需要LLM，建议先注册DeepSeek API（免费额度够测试用）

**Q: 前端页面空白？**  
A: 确保在项目根目录运行 `npm run dev` 启动前端

**Q: 数据会丢吗？**  
A: 所有数据存在 `backend/xingbang_data/` 目录，持久化保存

## 📞 获取帮助

查看完整文档：
- `PROJECT_OVERVIEW.md` - 项目总览
- `DEPLOYMENT_GUIDE.md` - 部署指南
- `IMPLEMENTATION_REPORT.md` - 实施报告