mini-openclaw/QUICK_START.md

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

🎯 最快启动方式

Windows用户

start_xingbang.bat

Linux/Mac用户

chmod +x start_xingbang.sh
./start_xingbang.sh

就这么简单！ 脚本会自动：

• ✅ 检查Python环境
• ✅ 创建虚拟环境
• ✅ 安装依赖
• ✅ 初始化数据目录
• ✅ 启动后端服务

📖 访问系统

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

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

🧪 快速测试

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

python test_xingbang.py

测试输出示例：

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

🎯 试用功能

1. 查询主审员画像

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

2. 测试主审员智能分配

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. 查看团队经验库

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

📚 下一步

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

⚙️ 配置ERP连接（可选）

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

1. 复制环境变量模板：

cp backend/.env.example backend/.env

2. 编辑 backend/.env，填写ERP连接信息：

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部署（生产环境）

# 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 - 实施报告