# JZY-WEB

**Repository Path**: WQF2018/jzy-web

## Basic Information

- **Project Name**: JZY-WEB
- **Description**: 企业官网
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-12-10
- **Last Updated**: 2025-12-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 简之远企业服务官网

## 项目结构
```
JZY-WEB/
├── frontend/                # 前端项目
│   ├── website/            # 官网前端
│   │   ├── src/           # 源代码
│   │   │   ├── api/       # API接口定义，包含与后端交互的请求函数
│   │   │   ├── assets/    # 静态资源，如图片、样式等
│   │   │   ├── components/# 可复用组件，如导航栏、页脚等
│   │   │   ├── router/    # 路由配置，定义页面跳转规则
│   │   │   ├── store/     # 状态管理，使用Pinia管理全局状态
│   │   │   ├── utils/     # 工具函数，如日期格式化、请求封装等
│   │   │   ├── views/     # 页面组件，如首页、服务页等
│   │   │   ├── App.vue    # 根组件，作为应用入口
│   │   │   └── main.ts    # 入口文件，初始化Vue应用
│   │   ├── public/        # 公共资源，如favicon、静态HTML等
│   │   ├── package.json   # 项目配置，定义依赖和脚本
│   │   ├── tsconfig.json  # TypeScript配置，定义编译选项
│   │   └── vite.config.js # Vite配置，定义构建和开发服务器选项
│   │
│   └── admin/             # 管理后台前端
│       ├── src/           # 源代码
│       │   ├── api/       # API接口定义，包含与后端交互的请求函数
│       │   ├── assets/    # 静态资源，如图片、样式等
│       │   ├── components/# 可复用组件，如表格、表单等
│       │   ├── router/    # 路由配置，定义页面跳转规则
│       │   ├── store/     # 状态管理，使用Pinia管理全局状态
│       │   ├── utils/     # 工具函数，如日期格式化、请求封装等
│       │   └── views/     # 页面组件，如登录页、管理页等
│       ├── public/        # 公共资源，如favicon、静态HTML等
│       ├── package.json   # 项目配置，定义依赖和脚本
│       ├── tsconfig.json  # TypeScript配置，定义编译选项
│       └── vite.config.js # Vite配置，定义构建和开发服务器选项
│
├── backend/               # 后端项目
│   ├── src/              # 源代码
│   │   ├── config/       # 配置文件，如数据库连接、环境变量等
│   │   ├── controllers/  # 控制器，处理业务逻辑，如文章、服务、留言等
│   │   ├── middleware/   # 中间件，如认证、日志、错误处理等
│   │   ├── models/       # 数据模型，定义数据库表结构
│   │   ├── routes/       # 路由，定义API端点
│   │   ├── utils/        # 工具函数，如响应封装、日期处理等
│   │   └── app.js        # 应用入口，初始化Express服务
│   ├── logs/             # 日志文件，记录应用运行日志
│   └── package.json      # 项目配置，定义依赖和脚本
│
├── database/             # 数据库相关
│   ├── init.sql         # 数据库初始化脚本，创建表结构
│   └── data.sql         # 基础数据脚本，插入初始数据
│
└── docs/                # 项目文档
    ├── api/            # API文档，详细说明接口定义
    └── database/       # 数据库文档，说明表结构和关系
```

## 技术栈
### 前端
- Vue 3 + TypeScript
- Vite
- Vue Router
- Pinia
- Element Plus
- Axios

### 后端
- Node.js
- Express
- MySQL
- JWT
- bcryptjs

## 开发环境要求
- Node.js >= 16.0.0
- MySQL >= 8.0
- Windows 10

## 快速开始

### 1. 克隆项目
```bash
git clone [项目地址]
cd JZY-WEB
```

### 2. 安装依赖
```bash
# 安装官网前端依赖
cd frontend/website
npm install

# 安装管理后台依赖
cd ../admin
npm install

# 安装后端依赖
cd ../../backend
npm install
```

### 3. 配置环境变量
在 backend 目录下创建 .env 文件：
```
PORT=3001
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASSWORD=123456
DB_NAME=jzy_web
JWT_SECRET=your_jwt_secret
```

### 4. 初始化数据库
```bash
# 登录MySQL
mysql -u root -p

# 执行初始化脚本
source database/init.sql
source database/data.sql
```

### 5. 启动项目
```bash
# 启动后端服务
cd backend
npm run dev

# 启动官网前端（新终端）
cd frontend/website
npm run dev

# 启动管理后台（新终端）
cd frontend/admin
npm run dev
```

## 项目说明
本项目是一个企业服务官网，包含以下主要功能：

### 前台展示
- 首页展示
- 服务项目展示
- 政策速递
- 关于我们
- 联系我们

### 管理后台
- 管理员登录
- 政策管理
- 服务管理
- 留言管理
- 网站设置

## 开发规范
1. 代码规范
   - 使用ESLint进行代码检查
   - 使用Prettier进行代码格式化
   - 遵循Vue 3组合式API规范

2. Git提交规范
   - feat: 新功能
   - fix: 修复bug
   - docs: 文档更新
   - style: 代码格式调整
   - refactor: 代码重构
   - test: 测试用例
   - chore: 构建过程或辅助工具的变动