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/`：历史迁移与修数脚本归档目录
|