first commit

2025-06-25 12:06:37 +08:00 · 2025-06-25 12:06:37 +08:00 · ab5d10a9ca
commit ab5d10a9ca
1 changed files with 123 additions and 0 deletions
--- a/README.md
+++ b/README.md
@ -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: 推荐使用nvm（Node Version Manager）来管理Node.js版本：
+```bash
+# 安装指定版本
+nvm install 12.22.12
+nvm use 12.22.12
+```
+
+## 联系方式
+
+- 作者：王觉贤
+- 邮箱：615297896@qq.com
+
+## 许可证
+
+私有项目，未经授权不得使用。