# glass_stand

**Repository Path**: ooooinfo/glass_stand

## Basic Information

- **Project Name**: glass_stand
- **Description**: 眼镜工具 
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-20
- **Last Updated**: 2026-06-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GlassStand — PD Measurement App

多参考物瞳距(PD)测量应用，面向线上眼镜配镜场景。

## 项目结构

```
glass_stand/
├── app/              ← Flutter 前端（瞳距测量 App）
├── glassadmin/       ← Python FastAPI 后端（用户/试用/许可管理）
└── adminvue/         ← Vue3 管理后台（数据总览 + 用户/购买管理）
```

## 快速启动

### 后端 (glassadmin)
```bash
cd glassadmin
pip install -e ".[dev]"
bash run.sh           # 启动在 :8867
```

### 管理后台 (adminvue)
```bash
cd adminvue
npm install
npm run dev           # 启动在 :3001
# 登录: admin / glassstand2024
```

### Flutter App (app)
```bash
cd app
flutter pub get
flutter run --dart-define=ENV=staging
```

## API 端点

| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/v1/register` | POST | 设备注册 |
| `/api/v1/license/check` | POST | 许可状态查询 |
| `/api/v1/trial/consume` | POST | 消耗试用次数 |
| `/api/v1/purchase/record` | POST | 记录购买 + 收据验证 |
| `/api/v1/purchase/restore` | POST | 恢复购买 |
| `/api/v1/admin/login` | POST | 管理员登录 (JWT) |
| `/api/v1/admin/dashboard` | GET | 数据总览 |

## 技术栈

- **前端**: Flutter 3.x + Dart, Google ML Kit Face Mesh (468点人脸网格)
- **后端**: FastAPI + SQLAlchemy + MySQL (asyncmy)
- **管理后台**: Vue3 + Vite + Element Plus + Pinia
- **数据库**: MySQL (远程) + SQLite (本地存储)

## 核心功能

通过手机前置摄像头拍照，同时使用多种已知尺寸参考物（银行卡/身份证/硬币/ArUco标定卡/虹膜估算）交叉验证计算瞳距，提供带置信度的多方法比对结果。