系统架构
架构概览
CSSA-Website 采用 纯前端 SPA 架构,运行于浏览器,不依赖后端服务。整体结构如下:
分层设计
| 层级 | 职责 | 对应代码 |
|---|---|---|
| 入口层 | 挂载 React 根、StrictMode | src/index.js |
| 路由层 | 定义路径与页面映射 | src/App.js |
| 布局层 | Header、Navbar、Footer | src/components/Header, Navbar, Footer |
| 页面层 | 各业务页面 | src/components/Pages/ |
| UI 层 | 通用 UI 组件 | src/components/ui/ |
| 工具层 | 工具函数(如 cn) | src/lib/utils.js |
路由架构
- 首页:展示 Header 大图 + Navbar + 主内容
- 子页:仅展示 Navbar + 主内容(无 Header)
- 404:未匹配路径统一跳转至缓冲页
Activity_BufferPage
路由一览
数据流
- 无全局状态:不使用 Redux、Context 等全局状态管理
- 本地状态:各组件使用
useState、useEffect、useRef - 数据来源:组件内定义、
Honor_Wall.json、public/静态资源
部署形态
- 使用
npm run build生成静态文件 - 可部署至任何静态托管(Netlify、Vercel、GitHub Pages、Nginx 等)
- 需配置 SPA 回退:未匹配路径返回
index.html