first commit

This commit is contained in:
yindongqi 2025-06-25 12:06:37 +08:00
commit ab5d10a9ca

123
README.md Normal file
View File

@ -0,0 +1,123 @@
# JT360 前端项目
## 项目简介
JT360是一个基于Vue.js 2.x的前端项目使用Webpack 3.x作为构建工具。项目集成了Mint-UI组件库支持移动端开发。
## 技术栈
- **Vue.js 2.5.2** - 前端框架
- **Vue Router 3.0.1** - 路由管理
- **Vuex 3.0.1** - 状态管理
- **Mint-UI 2.2.13** - 移动端UI组件库
- **Webpack 3.6.0** - 构建工具
- **Axios 0.17.1** - HTTP客户端
- **Sass** - CSS预处理器
## 环境要求
### Node.js版本要求
**严格要求使用 Node.js 12.22.12 版本**
```bash
# 检查Node.js版本
node -v
# 应该显示: v12.22.12
```
### 其他要求
- npm >= 3.0.0
- 支持ES6+的现代浏览器
## 安装和运行
### 1. 克隆项目
```bash
git clone [项目地址]
cd jt360front
```
### 2. 安装依赖
```bash
npm install
# 或者使用yarn(推荐使用yarn)
yarn install
```
### 3. 开发环境运行
```bash
yarn dev
```
### 4. 生产环境构建
```bash
yarn build
```
## 项目结构
```
jt360front/
├── config/ # 配置文件
├── src/ # 源代码
│ ├── components/ # 组件
│ │ ├── common/ # 公共组件
│ │ ├── login/ # 登录相关组件
│ │ ├── signin/ # 签到相关组件
│ │ ├── study/ # 学习相关组件
│ │ └── user/ # 用户相关组件
│ ├── assets/ # 静态资源
│ ├── router/ # 路由配置
│ ├── utils/ # 工具函数
│ ├── vuex/ # 状态管理
│ └── weixin/ # 微信相关配置
├── static/ # 静态文件
└── index.html # 入口HTML文件
```
## 主要功能模块
- **用户认证** - 登录、注册、微信登录
- **学习系统** - 课程管理、考试系统、每日练习
- **用户中心** - 个人信息、证书管理、密码修改
- **签到系统** - 二维码签到、签到记录
- **留言系统** - 留言发布、查看、管理
## 开发注意事项
1. **Node.js版本**必须使用12.22.12版本,其他版本可能导致依赖包兼容性问题
2. **浏览器兼容性**支持现代浏览器不支持IE8及以下版本
3. **移动端适配**项目主要针对移动端开发使用了Mint-UI组件库
## 构建和部署
### 开发环境
- 访问地址:`http://localhost:8080`
- 支持热重载
- 自动打开浏览器
### 生产环境
- 执行 `yarn build` 生成dist目录
- 将dist目录内容部署到Web服务器
## 常见问题
### Q: 为什么必须使用Node.js 12.22.12
A: 项目依赖的某些包如node-sass 4.12.0对Node.js版本有严格要求使用其他版本可能导致编译错误。
### Q: 如何切换Node.js版本
A: 推荐使用nvmNode Version Manager来管理Node.js版本
```bash
# 安装指定版本
nvm install 12.22.12
nvm use 12.22.12
```
## 联系方式
- 作者:王觉贤
- 邮箱615297896@qq.com
## 许可证
私有项目,未经授权不得使用。