# star_coffee

**Repository Path**: weimengxu/star_coffee

## Basic Information

- **Project Name**: star_coffee
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-26
- **Last Updated**: 2026-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 快乐咖 (Star Coffee)

一款模仿瑞幸咖啡风格的 Flutter 咖啡点单应用，采用深蓝色系主题设计，基于 Material 3 规范。

## 功能模块

### 登录模块

- **登录方式选择** — 支持账号密码登录和手机验证码登录两种方式
- **账号密码登录** — 输入用户名和密码进行登录，支持密码显示/隐藏切换
- **手机验证码登录** — 输入手机号获取验证码，60 秒倒计时防重复发送
- **登录态管理** — 基于 Riverpod 状态管理，未登录自动重定向至登录页

### 首页

- **商品轮播** — 横向滑动展示推荐商品，带指示器
- **团队展示** — 横向滑动展示咖啡师团队

### 订单

- **待支付订单列表** — 展示所有待支付订单
- **订单支付** — 一键支付，状态实时更新

### 我的

- **个人信息** — 展示用户头像、昵称、邮箱
- **功能菜单** — 个人信息、订单历史、地址修改
- **退出登录** — 退出后自动跳转登录页

## 技术栈

| 技术 | 说明 |
|---|---|
| Flutter | 跨平台 UI 框架 |
| Dart | 开发语言（SDK ^3.11.4） |
| flutter_riverpod | 状态管理 |
| go_router | 声明式路由 |
| Material 3 | UI 设计规范 |

## 项目结构

```
lib/
├── main.dart                 # 应用入口
├── app.dart                  # MaterialApp 配置
├── theme/
│   └── app_theme.dart        # 自定义主题（瑞幸咖啡风格）
├── router/
│   └── router.dart           # 路由配置（含登录重定向）
├── models/
│   ├── user.dart             # 用户模型
│   ├── product.dart          # 商品模型
│   ├── order.dart            # 订单模型
│   └── employee.dart         # 员工模型
├── providers/
│   ├── auth_provider.dart    # 登录状态管理
│   ├── product_provider.dart # 商品数据管理
│   └── order_provider.dart   # 订单数据管理
├── pages/
│   ├── login/
│   │   ├── login_page.dart          # 登录方式选择页
│   │   ├── account_login_page.dart  # 账号密码登录页
│   │   └── phone_login_page.dart    # 手机验证码登录页
│   ├── home/
│   │   └── home_page.dart           # 首页
│   ├── orders/
│   │   └── orders_page.dart         # 订单页
│   └── profile/
│       └── profile_page.dart        # 个人中心页
├── widgets/
│   └── bottom_nav.dart              # 底部导航栏
└── assets/
    └── images/                      # 图片资源
```

## 启动方式

### 环境准备

1. 安装 [Flutter SDK](https://flutter.dev/docs/get-started/install)（需 >= 3.x）
2. 运行 `flutter doctor` 确认环境正常

### 安装依赖

```bash
flutter pub get
```

### 启动应用

```bash
# Chrome 浏览器
flutter run -d chrome

# macOS 桌面
flutter run -d macos

# iOS 模拟器
flutter run -d ios

# Android 模拟器
flutter run -d android

# 查看所有可用设备
flutter devices
```

### 代码检查

```bash
flutter analyze
```

## 主题定制

项目采用自定义主题系统，详见 [docs/theme.md](docs/theme.md)。

核心文件：`lib/theme/app_theme.dart`

- `AppColors` — 所有颜色常量，可直接在任何 Widget 中引用
- `AppTheme` — 完整的 `ThemeData` 配置

引用方式：

```dart
import 'package:star_coffee/theme/app_theme.dart';

// 通过 Theme.of(context)
Theme.of(context).colorScheme.primary;

// 直接引用 AppColors
AppColors.textSecondary;
```

## 路由结构

```
/login              → 登录方式选择页
/login/account      → 账号密码登录页
/login/phone        → 手机验证码登录页
/home               → 首页（需登录）
/orders             → 订单页（需登录）
/profile            → 个人中心（需登录）
```

未登录用户访问任何页面会自动重定向至 `/login`，已登录用户访问 `/login` 会重定向至 `/home`。