常见问题

官网和 Portal 有什么区别？

官网（本项目）是对外展示站。招新申请、面试、报销、教室等在 CSSA Portal。Navbar「加入我们」只是外链。

为什么没有后端？

当前需求都能用静态页面 + 外链满足。活动报名若需要账号体系，应落到 Portal，而不是在官网加 API。

开发端口为什么不是 3000？

项目已从 Create React App 迁到 Vite 8，默认端口是 5173。

构建产物在哪个目录？

dist/。文档或 Dashboard 若仍写 build，需要改掉。

必须同时维护中英文吗？

导航、页脚、列表页应中英 JSON 成对更新。活动详情和部门页正文可以保持中文，但 /en/ 路由要能打开。见 国际化。

如何只改荣誉墙或合作方？

编辑页面旁的 Honor_Wall.json / Partnership.json，不必改路由。见 更新页面内容。

有自动化测试吗？

没有。package.json 无 test 脚本。提交前至少本地 npm run dev 点一遍改动页，重要改动再 npm run build。

代码规范在哪里？

图片与目录约定见本系统 项目结构。更完整的部内规范见技术部 Notion「代码规范」；新人必读 · 开发规范 也适用。

生产域名是什么？

对外使用组织域名（常见为 bucssa.org）。以 Cloudflare Pages 当前自定义域为准。