unis_crm/docs/deployment-guide.md

2.2 KiB
Raw Blame History

全新环境部署说明

目标

本仓库已经把 CRM 自有业务表整理为单一入口脚本:

  • sql/init_full_pg17.sql

后续部署 CRM 表时,优先只执行这一份脚本即可。历史迁移脚本已归档到:

  • sql/archive/

执行顺序

1. 准备基础环境

需要先准备:

  • PostgreSQL 17
  • Redis
  • Java 17+
  • Maven 3.9+

2. 先初始化基础框架UnisBase表和基础数据

这一步不在本仓库维护,需要先由基础框架提供方执行。

当前 CRM 代码运行时会依赖下列基础表或基础数据:

  • sys_user
  • sys_org
  • sys_dict_item
  • sys_tenant_user
  • sys_role
  • sys_user_role
  • sys_param
  • sys_log
  • device

如果这些表或基础数据未准备完成CRM 即使业务表建好了,也会在登录、字典加载、组织信息、角色信息等链路上报错。

3. 执行 CRM 单文件初始化脚本

psql -h 127.0.0.1 -U postgres -d nex_auth -f sql/init_full_pg17.sql

说明:

  • 这份脚本既适合空库初始化,也兼容大部分旧环境补齐结构
  • 它已经吸收了仓库里原来的 DDL 迁移脚本
  • sql/archive/ 中的旧脚本仅保留作历史追溯,正常部署不再单独执行

4. 初始化完成后建议检查的 CRM 表

建议至少确认以下表已存在:

  • crm_customer
  • crm_opportunity
  • crm_opportunity_followup
  • crm_sales_expansion
  • crm_channel_expansion
  • crm_channel_expansion_contact
  • crm_expansion_followup
  • work_checkin
  • work_daily_report
  • work_daily_report_comment
  • work_todo
  • sys_activity_log

5. 启动后端服务

cd backend
mvn spring-boot:run

默认端口:

  • 8080

6. 启动前端并验证

建议至少验证以下链路:

  • 登录
  • 首页统计、待办、动态
  • 拓展列表与详情
  • 商机列表与详情
  • 工作台打卡、日报、历史记录

升级已有环境时的建议

如果不是全新环境,而是已有库升级:

  1. 先备份数据库
  2. 直接执行 sql/init_full_pg17.sql
  3. 验证登录、字典、组织、日报、商机、拓展几条主链路

当前目录约定

  • sql/init_full_pg17.sql:唯一部署入口脚本
  • sql/archive/:历史迁移与修数脚本归档目录