Backend - Hệ sinh thái Firebase

my-task-app/
│
├── services/                    ← 🔌 KẾT NỐI FIREBASE (trong dự án Next.js)
│   ├── firebase.ts              ← Khởi tạo kết nối
│   ├── auth.ts                  ← Hàm đăng nhập/đăng ký
│   ├── tasks.ts                 ← Hàm CRUD tasks
│   ├── projects.ts              ← Hàm CRUD projects
│   ├── users.ts                 ← Hàm quản lý users
│   └── storage.ts               ← Hàm upload/download file
│
├── firestore.rules              ← 🔐 SECURITY RULES (bảo mật Firestore)
├── storage.rules                ← 🔐 SECURITY RULES (bảo mật Storage)
│
├── functions/                   ← ⚡ CLOUD FUNCTIONS (chạy trên server Google)
│   ├── src/
│   │   ├── index.ts             ← Danh sách functions
│   │   ├── onTaskCreated.ts     ← Trigger khi tạo task mới
│   │   ├── onTaskCompleted.ts   ← Trigger khi hoàn thành task
│   │   ├── scheduledReport.ts   ← Báo cáo tự động hàng tuần
│   │   └── api/
│   │       └── sendEmail.ts     ← API gửi email
│   └── package.json             ← Dependencies riêng cho Functions
│
└── firebase.json                ← ⚙️ CẤU HÌNH Firebase project

📁 Firestore Database
│
├── 👥 users (Collection)
│   ├── user_001 (Document)
│   │   ├── name: "Nguyễn Văn A"
│   │   ├── email: "a@gmail.com"
│   │   ├── role: "admin"
│   │   ├── department: "Engineering"
│   │   ├── avatarUrl: "https://storage.../avatar.jpg"
│   │   └── createdAt: 2026-01-15T08:00:00
│   │
│   └── user_002 (Document)
│       ├── name: "Trần Thị B"
│       ├── email: "b@gmail.com"
│       ├── role: "member"
│       └── department: "Design"
│
├── 📋 tasks (Collection)
│   ├── task_001 (Document)
│   │   ├── title: "Làm báo cáo Q1"
│   │   ├── description: "Tổng hợp số liệu quý 1..."
│   │   ├── status: "in_progress"
│   │   ├── priority: "high"
│   │   ├── assigneeId: "user_001"        ← Liên kết đến users
│   │   ├── projectId: "project_001"      ← Liên kết đến projects
│   │   ├── deadline: 2026-04-30
│   │   ├── attachments: ["file_001.pdf"]
│   │   ├── createdBy: "user_002"
│   │   ├── createdAt: 2026-04-01T09:00:00
│   │   └── updatedAt: 2026-04-20T14:30:00
│   │
│   └── task_002 (Document)
│       └── ...
│
├── 🏢 projects (Collection)
│   └── project_001 (Document)
│       ├── name: "Dự án ABC"
│       ├── description: "Phát triển sản phẩm mới..."
│       ├── status: "active"
│       ├── members: ["user_001", "user_002"]
│       ├── ownerId: "user_001"
│       ├── createdAt: 2026-01-01
│       └── updatedAt: 2026-04-15
│
└── 🔔 notifications (Collection)
    └── notif_001 (Document)
        ├── userId: "user_001"            ← Gửi cho ai
        ├── type: "task_assigned"
        ├── message: "Bạn được giao task: Làm báo cáo Q1"
        ├── read: false
        ├── taskId: "task_001"            ← Liên kết đến task
        └── createdAt: 2026-04-01T09:05:00

📋 tasks/task_001                     ← Document gốc
│
├── title: "Làm báo cáo Q1"
├── status: "in_progress"
│
└── 💬 comments (Subcollection)       ← Bình luận thuộc về task này
    ├── comment_001
    │   ├── text: "Đã hoàn thành phần 1"
    │   ├── authorId: "user_001"
    │   └── createdAt: 2026-04-10
    ├── comment_002
    │   ├── text: "Review xong, LGTM"
    │   ├── authorId: "user_002"
    │   └── createdAt: 2026-04-11
    │
    └── 📎 activity (Subcollection)   ← Lịch sử thay đổi của task
        ├── log_001
        │   ├── action: "status_changed"
        │   ├── from: "todo"
        │   ├── to: "in_progress"
        │   └── changedBy: "user_001"
        └── log_002
            └── ...

Firebase Authentication               Firestore Database
┌──────────────────────┐              ┌──────────────────────┐
│ UID: xK9mNp2Q...     │──────────── │ users/xK9mNp2Q...    │
│ Email: a@gmail.com   │              │   name: "Nguyễn Văn A"│
│ Provider: Google     │              │   role: "admin"       │
│ Created: 2026-01-15  │              │   department: "Eng"   │
└──────────────────────┘              └──────────────────────┘
                                      
                                      ┌──────────────────────┐
                                      │ tasks/task_001        │
                                      │   assigneeId:         │
                                      │   "xK9mNp2Q..."  ────── Liên kết ngược
                                      │   createdBy:          │
                                      │   "xK9mNp2Q..."  ────── về UID
                                      └──────────────────────┘

📦 Cloud Storage
│
├── avatars/                          ← Ảnh đại diện
│   ├── user_001/
│   │   └── profile.jpg              ← avatars/user_001/profile.jpg
│   └── user_002/
│       └── profile.jpg
│
├── tasks/                            ← File đính kèm tasks
│   ├── task_001/
│   │   ├── bao-cao-q1.pdf           ← tasks/task_001/bao-cao-q1.pdf
│   │   ├── bang-tinh.xlsx
│   │   └── screenshot.png
│   └── task_002/
│       └── thiet-ke-v2.figma
│
├── projects/                         ← Tài liệu dự án
│   └── project_001/
│       ├── proposal.pdf
│       └── timeline.png
│
└── exports/                          ← File xuất báo cáo
    └── report-2026-04.pdf

functions/
├── src/
│   ├── index.ts                     ← Danh sách tất cả functions
│   │
│   ├── triggers/                    ← 🔥 Trigger từ Firestore
│   │   ├── onTaskCreated.ts         ← Khi tạo task mới
│   │   ├── onTaskUpdated.ts         ← Khi cập nhật task
│   │   ├── onTaskDeleted.ts         ← Khi xóa task
│   │   ├── onUserCreated.ts         ← Khi có user mới đăng ký
│   │   └── onProjectMemberAdded.ts  ← Khi thêm thành viên vào project
│   │
│   ├── scheduled/                   ← ⏰ Chạy theo lịch
│   │   ├── weeklyReport.ts          ← Báo cáo hàng tuần (thứ Hai 8:00)
│   │   ├── dailyReminder.ts         ← Nhắc deadline hàng ngày (8:00)
│   │   └── cleanupOldData.ts        ← Dọn dữ liệu cũ (1:00 sáng)
│   │
│   ├── api/                         ← 🌐 HTTP endpoints
│   │   ├── sendEmail.ts             ← API gửi email
│   │   ├── generateReport.ts        ← API tạo báo cáo PDF
│   │   └── webhookHandler.ts        ← Xử lý webhook từ bên ngoài
│   │
│   └── helpers/                     ← 🔧 Hàm tiện ích dùng chung
│       ├── email.ts                 ← Template và gửi email
│       ├── notifications.ts         ← Tạo thông báo trong Firestore
│       └── permissions.ts           ← Kiểm tra quyền
│
├── package.json                     ← Dependencies (firebase-admin, nodemailer...)
└── tsconfig.json                    ← Cấu hình TypeScript

📁 Firestore Security Rules

users/{userId}
├── READ:  Ai cũng đọc được (hiển thị tên, avatar)
│          HOẶC chỉ user đó đọc được (email, phone riêng tư)
└── WRITE: Chỉ user đó sửa được dữ liệu của mình

tasks/{taskId}
├── READ:  Chỉ thành viên cùng project đọc được
├── CREATE: Bất kỳ user đã đăng nhập nào cũng tạo được
├── UPDATE: Chỉ assignee hoặc người tạo task sửa được
└── DELETE: Chỉ admin hoặc người tạo task xóa được

projects/{projectId}
├── READ:  Chỉ members trong project đọc được
├── CREATE: Bất kỳ user đã đăng nhập
├── UPDATE: Chỉ owner hoặc admin
└── DELETE: Chỉ owner

notifications/{notifId}
├── READ:  Chỉ user nhận thông báo đọc được
├── WRITE: Chỉ Cloud Functions tạo được (không cho client tạo)
└── UPDATE: User đánh dấu đã đọc (chỉ field "read")

"Viết Firestore Security Rules:

1. Collection 'users':
   - Ai đã đăng nhập cũng đọc được name và avatarUrl
   - User chỉ sửa được document của chính mình
   - Không ai xóa được user (chỉ admin qua Cloud Functions)

2. Collection 'tasks':
   - User đã đăng nhập mới đọc được
   - User chỉ đọc tasks thuộc project mà mình là member
   - Ai đã đăng nhập cũng tạo task được
   - Chỉ assignee hoặc creator sửa task
   - Chỉ admin hoặc creator xóa task

3. Collection 'notifications':
   - User chỉ đọc notifications của mình
   - Không cho client tạo notifications (chỉ Cloud Functions)
   - User chỉ cập nhật field 'read' thành true"

"Thiết kế cấu trúc Firestore cho ứng dụng quản lý công việc:
- Collection 'users': name, email, role (admin/member), department, avatarUrl
- Collection 'tasks': title, description, status (todo/in_progress/completed),
  priority (low/medium/high), assigneeId, projectId, deadline, attachments
- Collection 'projects': name, description, status, members (array UIDs), ownerId
- Collection 'notifications': userId, type, message, read, taskId

Thêm subcollection 'comments' trong mỗi task document."

"Tạo Cloud Functions:
1. onTaskCreated: Khi tạo task mới → gửi notification cho assignee
2. onTaskCompleted: Khi task status đổi sang 'completed' → gửi email cho creator
3. dailyReminder: Mỗi ngày 8:00 AM → nhắc tasks sắp hết deadline (còn 2 ngày)
4. weeklyReport: Thứ Hai 8:00 AM → tổng hợp tasks tuần qua, gửi email cho admin"

"Viết Security Rules:
- users: ai cũng đọc name/avatar, chỉ owner sửa data của mình
- tasks: chỉ members trong project đọc/ghi, admin xóa được
- notifications: chỉ userId tương ứng đọc, client không tạo được
- storage: user đã đăng nhập upload vào folder của mình"

┌──────────────────────────────────────────────────────┐
│           HỆ SINH THÁI FIREBASE (BACKEND)            │
├──────────────────────────────────────────────────────┤
│                                                      │
│  🗄️ FIRESTORE (Database)                             │
│  ├── Collections: users, tasks, projects, ...       │
│  ├── Documents: mỗi document = 1 record dữ liệu   │
│  ├── Subcollections: comments, activity logs        │
│  └── Realtime: cập nhật tức thì cho mọi client     │
│                                                      │
│  🔐 AUTHENTICATION                                   │
│  ├── Phương thức: Google, Email, Phone OTP          │
│  ├── UID: mã định danh duy nhất cho mỗi user       │
│  └── Session: quản lý phiên đăng nhập tự động      │
│                                                      │
│  📦 CLOUD STORAGE                                    │
│  ├── Lưu file: ảnh, PDF, video                     │
│  ├── Tổ chức theo path: avatars/, tasks/, exports/  │
│  └── Kiểm soát quyền qua Storage Rules             │
│                                                      │
│  ⚡ CLOUD FUNCTIONS                                   │
│  ├── Triggers: phản ứng khi Firestore thay đổi     │
│  ├── Scheduled: chạy theo lịch (báo cáo, nhắc nhở) │
│  ├── HTTP: API endpoints cho frontend gọi          │
│  └── Chạy trên server Google, trả phí theo dùng    │
│                                                      │
│  🛡️ SECURITY RULES                                   │
│  ├── Firestore Rules: ai đọc/ghi data nào          │
│  ├── Storage Rules: ai upload/download file nào     │
│  └── Chạy trên server, không thể bypass từ client  │
│                                                      │
└──────────────────────────────────────────────────────┘