Repository của nền tảng Ecoma.io: nhiều bounded context và deploy unit chạy trên Cloudflare Workers, tổ chức theo Nx monorepo.
- Đóng góp →
CONTRIBUTING.md— điểm bắt đầu cho developer, coding agent và người review: cần đọc gì, tạo Issue thế nào, PR được merge khi nào. - Tài liệu hệ thống →
docs/README.md— bản đồ bốn viewarchitecture/,domains/,applications/,features/và quá trình kỹ thuật. - Quy trình kỹ thuật →
docs/engineering/— vòng đời, quản lý công việc trên GitHub và cách đóng góp.
For AI Agents Read
AGENTS.md— kiến trúc không thương lượng, ngôn ngữ, quy tắc PR và merge.
Mọi thay đổi kỹ thuật đi qua một quy trình thống nhất cho người và agent; không phải thay đổi nào cũng cần Issue hay Milestone. Năm bước dưới đây là bản rút gọn — vòng đời canonical có bảy bước:
- Hiểu context và xác định loại công việc — Discovery, Modelling, Experiment, Delivery hoặc Remediation.
- Search Issue/PR; tái sử dụng, liên kết hoặc tạo work item mới khi công việc độc lập theo dõi được.
- Tạo branch và draft PR khi công việc đã đủ rõ.
- Chạy validation phù hợp với loại thay đổi và báo cáo kết quả thật.
- Merge qua merge queue, rồi reconcile và đóng Issue khi đủ điều kiện.
Chi tiết → docs/engineering/contribution-workflow.md.