Kiến trúc
Bản đồ mã nguồn
Đọc mã theo một hành vi cụ thể sẽ dễ hơn đọc lần lượt tất cả thư mục. Bắt đầu từ tính năng, rồi đi theo đường dữ liệu.
Ba ranh giới quan trọng#
Giao diện React→window.desktop / IPC→Electron main
Renderer hiển thị giao diện và nhận thao tác. IPC là hợp đồng trao đổi có kiểm tra payload bằng zod. Main sở hữu thao tác hệ thống: file, shell, Git, cơ sở dữ liệu và provider.
Renderer không gọi trực tiếp Node hoặc truy cập SQLite. Một thay đổi giao diện có thể cần lần theo hợp đồng IPC và service đang xử lý hành vi đó.
Bản đồ thư mục#
| Đường dẫn | Trách nhiệm |
|---|---|
apps/desktop/src/features/ | Giao diện và logic phía renderer theo tính năng. |
apps/desktop/electron/ipc/ | Tiếp nhận, kiểm tra và chuyển yêu cầu. |
apps/desktop/electron/services/ | Xử lý hệ thống và điều phối phía main. |
packages/shared/ | Kiểu dữ liệu, schema và hợp đồng dùng chung. |
packages/db/ | Schema và lớp dữ liệu SQLite. |
packages/ui/ | Thành phần giao diện dùng chung. |
docs/features/ | Hợp đồng và phạm vi của mỗi tính năng. |
docs/progress/ | Tiến độ, phần còn thiếu và bằng chứng. |
Cách lần theo một hành vi#
- Tìm feature ID trong
docs/features.md. - Đọc metadata
code_ownershiptrong đặc tả để biết vùng mã sở hữu. - Tìm component hoặc controller xử lý thao tác bạn quan tâm.
- Nếu có
window.desktop, lần theo preload, IPC handler và service tương ứng. - Đọc tiến độ và test thuộc workspace để biết điều gì đã được kiểm chứng.
Tài liệu gốc để đối chiếu 3 nguồn
Đường dẫn trong kho mã MegaStacks. Đây là nguồn để kiểm tra hợp đồng và trạng thái, không phải liên kết tải mã công khai.
CLAUDE.mddocs/architecture.mddocs/features/loop-manager/ownership-and-boundaries.md