基于springboot2+vue2的党员教育和管理系统

1. 项目简介

党员教育和管理系统，旨在通过信息化手段提升党组织管理工作的效率。系统实现了对党员信息、党支部信息、党费缴纳、奖惩记录、支部日志与荣誉等核心业务的数字化管理。

系统根据用户角色（管理员、支部、党员）进行权限划分，不同角色拥有不同的操作界面和功能权限。例如，管理员可以进行全面的系统管理，支部可以管理本支部的相关信息，党员则主要进行信息查看和个人中心管理。

2. 技术栈

• 后端技术:

  • 核心框架: Spring Boot (v2.2.2.RELEASE)
  • 持久层框架: MyBatis Plus (v2.3) + MyBatis (v2.1.1)
  • 数据库: MySQL
  • 权限控制: Apache Shiro (v1.3.2)
  • 工具库: Hutool, Fastjson, Commons-lang3, Commons-io
  • AI能力: 百度人工智能Java SDK (用于人脸比对等)

• 前端技术:

  • 核心框架: Vue.js
  • UI组件库: Element UI
  • 图表库: ECharts
  • HTTP客户端: Axios

• 开发与部署:

  • 项目构建: Maven
  • 运行环境: JDK 1.8

3. 详细介绍

3.1 用户角色与权限

系统定义了三种用户角色，其权限在menu.js中详细配置：

• 管理员:

  • 拥有系统的全部管理权限。
  • 可以管理管理员账户、党费登记、各类基础数据（奖惩类型、单位类型、公告类型、日志类型、荣誉类型）、奖惩记录、基层单位、公告、党员、支部、支部日志和支部荣誉。
  • 拥有所有模块的增、删、改、查权限。

• 支部:

  • 主要负责本支部的相关业务。
  • 可以管理本支部的党费登记、奖惩记录、基层单位、党员、支部日志和支部荣誉。
  • 权限主要为“查看”和“新增”，不具备修改和删除全局配置的权限。

• 党员:

  • 权限以查看为主，用于获取信息和个人管理。
  • 可以查看党费登记、奖惩记录、公告、党员信息、支部信息、支部日志和支部荣誉。
  • 拥有“查看”权限，无新增、修改、删除权限。

3.2 核心功能模块

根据menu.js中的路由配置，系统的主要功能模块包括：

1. 管理员管理: 管理系统后台的登录账户。
2. 党费登记管理: 记录各支部或党员的党费缴纳情况，包括缴纳金额、登记日期、是否支付等状态。
3. 基础数据管理: 管理系统中的各类字典数据，例如：
   • 奖惩类型
   • 单位类型
   • 公告类型
   • 日志类型
   • 荣誉类型
4. 奖惩记录管理: 记录各支部或党员的奖惩情况，支持上传文件和文档作为附件。
5. 基层单位管理: 维护基层单位的信息，包括单位名称、联系人、联系方式、单位类型和地址。
6. 公告管理: 发布、修改和删除系统公告，支持公告类型分类和图片上传。
7. 党员管理: 维护党员的个人档案，信息非常全面，包括姓名、民族、籍贯、出生日期、文化程度、工作单位、入党转正时间、所在支部、联系方式、身份证号、邮箱等。
8. 支部管理: 维护党支部的信息，包括负责人姓名、党支部名称、联系方式、办公地址、邮箱及支部详情。
9. 支部日志管理: 记录各支部的工作日志，支持日志类型分类、文件上传和富文本详情。
10. 支部荣誉管理: 记录各支部获得的荣誉，包括成果、证书、荣誉名称、荣誉类型和证明文件。

3.3 数据库设计

项目数据库名为dangyuanjiaoyuguanli，核心数据表包括：

• yonghu: 党员信息表。
• zhibu: 支部信息表。
• dangfeidengji: 党费登记表。
• jiangchengjilu: 奖惩记录表。
• jicengdanwei: 基层单位表。
• zhiburizhi: 支部日志表。
• zhiburongyu: 支部荣誉表。
• news: 公告表。
• dictionary: 字典表，用于存储各类下拉选项数据。
• users: 系统管理员表。
• token: 用户登录token管理表。

3.4 技术特点

• 基于Spring Boot: 简化了项目配置和部署。
• 前后端分离: 前端Vue项目通过Ajax请求调用后端的RESTful API进行数据交互。
• 权限控制: 通过Apache Shiro + Token机制实现用户登录验证和接口访问权限控制。
• 数据字典支持: 通过dictionary表和自定义注解，实现了数据库字段与页面下拉选项的动态绑定。
• 图表统计: 集成了ECharts，后端CommonController提供了丰富的图表数据接口（柱状图、饼状图等），用于数据可视化。
• 文件处理: 支持Excel批量导入导出（基于POI）和普通文件上传下载。

4. 部分代码

4.1 后端Controller示例 (DangfeidengjiController.java)

该控制器负责处理“党费登记”相关的HTTP请求，展示了分页查询、保存、更新、删除等标准操作。

package com.controller;

// ... 省略导入

/**
 * 党费登记
 * 后端接口
 */
@RestController
@RequestMapping("/dangfeidengji")
public class DangfeidengjiController {
    private static final Logger logger = LoggerFactory.getLogger(DangfeidengjiController.class);

    @Autowired
    private DangfeidengjiService dangfeidengjiService;
    @Autowired
    private DictionaryService dictionaryService;

    /**
    * 后端列表
    */
    @RequestMapping("/page")
    public R page(@RequestParam Map<String, Object> params, HttpServletRequest request){
        // ... 角色判断和参数处理
        PageUtils page = dangfeidengjiService.queryPage(params);
        // 字典表数据转换
        List<DangfeidengjiView> list =(List<DangfeidengjiView>)page.getList();
        for(DangfeidengjiView c:list){
            dictionaryService.dictionaryConvert(c, request);
        }
        return R.ok().put("data", page);
    }

    /**
    * 后端保存
    */
    @RequestMapping("/save")
    public R save(@RequestBody DangfeidengjiEntity dangfeidengji, HttpServletRequest request){
        // ... 角色判断
        // 查重逻辑
        Wrapper<DangfeidengjiEntity> queryWrapper = new EntityWrapper<DangfeidengjiEntity>()
            .eq("zhibu_id", dangfeidengji.getZhibuId())
            .eq("dangfeidengji_name", dangfeidengji.getDangfeidengjiName());

        DangfeidengjiEntity existingEntity = dangfeidengjiService.selectOne(queryWrapper);
        if(existingEntity == null){
            dangfeidengji.setCreateTime(new Date());
            dangfeidengjiService.insert(dangfeidengji);
            return R.ok();
        } else {
            return R.error(511,"表中有相同数据");
        }
    }

    // ... 省略 update, delete 等方法
}

4.2 核心Mapper XML (NewsDao.xml)

展示了MyBatis的动态SQL查询能力，支持多条件筛选和关联查询（虽然此例中未关联其他表）。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.dao.NewsDao">

    <!-- 通用查询结果列 -->
    <sql id="Base_Column_List">
        a.id as id
        ,a.news_name as newsName
        ,a.news_types as newsTypes
        ,a.news_photo as newsPhoto
        ,a.insert_time as insertTime
        ,a.news_content as newsContent
        ,a.create_time as createTime
    </sql>

    <select id="selectListView" parameterType="map" resultType="com.entity.view.NewsView" >
        SELECT <include refid="Base_Column_List" />
        FROM news a
        <where>
            <if test=" params.newsName != '' and params.newsName != null and params.newsName != 'null' ">
                and a.news_name like CONCAT('%',#{params.newsName},'%')
            </if>
            <if test="params.newsTypes != null and params.newsTypes != ''">
                and a.news_types = #{params.newsTypes}
            </if>
            <!-- 其他条件 -->
        </where>
        order by a.${params.orderBy} desc 
    </select>

</mapper>

4.3 前端权限工具 (utils.js)

展示了前端如何根据当前用户的角色和预设的菜单权限，来判断是否显示某个操作按钮（如“新增”、“修改”）。

// 从storage中获取角色
import storage from './storage';
// 导入静态菜单配置
import menu from './menu';

/**
 * 是否有权限
 * @param {*} tableName 模块对应的表名
 * @param {*} key 操作按钮名称，如 '新增'
 */
export function isAuth(tableName, key) {
    // 获取当前用户角色
    let role = storage.get("role");
    if(!role){
        role = '管理员';
    }
    // 获取完整的菜单权限配置
    let menus = menu.list();
    // 遍历查找当前角色下是否有该模块的该操作权限
    for(let i=0;i<menus.length;i++){
        if(menus[i].roleName==role){
            for(let j=0;j<menus[i].backMenu.length;j++){
                for(let k=0;k<menus[i].backMenu[j].child.length;k++){
                    if(tableName==menus[i].backMenu[j].child[k].tableName){
                        let buttons = menus[i].backMenu[j].child[k].buttons.join(',');
                        // 判断操作是否在button列表中
                        return buttons.indexOf(key) !== -1 
                    }
                }
            }
        }
    }
    return false;
}

4.4 数据库初始化脚本 (db.sql)

该SQL文件用于创建数据库和所有表结构，并初始化部分必要数据。

-- 创建数据库
CREATE DATABASE /*!32312 IF NOT EXISTS*/`dangyuanjiaoyuguanli` /*!40100 DEFAULT CHARACTER SET utf8 */;
USE `dangyuanjiaoyuguanli`;

-- 创建党员表
CREATE TABLE `yonghu` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '主键',
  `username` varchar(200) DEFAULT NULL COMMENT '账户',
  `password` varchar(200) DEFAULT NULL COMMENT '密码',
  `yonghu_name` varchar(200) DEFAULT NULL COMMENT '党员姓名',
  `yonghu_photo` varchar(255) DEFAULT NULL COMMENT '证件照片',
  `minzu` varchar(200) DEFAULT NULL COMMENT '民族',
  `sex_types` int(11) DEFAULT NULL COMMENT '性别',
  `zhibu_id` int(200) DEFAULT NULL COMMENT '所在支部',
  `yonghu_delete` int(11) DEFAULT '1' COMMENT '假删',
  `create_time` timestamp NULL DEFAULT NULL COMMENT '创建时间',
  PRIMARY KEY (`id`)
);

-- 初始化管理员账户 (密码为 admin)
insert into `users`(`id`,`username`,`password`,`role`,`addtime`) values (1,'admin','admin','管理员','2021-02-25 15:59:12');

5. 部分截图

6. 项目总结

该“党员教育和管理系统”是一个功能完善、结构清晰的Java Web项目。它采用了当前主流的Spring Boot + MyBatis Plus + Vue.js技术栈，实现了从后端API到前端界面的完整闭环。

项目优点：

1. 功能契合需求：模块划分紧密围绕党员和支部管理的实际业务，如党费、奖惩、日志等，具有很高的实用性。
2. 设计成熟：
   • 通过数据字典管理下拉选项，提高了系统的灵活性和可维护性。
   • 使用逻辑删除（xxx_delete字段）保护数据安全。
   • 基于Token的身份验证和基于角色的访问控制（RBAC）设计合理。
   • 前后端分离的模式有利于分工协作和后期扩展。
3. 代码规范：后端代码结构清晰（Controller, Service, Dao, Entity），遵循了MVC模式。前端代码也有较好的模块化（如工具类utils.js的封装）。
4. 开箱即用：提供了完整的数据库脚本，方便开发人员快速搭建运行环境。

总结来说，这是一个高质量的毕业设计或小型企业级项目作品，它不仅实现了一个管理系统的核心增删改查功能，还在权限管理、数据字典、代码分层等方面都做得比较到位，具有很好的学习和参考价值。

7. 资源

https://fifteen.xiaobias.com/source/196