# flutters

**Repository Path**: loan_ph/flutters

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-30
- **Last Updated**: 2025-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Flutter A Project

这是一个Flutter项目，包含多个功能页面和组件。

## 项目结构

```
lib/
├── config/           # 配置文件
├── data/            # 数据层和API服务
├── domain/          # 业务逻辑层
├── global/          # 全局常量和配置
├── page/            # 页面组件
├── routing/         # 路由配置
├── ui/              # UI组件
├── utils/           # 工具类
└── main.dart        # 应用入口
```

## 主要功能

### 1. 手机号输入页面 (Phone Input Page)

**文件位置**: `lib/page/phone_input_page.dart`

这是一个完整的手机号输入页面，包含以下特性：

- 📱 手机号输入框（支持菲律宾国家代码+63）
- 🔐 Get OTP按钮（集成API调用）
- 📄 Privacy Policy链接（跳转到HTML页面）
- 🎨 现代化UI设计（使用SizedBox替代图标）
- ✅ 实时输入验证
- 🔄 加载状态指示器
- 📱 响应式布局

**使用方法**:
```dart
// 导航到手机号输入页面
Navigator.pushNamed(context, '/input_phone');
```

**API集成**:
- 使用Dio HTTP客户端
- 完整的错误处理
- 日志记录功能

**依赖包**:
- `dio: ^5.9.0` - HTTP客户端
- `logger: ^2.5.0` - 日志记录
- `url_launcher: ^6.2.5` - URL启动器

### 2. 其他页面

- **Splash Page**: 启动页面
- **Start Page**: 开始页面
- **Protocol Page**: 协议页面

## 快速开始

### 1. 安装依赖

```bash
flutter pub get
```

### 2. 配置API

在 `lib/data/api_service.dart` 中配置您的实际API地址：

```dart
static void init() {
  _dio.options.baseUrl = 'https://your-actual-api-domain.com/api';
  // ... 其他配置
}
```

### 3. 运行应用

```bash
flutter run
```

## 路由配置

应用使用命名路由，主要路由包括：

- `/` - 启动页面
- `/ff` - 开始页面
- `/input_phone` - 手机号输入页面
- `/protocol` - 协议页面
- `/main` - 主页面

## 自定义配置

### 颜色主题

在 `lib/config/public_color.dart` 中修改颜色配置：

```dart
const Color colorMain = Color(0xFFFDBD00);        // 主色调
const Color colorFF222222 = Color(0xFF222222);    // 文字颜色
```

### 国家代码

修改 `lib/page/phone_input_page.dart` 中的国家代码：

```dart
Text(
  '+63',  // 修改为其他国家代码
  // ...
),
```

## 开发说明

### 代码规范

- 使用Flutter官方推荐的代码风格
- 遵循Dart语言最佳实践
- 使用const构造函数优化性能

### 错误处理

- 完整的异常捕获和处理
- 用户友好的错误提示
- 网络错误处理

### 测试

建议在不同设备和网络环境下测试应用功能。

## 注意事项

1. **网络权限**: 确保在Android和iOS配置中添加了网络权限
2. **HTTPS**: 生产环境请使用HTTPS协议
3. **API配置**: 根据实际需求配置API地址和参数
4. **本地化**: 可以添加多语言支持

## 贡献

欢迎提交Issue和Pull Request来改进这个项目。

## 许可证

本项目采用MIT许可证。