138 lines
2.9 KiB
Markdown
138 lines
2.9 KiB
Markdown
# 兴邦金租 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` - 实施报告
|