Cùng một hệ thống, vì sao FDE phải giải thích theo hai cách
Giám đốc cần một đoạn văn để ra quyết định; kỹ sư trưởng cần đủ chi tiết để tự vận hành khi bạn rời đi.
Tóm tắt nhanh
- Hãy chọn người nghe trước rồi mới chọn cách giải thích: giám đốc hỏi chuyện quyết định, kỹ sư trưởng hỏi chuyện vận hành.
- Sơ đồ ngữ cảnh dành cho cả người không làm kỹ thuật, sơ đồ container mới ghi công nghệ, và cả hai phải rút ra từ cùng một mô hình.
- Bản kỹ thuật là thứ kỹ sư của khách sẽ mở khi bạn đã rời dự án, nên hãy coi nó là sản phẩm bàn giao.
Một FDE thường phải giải thích cùng một hệ thống ít nhất hai lần. Lần đầu là trong phòng họp với giám đốc vận hành, người duyệt ngân sách và chịu trách nhiệm trước ban lãnh đạo. Lần sau là với kỹ sư trưởng của khách, người sẽ trực sự cố lúc ba giờ sáng khi bạn đã rời dự án.
Hai buổi đó cần hai cách nói khác nhau. FullStack viết rằng FDE phải giải thích trade-off kỹ thuật cho những người sẽ không bao giờ đọc code, còn Palantir tách hẳn việc này thành hai vai: theo Oxagile, vai Echo lo sứ mệnh, các bên liên quan và việc áp dụng của khách, vai Delta lo phần thực thi kỹ thuật.
Nếu làm một mình, bạn phải giữ cả hai vai, bằng hai bản giải thích rút ra từ cùng một mô hình để chúng không mâu thuẫn nhau.
Mỗi người nghe đến với một câu hỏi khác
Lucidchart khuyên trước khi chọn cách tiếp cận, hãy nghĩ xem người nghe là ai. Ở dự án FDE, câu hỏi này có câu trả lời khá cụ thể.
Giám đốc muốn biết hệ thống thay đổi gì trong công việc của họ và họ cần quyết định điều gì; kỹ sư trưởng muốn biết cái gì chạy ở đâu, cái gì có thể hỏng, và khi hỏng thì ai sửa.
Mô hình C4 cho bạn sẵn hai lớp tương ứng. Theo tài liệu của C4, sơ đồ ngữ cảnh (system context) là loại sơ đồ có thể đưa cho người không làm kỹ thuật xem. Vì người xem không cần biết công nghệ, cách an toàn là chỉ vẽ con người và các hệ thống phần mềm.
Sơ đồ container nằm ngay dưới, dành cho lập trình viên và đội vận hành. Nó cho thấy kiến trúc ở mức cao, những lựa chọn công nghệ chính và cách các container giao tiếp với nhau. Vì hai sơ đồ cùng mô tả một hệ thống, điều bạn hứa với giám đốc sẽ khớp với cấu hình bạn bàn giao cho kỹ sư.
Hình ảnh còn có một lợi thế riêng. Lucidchart cho rằng nội dung trực quan dễ học và được nhớ lâu hơn khái niệm chỉ được đọc hoặc nghe kể, nên một sơ đồ bốn ô thường hiệu quả hơn ba trang mô tả.
Một hệ thống xử lý hồ sơ, kể hai lần
Lấy một ví dụ giả định. Bạn triển khai cho một công ty bảo hiểm một agent đọc email yêu cầu bồi thường, trích xuất các trường thông tin, rồi đưa lên màn hình để nhân viên thẩm định duyệt. Có một quyết định cần chốt: xử lý từng hồ sơ ngay khi email đến, hay đưa hồ sơ vào hàng đợi rồi xử lý dần.
Bản cho giám đốc bắt đầu bằng sơ đồ ngữ cảnh có bốn ô: khách hàng gửi hồ sơ, nhân viên thẩm định, hệ thống quản lý hợp đồng sẵn có của công ty, và nhà cung cấp mô hình AI. Sơ đồ này không có mũi tên nào ghi tên cơ sở dữ liệu.
Tiếp theo là một đoạn trade-off duy nhất, viết sao cho giám đốc đọc xong có thể trả lời ngay:
“Có hai cách.
Cách một: hồ sơ được đọc ngay khi email đến, nhân viên thấy kết quả gần như tức thì.
Đổi lại, nếu dịch vụ AI bên ngoài chậm hoặc gián đoạn, một số hồ sơ phải gửi lại.
Cách hai: hồ sơ xếp hàng và được đọc lần lượt, kết quả có sau vài phút.
Bù lại, không hồ sơ nào thất lạc kể cả khi dịch vụ AI gặp sự cố.
Đội đề xuất cách hai.
Anh/chị chỉ cần xác nhận một điều: chờ vài phút có chấp nhận được với quy trình thẩm định hiện nay không?”
Bản cho kỹ sư trưởng là sơ đồ container của cùng hệ thống đó. Có một dịch vụ nhận email, một hàng đợi, một worker gọi API của mô hình, một cơ sở dữ liệu Postgres lưu kết quả trích xuất, và một ứng dụng web cho nhân viên.
Ở đây bạn nói về số lần retry, chỗ lưu những message xử lý thất bại, chỗ đặt cảnh báo, và việc ai trực khi hàng đợi bị dồn.
Bảng dưới đặt cùng một quyết định vào hai cách nói:
| Khía cạnh | Với giám đốc vận hành | Với kỹ sư trưởng |
|---|---|---|
| Quyết định | Chờ vài phút có chấp nhận được không | Đổi xử lý đồng bộ sang hàng đợi cùng worker |
| Rủi ro | Hồ sơ có thể phải gửi lại | Timeout khi gọi API mô hình, message bị mất |
| Cách giảm rủi ro | Không hồ sơ nào thất lạc | Retry có giới hạn, có chỗ lưu message lỗi |
| Việc của họ sau buổi họp | Trả lời có hoặc không | Nhận runbook và lịch trực |
Làm sao để hai bản không thành hai câu chuyện
Bắt đầu bằng một mô hình duy nhất: danh sách các tác nhân, các hệ thống và các container, giữ trong một file mà cả đội cùng sửa. Vẽ sơ đồ ngữ cảnh trước, vì nếu không vẽ được hệ thống mà không nhắc đến công nghệ thì nhiều khả năng bạn chưa hiểu rõ nó phục vụ ai.
Tiếp theo, viết đoạn trade-off. The Hustling Engineer khuyên mở đầu bằng lý do khái niệm đó quan trọng với người nghe và luôn nối việc kỹ thuật với một kết quả cụ thể. Vì thế đoạn văn nên kết thúc bằng một câu hỏi người nghe có thể trả lời, như “chờ vài phút có được không”.
Cũng theo The Hustling Engineer, phép so sánh với đồ vật và trải nghiệm hằng ngày giúp ý phức tạp dễ hiểu hơn, còn thuật ngữ nếu bắt buộc phải dùng thì hãy định nghĩa.
Thử thay “độ trễ” bằng “chờ vài phút”, thay “retry” bằng “tự gửi lại”. Hàng đợi có thể ví như quầy lấy số ở ngân hàng: ai đến trước được phục vụ trước, và không ai bị bỏ sót khi quầy tạm đóng.
Chỉ sau đó mới vẽ sơ đồ container, chép tên các thành phần từ cùng mô hình và thêm công nghệ vào. Cuối cùng, nhờ giám đốc tóm tắt quyết định bằng lời của họ. Nếu họ nói lại đúng câu hỏi bạn đặt ra, bản giải thích đã đạt.
Lỗi thường gặp nằm ở cả hai phía
Lỗi phổ biến với người không làm kỹ thuật là nói quá đơn giản tới mức coi thường họ. a16z mô tả FDE làm việc ngay trong tổ chức của khách để hiểu ngữ cảnh nghiệp vụ, và ngữ cảnh đó nằm trong đầu chính những người bạn đang trình bày.
Giám đốc vận hành hiểu quy trình thẩm định hơn bạn, nên hãy dùng chính ngôn ngữ của quy trình đó.
Lỗi ngược lại là nói quá nhiều chi tiết. Nếu slide cho giám đốc có tên một thư viện mã nguồn mở, rất có thể bạn đang trình bày cho chính mình.
Lỗi nguy hiểm nhất nằm ở phía kỹ sư: đưa cho kỹ sư trưởng bộ slide đã trình bày cho giám đốc rồi coi như đã bàn giao. Người trực sự cố lúc ba giờ sáng cần sơ đồ container, runbook và các quyết định đã chốt, chứ slide không giúp họ tìm ra message nào bị kẹt.
Lỗi cuối cùng là để hai bản lệch nhau, chẳng hạn nói với giám đốc “vài phút” trong khi cấu hình timeout lại cho phép chờ cả giờ.
Biến kỹ năng này thành bằng chứng trong hồ sơ
FullStack đặt hai yêu cầu cạnh nhau cho một FDE giỏi: độ sâu kỹ thuật của kỹ sư senior và óc phán đoán để làm việc với những người không làm kỹ thuật, trên những bài toán chưa ai định nghĩa rõ. Một dòng trong CV khó cho thấy điều này, nhưng tài liệu thì làm được.
Trong portfolio, hãy để sơ đồ ngữ cảnh, sơ đồ container và đoạn trade-off của cùng một dự án nằm cạnh nhau, mỗi bản ghi rõ dành cho ai. Người phỏng vấn sẽ thấy cùng lúc cả hai yêu cầu.
Khi đọc tin tuyển dụng, hãy để ý những dòng yêu cầu làm việc với cả bên kỹ thuật lẫn bên không kỹ thuật. Đó là gợi ý rằng buổi phỏng vấn có thể đề nghị bạn giải thích một hệ thống hai lần. Hãy luyện trước bằng một hệ thống bạn từng làm, với đồng hồ bấm giờ: hai phút cho giám đốc, mười phút cho kỹ sư trưởng.
Ngày bạn rời dự án, giám đốc sẽ nhớ quyết định họ đã đưa ra, còn kỹ sư trưởng sẽ mở tài liệu bạn để lại vào lần đầu hàng đợi bị dồn. Mỗi bản giải thích nên được viết cho đúng khoảnh khắc ấy.
Bài này có hữu ích không?
Cảm ơn bạn đã góp ý!
7 nguồn
- The seven skills that define a forward-deployed engineer · 2026-11-10
- The Palantirization of everything · 2026-01-16
- How to Explain Technical Concepts to Non-Technical Stakeholders · 2024-11-24
- How to communicate technical information to a non-technical audience · 2023-08-02
- System context diagram | C4 model
- Container diagram | C4 model
- Palantir Forward Deployed Engineer Model: What Companies Should Copy · 2026-07-13