openatom-system/
├── .github/workflows/ # CI/CD 工作流（7 个）
├── astrbot/ # AstrBot QQ 机器人
├── backend/ # 后端 Spring Boot 项目
├── docs/ # PRD 及 API 文档（25+ 篇）
├── docs-site/ # VuePress 开发文档站
├── docs-system/ # 文档中心（ONLYOFFICE）子系统
├── frontend/
│ ├── web_pc/ # PC 端 Vue 3 项目
│ ├── uni_app/ # UniApp 微信小程序
│ └── ios_app/ # iOS 原生项目（预留）
├── lab-management-system/ # 实验室管理系统后端
├── lab-ui-web/ # 实验室管理系统前端
├── mail-system/ # 独立自托管邮件系统（含 mail-web）
├── seafile/ # Seafile 网盘集成
├── tools/ # 运维工具
├── docker-compose.yml # 全栈 Docker 编排
├── Dockerfile # 后端容器化配置
├── README.md # 项目说明
└── LICENSE # 开源协议
backend/
├── db/ # 手工初始化 SQL
│ ├── create_table.sql # 全量建表脚本
│ ├── alter_recruitment_form_feature.sql
│ └── cleanup_duplicate_memberships.sql
├── deploy/ # 部署配置
│ └── nginx/
│ └── oauth-api-location.conf # OAuth API 反代片段
├── scripts/ # 运维脚本
│ └── check-flyway-migrations.sh # Flyway 迁移完整性检查
├── src/main/java/edu/jmi/openatom/server/openatomsystem/
│ ├── OpenatomSystemApplication.java # 主启动类
│ ├── bootstrap/ # 启动初始化器
│ │ ├── SystemUserInitializer.java # 默认管理员
│ │ ├── SystemPermissionInitializer.java # 权限种子
│ │ ├── DefaultClubInitializer.java # 默认社团
│ │ ├── SchemaCompatibilityInitializer.java # 兜底建表/补列
│ │ └── ...
│ ├── config/ # 配置类
│ │ ├── SaTokenConfigure.java # Sa-Token 配置
│ │ ├── SaPermissionInterfaceImpl.java # 权限接口实现
│ │ ├── MybatisPlusConfig.java # MyBatis Plus 配置
│ │ ├── RedisConfig.java # Redis 配置
│ │ └── FlywayRepairStrategyConfig.java
│ ├── security/ # 安全
│ │ └── PasswordService.java # 密码服务
│ ├── controller/ # 控制器（53 个）
│ │ ├── AuthController.java # 认证
│ │ ├── ClubController.java # 社团
│ │ ├── UserController.java # 用户
│ │ ├── ApplicationController.java # 入会申请
│ │ ├── MembershipController.java # 成员管理
│ │ ├── ActivityController.java # 活动
│ │ ├── BotManagementController.java # QQ 群管理
│ │ ├── SitemapController.java # 站点地图（SEO）
│ │ └── ...
│ ├── service/ # 服务层
│ ├── service/impl/ # 服务实现
│ ├── mapper/ # MyBatis Mapper 接口
│ ├── entity/ # 实体类（77 个）
│ ├── dto/ # 请求 DTO（70+ 个）
│ ├── vo/ # 响应 VO
│ ├── enums/ # 枚举
│ │ ├── SystemPermission.java # 权限点枚举
│ │ ├── UserStatus.java
│ │ └── VoteResultVisibility.java
│ ├── common/ # 公共工具
│ │ ├── Result.java # 统一响应
│ │ ├── Jsons.java # JSON 工具
│ │ ├── Times.java # 时间工具
│ │ ├── FormSchemaFields.java # 表单字段
│ │ └── web/ # Web 拦截器
│ │ ├── OperationLogInterceptor.java
│ │ ├── ApplicationSubmitRateLimitInterceptor.java
│ │ └── ...
│ ├── aspect/ # AOP 切面
│ │ └── ControllerLogAspect.java # 控制器日志
│ ├── exception/ # 异常处理
│ │ ├── GlobalExceptionHandlerAdvice.java
│ │ └── RateLimitExceededException.java
│ └── cache/ # 缓存
├── src/main/resources/
│ ├── application.yml # 主配置
│ ├── application-dev.yaml # 开发环境
│ ├── application-prod.yaml # 生产环境
│ └── db/migration/ # Flyway 迁移脚本
│ ├── V1__init_schema.sql
│ ├── V2__add_qq_openid_to_user.sql
│ ├── ...
│ └── V53__add_seafile_oauth_client.sql
├── uploads/ # 文件上传目录（运行期）
└── pom.xml # Maven 配置
frontend/web_pc/
├── src/
│ ├── main.ts # 应用入口
│ ├── App.vue # 根组件
│ ├── api/ # API 请求
│ │ ├── request.ts # Axios 实例与拦截器
│ │ └── index.ts # API 方法定义
│ ├── router/
│ │ └── index.ts # 路由配置（含权限守卫）
│ ├── layouts/ # 布局
│ │ ├── AdminLayout.vue # 管理后台布局
│ │ └── SiteLayout.vue # 前台布局
│ ├── views/ # 页面视图
│ │ ├── admin/ # 管理后台（42 个页面）
│ │ ├── site/ # 前台展示（37 个页面）
│ │ └── AuthCallback.vue 等 # 根级页面
│ ├── components/ # 公共组件
│ │ ├── admin/ # 管理后台组件
│ │ ├── common/ # 通用组件（13 个）
│ │ ├── site/ # 前台组件
│ │ │ ├── home/ # 首页组件
│ │ │ ├── shell/ # 布局壳组件
│ │ │ ├── workspace/ # 工作台组件
│ │ │ ├── blog/ # 博客组件
│ │ │ ├── member/ # 成员主页组件
│ │ │ ├── points/ # 积分图表组件
│ │ │ └── PartnerClubCard.vue # 合作社团卡片
│ │ └── ui/ # 动画 UI 组件
│ │ ├── aurora-background/
│ │ ├── apple-card-carousel/
│ │ ├── flip-card/
│ │ ├── globe/
│ │ ├── marquee/
│ │ ├── smooth-cursor/
│ │ ├── link-preview/
│ │ ├── morphing-text/
│ │ └── ...
│ ├── composables/ # 组合式函数
│ │ ├── useAppStatus.ts
│ │ ├── useRouteTransition.ts
│ │ ├── useTheme.ts
│ │ └── useSiteMotion.ts
│ ├── utils/ # 工具函数
│ │ ├── auth.ts # 认证 Token 管理
│ │ ├── oidc.ts # OIDC 认证
│ │ ├── permission.ts # 权限判断
│ │ ├── seo.ts # 页面 SEO 管理
│ │ ├── googleIdentity.ts # Google 身份
│ │ ├── format.ts # 格式化
│ │ ├── markdown.ts # Markdown 渲染
│ │ └── qr.ts # 二维码
│ ├── constants/ # 常量（colleges.ts）
│ ├── plugins/ # 插件注册（element-plus.ts）
│ ├── styles/ # 样式（6 个 css）
│ ├── lib/ # 第三方库封装
│ └── vendor/ # 第三方代码
├── public/ # 静态资源
│ ├── about/ # 关于页影集
│ ├── brand/ # 品牌素材
│ ├── robots.txt # 爬虫规则
│ └── BingSiteAuth.xml # Bing 站点验证
├── package.json # pnpm 管理
├── vite.config.ts
├── tsconfig.json
├── nginx.conf # 前端 Nginx 配置
└── Dockerfile # 前端容器化配置
系统通过 docker-compose.yml 编排以下服务：
| 服务 | 容器名 | 端口 | 说明 |
|---|
| redis | openatom-redis | 6379 | Redis 缓存，仅本地访问 |
| backend | openatom-backend | 8921 | Spring Boot 后端，host 网络模式 |
| frontend | openatom-frontend | 18080→80 | Vue 前端 + Nginx |
| astrbot | openatom-astrbot | 6185, 6198 | AstrBot 机器人核心 |
| napcat | openatom-napcat | 6099, 3000 | NapCat QQ 协议端 |
| docs | openatom-docs | 16000→80 | VuePress 文档站 |
| 文件 | 说明 |
|---|
README.md | 项目整体说明与部署指南 |
docs/DESIGN.md | 前端设计规范（Apple 风格设计系统） |
docs/BOTPRD.md | QQ 群机器人需求文档 |
docs/LMS.md | 实验室管理系统需求文档 |
docs/club-management-prd.md | 社团管理系统 PRD |
docs/club-management-rest-api.md | REST API 文档 |
docs/club-management-openapi.yaml | OpenAPI 规范 |
docs/oauth-usage.md | OAuth 使用指南 |
docs/ai-activity-automation-prd.md | AI 活动自动化 PRD |
docs/ai-integration-guide.md | AI 集成指南 |
docs/microservices-cicd-deploy.md | 微服务 CI/CD 部署方案 |
docs/unified-group-center.md | 统一分组中心设计 |
docs/standalone-self-hosted-mail-system-design.md | 自托管邮件系统设计 |
docs/partner-clubs-page-prd.md | 合作社团页 PRD |
docs/member-profile-blog-prd.md | 成员主页/博客 PRD |