Mục tiêu

Bộ prompt này giúp tạo tài liệu kỹ thuật hoàn chỉnh cho một microservice thanh toán sử dụng REST API và Kafka. Tài liệu đầu ra hướng tới tính thực chiến, rõ ràng, có thể dùng cho thiết kế hệ thống, onboarding đội backend, review kiến trúc hoặc chuẩn bị triển khai production.

Nội dung có thể bao phủ

• Tổng quan mục tiêu nghiệp vụ và phạm vi microservice thanh toán.
• Kiến trúc hệ thống, các service liên quan và luồng giao tiếp REST/Kafka.
• Thiết kế REST API, request/response, status code và quy ước lỗi.
• Thiết kế Kafka topic, event schema, producer/consumer, retry và dead-letter queue.
• Idempotency, transaction consistency, saga/outbox pattern và xử lý thanh toán bất đồng bộ.
• Bảo mật, phân quyền, mã hóa dữ liệu nhạy cảm và tuân thủ PCI DSS ở mức mô tả.
• Logging, tracing, metrics, alerting và checklist vận hành.

Khi nào nên dùng

• Khi cần viết tài liệu kỹ thuật cho microservice thanh toán mới.
• Khi cần chuẩn hóa tài liệu hiện có để dễ review và bàn giao.
• Khi đội backend cần mô tả rõ tích hợp giữa REST API, Kafka và hệ thống cổng thanh toán.
• Khi chuẩn bị tài liệu thiết kế trước khi triển khai production.

Hướng dẫn tùy biến

1. Thay thế các phần trong ngoặc vuông bằng thông tin thực tế như tên service, stack công nghệ, database, payment provider và tiêu chuẩn nội bộ.
2. Bổ sung các endpoint, event, topic hoặc ràng buộc nghiệp vụ đặc thù của hệ thống.
3. Nếu chưa có đủ thông tin, yêu cầu AI đặt câu hỏi làm rõ trước khi viết tài liệu.
4. Có thể yêu cầu AI xuất bản tài liệu theo định dạng dành cho Confluence, Notion, Markdown nội bộ hoặc tài liệu thiết kế kỹ thuật.

Lưu ý

• Không đưa thông tin bí mật như API key, token, thông tin merchant thật hoặc dữ liệu thẻ thật vào prompt.
• Các nội dung về bảo mật và tuân thủ nên được đội security hoặc compliance kiểm tra lại trước khi áp dụng.
• Với hệ thống thanh toán thực tế, cần review kỹ các phần idempotency, retry, reconciliation và xử lý lỗi để tránh phát sinh giao dịch trùng hoặc mất sự kiện.