Cập nhật Freelance Flow: Chuyển đổi sang Supabase và Công khai mã nguồn

Cập nhật Freelance Flow: Chuyển đổi sang Supabase và Công khai mã nguồn

Tên ứng dụng: Freelance Flow

Phiên bản: v1.2 - Cloud Edition

Trải nghiệm: fflow.manhhuynh.work

Sau hơn 6 tháng mò mẫm tìm hiểu và quất roi mấy con AI 🤡, mình vừa hoàn thành bản cập nhật mới (v1.2) cho Freelance Flow – công cụ quản lý dự án cá nhân. Phiên bản này đánh dấu sự thay đổi lớn về kiến trúc: chuyển từ lưu trữ LocalStorage (Offline) sang sử dụng Supabase (Cloud), đồng thời mình cũng quyết định công khai toàn bộ mã nguồn (Public Source Code) để cộng đồng có thể tham khảo hoặc tự sử dụng.


I. Thay đổi kiến trúc: LocalStorage → Supabase

🔄 Từ Offline sang Cloud

Phiên bản cũ (v1.0): Dữ liệu lưu trữ hoàn toàn trên LocalStorage (trình duyệt). Nhanh, đơn giản nhưng gặp vấn đề:

  • Khó đồng bộ giữa các thiết bị
  • Rủi ro mất dữ liệu khi xóa cache
  • Không thể chia sẻ cho khách hàng

Phiên bản mới (v1.2): Backend sử dụng Supabase (PostgreSQL), mở ra khả năng:

  • ✅ Đồng bộ xuyên suốt mọi thiết bị
  • ✅ Chia sẻ Timeline, Báo giá qua link
  • ✅ Backup tự động, an toàn hơn
🔗 Tính năng chia sẻ mới

Giờ đây bạn có thể chia sẻ Timeline dự án và Báo giá trực tiếp cho khách hàng qua đường dẫn web, không cần export file.

Trang chia sẻ dự án
Trang chia sẻ dự án cho khách hàng
Cấu hình chia sẻ
Hộp thoại cấu hình chia sẻ

II. Demo Online & Khuyến nghị Self-host

⚠️ QUAN TRỌNG: Đây là dự án thực hiện hoàn toàn phần code bằng AI (vibe code) nên các vấn đề về bảo mật có thể chưa được đảm bảo tốt.

Lưu ý: Bản Demo này chạy trên tài nguyên giới hạn (Free Tier, dùng chung API Key), nên mục đích chính là để test tính năng. Mình KHÔNG khuyến khích dùng nó cho dữ liệu công việc quan trọng hoặc nhạy cảm.

🏠 Khuyến nghị: Tự triển khai (Self-host)

Mình khuyến khích các bạn tải mã nguồn về và tự deploy. Chỉ mất khoảng 15-30 phút setup, bạn sẽ có hệ thống private hoàn toàn:

🌐 Tên miền riêng

Chuyên nghiệp với subdomain của bạn (vd: work.ten-cua-ban.com)

🔒 Dữ liệu riêng tư

Data nằm trên tài khoản Supabase chính chủ của bạn

⚙️ Chủ động tài nguyên

Tự quản lý API Key (Gemini, Database) không lo bị ảnh hưởng

Dashboard v1.2
Giao diện Dashboard v1.2

III. Tài liệu & Mã nguồn

Mã nguồn hiện đã được public trên GitHub (giấy phép phi thương mại). Mình cũng đã soạn tài liệu hướng dẫn chi tiết từng bước, từ việc lấy API Key đến deploy lên Vercel để ngay cả các bạn không chuyên kỹ thuật (non-tech) cũng có thể làm được.

💡 Mẹo cho người không chuyên kỹ thuật: Bạn có thể sử dụng các AI Agent như Antigravity, Cursor, Windsurf, hoặc VS Code (thường cung cấp gói miễn phí cho tính năng agentic coding). Các agent này có thể tự động chạy lệnh terminal, cài đặt dependencies và cấu hình biến môi trường giúp bạn, làm cho quá trình cài đặt nhanh và chính xác hơn nhiều.

� Tài liệu hướng dẫn

Hướng dẫn chi tiết từng bước cài đặt và triển khai

Xem tài liệu
� GitHub Repository

Mã nguồn mở, giấy phép phi thương mại

Xem mã nguồn
Tài liệu cài đặt
Giao diện tài liệu hướng dẫn cài đặt

Hy vọng công cụ nhỏ này sẽ giúp ích cho quy trình quản lý công việc của anh em Freelancer. Rất mong nhận được feedback và báo lỗi từ cộng đồng!

— Mạnh Huỳnh