# Dj-APP

**Repository Path**: minisoft_1/dj-app

## Basic Information

- **Project Name**: Dj-APP
- **Description**: D建管理系统
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-13
- **Last Updated**: 2025-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智慧党建系统

## 项目简介

智慧党建系统是一个集宣传、管理、服务、互动、教育、学习于一体的综合性党建平台。系统支持手机端和多终端适配学习，包含党员管理、组织管理、党费缴纳、学习答题、风采展示、积分商城等功能模块。

## 技术架构

### 前端技术栈
- **UniApp**: 跨平台移动应用开发框架
- **Vue.js**: 渐进式JavaScript框架
- **uni-ui**: UniApp官方UI组件库

### 后端技术栈
- **Spring Boot**: Java企业级应用开发框架
- **Spring Security**: 安全认证框架
- **MyBatis Plus**: 持久层框架
- **MySQL**: 关系型数据库
- **Redis**: 缓存数据库
- **JWT**: JSON Web Token认证
- **Knife4j**: API文档工具

## 项目结构

```
881/
├── pages/                    # 前端页面
│   ├── index/               # 首页
│   ├── login/               # 登录页
│   ├── study/               # 学习栏目
│   ├── exam/                # 答题系统
│   ├── dues/                # 党费缴纳
│   ├── member/              # 党员管理
│   ├── mall/                # 积分商城
│   └── profile/             # 个人中心
├── api/                     # API接口
├── utils/                   # 工具类
├── static/                  # 静态资源
├── D-Server/                # 后端服务
│   ├── src/main/java/       # Java源码
│   │   └── com/party/       # 主包
│   │       ├── config/      # 配置类
│   │       ├── controller/  # 控制器
│   │       ├── service/     # 服务层
│   │       ├── mapper/      # 数据访问层
│   │       ├── entity/      # 实体类
│   │       ├── dto/         # 数据传输对象
│   │       ├── common/      # 公共类
│   │       ├── security/    # 安全配置
│   │       └── util/        # 工具类
│   ├── src/main/resources/  # 资源文件
│   └── sql/                 # 数据库脚本
└── README.md               # 项目说明
```

## 功能模块

### 1. 门户首页
- 党建工作内容展示
- 相关资讯发布
- 政策动态更新
- 快捷功能入口

### 2. 学习栏目
- 文章学习资料
- 音视频学习内容
- 学习进度跟踪
- 学习记录统计

### 3. 答题系统
- 多种题型支持（选择题、判断题、填空题）
- 随机组卷功能
- 考试时间限制
- 成绩统计分析

### 4. 党费缴纳
- 党费标准管理
- 缴费记录查询
- 逾期提醒功能
- 财务统计报表

### 5. 党员管理
- 党员信息维护
- 组织关系管理
- 党员发展流程
- 优秀党员评选

### 6. 积分商城
- 积分获取规则
- 商品兑换功能
- 兑换记录查询
- 库存管理

## 环境要求

### 开发环境
- Node.js 14+
- JDK 1.8+
- Maven 3.6+
- MySQL 8.0+
- Redis 6.0+

### 开发工具
- HBuilderX (前端开发)
- IntelliJ IDEA (后端开发)
- Navicat (数据库管理)

## 快速开始

### 1. 数据库初始化

```sql
-- 创建数据库
CREATE DATABASE DOA DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 导入初始化脚本
mysql -u root -p DOA < D-Server/sql/init.sql
```

### 2. 后端启动

```bash
# 进入后端目录
cd D-Server

# 编译项目
mvn clean compile

# 启动服务
mvn spring-boot:run
```

后端服务将在 `http://localhost:8080` 启动

### 3. 前端启动

```bash
# 在项目根目录下
# 使用HBuilderX打开项目
# 运行到浏览器或移动设备
```

### 4. 访问系统

- 前端地址: 根据运行环境确定
- 后端API: http://localhost:8080/api
- API文档: http://localhost:8080/api/doc.html

## 默认账号

| 用户名 | 密码 | 角色 | 说明 |
|--------|------|------|------|
| admin | 123456 | 管理员 | 系统管理员账号 |
| zhangsan | 123456 | 正式党员 | 测试党员账号 |
| lisi | 123456 | 预备党员 | 测试党员账号 |

## API接口

### 认证相关
- POST `/api/auth/login` - 用户登录
- POST `/api/auth/register` - 用户注册
- GET `/api/auth/userinfo` - 获取用户信息
- POST `/api/auth/logout` - 用户登出

### 学习相关
- GET `/api/study/materials` - 获取学习资料列表
- GET `/api/study/materials/{id}` - 获取学习资料详情
- POST `/api/study/record` - 记录学习进度

### 考试相关
- GET `/api/exam/list` - 获取考试列表
- GET `/api/exam/{id}` - 获取考试详情
- POST `/api/exam/submit` - 提交答卷

### 党费相关
- GET `/api/dues/list` - 获取党费记录
- POST `/api/dues/pay` - 缴纳党费

### 积分商城
- GET `/api/mall/goods` - 获取商品列表
- POST `/api/mall/exchange` - 兑换商品

## 配置说明

### 数据库配置
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/DOA
    username: root
    password: root
```

### JWT配置
```yaml
jwt:
  secret: smartPartyBuildingSecretKey2023
  expiration: 604800  # 7天
```

### 文件上传配置
```yaml
file:
  upload:
    path: /uploads/
    max-size: 100MB
```

## 部署说明

### 1. 生产环境配置
- 修改数据库连接信息
- 配置Redis连接
- 设置文件上传路径
- 配置JWT密钥

### 2. 打包部署
```bash
# 后端打包
cd D-Server
mvn clean package

# 前端打包
# 使用HBuilderX发行到各个平台
```

## 开发规范

### 1. 代码规范
- 遵循阿里巴巴Java开发手册
- 使用统一的代码格式化配置
- 添加必要的注释和文档

### 2. 接口规范
- 统一返回结果格式
- 规范的HTTP状态码使用
- 完整的API文档

### 3. 数据库规范
- 统一的表名和字段命名
- 必要的索引和约束
- 逻辑删除标记

## 常见问题

### 1. 数据库连接失败
- 检查数据库服务是否启动
- 确认连接参数是否正确
- 检查防火墙设置

### 2. JWT认证失败
- 检查token是否过期
- 确认请求头格式正确
- 验证JWT密钥配置

### 3. 文件上传失败
- 检查上传路径权限
- 确认文件大小限制
- 验证文件类型限制

## 更新日志

### v1.0.0 (2023-10-13)
- 初始版本发布
- 完成基础功能模块
- 支持用户认证和授权
- 实现学习、考试、党费、积分商城功能

## 联系方式

如有问题或建议，请联系开发团队。

## 许可证

本项目采用 MIT 许可证。