GianSandoval5/flutter_enterprise_architecture
GitHub: GianSandoval5/flutter_enterprise_architecture
这是一个基于Clean Architecture的Flutter企业移动应用起步项目，帮助开发者快速搭建可扩展、安全的生产级应用框架。
Stars: 0 | Forks: 0
# Flutter企业架构起步项目
用于企业移动应用的生产就绪Flutter架构起步项目，采用Clean Architecture、模块化功能、依赖注入、API契约、测试和CI/CD。
## 演示内容
- 采用功能优先边界的Clean Architecture。
- 数据/领域/表现层分离。
- 使用`get_it`进行依赖注入。
- 使用`go_router`的声明式导航。
- 使用`dio`的REST网络通信。
- 使用`flutter_secure_storage`的安全会话存储。
- 通过Dio拦截器注入Bearer令牌。
- 基于认证状态的路由保护。
- 通过异常、失败和`Result`进行类型化错误处理。
- 使用`--dart-define`的环境配置。
- 认证示例流程。
- REST个人资料示例流程。
- 单元/控件测试示例。
- GitHub Actions CI。
## 项目结构
```
lib/
app/
core/
config/
di/
errors/
network/
routing/
storage/
theme/
features/
auth/
data/
domain/
presentation/
dashboard/
profile/
shared/
utils/
widgets/
test/
docs/
.github/workflows/
```
## 运行
```
flutter pub get
flutter run --dart-define=ENV=dev
```
演示凭据：
```
architect@example.com
Enterprise123
```
## 环境
```
flutter run --dart-define=ENV=staging --dart-define=API_BASE_URL=https://staging-api.example.com
flutter run --release --dart-define=ENV=prod --dart-define=API_BASE_URL=https://api.example.com
```
## 文档
- [架构](docs/ARCHITECTURE.md)
- [API契约](docs/API_CONTRACTS.md)
- [环境](docs/ENVIRONMENTS.md)
- [功能指南](docs/FEATURE_GUIDE.md)
- [安全](docs/SECURITY.md)
- [测试](docs/TESTING.md)
## 架构决策
- [功能优先的Clean Architecture](docs/adr/0001-feature-first-clean-architecture.md)
- [手动模型映射](docs/adr/0002-manual-model-mapping.md)
- [会话存储与令牌注入](docs/adr/0003-session-storage-and-token-injection.md)
标签：API契约, Bearer Token, Dart语言, dio, Flutter, flutter_secure_storage, get_it, GitHub Actions, go_router, REST API, Runtime Enforcement, 企业应用, 企业级架构, 依赖注入, 单元测试, 启动器模板, 安全存储, 导航管理, 开发模板, 操作系统检测, 文档管理, 架构设计, 模块化开发, 测试, 清洁架构, 演示项目, 环境变量, 环境配置, 移动应用框架, 移动开发, 组件测试, 网络请求, 自动笔记, 认证系统, 软件开发, 错误处理