# ui

**Repository Path**: scpim/ui

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-07
- **Last Updated**: 2026-02-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Flutter UI 开发框架

一个简单易懂、高效的 Flutter UI 开发框架，提供清晰的分层架构、标准化目录结构、组件化开发体系和最佳实践。

## 特性

- 🏗️ **清晰的分层架构**：Presentation - Business Logic - Data 三层架构
- 🧩 **组件化开发**：提供基础 UI 组件库和开发规范
- 🔄 **状态管理**：集成 Provider 状态管理方案
- 🧭 **路由导航**：简单易用的路由配置和导航系统
- 🌐 **网络请求**：标准化的 HTTP 请求封装和错误处理
- 🎨 **主题系统**：统一的主题配置和样式管理

## 快速开始

### 前置要求

- Flutter SDK >= 3.10.0
- Dart SDK >= 3.0.0

### 安装依赖

```bash
flutter pub get
```

### 运行项目

```bash
flutter run
```

## 项目结构

```
lib/
├── core/                  # 核心框架代码
│   ├── config/           # 配置管理
│   ├── network/          # 网络封装
│   ├── providers/        # 全局状态
│   ├── routes/           # 路由管理
│   └── constants/        # 常量定义
├── widgets/              # 可复用组件库
│   ├── buttons/
│   ├── inputs/
│   ├── cards/
│   ├── lists/
│   └── common/
├── pages/                # 页面（按功能模块）
│   ├── home/
│   ├── todo/
│   └── settings/
├── models/               # 数据模型
├── services/            # 业务服务
└── utils/                # 工具类
```

## 核心依赖

- **provider** ^6.1.0 - 状态管理
- **dio** ^5.4.0 - 网络请求
- **shared_preferences** ^2.2.2 - 本地存储

## 文档

详细的框架文档请参考 `docs/` 目录：

- [开发框架文档](docs/framework_guide.md) - 完整的框架使用指南
- [设计文档](docs/design_doc.md) - 框架设计理念和架构决策
- [API 参考](docs/api_reference.md) - API 详细说明
- [最佳实践](docs/best_practices.md) - 开发最佳实践
- [代码规范](docs/code_style.md) - 代码规范和风格指南

## 开发规范

本项目遵循以下开发规范：

- 代码风格：遵循 Dart 官方代码规范（Effective Dart）
- 测试覆盖率：核心功能测试覆盖率 ≥ 80%
- 组件复用率：组件复用率 ≥ 60%
- 文档完整性：文档完整性 ≥ 90%

## 许可证

本项目为内部框架，不对外发布。