Đọc site này thế nào
AIMY: phần mềm quản lý trung tâm Before/After School Care (giữ trẻ trước & sau giờ học) — đăng ký học, đặt suất, billing, nhân sự, báo cáo sự việc cho phụ huynh.
Trang này: cách tài liệu được tổ chức → bạn lấy đúng thứ cần, dù là người mới, kỹ sư, hay support.
Nguyên tắc trình bày: đi từ ngoài vào trong
Mỗi domain kể chuyện theo cùng một mạch, từ dễ đến sâu. Dừng ở tầng nào tùy nhu cầu:
| Trang | Trả lời câu hỏi | Hợp với ai |
|---|---|---|
| Tổng quan | Domain này là gì, giải quyết vấn đề gì, ai dùng? | Mọi người |
| Góc nhìn end-user | Người dùng cuối thao tác ra sao, thấy gì trên màn hình? | Mọi người, support |
| Khái niệm cốt lõi | Các thuật ngữ và "vật thể" chính trong domain là gì? | Mọi người |
| Kiến trúc hệ thống | Hệ thống gồm những thành phần nào, dữ liệu chảy thế nào? | Kỹ sư, kiến trúc |
| Luồng xử lý trong code | Code nào, queue/worker nào xử lý? | Kỹ sư |
| Case thường gặp | Tình huống thực tế và cách hệ thống phản ứng? | Kỹ sư, support |
Quy ước trong tài liệu
- Ngôn ngữ: tiếng Việt là chính, mixed English ở thuật ngữ phổ biến/chuyên ngành (
NotificationJob,Enrollment,EntityEvent…) — dịch "thuần Việt" làm giảm nghĩa và khó tra cứu. Lần đầu xuất hiện có chú thích nghĩa. - Khối code & sơ đồ: ví dụ minh họa để hiểu, không phải bản sao chính xác của code.
- Sơ đồ: vẽ bằng Mermaid. Đọc theo chiều mũi tên; chú thích cạnh mũi tên cho biết "cái gì truyền sang cái gì".
Wiki tóm lược cho dễ hiểu, không phải đặc tả đầy đủ. Khi nghi ngờ chi tiết → đối chiếu hành vi thật của hệ thống hoặc hỏi team domain.
Ba "ứng dụng" bạn sẽ nghe nhắc tới
Hệ thống AIMY gồm 3 project độc lập (chi tiết ở Nền tảng):
| Tên | Là gì | Vai trò |
|---|---|---|
| Topi | Frontend React/UmiJS (cũ, maintenance) | Một phần giao diện admin |
| Tuke | Frontend Next.js (mới, đang phát triển) | Giao diện web hiện đại |
| Tux | Backend .NET 8 + Workers | API, nghiệp vụ, xử lý nền (queue/worker) |
Hầu hết "luồng xử lý bên trong" nằm ở Tux (backend + workers).