From ab5d10a9caaaabf02a42064ca705cca72f0cd53d Mon Sep 17 00:00:00 2001 From: yindongqi Date: Wed, 25 Jun 2025 12:06:37 +0800 Subject: [PATCH] first commit --- README.md | 123 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 123 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..d1d8ef7 --- /dev/null +++ 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 + +## 许可证 + +私有项目,未经授权不得使用。 \ No newline at end of file