# pubres

**Repository Path**: achang_13/pubres

## Basic Information

- **Project Name**: pubres
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-21
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 惠州市公共资源交易系统

## 项目简介

本系统是**惠州市公共资源交易中心**委托开发的政府招投标管理系统，用于规范和数字化公共资源交易全流程。

### 核心目标

- 实现招投标全流程电子化（项目登记 → 招标 → 投标 → 开标 → 评标 → 定标 → 归档）
- 满足**等保三级**信息安全要求
- 对接省级交易平台（WebService）
- 服务 10+ 政府部门、2000+ 投标企业、500+ 评标专家

## 技术栈

### 后端技术

| 技术 | 版本 | 用途 |
|------|------|------|
| Spring Boot | 2.7.18 | 应用框架 |
| Spring Security | (managed) | 认证授权 |
| MyBatis-Plus | 3.5.3.1 | ORM 框架 |
| Druid | 1.2.16 | 数据库连接池 |
| Java | 1.8 | 运行环境 |
| JJWT | 0.9.1 | JWT Token |
| Redis | 7.0 | 缓存/会话 |
| RabbitMQ | 3.12 | 消息队列 |
| WebSocket | STOMP | 实时通信 |
| Activiti | 5.22.0 | 工作流 |
| MinIO | 8.5.2 | 对象存储 |
| Knife4j | 4.1.0 | API文档 |
| Flyway | (managed) | 数据库迁移 |

### 前端技术

| 技术 | 版本 | 用途 |
|------|------|------|
| Vue | 2.6.14 | 前端框架 |
| Vue Router | 3.5.4 | 路由管理 |
| Vuex | 3.6.2 | 状态管理 |
| Element UI | 2.15.14 | UI组件库 |
| TDesign Vue | 1.14.5 | UI组件库 |
| Axios | 0.27.2 | HTTP客户端 |
| ECharts | 5.4.3 | 图表 |
| dayjs | 1.11.9 | 日期处理 |
| js-cookie | 3.0.1 | Cookie管理 |

## 项目结构

```
lsc-publicResource/
├── backend/                    # 后端项目
│   ├── pom.xml                # Maven配置
│   └── src/
│       └── main/
│           ├── java/com/huizhou/pubres/
│           │   ├── PubResApplication.java    # 启动类
│           │   ├── common/                   # 公共层
│           │   ├── framework/                # 框架层
│           │   └── modules/                  # 业务模块
│           └── resources/
│               ├── application.yml           # 主配置
│               ├── application-dev.yml       # 开发配置
│               └── db/migration/             # Flyway脚本
│
├── frontend/                   # 前端项目
│   ├── package.json          # 依赖配置
│   ├── vue.config.js         # 构建配置
│   └── src/
│       ├── main.js           # 入口文件
│       ├── App.vue           # 根组件
│       ├── permission.js     # 路由守卫
│       ├── router/           # 路由定义
│       ├── store/            # 状态管理
│       ├── api/              # API服务
│       ├── utils/            # 工具函数
│       ├── layout/           # 布局组件
│       ├── components/       # 公共组件
│       └── views/            # 页面组件
│
├── docker/                     # Docker环境
│   ├── docker-compose.yml    # 编排配置
│   ├── mysql/                # MySQL配置
│   ├── redis/                # Redis配置
│   └── README.md             # 使用说明
│
└── docs/                       # 项目文档
    ├── 01-项目总览.md
    ├── 02-系统架构设计.md
    ├── 03-功能模块拆解.md
    ├── 04-数据库设计分析.md
    ├── 05-技术栈深度分析.md
    ├── 06-设计模式与亮点.md
    ├── 07-安全体系设计.md
    ├── 08-开发路线图.md
    └── 09-角色功能拆解与开发计划.md
```

## 快速开始

### 环境要求

- JDK 1.8+
- Node.js 12+
- Docker Desktop 4.0+
- Maven 3.6+

### 启动Docker环境

```bash
# 进入docker目录
cd docker

# 启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps
```

### 启动后端

```bash
# 进入后端目录
cd backend

# 安装依赖
mvn clean install

# 启动应用
mvn spring-boot:run
```

后端启动后访问：
- API文档: http://localhost:8088/pubres/doc.html
- Druid监控: http://localhost:8088/pubres/druid

### 启动前端

```bash
# 进入前端目录
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

前端启动后访问：http://localhost:9528

### 初始账号

| 用户名 | 密码 | 角色 |
|--------|------|------|
| admin | admin123 | 系统管理员 |
| tenderer | admin123 | 招标人 |
| bidder | admin123 | 投标人 |
| expert | admin123 | 评标专家 |
| supervisor | admin123 | 监督人员 |

## 功能模块

### 1. 系统管理模块 (admin)
- 用户管理、角色管理、菜单管理
- 组织机构、数据字典、系统配置
- 日志管理、专家库、投标人库

### 2. 项目登记模块 (tenderer)
- 项目创建、编辑、审批
- 项目状态管理

### 3. 招标管理模块 (tenderer)
- 招标文件编制、发布
- 评分配置、质疑答疑
- 招标变更管理

### 4. 投标管理模块 (bidder)
- 投标文件上传、加密
- 保证金管理、资质管理
- 资格审查

### 5. 开标管理模块 (all)
- 开标大厅（WebSocket实时）
- 6步开标流程
- 大屏展示

### 6. 评标管理模块 (expert)
- 专家抽取、评标打分
- 投票系统（Redis缓存）
- 评标报告

### 7. 定标管理模块 (tenderer)
- 中标公示、合同管理
- 项目归档

### 8. 监督管理模块 (supervisor)
- 全流程监督、投诉处理
- 穿透式监管

### 9. 公共门户模块 (public)
- 公告公示、中标公示

### 10. 消息通知模块 (all)
- 站内消息、订阅管理

## 开发规范

### 代码规范

- 后端遵循阿里巴巴Java开发手册
- 前端遵循Vue.js风格指南
- 使用Lombok简化代码
- 统一异常处理和响应封装

### API规范

```
GET    /api/v1/{module}/{resource}        # 列表
GET    /api/v1/{module}/{resource}/{id}   # 详情
POST   /api/v1/{module}/{resource}        # 创建
PUT    /api/v1/{module}/{resource}/{id}   # 更新
DELETE /api/v1/{module}/{resource}/{id}   # 删除
```

### 响应格式

```json
{
  "success": true,
  "data": {},
  "error": null
}
```

## 部署说明

### 开发环境

使用Docker Compose一键部署所有依赖服务。

### 生产环境

1. 配置生产环境数据库
2. 配置Redis、RabbitMQ、MinIO
3. 构建后端jar包
4. 构建前端dist
5. 配置Nginx反向代理
6. 使用Docker或直接部署

## 相关文档

详细文档请参考 `docs/` 目录：

- [项目总览](docs/01-项目总览.md)
- [系统架构设计](docs/02-系统架构设计.md)
- [功能模块拆解](docs/03-功能模块拆解.md)
- [数据库设计分析](docs/04-数据库设计分析.md)
- [技术栈深度分析](docs/05-技术栈深度分析.md)
- [设计模式与亮点](docs/06-设计模式与亮点.md)
- [安全体系设计](docs/07-安全体系设计.md)
- [开发路线图](docs/08-开发路线图.md)
- [角色功能拆解与开发计划](docs/09-角色功能拆解与开发计划.md)

## 📊 项目规模

| 维度 | 数量 |
|------|------|
| 后端 Controller | 37 个 |
| 数据库表 | ~88 张 |
| 前端页面 | 76 个 Vue 组件 |
| API 接口文件 | 39 个 |
| PRD 文档 | 9 份 |
| 系统设计文档 | 13 份 |
| 角色权限文档 | 8 份 |

## 许可证

Copyright © 2024 惠州市公共资源交易中心

All rights reserved.