OARS Docs

Appearance

实施交付 ​

按下面顺序完成环境交付。细节见各子页。

实施顺序 ​

  1. 准备数据库、Redis、文件存储目录和后端配置。
  2. 启动后端，完成数据库版本迁移。
  3. 初始化组织、角色、用户、菜单授权和必要业务基础数据。
  4. 如启用文档在线编辑，先部署 ONLYOFFICE，再联调回调。
  5. 如涉及源码交付，确认产品基线、客户仓库或分支、二开补丁、数据库脚本、配置模板和发布说明。
  6. 用健康检查、接口文档、前端入口和关键业务流程做验收。

关键前置条件 ​

  • 后端默认端口 8080。直接启动时，应用上下文为根路径 /。
  • 标准容器交付中，浏览器经前端访问接口时常用前缀 /oars（由前端反向代理转发）。
  • 数据库默认 MySQL 8.0+，库名 oars；Redis 默认 localhost:6379。生产环境必须覆盖连接、密码与密钥。
  • 文件默认本地存储，路径为 ./uploads。
  • 数据库结构变更由启动时的版本化迁移自动执行。
  • 源码交付使用客户分支或私有仓库固化版本，不以未提交工作区作为交付依据。

检查项 ​

  • 健康检查返回正常（直接访问后端一般为 /actuator/health；容器/网关场景以现场实际前缀为准）。
  • 接口文档：开发/测试环境可打开 /swagger-ui.html；生产环境默认关闭。
  • 数据库迁移历史中无失败记录。
  • 管理员角色拥有组织、角色、菜单、文档中心等必要权限。
  • 容器部署时，前端、后端、MySQL、Redis 健康检查通过，数据卷和环境配置已归档。
  • 源码交付已打客户版本标签，构建产物、数据库脚本、配置模板、发布说明和回滚方案已归档。

配置参考 ​

后端主配置位于 application.yml，环境差异在对应环境配置中覆盖。生产必须单独配置数据库、Redis、JWT 密钥、文件存储、域名与 HTTPS。

相关文档 ​