Giới thiệu Tasco App Framework
Chào mừng bạn đến với tài liệu kỹ thuật của Tasco App Framework (hay Tasco SuperApp Platform). Đây là nền tảng di động doanh nghiệp (Enterprise Mobile Platform) hỗ trợ xây dựng hệ sinh thái SuperApp và các Mini-apps của Tasco Group một cách đồng bộ, an toàn và dễ dàng mở rộng.
Tài liệu này thuộc quyền sở hữu riêng tư và bảo mật (PRIVATE & CONFIDENTIAL) của Tasco Group. Nghiêm cấm phân phối hoặc tiết lộ ra bên ngoài mà không có sự đồng ý bằng văn bản từ Ban công nghệ Tasco.
1. Mục tiêu của Nền tảng
Hệ thống Core Framework được thiết kế nhằm giải phóng các nhóm phát triển khỏi việc thiết lập hạ tầng lặp đi lặp lại, cho phép họ tập trung tối đa vào logic nghiệp vụ của ứng dụng:
- Core Foundation: Chia sẻ cấu trúc khởi tạo (bootstrap), cấu hình (config), Dependency Injection (DI), Logging, Observability, Storage và Quản lý vòng đời (lifecycle).
- Design System (
ui_kit): Thư viện component và design token chuẩn hóa, nhất quán trải nghiệm người dùng toàn hệ sinh thái. - Hợp đồng Mini-app (
module): Một giao diện cắm ghép (plug-in contract) rõ ràng, giúp nhúng các module nghiệp vụ vào Host Shell mà không phụ thuộc lẫn nhau. - Clean Architecture & Định hướng một chiều: Ràng buộc phân lớp chặt chẽ giúp dự án dễ bảo trì ngay cả khi mở rộng quy mô lên hàng chục đội phát triển.
2. Bản đồ Trách nhiệm các Package
Tasco App Framework được tổ chức dưới dạng mono-repo gồm nhiều package bổ trợ lẫn nhau, được đóng gói độc lập và phát hành lên Private Registry https://pub.vtii.vn:
| Package | Tên trên Registry | Vai trò cốt lõi |
|---|---|---|
tasco_utils | tasco_utils | Thư viện nền tảng thuần túy: formatters, validators, extensions, enum trạng thái bất đồng bộ LoadingStatus. |
tasco_core | tasco_core | Runtime framework: quản lý môi trường (env), HTTP interceptor/refresh token, Route Guards, Loading Manager, OTA seam. |
tasco_ui_kit | tasco_ui_kit | Design system: màu Navy/Teal, typography, components chuẩn hóa và widget gốc TascoApp. |
tasco_module | tasco_module | Hợp đồng giao tiếp (Contract) giữa Host Shell và các Mini-apps (ModuleSlot, ModuleManager). |
tasco_notifications | tasco_notifications | Quản lý FCM push notifications và đăng ký push token tự động. |
tasco_observability | tasco_observability | Tích hợp giám sát lỗi (Crashlytics) và cấu hình động (Remote Config) từ Firebase. |
tasco_storage | tasco_storage | Lớp trừu tượng hóa dữ liệu bền vững (KeyValueStore, SecureStore, JsonStore, TokenStore). |
tasco_auth | tasco_auth | Feature xác thực dùng chung: quản lý trạng thái đăng nhập/đăng xuất với AuthCubit. |
tasco_ota | tasco_ota | Hạ tầng cập nhật trực tiếp không qua App Store/ChPlay sử dụng Shorebird engine. |
tasco_cli | tasco_cli | Công cụ dòng lệnh tasco hỗ trợ sinh dự án nhanh (scaffold) và sinh các component nghiệp vụ. |
3. Quy trình Bắt đầu Nhanh (Quick Start)
Bước 1: Thêm Token Private Registry
Để có thể tải các gói thư viện chuẩn tasco_* từ registry nội bộ, bạn cần đăng ký token truy cập:
dart pub token add https://pub.vtii.vn
# Hoặc sử dụng CLI sau khi cài đặt:
tasco login
Bước 2: Cài đặt Developer CLI
Kích hoạt công cụ tasco toàn cục trên máy tính của bạn:
dart pub global activate tasco_cli --hosted-url https://pub.vtii.vn
Bước 3: Tạo mới dự án SuperApp Shell
Scaffold ứng dụng host shell từ template tiêu chuẩn:
tasco create app --name "My SuperApp" --folder my_superapp --package vn.tasco.superapp
Hãy tiếp tục đọc phần Kiến trúc nền tảng để nắm được nguyên lý hoạt động của SuperApp Container và Mini-apps plug-in.