项目结构

源码根：portal/CSSAPortal/。

CSSAPortal/
├── cssaportal/          # settings、根 URL、WSGI/ASGI
├── accounts/            # 用户、部门、RBAC、激活码、申请档案
├── recruitment/         # 招新
├── treasury/            # 报销、入账
├── classroom/           # 教室预约
├── mailing/             # 邮件（无 DB 模型）
├── files/               # 文件索引与下载
├── services/            # Drive / GPT / SFTPGo
├── core/                # 首页、dashboard、ActivityLog、template tags
├── theme/               # Tailwind app；dist CSS 已提交
├── templates/           # 全局 Django 模板
├── static/              # 少量 JS
├── docs/                # USER_GUIDE_*、FIXLOG
├── .github/workflows/   # ci.yml、手动 deploy
├── manage.py
├── requirements.txt
└── .env.example

模板按角色分 base：templates/core/user_base.html、chair_base.html、admin_base.html，落地页 base_landing.html。

README_DJANGO.md 只覆盖早期 OAuth+RBAC，视为过时。开发说明以本站 + 仓库 README.md 为准。