95 lines
3.3 KiB
Markdown
95 lines
3.3 KiB
Markdown
# 会议核销SaaS 开发启动说明
|
||
|
||
## 目录
|
||
- `backend/`：Spring Boot 后端工程（按模块分包）。
|
||
- `frontend/`：Vue3 + Element Plus 前端工程（按模块路由）。
|
||
- `基金会、协会、北京欣欣会议核销系统_完整版.md`：业务需求文档。
|
||
- `会议核销SaaS系统_技术开发文档.md`：技术开发文档。
|
||
|
||
## 当前已落地MVP模块
|
||
- 后端核心接口
|
||
- `GET /api/system/health`
|
||
- `GET/POST /api/projects`
|
||
- `POST /api/projects/{id}/freeze`
|
||
- `GET/POST /api/meetings`
|
||
- `POST /api/meetings/{id}/submit`
|
||
- `GET /api/audits/tasks`
|
||
- `POST /api/audits/tasks/{id}/approve`
|
||
- `POST /api/audits/tasks/{id}/reject`
|
||
- `POST /api/audits/tasks/{id}/return`
|
||
- `GET /api/finance/projects`
|
||
- `POST /api/finance/payments`
|
||
- 后端分层结构
|
||
- 已按 `controller/service/repository/model/dto` 分层。
|
||
- 已实现业务异常、参数校验、统一响应结构、错误码处理。
|
||
- 数据库与初始化
|
||
- `backend/src/main/resources/db/schema.sql`
|
||
- `backend/src/main/resources/db/data.sql`
|
||
- 调度任务（无MQ）
|
||
- 已实现 `Scheduler + async_job` 内存版执行机制、重试与幂等防重。
|
||
- 前端模块页面
|
||
- 项目管理（新建/冻结/列表）
|
||
- 会议管理（新建/会议级提交）
|
||
- 审核管理（通过/拒绝/退回）
|
||
- 财务管理（支付确认/列表）
|
||
|
||
## 第二阶段已落地
|
||
- 持久化升级
|
||
- 新增 JDBC 仓储实现（项目/会议/审核/支付/任务）。
|
||
- 支持通过 `APP_REPOSITORY_MODE` 切换 `jdbc` 与 `in-memory`。
|
||
- 数据库迁移
|
||
- 新增 Flyway 迁移脚本：
|
||
- `backend/src/main/resources/db/migration/V1__init_schema.sql`
|
||
- `backend/src/main/resources/db/migration/V2__seed_data.sql`
|
||
- 系统设置基础模块
|
||
- 后端新增用户与角色接口：`/api/users`、`/api/roles`
|
||
- 前端新增用户管理、角色管理页面与菜单。
|
||
- 文件能力
|
||
- 新增 OSS 预签名下载接口：`GET /api/files/presign-download`
|
||
|
||
## 第三阶段当前进展（已完成）
|
||
- 认证与鉴权
|
||
- 新增 JWT 登录接口：`POST /api/auth/login`
|
||
- 新增鉴权拦截器：统一校验 `Authorization: Bearer <token>`
|
||
- 新增 RBAC 权限注解：`@RequirePermission`
|
||
- 权限落地
|
||
- 项目、会议、审核、财务关键写操作已接入权限码校验。
|
||
- Flyway 迁移增强
|
||
- 新增 `V3__auth_rbac_seed.sql`，补齐用户、角色、权限与映射初始化数据。
|
||
- 前端登录与路由守卫
|
||
- 新增登录页 `/login`
|
||
- 未登录自动跳转登录，token 过期自动清理并回登录页。
|
||
- 新增退出登录按钮。
|
||
|
||
## 启动方式
|
||
|
||
### 后端
|
||
1. 配置 `backend/src/main/resources/application.yml` 中的 MySQL 与 OSS 参数。
|
||
2. 在 `backend` 目录执行：
|
||
- `mvn spring-boot:run`
|
||
|
||
### 前端
|
||
1. 在 `frontend` 目录执行：
|
||
- `npm install`
|
||
- `npm run dev`
|
||
|
||
## 测试与构建
|
||
|
||
### 后端
|
||
- 在 `backend` 目录执行：
|
||
- `mvn clean test`
|
||
|
||
### 前端
|
||
- 在 `frontend` 目录执行：
|
||
- `npm run build`
|
||
|
||
## 试运行与发布
|
||
- 试运行与回滚预案见：
|
||
- `docs/MVP_试运行与发布回滚预案.md`
|
||
|
||
## 下一阶段建议
|
||
1. 接入真实 MySQL 持久化仓储（替换内存仓储）。
|
||
2. 完成租户/用户/角色/权限模块。
|
||
3. 完善审核流配置化与任务告警通知通道。
|
||
4. 落地 OSS 上传、模板治理、专家模块。
|