# twentyflutter

**Repository Path**: clzx1220/twentyflutter

## Basic Information

- **Project Name**: twentyflutter
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-09
- **Last Updated**: 2025-10-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TwentyFlutter 🚀

多功能个人助理APP - 基于Flutter的现代化个人管理系统

## 📱 项目简介

TwentyFlutter是一个功能丰富的个人助理应用程序，集成了CRM客户管理、备忘录、日历日程和待办事项管理功能。采用模块化架构设计，支持多平台运行。

## ✨ 核心功能

### 🔐 双模式认证系统
- **在线模式**: 支持完整的用户注册和登录
- **离线模式**: 提供测试账户快速体验
- **快速切换**: 一键切换在线/离线模式

### 📊 CRM客户管理
- 客户信息管理
- 联系人跟踪
- 销售机会管理
- 客户分类标签

### 📝 备忘录功能
- 富文本编辑
- 多媒体支持
- 快速搜索
- 分类管理

### 📅 日历日程
- 月视图/周视图切换
- 事件提醒
- 重复事件设置
- 日程共享

### ✅ 待办事项
- 任务创建与编辑
- 优先级设置
- 进度跟踪
- 完成统计

### 🕐 统一时间线
- 跨模块事件整合
- 时间轴展示
- 快速筛选
- 历史记录

## 🛠️ 技术架构

### 技术栈
- **前端**: Flutter 3.x
- **状态管理**: Riverpod
- **后端**: Supabase
- **数据库**: PostgreSQL
- **部署**: Docker
- **认证**: Supabase Auth

### 项目结构
```
lib/
├── modules/          # 功能模块层
│   ├── crm/         # CRM客户管理
│   ├── notes/       # 备忘录模块
│   ├── calendar/    # 日历日程
│   └── todo/        # 待办事项
├── core/            # 核心功能层
│   ├── timeline/    # 统一时间线
│   ├── navigation/  # 导航管理
│   ├── settings/    # 设置管理
│   └── sync/        # 数据同步
├── shared/          # 共享资源层
│   ├── widgets/     # 通用UI组件
│   ├── utils/       # 工具类
│   ├── constants/   # 常量定义
│   ├── models/      # 共享数据模型
│   └── providers/   # 共享状态管理
└── main.dart        # 应用入口
```

## 🚀 快速开始

### 环境要求
- Flutter 3.x
- Dart 3.x
- Docker (可选)
- Git

### 本地开发
```bash
# 克隆项目
git clone https://gitee.com/clzx1220/twentyflutter.git

# 进入项目目录
cd twentyflutter/twenty_flutter

# 安装依赖
flutter pub get

# 运行应用
flutter run
```

### Docker部署
```bash
# 启动后端服务
cd docker/supabase
docker-compose -f docker-compose-auth.yml up -d

# 运行Flutter Web
flutter run -d chrome
```

## 📱 支持平台

- ✅ iOS
- ✅ Android  
- ✅ Web
- ✅ Windows
- ✅ macOS
- ✅ Linux

## 🧪 测试

项目包含完整的测试套件：
- 单元测试
- 组件测试
- 集成测试
- 端到端测试

运行测试：
```bash
flutter test
```

## 📖 开发文档

详细的开发文档请参考 `docs/` 目录：
- [项目架构设计](docs/technical/modular_architecture_design.md)
- [开发规范](docs/technical/coding_standards.md)
- [Supabase集成指南](docs/technical/supabase_integration_guide.md)

## 🤝 贡献指南

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'Add some amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 创建 Pull Request

## 📝 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 👥 作者

- **clzx1220** - 初始工作 - [Gitee](https://gitee.com/clzx1220)

## 🙏 致谢

- Flutter 团队提供优秀的跨平台框架
- Supabase 提供强大的后端服务
- 所有为开源社区贡献的开发者们

## 📞 联系方式

如有问题或建议，欢迎通过以下方式联系：
- Gitee: [@clzx1220](https://gitee.com/clzx1220)

---

⭐ 如果这个项目对你有帮助，请给个Star支持一下！