# JDPython

**Repository Path**: I-loveme/jdpython

## Basic Information

- **Project Name**: JDPython
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 酒店 AI 四阶渐进实训系统

基于 ERPNext + FastAPI BFF + Vue3 的酒店 AI 实训平台，分四阶递进实现 Pipeline → Dify 工作流 → LangGraph Agent → CrewAI 多 Agent 协同。

## 项目结构

```
jdpython/
├── infra/              # 底层基建（李昊璋）— ERP、AI 服务、数据脚本
├── lab-server/         # FastAPI BFF 中间层（马兴桦）
├── lab-web/            # Vue3 前端（张子煜）
└── docs/               # 测试与交付文档（程佳欣）
```

## 开发顺序

1. **第一阶段**：底层部署 + 服务/前端骨架
2. **第二阶段**：四阶 API 与页面对接
3. **第三阶段**：全员自测
4. **第四阶段**：文档整合归档

## 快速启动

详见 [infra/docs/底层服务启动命令清单.md](infra/docs/底层服务启动命令清单.md)

### Windows（PowerShell，在项目根目录执行）

```powershell
# 0. 一键检查环境 + 安装依赖（推荐）
.\setup.ps1

# 1. 启动 ERP + AI 底层服务（需先安装 Docker Desktop）
.\infra\scripts\start_all.ps1

# 2. 填充数据 & 体检
py infra\scripts\seed_hotel.py
py infra\scripts\data_audit.py

# 3. 启动 BFF（马兴桦）
cd lab-server
py -m pip install -r requirements.txt
py -m uvicorn app.main:app --reload

# 4. 启动前端（张子煜）
cd lab-web
npm install
npm run dev
```

> **注意**：Windows 上请用 `py -m pip` 代替 `pip`，用 `py` 代替 `python`（若 PATH 未配置）。

### Linux / macOS

```bash
pip install -r infra/requirements.txt
bash infra/scripts/start_all.sh
python infra/scripts/seed_hotel.py
```

## 团队成员

| 成员   | 模块                          |
|--------|-------------------------------|
| 李昊璋 | ERP 底座 + 数据层 + AI 底层   |
| 马兴桦 | FastAPI BFF 四阶接口          |
| 张子煜 | Vue3 四阶页面                 |
| 程佳欣 | 全流程测试 + 文档整合         |

## 技术栈约束

- ERP：ERPNext / frappe_docker + Hospitality（PlanB 自定义 DocType）
- LLM：Ollama qwen2.5:7b
- 工作流：Dify
- 可观测：Langfuse
- BFF：FastAPI
- 前端：Vite + Vue3 + Element Plus