Claude cho Engineering: Thiết kế kiến trúc hệ thống

Trong quá trình phát triển phần mềm, một trong những thách thức lớn nhất không phải là viết code mà là đưa ra quyết định thiết kế đúng đắn — chọn công nghệ nào, kiến trúc nào, và tại sao. Claude có thể trở thành người đồng hành kỹ thuật giúp bạn tạo Architecture Decision Record (ADR) chuẩn mực, phân tích trade-off, và lưu trữ lý do đằng sau mỗi quyết định quan trọng.

ADR là gì và tại sao cần thiết?

Architecture Decision Record (ADR) là tài liệu ngắn gọn ghi lại một quyết định kiến trúc quan trọng, bao gồm bối cảnh, các lựa chọn đã xem xét, quyết định cuối cùng và hệ quả của nó. ADR giải quyết một vấn đề phổ biến trong nhiều team engineering Việt Nam: sau 6 tháng, không ai nhớ tại sao lại chọn MongoDB thay vì PostgreSQL, hoặc tại sao lại dùng message queue thay vì gọi API trực tiếp.

Lợi ích chính của ADR:

• Giúp người mới onboard hiểu lịch sử kiến trúc hệ thống
• Tránh tranh luận lại những quyết định đã được cân nhắc kỹ
• Tạo cơ sở để review và cập nhật khi bối cảnh thay đổi
• Minh bạch hóa quá trình ra quyết định kỹ thuật với stakeholders

Ba cách dùng Claude cho kiến trúc

1. Tạo ADR mới

Khi cần quyết định giữa các phương án công nghệ, hãy mô tả bối cảnh và ràng buộc của bạn cho Claude:

Tôi cần tạo ADR cho quyết định chọn message broker cho hệ thống
đặt hàng của startup thương mại điện tử với 50K đơn/ngày.

Ràng buộc:
- Team 5 người, chủ yếu quen với AWS
- Budget hạn chế, muốn dùng managed service
- Cần xử lý event ordering cho đơn hàng
- Có thể scale lên 500K đơn/ngày trong 2 năm tới

Hãy tạo ADR so sánh Amazon SQS+SNS vs Apache Kafka vs RabbitMQ.

Claude sẽ tạo ADR đầy đủ với bảng so sánh các chiều như độ phức tạp, chi phí, khả năng mở rộng, và độ quen thuộc của team.

2. Review thiết kế hiện có

Paste sơ đồ kiến trúc hoặc mô tả hệ thống vào Claude để nhận phản hồi có cấu trúc:

Review thiết kế microservices này cho hệ thống fintech của chúng tôi:

- API Gateway (Kong) nhận request từ mobile app
- Auth Service: JWT với Redis cache
- Payment Service: gọi thẳng sang Inventory Service
- Order Service: PostgreSQL, xử lý 200 TPS peak
- Notification Service: gửi email/SMS qua SendGrid/Twilio

Vấn đề hiện tại: đôi khi đơn hàng bị tạo nhưng không có thông báo.
Hãy identify các điểm yếu kiến trúc và đề xuất cải thiện.

3. Thiết kế hệ thống từ yêu cầu

Claude có thể giúp bạn thiết kế một component mới từ đầu khi nhận được requirements rõ ràng.

Workflow: Tạo ADR với Claude

1. Bước 1 — Xác định quyết định cần ghi lại: Câu hỏi dạng "Chúng ta nên dùng X hay Y cho Z?" là tín hiệu tốt để tạo ADR.
2. Bước 2 — Cung cấp bối cảnh đầy đủ: Team size, budget, timeline, tech stack hiện tại, load dự kiến.
3. Bước 3 — Yêu cầu Claude tạo ADR: Chỉ định rõ các option muốn so sánh.
4. Bước 4 — Review và bổ sung: Thêm context nội bộ mà Claude không biết (ví dụ: vendor relationship, team preference).
5. Bước 5 — Lưu trữ trong repo: Đặt file ADR vào docs/adr/ hoặc architecture/decisions/.

Cấu trúc ADR chuẩn

Claude sẽ tạo ADR theo format sau:

# ADR-007: Chọn Message Broker cho Order Processing

Status: Accepted
Date: 2026-03-15
Deciders: CTO, Lead Backend, DevOps Lead

## Bối cảnh
Hệ thống xử lý đơn hàng hiện tại gọi API đồng bộ giữa
Order Service và các downstream services. Khi Notification
Service chậm, toàn bộ luồng đặt hàng bị ảnh hưởng...

## Quyết định
Sử dụng Amazon SQS cho async messaging với FIFO queues
cho các event yêu cầu ordering.

## Các phương án đã xem xét

### Option A: Amazon SQS + SNS
| Chiều         | Đánh giá       |
|---------------|----------------|
| Độ phức tạp   | Thấp           |
| Chi phí       | ~$50/tháng     |
| Scalability   | Cao (managed)  |
| Team quen     | Cao (AWS)      |

Ưu: Managed hoàn toàn, tích hợp AWS ecosystem tốt
Nhược: Không có replay, giới hạn message size 256KB

### Option B: Apache Kafka
...

## Hệ quả
- Dễ hơn: Decoupling services, retry tự động
- Khó hơn: Debug distributed transactions
- Cần revisit: Nếu cần event sourcing trong tương lai

Prompt nâng cao: So sánh kiến trúc

Để nhận phân tích sâu hơn, hãy thêm các ràng buộc phi chức năng:

So sánh monolith vs microservices cho startup SaaS B2B của tôi:

Thông tin:
- MVP sau 3 tháng, hiện có 2 backend developers
- Dự kiến 100 khách hàng doanh nghiệp trong năm 1
- Tính năng: CRM, reporting, integrations với 3rd party
- Tech stack: Node.js, PostgreSQL

Tôi đang lean về monolith nhưng muốn nghe phân tích
trade-off đầy đủ, đặc biệt về long-term maintainability.

Mẹo dùng Claude hiệu quả cho kiến trúc

• Nêu ràng buộc trước: "Cần ship trong 2 tuần" hay "Phải handle 10K RPS" định hình câu trả lời. Không có ràng buộc, không có thiết kế tối ưu.
• Đặt tên các option: Dù bạn đã có preference, yêu cầu Claude phân tích nhiều phương án để có góc nhìn khách quan hơn.
• Bao gồm non-functional requirements: Latency, chi phí, kinh nghiệm team, và gánh nặng bảo trì quan trọng không kém tính năng.
• Review định kỳ: Yêu cầu Claude review lại ADR cũ khi scale thay đổi: "ADR này được viết khi có 10K users. Bây giờ có 1M users, gợi ý nào cần update?"

Ví dụ thực tế: VNG và bài toán real-time notification

Giả sử bạn đang làm tại một công ty như VNG, cần thiết kế hệ thống push notification cho 50 triệu người dùng. Prompt với Claude:

Thiết kế hệ thống push notification cho 50M DAU:

Requirements:
- Gửi notification theo real-time (p99 < 2 giây)
- Support: iOS APNs, Android FCM, Web Push
- Personalization: dựa trên user behavior
- Analytics: delivery rate, open rate
- Budget: $10K/tháng infrastructure

Hãy design high-level architecture với component diagram,
data flow, và phân tích top 3 rủi ro kỹ thuật.

Lưu ADR vào codebase

Best practice là lưu ADR ngay trong repository để version control cùng code. Tạo cấu trúc thư mục:

docs/
  adr/
    README.md          (index của tất cả ADR)
    ADR-001-database.md
    ADR-002-auth.md
    ADR-007-messaging.md
  architecture/
    system-overview.md
    data-flow.md

Yêu cầu Claude tạo README index tự động từ danh sách file ADR là một workflow hiệu quả giúp documentation luôn up-to-date.

Bước tiếp theo

Sau khi nắm vững ADR và kiến trúc cơ bản, hãy khám phá các workflow kỹ thuật khác:

• Xem thư viện ứng dụng Claude để tìm thêm use case engineering
• Kết hợp với System Design workflow để chuẩn bị technical interview hoặc planning session
• Dùng Code Review workflow để đảm bảo implementation đúng với ADR đã định

Bài viết liên quan

• Claude cho Engineering: System Design interviews và planning
• Claude cho Engineering: Chiến lược testing toàn diện
• Claude cho Engineering: Code Review tự động
• Claude cho Data: Xây dựng Dashboard từ dữ liệu
• Claude Skills — Tạo Excel, PowerPoint, PDF tự động