Blueprint v3

MindfulBlock Technical Docs

Hệ thống quản lý sự tập trung đa nền tảng & Đồng bộ thời gian thực

01 Yêu cầu Chức năng Hệ thống

FR-01: Engine Lực cản (Friction)

Hệ thống phải triển khai "Soft Block" thay vì chỉ chặn cứng, buộc người dùng phải tương tác có ý thức trước khi truy cập.

  • REQ-01: Tự động nhận diện DNS query/HTTP request đến danh sách đen trong < 100ms.
  • REQ-02: Cung cấp thử thách: Giải toán, Chờ đợi, hoặc Gõ xác nhận.
  • REQ-02.1: Quản lý danh sách chặn: Hỗ trợ Import/Export CSV để chia sẻ cấu hình.
  • REQ-02.2: **Hệ thống Token Shop**: Người dùng tích lũy token qua thời gian tập trung để mua Site Pass hoặc Streak Freeze.

FR-02: Quản lý Tập trung

  • REQ-03: Một tài khoản quản lý tối đa 5 thiết bị đồng thời.
  • REQ-04: Đồng bộ 2 chiều (Bidirectional) tất cả quy tắc chặn ngay lập tức.
  • REQ-05: **Minimize to Tray**: Mặc định thu nhỏ xuống khay hệ thống để đảm bảo tính liên tục của việc chặn.

Ma trận Ưu tiên Yêu cầu

02 Yêu cầu Phi chức năng (NFR)

Hiệu năng (Performance)

Mức chiếm dụng CPU không quá 1.5% khi chạy ngầm trên Desktop. Pin mobile không hao tổn quá 1% mỗi 12h.

Tính sẵn sàng (Availability)

Hệ thống chặn phải hoạt động 100% thời gian ngay cả khi mất kết nối mạng (Local Cache Engine).

Bảo mật (Security)

Toàn bộ logs vi phạm phải được mã hóa AES-256 trước khi lưu trữ hoặc truyền tải.

03 Kiến trúc Hệ thống & Cơ sở dữ liệu

Thiết kế Xử lý Xung đột (Conflict Resolution)

// Chiến lược Versioning đa thiết bị
const syncEngine = (localDoc, cloudDoc) => {
  if (cloudDoc.v > localDoc.v) {
    return applyRemoteUpdate(cloudDoc); // Update cục bộ
  } else if (localDoc.v > cloudDoc.v) {
    return pushLocalChanges(localDoc); // Ghi đè Cloud
  } else {
    return 'UP_TO_DATE';
  }
}

Mô hình thực thể (Database Schema)

Collection: Rules

  • - rule_id: PK
  • - pattern: string
  • - type: ENUM
  • - v: integer
  • - t: timestamp

Collection: Gamification

  • - balance: int (Tokens)
  • - streak_freezes: int
  • - active_passes: Array<Pass>
  • - last_checkin: timestamp
01

Biểu đồ Use Case Tổng quát

Tổng quan tính năng hiện tại và lộ trình phát triển.

Loading Use Case Diagram...

Hệ thống Lực cản (Friction)

Cốt lõi của ứng dụng. Thay vì chặn cứng, hệ thống đưa ra các thử thách (Toán, Gõ phím) để người dùng cân nhắc lại quyết định truy cập.

Gamification & Phần thưởng

Cơ chế thưởng Token khi tập trung, dùng để mua vật phẩm trong Shop hoặc chăm sóc "Khu vườn số" (Digital Garden).

Đồng bộ & Quản lý

Cấu hình được đồng bộ qua Cloud (Firebase), đảm bảo nhất quán giữa PC và Extension.