# wallpaper

**Repository Path**: ali0074/wallpaper

## Basic Information

- **Project Name**: wallpaper
- **Description**: uniapp+unicloud 的壁纸项目完整代码
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-10-26
- **Last Updated**: 2026-01-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 炫壁 - 高清壁纸精选小程序

一款基于UniApp和UniCloud云开发的美观、轻量级壁纸小程序。为用户提供海量高清、分类清晰的手机壁纸，支持浏览、搜索、收藏和下载。

## 技术栈

- **前端**: UniApp (Vue 3 + Vite)+UniCloud
- **后端/云服务**: UniCloud（阿里云版）
- **数据库**: UniCloud JSON数据库

## 项目结构

```
project-root/
├── cloudfunctions/       # 云函数目录
│   ├── wallpaper/        # 壁纸相关云函数
│   ├── category/         # 分类相关云函数
│   ├── favorite/         # 收藏相关云函数
│   └── ...
├── components/           # 通用组件
│   ├── wallpaper-grid.vue # 壁纸瀑布流组件
├── pages/                # 页面文件
│   ├── index/            # 首页
│   ├── category/         # 分类相关页面
│   ├── detail/           # 壁纸详情页
│   ├── profile/          # 个人中心
│   ├── search/           # 搜索页面
│   ├── download/         # 下载历史
│   ├── feedback/         # 意见反馈
│   ├── setting/          # 设置页面
│   └── admin/            # 管理员页面
├── static/               # 静态资源
├── database/
│   └── db_init.json      # 数据库初始化文件
├── App.vue               # 应用入口文件
├── main.js               # 入口文件
├── manifest.json         # 应用配置
├── pages.json            # 页面配置
└── uni.scss              # 全局样式变量
```

## 功能特性

### 用户端
- 🏠 首页瀑布流壁纸展示
- 🔍 关键词搜索壁纸
- 📂 分类浏览壁纸
- ❤️ 收藏/取消收藏壁纸
- 📥 下载壁纸到相册
- 📝 个人中心管理收藏和下载记录
- 💬 意见反馈功能
- ⚙️ 应用设置（清除缓存、通知设置等）

### 管理端
- 🔐 管理员登录
- 🖼️ 壁纸上传、编辑、删除
- 📂 分类管理
- 👥 用户管理
- 📝 反馈管理

## 安装与运行

### 前置要求
- Node.js 14+
- HBuilderX 3.6+
- UniCloud 阿里云账号

### 安装步骤

1. **克隆项目**
```bash
git clone <repository-url>
cd TREA-wallpaper
```

2. **初始化UniCloud环境**
   - 在HBuilderX中打开项目
   - 点击顶部菜单 `uniCloud > 关联云服务空间`
   - 选择或创建阿里云云服务空间

3. **初始化数据库**
   - 右键点击 `database` 目录
   - 选择 `初始化数据库`
   - 选择 `db_init.json` 文件

4. **上传云函数**
   - 右键点击 `cloudfunctions` 目录
   - 选择 `上传部署`

5. **运行项目**
   - 点击工具栏的运行按钮
   - 选择运行到微信开发者工具或其他平台

## 数据库设计

项目包含以下主要数据集合：
- `uni-id-users`: 用户表（UniID自动创建）
- `wallpapers`: 壁纸表
- `categories`: 分类表
- `favorites`: 收藏表
- `downloads`: 下载历史表
- `feedback`: 意见反馈表

详细字段定义请查看 `database/db_init.json` 文件。

## 开发注意事项

1. **权限控制**
   - 管理员操作的云函数需要进行权限校验
   - 用户操作需要验证登录状态

2. **性能优化**
   - 图片使用懒加载
   - 实现分页加载
   - 列表页使用缩略图

3. **用户体验**
   - 下载操作前请求相册权限
   - 异步操作提供加载状态提示
   - 错误处理和用户反馈

## 构建与发布

1. **构建H5**
   - 点击顶部菜单 `发行 > 网站-PC Web或手机H5`
   - 选择目标平台构建

2. **构建小程序**
   - 点击顶部菜单 `发行 > 小程序-微信`
   - 配置小程序AppID后构建

## 管理员登录

- 管理端入口：`/pages/admin/login`
- 初始账号/密码：admin/admin123
- 生产环境请务必修改默认密码

## 许可证

MIT