系统一览
技术部维护多个系统。认领项目、接 Issue、或部长分配任务之后，用下表找到对应文档；自学阶段浏览即可，不必深入。
系统列表
| 系统 | 说明 | 文档入口 | 文档成熟度 |
|---|---|---|---|
| 官网 | BUCSSA 官方网站前端（静态 SPA） | 官网文档 | 中文实用文档已对齐 Vite + i18n |
| 门户系统 | 招新 / 报销 / 教室 / 账号（Django） | 门户文档 | 开发者文档已就绪；用户教程见站外 Google Doc |
| SFTPGo 网盘 | 部内文件传输与网盘 | 文档 v2 · 文档 v1 / SOP | v2 建设中；v1 可参考 |
| 少数派抽奖 | 大型线下活动实时抽奖与互动 | 抽奖系统 | 较完整 |
| CSSA GPT | 内部大模型对话（Open WebUI + LiteLLM） | GPT 文档 | 较完整 |
| 主席选举系统 | 内部公投 / 主席选举（Next.js + Neon） | 选举文档 | 较完整 |
| CSSA Docs | 本文档站（Docusaurus + Cloudflare） | 文档站说明 | 较完整 |
待补充
- 哪些 repo 常发 good first issue — 见 新人指引 · 待补充表
生产环境拓扑（主服务器域名、Nginx、备份）见 服务器与运维 · 基础设施概览。
认领 / 接 Issue 后怎么读
- 打开上表中对应系统的 index 或 概览 · Introduction。
- 要写代码 → 入门指南 + 参与贡献（及 开发规范）。
- 做活动、用界面 → 用户指南。
- 部署、服务器 → 一般 eboard 主导；部员仅在明确授权后看 部署指南 或 服务器与运维。
按任务快速入口
| 任务 | 建议路径 |
|---|---|
| 练手改官网 | 官网 · Installation |
| 练手改文档站 | Docs · Installation |
| 本地跑 Portal | 门户 · Installation |
| 活动操作抽奖 | 抽奖 · 认证场景 |
| 使用内部 GPT | GPT · 快速开始 |
| 本地跑主席选举 | 选举 · Installation |
| 网盘 Linux 层维护 | 网盘 v1 · 服务器 SOP |
| 主服务器拓扑 / 发布 | 基础设施概览 |
关于 Admin / System / Member
这三个词在 术语表 和 网盘 v1 文档里出现，指 SFTPGo 权限模型中的分工（Linux 运维 / 网盘后台 / 普通用户），不是技术部部员的岗位分类。新人只需知道：接到网盘相关任务时再读 v1 文档即可。
和「服务器与运维」的关系
- 项目文档 · 部署指南：单个应用如何构建与启动。
- 服务器与运维：主服务器上的域名、nginx、备份与访问 — 通常 infra 方向才需要。