# bullion-premium-miniprogram

**Repository Path**: recallg/bullion-premium-miniprogram

## Basic Information

- **Project Name**: bullion-premium-miniprogram
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-28
- **Last Updated**: 2026-01-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 金银投资小程序

基于设计稿实现的微信小程序，提供贵金属投资相关的功能。
可以扫码查看效果：![扫码查看](https://gitee.com/recallg/bullion-premium-miniprogram/raw/main/images/qr.jpeg)

## 功能特性

### 主要页面
1. **首页** - 实时行情、热门产品、价格走势
2. **行情页** - 详细行情信息
3. **资产页** - 资产管理和统计
4. **我的页** - 个人中心和工具入口

### 功能模块
- ✅ 实时行情展示（黄金、白银）
- ✅ 价格换算（国际价格转人民币）
- ✅ 溢价计算器
- ✅ 资产管理（添加、查看、删除）
- ✅ 资产统计（持仓数量、价值、盈亏）

## 项目结构

```
miniprogram/
├── app.js              # 全局逻辑
├── app.json            # 全局配置
├── app.wxss            # 全局样式
├── pages/              # 页面目录
│   ├── index/          # 首页
│   ├── market/         # 行情页
│   ├── assets/         # 资产页
│   │   ├── gold-list/  # 黄金资产列表
│   │   ├── silver-list/# 白银资产列表
│   │   └── add-asset/  # 添加资产
│   ├── profile/        # 我的页
│   ├── convert/        # 价格换算
│   └── premium/        # 溢价信息
├── utils/              # 工具函数
│   └── calculator.js   # 计算工具
└── images/             # 图片资源（需要添加）

```

## 设计规范

### 颜色系统
- **背景色**: `#1A1A1C` (深黑)
- **卡片色**: `#242426` (深灰)
- **强调色**: `#C9A962` (金色)
- **主文字**: `#F5F5F0` (浅灰白)
- **次要文字**: `#6E6E70` (中灰)
- **成功色**: `#6E9E6E` (绿色)
- **危险色**: `#E57373` (红色)

### 字体
- **标题**: 32px / 24px / 20px / 18px
- **正文**: 14px
- **小字**: 12px / 10px

### 间距
- **xs**: 4px
- **sm**: 8px
- **md**: 12px
- **lg**: 16px
- **xl**: 20px
- **2xl**: 24px

### 圆角
- **小**: 12px
- **中**: 16px
- **大**: 20px
- **超大**: 24px
- **圆形**: 50%

## 使用说明

### 1. 配置小程序

1. 打开微信开发者工具
2. 导入项目，选择 `miniprogram` 目录
3. 在 `project.config.json` 中配置你的 AppID

### 2. 添加图标资源

需要在 `images` 目录下添加以下图标文件：

- `tab-home.png` / `tab-home-active.png` - 首页图标
- `tab-market.png` / `tab-market-active.png` - 行情图标
- `tab-assets.png` / `tab-assets-active.png` - 资产图标
- `tab-profile.png` / `tab-profile-active.png` - 我的图标
- `icon-bell.png` - 通知图标
- `icon-search.png` - 搜索图标
- `icon-gold.png` - 黄金图标
- `icon-silver.png` - 白银图标
- `icon-user.png` - 用户图标
- `icon-calculator.png` - 计算器图标
- `icon-trend.png` - 趋势图标
- `icon-arrow-right.png` - 右箭头
- `icon-arrow-down.png` - 下箭头
- `icon-calendar.png` - 日历图标
- `icon-up.png` - 上涨图标
- `icon-refresh.png` - 刷新图标
- `icon-edit.png` - 编辑图标

### 3. 数据说明

#### 全局数据
- `marketData`: 实时行情数据
- `exchangeRate`: 汇率（默认 7.2）
- `assets`: 用户资产数据（存储在本地）

#### 数据存储
- 资产数据使用 `wx.setStorageSync` 存储在本地
- 行情数据在 `app.js` 中初始化，可连接真实API

### 4. 功能说明

#### 价格换算
- 输入国际金价/银价（美元/盎司）
- 自动计算人民币价格（元/克）
- 公式：`人民币价格 = (美元价格 × 汇率) / 31.1035`

#### 溢价计算
- 选择金属类型（黄金/白银）
- 输入基准价格和买入价格
- 自动计算溢价金额、溢价率、溢价等级
- 溢价等级：
  - 0-5%: 正常溢价（绿色）
  - 5-10%: 偏高溢价（黄色）
  - >10%: 高溢价（红色）

#### 资产管理
- 添加资产：输入价格、克数、渠道、时间
- 查看资产：显示持仓数量、价值、均价、盈亏
- 删除资产：长按或点击删除按钮

## 开发说明

### 数据更新
- 行情数据每3秒自动更新（可在 `pages/index/index.js` 中调整）
- 资产数据实时计算，基于当前市场价格

### API 接口
目前使用模拟数据，实际开发时需要：
1. 连接真实行情API
2. 实现用户登录/注册
3. 实现数据同步（云端存储）

### 待完善功能
- [ ] 搜索功能
- [ ] 通知功能
- [ ] 图表展示（价格走势）
- [ ] 资产编辑功能
- [ ] 数据导出
- [ ] 用户登录
- [ ] 数据同步

## 注意事项

1. **图标资源**: 需要添加所有图标文件，否则部分页面可能显示异常
2. **AppID**: 需要在 `project.config.json` 中配置你的小程序 AppID
3. **数据持久化**: 资产数据存储在本地，清除缓存会丢失数据
4. **样式单位**: 使用 `rpx` 单位，适配不同屏幕尺寸

## 技术栈

- 微信小程序原生框架
- JavaScript ES6+
- WXSS (类似 CSS)

## 版本信息

- 版本: 1.0.0
- 基于设计稿: pencil-new.pen
- 设计分析文档: 设计稿分析.md