# OfflineApp

**Repository Path**: starry123/OfflineApp

## Basic Information

- **Project Name**: OfflineApp
- **Description**: OfflineApp
- **Primary Language**: NodeJS
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 可婕君 - 基于 uniapp 的 APP 移动端

可婕君是一款基于 uni-app 开发的移动端应用，提供了丰富的功能模块，包括记账、账本管理、工作台、系统管理等。

## 📦 功能模块

### 1. 工作台 (workbench)
- 常用应用快速访问
- 应用分类展示
- 搜索应用功能
- 通知提醒
- 横幅展示

### 2. 系统管理 (system)
- 用户管理
- 角色管理
- 职位管理
- 机构管理
- 系统配置
- 字典管理
- 菜单管理
- 日志管理

### 3. 个人中心 (user)
- 个人资料
- 设置
- 反馈
- 帮助
- 关于

### 4. 认证功能 (auth)
- 登录

  ![登录](/Doc/img/login.png)

  

- 注册

- 忘记密码

- 个人资料编辑



- ![记账](/Doc/img/record.png)

- ![记账添加](/Doc/img/record-add.png)

- 

- ![体重](/Doc/img/weigh.png)

- 

- ![体重添加](/Doc/img/weigh-add.png)

  

  

## 🛠️ 技术栈

- **框架**: uni-app (Vue 2)
- **UI组件库**: uView UI
- **样式预处理器**: SCSS
- **状态管理**: Vuex
- **开发工具**: HBuilderX

## 📁 目录结构

```
├── src/
│   ├── api/             # API请求封装
│   ├── components/      # 自定义组件和uni-ui组件
│   ├── config/          # 配置文件
│   ├── pages/           # 页面组件
│   │   ├── auth/        # 认证相关（登录、注册、忘记密码）
│   │   ├── system/      # 系统管理（用户、角色、菜单、字典等）
│   │   ├── tabbar/      # 底部标签栏页面（首页、工作台、我的）
│   │   ├── user/        # 用户相关（个人资料、设置、反馈）
│   │   ├── bookkeeping/ # 记账相关
│   │   └── leger/       # 账本相关
│   ├── plugins/         # 插件（uView UI）
│   ├── router/          # 路由配置
│   ├── static/          # 静态资源（图片、图标）
│   ├── store/           # Vuex状态管理
│   ├── utils/           # 工具函数
│   ├── App.vue          # 应用入口组件
│   ├── main.js          # 应用入口文件
│   ├── manifest.json    # 应用配置
│   ├── pages.json       # 页面配置
│   └── uni.scss         # 全局样式变量
├── public/              # 静态资源（H5端）
├── package.json         # 项目依赖
└── README.md            # 项目说明文档
```

## 🍿 运行

### 方式一：使用 HBuilderX（推荐）
```
1. 将项目拖入 HBuilderX
2. 在 `src/config/` 目录下的配置文件中修改后端接口地址（默认：http://localhost:6662/api/v1）
3. 点击 HBuilderX 状态栏的运行按钮，选择运行到手机或浏览器
```

### 方式二：使用命令行
```bash
# 安装依赖
npm install

# 运行到 H5
npm run dev:h5

# 运行到微信小程序
npm run dev:mp-weixin

# 运行到 App
npm run dev:app
```

## 📱 构建

```bash
# 构建 H5
npm run build:h5

# 构建微信小程序
npm run build:mp-weixin

# 构建 App
npm run build:app
```

## 🎨 开发规范

### 1. 组件命名规范
- 页面组件：使用短横线命名法（如 `sys-user-page`）
- 自定义组件：使用短横线命名法（如 `custom-button`）
- 组件文件：使用短横线命名法（如 `user-info.vue`）

### 2. 代码风格
- 使用 2 个空格缩进
- 变量命名使用驼峰命名法
- 常量命名使用全大写，单词间用下划线分隔
- 函数命名使用驼峰命名法

### 3. 样式规范
- 使用 SCSS 预处理器
- 样式文件与组件文件同名，使用 `style scoped`
- 全局样式定义在 `uni.scss` 中
- 使用 rpx 作为尺寸单位

### 4. API 规范
- API 请求统一封装在 `src/api/` 目录下
- 每个模块的 API 单独封装在一个文件中
- 使用 `request.js` 封装基础请求方法

## 📋 注意事项

1. 确保 Node.js 版本 >= 12.0.0
2. 使用 HBuilderX 开发时，建议安装 uni-app 插件和 uView UI 插件
3. 修改后端接口地址时，需同时修改开发环境和生产环境的配置
4. 开发微信小程序时，需在微信开发者工具中设置合法域名
5. 构建 App 时，需配置相应的 App 证书

## 🤝 贡献

欢迎提交 Issue 和 Pull Request，共同完善可婕君应用。

## 📄 许可证

MIT License

## 📞 联系方式

如有问题或建议，欢迎联系我们。

---

**可婕君** - 让生活更便捷