BUCSSA 官网文档
波士顿大学中国学生学者联合会（BUCSSA）官方网站前端 — 基于 React + Vite 的静态单页应用（SPA），无自建后端 API、无登录认证，当前也不需要环境变量。
本目录说明官网前端项目的架构、内容维护、本地开发与部署。应用代码仓库：bucssatech22/CSSA-Website。生产站点通常为 bucssa.org（以当前 Cloudflare Pages 绑定为准）。
本站点按 Diátaxis 框架组织：概览负责理解，入门负责上手，用户指南负责日常维护，参考负责查阅，开发者指南负责扩展代码。
文档导航
| 分类 | 说明 | 入口 |
|---|---|---|
| 概览 | 项目边界、功能、架构与技术栈 | 项目介绍 |
| 入门指南 | 安装与第一次改内容 | 安装 · 快速开始 |
| 用户指南 | 改文案、翻译、图片与外链 | 更新页面内容 · 国际化 |
| 参考 | 路由表与内容存放位置 | 路由对照 · 内容位置 |
| 开发者指南 | 目录、布局、新增页面 | 项目结构 · 新增页面 |
| 部署指南 | 本地预览与生产托管 | 本地部署 · 生产部署 |
| 故障排查 | 常见错误 | 常见错误 |
| 常见问题 | FAQ | FAQ |
推荐阅读顺序
第一次改官网的部员（改文案 / 图片 / 翻译）
- Introduction → Installation → Quick Start
- 更新页面内容 → 国际化 → 管理图片
需要新增页面或改路由的开发者
- System Architecture → Project Structure
- Code Architecture → Adding New Pages
- 上线前阅读 Production Deployment
官网不托管招新、报销、账号等业务逻辑；这些在 CSSA Portal。
技术栈摘要
React 18 · React Router 6 · Vite 8 · i18next · Tailwind CSS 3.4 · Framer Motion
完整版本与依赖见 技术栈。
上游与参考
本文档描述部内如何维护官网前端；React、Vite、路由、样式与 i18n 的细节请查上游官方文档。
| 项目 | 官方文档 | 源码 |
|---|---|---|
| React | react.dev | facebook/react |
| React Router | reactrouter.com | remix-run/react-router |
| Vite | vite.dev | vitejs/vite |
| i18next | i18next.com | i18next/i18next |
| Tailwind CSS | tailwindcss.com/docs | tailwindlabs/tailwindcss |
| Framer Motion | motion.dev/docs | motiondivision/motion |
更多 UI 库（React Icons、Radix 等）见 技术栈。