69 lines
1.8 KiB
Markdown
69 lines
1.8 KiB
Markdown
# 培训结业证书管理与查询系统
|
||
|
||
一期目标：快速上线一个可导入、可管理、可查询、可核验、可下载 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)
|