# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## 项目概述

ftng 是一个 Flutter 应用项目，使用 Dart SDK ^3.9.0。

## 常用命令

### 开发命令
```bash
# 获取依赖
flutter pub get

# 运行应用 (调试模式)
flutter run

# 热重载 (应用运行时按 r)
# 热重启 (应用运行时按 R)

# 构建应用
flutter build apk          # Android APK
flutter build ios          # iOS (需要 macOS)
flutter build web          # Web 应用
```

### 测试与代码检查
```bash
# 运行所有测试
flutter test

# 运行单个测试文件
flutter test test/widget_test.dart

# 代码静态分析
flutter analyze

# 代码格式化
dart format .
```

### Floor 数据库代码生成
```bash
# 生成 Floor 数据库代码 (修改 entity/dao 后执行)
dart run build_runner build

# 清理并重新生成
dart run build_runner build --delete-conflicting-outputs
```

## 关键依赖

| 包名 | 用途 |
|------|------|
| get | 状态管理、路由、依赖注入 |
| floor + sqflite | SQLite 数据库 ORM |
| shared_preferences | 本地键值存储 |
| audioplayers | 音频播放 |
| connectivity_plus | 网络连接状态检测 |
| flutter_easyloading | 加载动画组件 |
| uuid | UUID 生成 |

## 项目结构约定

```
lib/
├── main.dart          # 应用入口
├── app/               # GetX 应用配置 (bindings, routes)
├── controllers/       # GetX 控制器
├── views/             # 页面/视图
├── models/            # 数据模型
├── database/          # Floor 数据库配置
│   ├── entity/        # 数据库实体
│   ├── dao/           # 数据访问对象
│   └── database.dart  # 数据库定义
├── services/          # 业务服务层
├── utils/             # 工具类
└── constants/         # 常量定义
```

## 代码规范

- 使用 GetX 进行状态管理 (`GetxController`)
- 数据库实体使用 `@entity` 注解，DAO 使用 `@dao` 注解
- 路由使用 GetX 路由管理 (`GetPage`)
- 遵循 `flutter_lints` 代码规范