Initial certificate system

README.md

@@ -0,0 +1,67 @@
+# 培训结业证书管理与查询系统
+
+一期目标：快速上线一个可导入、可管理、可查询、可核验、可下载 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
+```
+
+当前本地验收版已支持：
+
+- 学员手动新增、查询、修改、删除。
+- 项目新增、搜索、修改、启用、停用。
+- 证书手动新增、后台预览、后台下载、作废、重置链接。
+- 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/usage-deployment-manual.md)
+- [上线检查清单](docs/deployment-checklist.md)