feat: expand AI workflow support and refresh docs
This commit is contained in:
134
README.md
Normal file
134
README.md
Normal file
@@ -0,0 +1,134 @@
|
||||
# DesignerCEP 项目文档(当前仓库版)
|
||||
|
||||
本仓库是一个包含前端、后端、管理工具和 PLT 处理服务的多模块项目。
|
||||
|
||||
## 1. 模块说明
|
||||
|
||||
| 模块 | 路径 | 技术栈 | 用途 |
|
||||
|---|---|---|---|
|
||||
| Designer | `Designer/` | Vue3 + Vite + TS | 主前端/CEP 面板 |
|
||||
| AdminPanel | `AdminPanel/` | Vue3 + Vite + TS | 管理面板前端 |
|
||||
| Server | `Server/` | FastAPI + SQLAlchemy | 主后端 API |
|
||||
| AdminTool | `AdminTool/` | PyQt5 + Paramiko | 管理/部署 GUI 工具 |
|
||||
| PltService | `PltService/` | FastAPI + OpenCV + Shapely | 独立 PLT 裁片处理服务 |
|
||||
|
||||
## 2. 推荐环境
|
||||
|
||||
- Node.js 18+
|
||||
- Python 3.12(与 `Server/Dockerfile` 保持一致)
|
||||
- Docker + Docker Compose(用于后端容器部署)
|
||||
|
||||
## 3. 快速本地启动
|
||||
|
||||
### 3.1 启动后端(Server)
|
||||
|
||||
```bash
|
||||
cd Server
|
||||
pip install -r requirements.txt
|
||||
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
|
||||
```
|
||||
|
||||
健康检查:
|
||||
|
||||
```bash
|
||||
curl http://localhost:8000/health
|
||||
```
|
||||
|
||||
### 3.2 启动主前端(Designer)
|
||||
|
||||
```bash
|
||||
cd Designer
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
默认开发地址:`http://localhost:5173`
|
||||
|
||||
### 3.3 启动管理前端(AdminPanel)
|
||||
|
||||
```bash
|
||||
cd AdminPanel
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
默认开发地址:`http://localhost:5180`
|
||||
|
||||
### 3.4 启动管理工具(AdminTool,可选)
|
||||
|
||||
```bash
|
||||
cd AdminTool
|
||||
pip install -r requirements.txt
|
||||
python admin_gui.py
|
||||
```
|
||||
|
||||
仅进入部署页:
|
||||
|
||||
```bash
|
||||
python deploy_tool.py
|
||||
```
|
||||
|
||||
### 3.5 启动 PLT 微服务(可选)
|
||||
|
||||
```bash
|
||||
cd PltService
|
||||
pip install -r requirements.txt
|
||||
python main.py
|
||||
```
|
||||
|
||||
默认端口:`8080`
|
||||
|
||||
## 4. 构建说明
|
||||
|
||||
### Designer
|
||||
|
||||
```bash
|
||||
cd Designer
|
||||
npm run build
|
||||
```
|
||||
|
||||
产物目录:`Designer/dist_core/`
|
||||
|
||||
### AdminPanel
|
||||
|
||||
```bash
|
||||
cd AdminPanel
|
||||
npm run build
|
||||
```
|
||||
|
||||
产物目录:`AdminPanel/dist/`
|
||||
|
||||
## 5. 后端 Docker 部署(Server)
|
||||
|
||||
```bash
|
||||
cd Server
|
||||
docker-compose up -d --build
|
||||
docker-compose ps
|
||||
```
|
||||
|
||||
## 6. 配置与安全说明
|
||||
|
||||
- 运行配置请优先参考 `Server/.env.example`,再在本地复制为 `Server/.env`。
|
||||
- `Server/.env` 中包含核心配置(数据库、密钥、邮件、AI 服务等)。
|
||||
- 当前仓库中的 `.env` 若包含真实密钥,不适合继续共享。建议立即轮换所有密钥,并改为仅保留 `.env.example` 模板。
|
||||
- 生产环境请务必修改:
|
||||
- `SECRET_KEY`
|
||||
- `ADMIN_TOKEN`
|
||||
- 数据库账号密码
|
||||
- AI/云存储密钥
|
||||
|
||||
## 7. 数据库迁移
|
||||
|
||||
- 正式环境推荐使用 Alembic:`cd Server && .venv\Scripts\python -m alembic upgrade head`
|
||||
- 本地 SQLite 仍保留轻量补列兜底逻辑,但它只适合开发调试
|
||||
- 迁移细节见 `Server/migrations/README.md`
|
||||
|
||||
## 8. 备注
|
||||
|
||||
- 旧文档里提到的 `auto_deploy_core.py`、`npm run build:core` 与当前代码不一致,已以本文件和各子模块 README 为准。
|
||||
|
||||
## 9. 最近前端更新(2026-03-09)
|
||||
|
||||
- `Designer` 登录页已支持“记住账号 / 记住密码”。
|
||||
- `Designer` 个人中心已做风格统一,移除顶部统计卡片,减少视觉干扰。
|
||||
- `Designer` AI 助手已开始拆分为头部 / 消息流 / 输入区组件,工具状态改为按会话隔离。
|
||||
Reference in New Issue
Block a user