# ticket-record

**Repository Path**: DoubleH0911/ticket-record

## Basic Information

- **Project Name**: ticket-record
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-04
- **Last Updated**: 2026-10-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 票根日记

票根日记是一款用于记录演出、漫展及其他线下活动的 uni-app 小程序。

## 简介

票根日记帮助用户管理各类线下活动的参与记录，包括演唱会、漫展、剧场演出等。用户可以追踪想去的活动、规划即将参加的活动、记录已参加活动的感受，并按艺人或嘉宾聚合查看参加历史。

## 主要功能

### 首页
- 下一场活动倒计时展示
- 活动参与统计数据
- 近期活动计划预览

### 活动管理
- 三种状态管理：想去、已计划、已参加
- 活动记录包含：时间、地点、票务信息、评分、现场感受
- 支持现场照片与票面照片上传

### 票夹
- 添加票根记录
- 按票根形式查看已参加活动
- 记录现场感受

### 人物档案
- 按艺人或嘉宾聚合参加记录
- 维护头像和备注信息
- 查看相关活动历史

### 用户系统
- 微信登录：通过 uni-id 区分用户
- 昵称和头像由用户主动选择设置

## 技术架构

### 前端
- **框架**：uni-app + Vue 3
- **状态管理**：Pinia
- **平台**：微信小程序

### 后端
- **云服务**：uniCloud (阿里云)
- **用户体系**：uni-id-pages
- **存储**：阿里云云存储、云数据库

### 项目结构

```
ticket-record/
├─ components/          # 公共组件
├─ composables/         # 组合式 API
├─ constants/           # 业务常量
├─ pages/               # 页面目录
│  ├─ home/            # 首页
│  ├─ activities/      # 活动管理
│  ├─ tickets/         # 票夹
│  ├─ people/          # 人物档案
│  ├─ login/           # 登录
│  ├─ mine/            # 我的
│  └─ ...
├─ services/            # 云对象客户端服务
├─ stores/              # 状态管理
├─ uniCloud-aliyun/    # 阿里云云端代码
│  ├─ cloudfunctions/ # 云函数
│  └─ database/        # 数据库 Schema
└─ utils/               # 工具函数
```

### 云端服务

| 云对象 | 功能说明 |
|--------|----------|
| activity-service | 活动 CRUD、状态管理、统计排行 |
| artist-service | 人物档案管理、头像绑定 |
| media-service | 媒体文件上传、清理、URL 解析 |
| ticket-record-common | 公共工具库、敏感字段检测 |

## 隐私保护

- **图片存储**：图片二进制上传至云存储，数据库仅保存媒体 ID、用途、归属和尺寸等引用信息
- **敏感信息**：不设置二维码、订单号或身份证字段，云端会拒绝疑似敏感字段
- **票面脱敏**：票面照片需用户自行裁剪或打码后上传，并勾选脱敏确认
- **数据隔离**：云端数据按 uni-id 用户 ID 隔离，保障用户隐私

## 快速开始

### 环境要求
- HBuilderX
- 微信开发者工具
- 阿里云服务空间

### 运行步骤

1. **打开项目**：使用 HBuilderX 打开 `ticket-record/` 目录

2. **配置云服务**：
   - 在 HBuilderX 中创建并关联阿里云服务空间
   - 导入官方 `uni-id-pages`
   - 上传 Schema、公共模块和云对象
   - 详细步骤请参考 [`uniCloud-aliyun/DEPLOYMENT.md`](ticket-record/uniCloud-aliyun/DEPLOYMENT.md)

3. **运行调试**：
   - 选择「运行到小程序模拟器 → 微信开发者工具」
   - 编译产物位于 `ticket-record/unpackage/dist/dev/mp-weixin/`

### 配置说明

微信小程序 AppID 已在 `manifest.json` 中配置。`AppSecret`、`tokenSecret` 和服务空间密钥为服务端敏感配置，请勿提交到代码仓库。

## 文档

- [部署指南](ticket-record/uniCloud-aliyun/DEPLOYMENT.md)
- [游客访问与登录整改](ticket-record/docs/guest-access.md)
- [审核整改说明](ticket-record/docs/releasing.md)
- [组件使用约定](ticket-record/docs/ui-components.md)

## 开源协议

本项目仅供学习交流使用。