## 📱 项目特性

- 🚀 基于 Vue 3 + TypeScript 开发
- 📦 使用 Vite 作为构建工具
- 🎨 集成 uni-scss 主题系统
- 🔧 支持多平台发布（微信小程序、微信公众号）

## 🛠️ 技术栈

- **框架**: uni-app (Vue 3)
- **语言**: TypeScript
- **构建工具**: Vite
- **包管理器**: pnpm
- **样式**: SCSS + uni-scss
- **组件库**: uni-ui

## 📁 项目结构

```
uni-app-demo/
├── config/                 # 配置文件
│   ├── globalData.ts      # 全局数据配置
│   ├── index.ts           # 配置入口
│   └── menu.ts            # 菜单配置
├── hook/                  # 自定义 Hooks
│   ├── index.ts
│   └── use-on-load/       # 页面加载 Hook
├── pages/                 # 页面文件
│   ├── business/          # 业务页面
│   │   └── tabbar/        # TabBar 页面
│   │       ├── homePage/  # 首页
│   │       └── personalCenter/ # 个人中心
│   └── components/        # 页面组件
├── static/                # 静态资源
│   └── images/            # 图片资源
├── theme/                 # 主题样式
│   ├── common/            # 通用样式变量
│   ├── mixins/            # SCSS 混入
│   └── index.scss         # 主题入口
├── uni_modules/           # uni-ui 组件
├── utils/                 # 工具函数
├── App.vue                # 应用入口
├── main.js                # 主入口文件
├── manifest.json          # 应用配置
├── pages.json             # 页面配置
└── vite.config.js         # Vite 配置
```

## 🚀 快速开始

### 环境要求

- Node.js >= 18.0.0 | 20.0.0
- pnpm >= 9.5.0

### 安装依赖

```bash
# 使用 pnpm 安装依赖
pnpm install
```

### 开发运行

```bash
# 微信小程序开发
pnpm dev:mp-weixin

# 支付宝小程序开发
pnpm dev:mp-alipay

# H5 开发
pnpm dev:h5

# 公众号开发
pnpm dev:mp-gongzhonghao
```

### 构建发布

```bash
# 微信小程序构建
pnpm build:mp-weixin

# 支付宝小程序构建
pnpm build:mp-alipay

# H5 构建
pnpm build:h5

# 公众号构建
pnpm build:mp-gongzhongha
```

## 🎨 主题配置

项目使用 uni-scss 主题系统，支持：

- 自定义颜色变量
- 响应式设计
- 组件主题定制
- CSS 变量支持

项目支持主题色自定义，修改 `uni.scss` 文件中的 SCSS 变量：

```scss
// 主色
$uni-primary: #409eff;
// 成功色
$uni-success: #4cd964;
// 警告色
$uni-warning: #f0ad4e;
// 错误色
$uni-error: #dd524d;
```

## 🔧 开发配置

### 代理配置

开发环境已配置 API 代理，代理地址：`https://cs001.kasitesoft.com/`

### 路径别名

- `@` 指向项目根目录

### 全局数据

全局数据配置位于 `config/globalData.ts`，包含：

- 应用 ID 配置
- 登录状态管理
- 设备信息存储
- 渠道配置

## 📦 依赖管理

项目使用 pnpm 作为包管理器，提供以下脚本：

```bash
# 清理依赖
pnpm clean

# 清理 node_modules
pnpm clean:modules
```

## 📄 如何同步开发 @kasite/uni-app-base

1. 本地创建文件夹 `uni-app-base`

2. 将 `@kasite/uni-app-base` 源代码复制到 `uni-app-base` 文件夹下

3. 修改 `package.json` 文件中的 `@kasite/uni-app-base` 引用为 `workspace:*`

```json
"dependencies": {
  "@kasite/uni-app-base": "workspace:*"
}
```

4. 运行 `pnpm install` 安装依赖