# 天派Pda

**Repository Path**: lksfsm/tpPda

## Basic Information

- **Project Name**: 天派Pda
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-31
- **Last Updated**: 2026-01-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 无缝智造 (Seamless Manufacturing)

[![Flutter](https://img.shields.io/badge/Flutter-3.5+-blue.svg)](https://flutter.dev)
[![Dart](https://img.shields.io/badge/Dart-3.5+-blue.svg)](https://dart.dev)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

智能制造管理应用，支持 iOS 和 Android 平台。

## ✨ 特性

- 🌍 **国际化支持** - 支持中文和英文
- 🎨 **主题切换** - 支持亮色/暗色主题
- 📱 **响应式设计** - 适配不同屏幕尺寸
- 🔐 **安全认证** - 完整的用户认证系统
- 🚀 **高性能** - 优化的性能和流畅体验
- 📦 **模块化架构** - Clean Architecture 分层设计
- 🧪 **可测试** - 完善的单元测试和集成测试

## 📋 技术栈

- **框架**: Flutter 3.5+
- **语言**: Dart 3.5+
- **状态管理**: Riverpod 2.6+
- **路由导航**: GoRouter 14.6+
- **网络请求**: Dio 5.7+
- **本地存储**: Hive 2.2+ / SharedPreferences 2.3+
- **代码生成**: Freezed, Json Serializable
- **UI适配**: Flutter ScreenUtil 5.9+

## 🚀 快速开始

### 环境要求

- Flutter SDK >= 3.5.0
- Dart SDK >= 3.5.0
- iOS: Xcode >= 15.0
- Android: Android Studio + Java >= 17

### 安装

```bash
# 克隆项目
git clone <repository-url>
cd flutter_native

# 安装依赖
flutter pub get

# 生成国际化文件
flutter gen-l10n

# 生成代码
flutter pub run build_runner build --delete-conflicting-outputs
```

### 运行

```bash
# iOS
flutter run

# Android
flutter run

# 指定设备
flutter run -d <device-id>
```

### 构建

```bash
# 构建 APK
flutter build apk --release

# 构建 App Bundle
flutter build appbundle --release

# 构建 iOS
flutter build ios --release
```

## 📁 项目结构

```
flutter_native/
├── lib/
│   ├── main.dart              # 应用入口
│   ├── app.dart               # 应用主体
│   ├── core/                  # 核心模块
│   │   ├── config/           # 配置文件
│   │   ├── constants/        # 常量定义
│   │   ├── router/           # 路由配置
│   │   └── utils/            # 工具类
│   ├── features/             # 功能模块
│   │   ├── auth/            # 认证模块
│   │   └── home/            # 首页模块
│   ├── shared/              # 共享模块
│   │   ├── models/          # 数据模型
│   │   ├── widgets/         # 共享组件
│   │   └── services/        # 共享服务
│   └── l10n/                # 国际化文件
├── assets/                   # 资源文件
├── docs/                     # 项目文档
└── test/                     # 测试文件
```

## 📖 文档

- [快速开始](docs/快速开始.md)
- [项目说明](docs/项目说明.md)
- [开发规范](docs/开发规范.md)
- [API文档](docs/API文档.md)

## 🛠️ 开发

### 代码规范

项目使用 `very_good_analysis` 进行代码检查：

```bash
# 代码分析
flutter analyze

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

### 测试

```bash
# 运行所有测试
flutter test

# 运行特定测试
flutter test test/unit/user_test.dart

# 测试覆盖率
flutter test --coverage
```

### 调试

```bash
# 启用调试模式
flutter run --debug

# 性能分析
flutter run --profile
```

## 🔧 配置

### 环境配置

在 `lib/core/config/env_config.dart` 中修改环境：

```dart
// 开发环境
EnvConfig.setEnvironment(Environment.development);

// 生产环境
EnvConfig.setEnvironment(Environment.production);
```

### 应用配置

在 `lib/core/config/app_config.dart` 中修改应用配置参数。

## 🌐 国际化

添加新的翻译：

1. 在 `lib/l10n/app_zh.arb` 中添加中文翻译
2. 在 `lib/l10n/app_en.arb` 中添加英文翻译
3. 运行 `flutter gen-l10n` 生成代码
4. 在代码中使用：`S.of(context).yourKey`

## 📝 版本历史

### v1.0.0 (2025-01-01)
- 🎉 初始版本发布
- ✅ 实现基础架构
- ✅ 添加国际化支持
- ✅ 完成用户认证模块
- ✅ 实现首页框架

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'feat: add amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 提交 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 📧 联系方式

- 项目主页: <repository-url>
- 问题反馈: <repository-url>/issues
- 邮箱: your-email@example.com

## 🙏 致谢

感谢所有贡献者的付出！

---

用 ❤️ 和 Flutter 构建