104 lines
2.2 KiB
Markdown
104 lines
2.2 KiB
Markdown
|
|
# 全新环境部署说明
|
|||
|
|
|
|||
|
|
## 目标
|
|||
|
|
|
|||
|
|
本仓库已经把 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 单文件初始化脚本
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
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. 启动后端服务
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd backend
|
|||
|
|
mvn spring-boot:run
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
默认端口:
|
|||
|
|
|
|||
|
|
- `8080`
|
|||
|
|
|
|||
|
|
### 6. 启动前端并验证
|
|||
|
|
|
|||
|
|
建议至少验证以下链路:
|
|||
|
|
|
|||
|
|
- 登录
|
|||
|
|
- 首页统计、待办、动态
|
|||
|
|
- 拓展列表与详情
|
|||
|
|
- 商机列表与详情
|
|||
|
|
- 工作台打卡、日报、历史记录
|
|||
|
|
|
|||
|
|
## 升级已有环境时的建议
|
|||
|
|
|
|||
|
|
如果不是全新环境,而是已有库升级:
|
|||
|
|
|
|||
|
|
1. 先备份数据库
|
|||
|
|
2. 直接执行 `sql/init_full_pg17.sql`
|
|||
|
|
3. 验证登录、字典、组织、日报、商机、拓展几条主链路
|
|||
|
|
|
|||
|
|
## 当前目录约定
|
|||
|
|
|
|||
|
|
- `sql/init_full_pg17.sql`:唯一部署入口脚本
|
|||
|
|
- `sql/archive/`:历史迁移与修数脚本归档目录
|