xinyin025/RuoYi-Vue-Plus
1
0
Fork 0
mirror of https://github.com/dromara/RuoYi-Vue-Plus.git synced 2025-09-26 21:26:39 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
0940f6d504
RuoYi-Vue-Plus/PMS联系人模块部署指南.md

4.6 KiB
Raw Blame History

PMS联系人模块部署指南

概述

本文档提供PMS模块中联系人、标签、联系人标签关系三个功能的完整部署指南，确保前端页面能正常访问。

已完成功能清单

✅ 后端开发

  • Controller层：完整的REST API接口
  • Service层：完整的业务逻辑，包含复杂关联操作
  • Mapper层：完整的数据访问层，支持复杂查询
  • Domain对象：Entity、BO、VO完整定义

✅ 前端开发

  • 页面组件：
    • 联系人管理：/src/views/pms/contact/index.vue
    • 标签管理：/src/views/pms/tag/index.vue
    • 标签关联管理：/src/views/pms/tag-relation/index.vue
  • 表单组件：ContactForm.vue、TagForm.vue、RelationForm.vue
  • API服务层：完整的API接口封装
  • TypeScript类型：完整的类型定义

✅ 路由配置

  • 路由自动生成完成
  • 国际化配置完成

部署步骤

第一步：数据库部署

执行完整的数据库部署脚本：

# 在MySQL中执行
mysql -u root -p your_database < script/sql/pms/deploy_pms_complete.sql

该脚本包含：

  1. 表结构创建：

    • pms_customer_contacts - 客户联系人表
    • pms_contact_tags - 联系人标签表
    • pms_contact_tag_relations - 联系人标签关联表

  2. 基础字典数据：

    • 联系人类型、状态、性别、会员等级
    • 标签分类等字典配置

  3. 菜单权限配置：

    • PMS主菜单
    • 三个子功能菜单及按钮权限
    • 超级管理员权限分配

  4. 测试数据：

    • 3个测试联系人
    • 5个测试标签
    • 标签关联关系

第二步：后端服务启动

cd ruoyi-admin
mvn spring-boot:run -Dspring-boot.run.profiles=dev

验证后端服务：

  • 访问 http://localhost:8080/doc.html
  • 检查PMS模块API是否正常显示

第三步：前端服务启动

cd ruoyi-plus-soybean
npm run dev

验证前端服务：

  • 访问 http://localhost:3200
  • 登录系统后检查PMS菜单是否显示

第四步：功能验证

  1. 菜单访问验证：

    • PMS管理 → 客户联系人
    • PMS管理 → 联系人标签
    • PMS管理 → 标签关联管理

  2. 功能操作验证：

    • 联系人的增删改查
    • 标签的增删改查
    • 标签关联的管理

功能特性

联系人管理

  • ✅ 完整的CRUD操作
  • ✅ 高级搜索（姓名、电话、类型、状态）
  • ✅ 标签关联管理
  • ✅ 数据导出功能
  • ✅ 权限控制

标签管理

  • ✅ 完整的CRUD操作
  • ✅ 颜色选择器
  • ✅ 分类管理
  • ✅ 门店级/租户级标签
  • ✅ 排序功能

标签关联管理

  • ✅ 联系人与标签的关联
  • ✅ 远程搜索功能
  • ✅ 批量操作
  • ✅ 关联关系验证

技术架构

后端技术栈

  • Spring Boot 3.x
  • MyBatis Plus
  • Sa-Token权限框架
  • 多租户支持

前端技术栈

  • Vue 3 + TypeScript
  • Naive UI组件库
  • Soybean Admin Pro框架
  • Vite构建工具

权限配置

菜单权限

  • pms:contacts:* - 联系人管理权限
  • pms:contactTags:* - 标签管理权限
  • pms:contactTagRelations:* - 标签关联管理权限

按钮权限

每个功能模块包含：

  • query - 查询权限
  • add - 新增权限
  • edit - 编辑权限
  • remove - 删除权限
  • export - 导出权限

数据模型

核心表关系

pms_customer_contacts (联系人表)
    ↓ 1:N
pms_contact_tag_relations (关联表)
    ↓ N:1
pms_contact_tags (标签表)

多租户支持

  • 所有表支持租户级数据隔离
  • 标签支持门店级和租户级两种范围
  • 自动租户数据过滤

故障排查

常见问题

  1. 菜单不显示

    • 检查数据库菜单配置是否正确执行
    • 检查用户角色权限分配

  2. API调用失败

    • 检查后端服务是否正常启动
    • 检查数据库连接配置

  3. 前端页面报错

    • 检查前端依赖是否安装完整
    • 检查API接口路径是否正确

  4. 数据查询为空

    • 检查测试数据是否正确插入
    • 检查多租户配置

日志查看

  • 后端日志：ruoyi-admin/logs/
  • 前端控制台：浏览器开发者工具

后续扩展

计划功能

  • 联系人详情页面优化
  • 标签统计分析
  • 批量导入功能
  • 高级筛选条件

性能优化

  • 数据库索引优化
  • 前端虚拟滚动
  • API响应缓存

联系支持

如遇到部署问题，请检查：

  1. 数据库脚本是否完整执行
  2. 服务启动日志是否有错误
  3. 网络和端口配置是否正确

部署完成标志：能够正常访问三个页面并进行基本的增删改查操作。