Dự án: quy trình tài liệu CEO → DEV

Hai bài trước cho ta nơi lưu (docs-as-code) và cách dựng nhanh (AI). Bài này ghép tất cả thành một quy trình chạy được: một tính năng đi từ ý tưởng tới code, qua mọi vai trò, để lại dấu vết trong repo.

Mọi vai trò đọc/ghi vào CÙNG repo, nên không ai làm việc với một bản "sự thật" lỗi thời.

Theo dõi một tính năng đi hết quy trình. Ý tưởng từ Sales: "cho người dùng nạp tiền bằng quét mã QR". Đây là chuỗi artifact để lại trong repo:

• ▸1. Glossary: thêm thuật ngữ "Mã QR nạp tiền" để cả công ty hiểu giống nhau.
• ▸2. User story (BA): "Là người dùng, tôi muốn nạp tiền bằng quét QR để khỏi nhập số tài khoản".
• ▸3. Cập nhật C4: Context hầu như không đổi; Container thêm quan hệ tới dịch vụ QR.
• ▸4. ADR (DEV): "Dùng dịch vụ QR của ngân hàng thay vì tự sinh" - kèm hệ quả.
• ▸5. Code: DEV hiện thực, cập nhật sơ đồ Component của API trong cùng PR.

# Nap tien bang quet QR

La nguoi dung, toi muon nap tien bang quet ma QR
de khoi phai nhap so tai khoan thu cong.

## Tieu chi chap nhan
- Cho rang nguoi dung mo man hinh nap tien,
  Khi quet mot ma QR hop le cua ngan hang lien ket,
  Thi so tien duoc dien san va cho xac nhan.
- Cho rang ma QR het han,
  Khi quet,
  Thi he thong bao "ma da het han" va khong nap.

Sơ đồ Container của ví (artifact bước 3) - chỗ tính năng mới sẽ gắn vào:

Lặp lại quy trình cho một lĩnh vực khác: tính năng "đặt món theo nhóm" (nhiều người cùng chọn món trong một đơn) của app đặt đồ ăn.

• ▸Glossary: "Đơn nhóm", "Người tạo đơn", "Thành viên" - định nghĩa rõ.
• ▸User story: cho cả người tạo đơn và thành viên tham gia.
• ▸C4: Container có thể thêm quan hệ thời gian thực (cập nhật giỏ hàng chung).
• ▸Để ý: cùng quy trình, chỉ khác phần tử - đó là điều cần ngấm.

Dự án thứ ba: tính năng "cấp chứng chỉ khi học viên hoàn thành khoá" của nền tảng học trực tuyến.

• ▸User story: "Là học viên, tôi muốn nhận chứng chỉ khi hoàn thành để chứng minh năng lực".
• ▸C4: thêm một component "Certificate Service" trong API; có thể thêm hệ thống ngoài để gửi/ký chứng chỉ.
• ▸ADR: chọn cách sinh chứng chỉ (PDF tự sinh hay dịch vụ ngoài) - ghi lại đánh đổi.

Ở mỗi bước, AI có thể dựng nháp để mèo con kiểm chứng - đúng như bài trước đã học.

• ▸BA: nhờ AI nháp user story + tiêu chí chấp nhận từ một mô tả ngắn của Sales.
• ▸Kiến trúc: nhờ AI cập nhật sơ đồ Container/Component khi thêm thành phần.
• ▸ADR: nhờ AI liệt kê các lựa chọn & đánh đổi để mèo con cân nhắc rồi chốt.
• ▸Luôn kiểm chứng: AI tăng tốc, nhưng chữ ký cuối là của con người.

Mèo con giờ không chỉ vẽ được C4, mà còn đưa nó vào một quy trình thật: tài liệu sống cùng code, AI dựng nháp, và mọi vai trò từ CEO/Sales đến DEV cùng một nguồn sự thật. Đây là thứ giúp cả công ty "nói cùng một ngôn ngữ" về hệ thống.

• ▸Áp dụng ngay: cho một tính năng thật đi hết quy trình, dù công ty đã có quy trình hay chưa.
• ▸Bắt đầu nhỏ: một user story + một sơ đồ cập nhật trong một PR, rồi nhân rộng.
• ▸Giữ kỷ luật kiểm chứng: tài liệu đúng mới đáng tin, và đáng tin mới được dùng.