跳到主要内容
版本:Current

系统架构

架构概览

CSSA-Website 采用 纯前端 SPA 架构,运行于浏览器,不依赖后端服务。整体结构如下:

分层设计

层级职责对应代码
入口层挂载 React 根、StrictModesrc/index.js
路由层定义路径与页面映射src/App.js
布局层Header、Navbar、Footersrc/components/Header, Navbar, Footer
页面层各业务页面src/components/Pages/
UI 层通用 UI 组件src/components/ui/
工具层工具函数(如 cnsrc/lib/utils.js

路由架构

  • 首页:展示 Header 大图 + Navbar + 主内容
  • 子页:仅展示 Navbar + 主内容(无 Header)
  • 404:未匹配路径统一跳转至缓冲页 Activity_BufferPage

路由一览

数据流

  • 无全局状态:不使用 Redux、Context 等全局状态管理
  • 本地状态:各组件使用 useStateuseEffectuseRef
  • 数据来源:组件内定义、Honor_Wall.jsonpublic/ 静态资源

部署形态

  • 使用 npm run build 生成静态文件
  • 可部署至任何静态托管(Netlify、Vercel、GitHub Pages、Nginx 等)
  • 需配置 SPA 回退:未匹配路径返回 index.html