docs: 建立 devdocs 开发文档集(13 份模块文档)

This commit is contained in:
AskaEth committed 2026-09-09 16:10:40 +08:00
1 parent 3e9592b006
commit 3b3496559b
15 files changed
+1685 -2

No files matched your search

+40 -2
View File
@@ -1,3 +1,41 @@
# Scoreboard
# Scoreboard · 运动会积分榜系统
一个简易实用的赛事积分榜系统
一套局域网内部署的运动会成绩与积分系统:**一个服务端 + 两个界面**。
| 界面 | 地址 | 用途 |
| --- | --- | --- |
| 实时积分大屏 | `/display` | 只读、无人值守;成绩发布后 1 秒内更新 |
| 裁判长管理面板 | `/admin` | 登录后录入、审核、发布成绩,控制大屏 |
后台一改数据,前台大屏实时跟着变;草稿不上屏,发布才生效,误操作可撤销、可追溯。
## 当前状态
📋 **设计阶段** —— 开发文档已成型,等待 D1–D13 决策确认,尚未开始编码。
## 文档
开发文档集见 [`devdocs/`](./devdocs/README.md):
| 编号 | 文档 |
| --- | --- |
| 01 | [需求与范围](./devdocs/01-需求与范围.md) |
| 02 | [积分与排名规则](./devdocs/02-积分与排名规则.md) ★ 核心 |
| 03 | [技术选型与架构](./devdocs/03-技术选型与架构.md) |
| 04 | [数据模型](./devdocs/04-数据模型.md) |
| 05 | [接口与实时协议](./devdocs/05-接口与实时协议.md) |
| 06 | [大屏端设计](./devdocs/06-大屏端设计.md) |
| 07 | [管理面板设计](./devdocs/07-管理面板设计.md) |
| 08 | [安全与可靠性](./devdocs/08-安全与可靠性.md) |
| 09 | [测试策略](./devdocs/09-测试策略.md) |
| 10 | [部署与现场方案](./devdocs/10-部署与现场方案.md) |
| 11 | [开发计划与里程碑](./devdocs/11-开发计划与里程碑.md) |
| 12 | [风险登记册](./devdocs/12-风险登记册.md) |
## 拟定技术栈
Node.js 22 + TypeScript + Fastify + Socket.IO + SQLite + Vue 3 + Vite
## 许可证
MIT