# summitos

**Repository Path**: sparguan/summitos

## Basic Information

- **Project Name**: summitos
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SummitOS MaaS

SummitOS MaaS 是一个面向攀岩馆的会员卡与运营工作台演示项目。项目使用 React、TypeScript 和 Vite 构建，包含用户端卡包、运动商城、附近门店、使用记录，以及运营端入场核销、会员管理、发卡运营和数据报表等功能。

线上地址：https://summitos.caiyai.com/

## 功能概览

- 会员登录：内置演示账号，打开页面后可直接登录体验。
- 用户端卡包：查看次数卡、期限卡、剩余次数、剩余天数、适用门店和最近使用记录。
- 会籍中心：展示会员等级、成长积分、权益套餐和升级状态。
- 运动商城：展示攀岩装备、耗材、安全装备和训练器材。
- 附近门店：展示门店距离、营业状态、人流负载和标签。
- 运营端核销：按会员卡进行入场核销，实时更新核销流水。
- 会员管理：查看会员持卡、消费、剩余次数和最近到店情况。
- 发卡运营：支持发卡、暂停、续费、退卡等演示操作。
- 数据报表：展示营收、发卡、活跃会员、退卡率和门店收入结构。

## 功能截图

### 登录页

![登录页](./docs/screenshots/login.png)

### 用户端卡包

![用户端卡包](./docs/screenshots/member-wallet.png)

### 运营端核销台

![运营端核销台](./docs/screenshots/operator-checkin.png)

## 技术栈

- React 19
- TypeScript 5
- Vite 6
- lucide-react
- CSS 响应式布局

## 本地运行

```bash
npm install
npm run dev
```

默认开发服务会监听本机地址，终端会输出可访问 URL。

## 构建

```bash
npm run build
```

构建产物输出到 `dist/`。

## 预览生产包

```bash
npm run preview
```

## 演示数据说明

项目当前使用前端内置演示数据，核心数据包括：

- 会员：陈思敏、李嘉乐、王凯文、试攀用户
- 卡种：10 次抱石卡、季度攀岩卡、20 次先锋私教卡、月攀岩卡、日体验卡
- 门店：中环 Boulder Project、九龙塘 Vertical Hub、铜锣湾 Summit Lab、尖沙咀 Crag Zone
- 运营指标：今日入场、可核销卡、本时段流水、闸机在线状态、营收结构等

这些数据用于产品原型和展示，不依赖后端接口。

## 部署说明

当前线上站点部署为静态文件服务：

- 域名：`summitos.caiyai.com`
- 构建目录：`dist/`
- 推荐 Web 服务：nginx
- SPA 路由回退：`try_files $uri $uri/ /index.html`

## 项目结构

```text
.
├── docs/screenshots/      # README 功能截图
├── src/
│   ├── App.tsx            # 页面、状态与演示数据
│   ├── main.tsx           # React 入口
│   └── styles.css         # 全局样式
├── index.html
├── package.json
├── tsconfig.json
└── vite.config.ts
```