基础设施与项目
NBTCA 的线上那一面,是一个持续运转的开源社区:几台自建服务器、一批跑在 Cloudflare 上的无服务函数,和几十个公开在 github.com/nbtca 上的项目,共同支撑着维修、活动、宣传和日常协作。这一页做一个概览——想深入某个项目,点进它的仓库即可。
维修系统(weekend 项目)
NBTCA 最核心的自建系统,支撑维修日和日常报修:
- Saturday(Go)——报修服务的后端 API。
- Sunday(Vue)——维修事件管理网站 repair.nbtca.space,已不再维护,工单管理迁至协会主页的维修面板。
- Hawaii(TypeScript,私有仓库)——微信小程序“NBT电脑维修”,早年的报修入口,已不再维护。
- RepairRecordPDF(C#)——生成报修记录单。
系统怎么运转(工单状态流转、角色权限、志愿者时长统计),见工单系统。
自建基础设施
- 校园网认证:nbtverify(Go)与 luci-app-nbtverify——对接学校的卓智网络接入门户,也适配 OpenWrt 路由器。
- 文件与镜像站:内网镜像站 i.nbtca.space(维修工具、系统镜像等,见软件仓库索引),站内维修工具由 Repair-Tools 仓库管理。这条线可以追到很早——2016 年的装系统教学课件里,系统镜像的下载链接已经指向协会自建的内网 FTP(
ftp://10.80.6.166)。 - 无服务后端:不少服务跑在 Cloudflare Workers 上,例如 ServerlessMQ(消息队列 / webhook 转 websocket)、shortlink(短链接)、uptimeflare(可用性监控)、cloudflare-docker-proxy(Docker 镜像仓库代理)。
- 虚拟组网:基于 Headscale 自建的 Tailscale 网络,中继节点也是自建的,见 Tailscale 使用指南。
- 编排与基础设施即代码:用 Terraform(infra)和 Docker(stacks)管理部署。两个仓库都是私有的。
- 消息中转:notification-center(Go)把各类 webhook 汇聚成统一消息中心。
机器人与自动化
- HuaJiBot.NET(C#)——当前的群机器人;前身是已归档的 huaji-bot(Go)。
网站与内容
- Home(Astro)——协会主页 nbtca.space,预约维修与队员用的维修面板都在这里。
- blogs(Vue)——计协博客;投稿见撰写并发布你的第一篇 NBTCA 博客。
- documents——你正在读的这个文档站;配套的 docs 是供其他项目读取本站内容的数据层库,nbtcal 是协会 ICS 日历库。
- published_post——微信公众号文章的镜像存档。
开发上手
新加入开发的成员,可以从 dev101 起步("First day at NBTCA dev team")。协作方式见 GitHub 工作流 与 Roadmap。
更多
以上只是概览。NBTCA 还维护 Minecraft 服务器、聊天室项目(pit 系列,私有)、照片整理、DNS 同步等工具,也给一些自用的上游项目维护带修改的分支(Logto、OpenList 等)——完整清单见 github.com/nbtca。