# coze-admin

**Repository Path**: code_3gsword/coze-admin

## Basic Information

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

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Coze Admin - 智能体管理 & 对话系统

> FastAPI + Bootstrap 5 + Coze API

## 快速开始

### 1. 用 VS Code 打开项目

```
File → Open Folder → 选择 coze-admin 目录
```

### 2. 初始化环境

VS Code 打开后，按 `Ctrl+Shift+B` 执行 **「初始化环境」** 任务，会自动：
- 创建 Python 虚拟环境（`.venv`）
- 安装所有依赖

或手动执行：
```powershell
python -m venv .venv
.venv\Scripts\pip.exe install -r requirements.txt
```

### 3. 配置数据库

```powershell
# 复制环境变量模板
copy backend\.env.example backend\.env

# 编辑 .env 填写数据库密码
notepad backend\.env
```

在 MySQL 中执行建库脚本：
```sql
source sql/schema.sql
```

### 4. 启动开发

**方式 A：VS Code 调试（推荐）**
- 按 `F5` → 选择 **「FastAPI 后端 (开发模式)」**
- 支持热重载，修改代码自动重启

**方式 B：终端启动**
```powershell
.venv\Scripts\python.exe -m uvicorn main:app --host 0.0.0.0 --port 8000 --reload --app-dir backend
```

**方式 C：一键脚本**
```powershell
.\start.bat
```

### 5. 访问页面

| 页面 | 地址 | 说明 |
|------|------|------|
| 前台登录 | http://localhost:8000/ | 普通用户入口 |
| 智能体聊天 | http://localhost:8000/chat | 登录后跳转 |
| 后台登录 | http://localhost:8000/admin-login | 管理员入口 |
| 后台管理 | http://localhost:8000/app | 管理面板 |
| API 文档 | http://localhost:8000/api/docs | Swagger UI |

默认账号：`admin / admin123`

---

## 项目结构

```
coze-admin/
├── backend/               FastAPI 后端
│   ├── main.py            入口 + 页面路由
│   ├── config.py          配置加载
│   ├── database.py        数据库连接
│   ├── models.py          ORM 模型
│   ├── schemas.py         Pydantic Schema
│   ├── auth.py            JWT 认证
│   ├── deps.py            依赖注入
│   ├── routers/           API 路由
│   │   ├── auth.py        登录/用户信息
│   │   ├── users.py       用户 CRUD
│   │   ├── roles.py       角色 CRUD
│   │   ├── bots.py        Bot CRUD
│   │   └── dashboard.py   统计数据
│   └── .env               环境变量（不提交 Git）
│
├── frontend/              前端页面
│   ├── index.html         前台登录页
│   ├── admin-login.html   后台登录页
│   ├── chat.html          智能体聊天页
│   ├── app.html           后台管理面板
│   └── js/
│       └── app.js         后台管理 JS
│
├── sql/
│   └── schema.sql         数据库建库脚本
│
├── deploy/                部署配置
│   ├── coze-admin.conf    Nginx 配置
│   ├── coze-admin.service Systemd 配置
│   ├── deploy.sh          一键部署脚本
│   └── DEPLOY.md          部署文档
│
├── .vscode/               VS Code 配置
│   ├── settings.json      工作区设置
│   ├── launch.json        调试配置
│   ├── tasks.json         任务配置
│   └── extensions.json    推荐扩展
│
├── .venv/                 Python 虚拟环境（不提交）
├── requirements.txt       Python 依赖
├── start.bat              Windows 一键启动
└── README.md              本文件
```

## VS Code 推荐扩展

打开项目后 VS Code 会自动提示安装：

| 扩展 | 用途 |
|------|------|
| Python | Python 语言支持 |
| Black Formatter | 代码格式化 |
| Prettier | HTML/JS 格式化 |
| Live Server | 前端预览（可选） |

## 开发说明

- **后端修改** → uvicorn `--reload` 自动重启
- **前端修改** → 刷新浏览器即可（已加 no-cache）
- **数据库改表** → 修改 `models.py` + `sql/schema.sql`，重启服务

## 部署

参见 [deploy/DEPLOY.md](deploy/DEPLOY.md)