Tụi em có vẽ sơ sơ, nhưng không cập nhật mấy tháng nay→ Thực ra, không ai còn hiểu hệ thống gồm những gì chạy ở đâu.
Một hệ thống không có tài liệu kỹ thuật thì sẽ trở thành một “hòn đảo thần bí”.
Sau vài vòng hỏi, không ai trong team biết:
- Cron job nào đang chạy?
- Queuing system connect ra sao?
- Bên nào gọi bên nào?
🎯 Bài học:
- CTO hoặc Fractional CTO cần ép team duy trì hệ thống tài liệu được up-to-date
- System Diagram (db → API → services → external)
- Sequence Diagram cho các flow chính
- Infra Diagram dùng Diagram-as-Code (Mermaid, Lucidchart, Cloudcraft), đừng có ngồi vẽ bằng draw.io nữa, bro
Đăng nhận xét