🚀 Smart Note App — Source Code Flutter (Offline-First + AI + Firebase)
Ứng dụng ghi chú thông minh thế hệ mới, tích hợp AI Gemini, đồng bộ Cloud thời gian thực, và bảo mật sinh trắc học. Kiến trúc chuẩn Production — sẵn sàng triển khai!
💎 Tổng quan dự án
Smart Note App là một ứng dụng ghi chú di động đa nền tảng hoàn chỉnh, được xây dựng bằng Flutter 3.x / Dart 3.x, áp dụng kiến trúc Clean Architecture và mô hình Offline-First chuẩn production.
Đây không chỉ là một app ghi chú đơn giản — đây là một hệ sinh thái quản lý thông tin cá nhân tích hợp trí tuệ nhân tạo, đồng bộ đám mây tự động, soạn thảo văn bản phong phú, và bảo mật cấp cao.
✅ Chạy được ngay trên Android & iOS ✅ Kiến trúc rõ ràng, dễ mở rộng ✅ Code sạch, có chú thích đầy đủ ✅ Tích hợp đầy đủ Backend (Firebase + Cloudinary)
✨ Tính năng đầy đủ (15 màn hình, 8 services)
📝 Soạn thảo & Nội dung
Rich Text Editor (flutter_quill): In đậm, nghiêng, gạch chân, màu sắc, heading, bullet list, numbered list
Chèn ảnh đa nguồn: Chụp ảnh trực tiếp hoặc chọn từ thư viện, upload tự động lên Cloudinary CDN
Ghi âm giọng nói: Ghi âm nội tuyến trong ghi chú, phát lại ngay trong editor
Bảng vẽ tay (Drawing Board): Tạo và nhúng bản vẽ tay vào ghi chú
Checklist thông minh: Tạo to-do list có thể check/uncheck trực tiếp
Nhãn phân loại (Labels): Tạo, chỉnh sửa và gán nhãn màu sắc cho ghi chú
Ghim ghi chú (Pin): Ghim ghi chú quan trọng lên đầu danh sách
Xuất PDF: Trích xuất ghi chú thành file PDF định dạng chuẩn, có thể chia sẻ
🤖 Trí tuệ nhân tạo (Google Gemini AI)
Tóm tắt tự động: Tóm tắt nội dung ghi chú dài thành bản tóm tắt súc tích
Gợi ý tiêu đề thông minh: AI tự động đặt tiêu đề phù hợp với nội dung
Chuyển đổi văn bản → Checklist: Biến đoạn văn bản thô thành danh sách công việc có cấu trúc
Gợi ý nhãn phân loại: AI gợi ý nhãn phù hợp dựa trên nội dung ghi chú
Màn hình chat AI riêng biệt: Giao diện chat với Gemini trực tiếp trong app
☁️ Đồng bộ & Lưu trữ (Offline-First)
SQLite cục bộ (sqflite): Mọi dữ liệu được lưu ngay lập tức xuống thiết bị — hoạt động 100% offline
SQLite FTS5 Full-Text Search: Tìm kiếm toàn văn siêu nhanh trong ghi chú
Firebase Firestore: Đồng bộ tự động lên cloud khi có kết nối mạng
Firebase Storage: Lưu trữ media (ảnh, audio) trên cloud
Cloudinary CDN: Upload và tối ưu hình ảnh chuyên nghiệp
Màn hình đồng bộ thực tế: Hiển thị tiến trình sync trực quan khi đăng nhập lần đầu
🔐 Xác thực & Bảo mật
Firebase Auth: Đăng nhập bằng Google (One-tap) và Email/Password
Xác thực Email: Luồng gửi và xác nhận email đầy đủ
Bảo mật sinh trắc học: Khóa/mở ghi chú riêng tư bằng Vân tay hoặc Face ID
Mã hóa dữ liệu nhạy cảm: Sử dụng thư viện crypto
🔔 Nhắc nhở & Tiện ích
Đặt lịch nhắc nhở: Thông báo push nội bộ với múi giờ chính xác (flutter_local_notifications + timezone)
Lưu trữ ghi chú (Archive): Lưu trữ ghi chú không còn dùng mà không xóa vĩnh viễn
Thùng rác (Trash): Khôi phục hoặc xóa vĩnh viễn ghi chú đã xóa
Nhiều chế độ xem: Chuyển đổi giữa Grid View và List View linh hoạt
Kéo thả sắp xếp: Sắp xếp lại thứ tự ghi chú bằng kéo thả (reorderables)
Tìm kiếm nâng cao: Màn hình tìm kiếm độc lập với lọc theo nhãn và trạng thái
⚙️ Cài đặt & Cá nhân hóa
Dark Mode / Light Mode: Chuyển đổi giao diện tối/sáng
Đa ngôn ngữ: Hỗ trợ đa ngôn ngữ (flutter_localizations)
Màn hình cài đặt đầy đủ: Quản lý thông báo, bảo mật, đồng bộ
Màn hình hồ sơ: Cập nhật ảnh đại diện, tên hiển thị
🛠️ Tech Stack (Công nghệ sử dụng)
Lớp Công nghệ Phiên bản
Framework Flutter & Dart 3.x / 3.x
State Management Provider ^6.1.0
Local Database SQLite (sqflite) + FTS5 ^2.4.2
Cloud Database Firebase Firestore ^6.4.1
Cloud Storage Firebase Storage ^13.4.1
Authentication Firebase Auth + Google Sign-In ^6.5.1
AI Engine Google Gemini 2.5 Flash Lite (firebase_ai) ^3.12.2
Image CDN Cloudinary API REST API
Rich Text flutter_quill ^11.5.1
Audio record + just_audio ^6.2.1 / ^0.10.5
Drawing flutter_drawing_board ^1.0.1
Biometrics local_auth ^3.0.1
Notifications flutter_local_notifications ^17.2.3
PDF Export pdf + printing ^3.10.8
Fonts Google Fonts ^8.1.0
Animations animations package ^2.2.0
UI Grid flutter_staggered_grid_view ^0.7.0
🏛️ Kiến trúc & Cấu trúc Code
Dự án áp dụng Clean Architecture với sự tách biệt rõ ràng giữa các layer:
lib/
┣ core/ # Cấu hình UI, Colors, Themes, Constants toàn cục
┣ features/ # Các tính năng riêng (editor, home, profile)
┣ models/ # Data classes thuần (Note, User, ChecklistItem, SyncStatus)
┣ providers/ # State Management (AuthProvider, NoteProvider, ThemeProvider, SyncProvider, LanguageProvider)
┣ repositories/ # Data Access Layer — trừu tượng hóa data source
┣ screens/ # 15 màn hình UI hoàn chỉnh
┣ services/ # 8 services giao tiếp với API, DB
┣ utils/ # Helper functions (format ngày, kiểm tra mạng, ...)
┗ widgets/ # UI Components dùng chung (NoteCard, EmptyState, ...)
15 màn hình: Splash → Login → Email Verification → Syncing → Home → Editor → Editor AI → Drawing → Search → Archive → Trash → Profile → Settings → Manage Labels → Label Selection
8 services: LocalNoteService · FirestoreNoteService · GeminiAIService · CloudinaryService · BiometricService · PDFExportService · ReminderService · PendingDeleteService
📦 Bạn nhận được gì?
✅ 100% Source Code Flutter — Toàn bộ mã nguồn, không obfuscate
✅ File cấu hình môi trường (.env.example) — Hướng dẫn cài đặt API keys
✅ Firebase Rules (firestore.rules) — Cấu hình bảo mật Firestore sẵn sàng
✅ README chi tiết — Hướng dẫn cài đặt từng bước từ A-Z
✅ Cấu trúc folder rõ ràng — Dễ đọc, dễ hiểu, dễ mở rộng
✅ Hỗ trợ build APK ngay — flutter build apk --release
⚙️ Yêu cầu cài đặt
Flutter SDK >= 3.0
Android Studio / VS Code
Tài khoản Firebase (miễn phí / Spark plan đủ dùng)
Tài khoản Cloudinary (miễn phí 25GB)
Gemini API Key (Google AI Studio — miễn phí)
🎯 Phù hợp với ai?
Đối tượng Mục đích sử dụng
Sinh viên CNTT Học kiến trúc Flutter thực tế, tham khảo đồ án
Freelancer Tùy chỉnh và bán lại sản phẩm cho khách hàng
Startup Nền tảng MVP cho sản phẩm ghi chú / productivity
Developer học AI Tham khảo tích hợp Gemini AI vào Flutter app thực tế
Agency Base code để xây dựng ứng dụng ghi chú thương hiệu riêng
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
HƯỚNG DẪN CÀI ĐẶT
Tải các thư viện phụ thuộc
flutter pub get
3. Cấu hình biến môi trường (.env)
Dự án sử dụng file .env để bảo mật API Keys. Tạo một file tên là .env ở thư mục gốc của dự án (ngang hàng với pubspec.yaml) và điền các thông tin sau:
# Cloudinary API Keys (Để upload ảnh)
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret
CLOUDINARY_UPLOAD_PRESET=your_upload_preset
4. Kết nối Firebase
Dự án đã có sẵn các file cấu hình Firebase. Tuy nhiên, nếu bạn muốn kết nối với Firebase của riêng bạn:
Cài đặt Firebase CLI.
Chạy lệnh cấu hình FlutterFire:
flutterfire configure
5. Chạy ứng dụng
Khởi chạy máy ảo Android (Emulator) hoặc cắm thiết bị thật, sau đó chạy lệnh:
flutter run
6. Build file cài đặt (APK)
Để xuất file APK phát hành cài đặt cho điện thoại:
flutter build apk --release
File APK sẽ nằm ở: build/app/outputs/flutter-apk/app-release.apk
Nguồn: Topcode.vn
