# 培训结业证书管理与查询系统

一期目标：快速上线一个可导入、可管理、可查询、可核验、可下载 PDF 证书的闭环系统。

## 本地验收启动

请优先使用这个文件：

```bat
start-local.bat
```

也可以在命令行运行：

```bat
cd /d C:\Users\nelso\Documents\projects\certificate-system
start-local.bat
```

启动后保持窗口不要关闭，然后打开：

```text
http://127.0.0.1:8000/admin/login
```

默认账号：

```text
admin / Admin123!
```

公开查询页：

```text
http://127.0.0.1:8000/query
```

如果 `.ps1` 被记事本打开，不用管它，改用 `start-local.bat`。如果想清空本地测试数据，运行：

```bat
reset-local-data.bat
```

当前本地验收版已支持：

- 学员手动新增、查询、修改、删除。
- 项目新增、搜索、修改、启用、停用。
- 证书手动新增、后台预览、后台下载、作废、重置链接、批量预生成 PDF。
- Excel 模板下载、导入、确认导入、导出证书。
- 操作日志中文显示。
- 公开查询（支持证书编号+姓名+图形验证码、手机号+短信验证码两种方式）、证书直达页、PDF 下载。

## 正式工程

- 后端：Python 3.12 + FastAPI + SQLAlchemy + Alembic
- 前端：Vue 3 + TypeScript + Vite + Element Plus
- 数据库：MySQL 8
- 部署：Docker Compose + Nginx

本地验收版在 `local_app/`，用于快速验证业务闭环；正式部署仍使用 `backend/`、`frontend/` 和 `docker-compose.yml`。

## 文档

- [开发决策记录](docs/decision-log.md)
- [MVP 范围说明](docs/mvp-scope.md)
- [正式部署操作手册](docs/正式部署操作手册.md)
- [部署与使用手册](docs/usage-deployment-manual.md)
- [上线检查清单](docs/deployment-checklist.md)
