Dữ liệu FDE TimesViệc làm FDE đang mở 873▼9 Thay đổi số việc đang mở trong 7 ngày, so sánh cùng phạm vi: không tính việc của các công ty mới được theo dõi tuần nàyMới trong 7 ngày 55Công ty đang tuyển 181Nhận làm từ xa 25%Lương trung vị (Mỹ) $200kTuyển nhiều nhất Databricks 98
中文EN

Tờ báo của nghề Forward Deployed Engineer

Bách khoa

Tiếp quản dự án nhà thầu bỏ dở: tuần đầu chưa vội sửa code

Một bảng kiểm kê, một baseline và một bản đánh giá bằng văn bản sẽ quyết định việc gì thật sự phải làm lại.

Chia sẻLinkedInFacebookX

Tóm tắt nhanh

  • Mục tiêu đầu tiên là giữ hoạt động kinh doanh chạy như thường, chưa phải cải thiện gì.
  • Đọc hệ thống thật trước tài liệu: khi hai bên vênh nhau, database đúng.
  • Viết lại toàn bộ là kết luận rút ra từ bằng chứng; phần lớn code thừa hưởng chỉ cần refactor.
Cây quyết định một tầng: câu hỏi "Kiến trúc có vững không?". Nhánh "Vững" được tô cam dẫn tới ô Refactor, nơi phần lớn quyết định kết thúc. Nhánh "Không" màu xám dẫn tới ô "Làm lại phần đó", ví dụ thành phần ghi thẳng vào database mà không có hàng đợi.
Trong tuần đầu tiếp quản, xét từng thành phần một: kiến trúc vững thì refactor, kiến trúc sai mới làm lại phần đó. Nguồn: Redwerk, Wavect, theo bài viết.

Thứ Hai, bạn đến văn phòng khách hàng. Nhà thầu cũ đã rời đi, để lại một repo, vài tài khoản cloud không rõ ai giữ mật khẩu, một pipeline nửa chạy nửa không, và một ban giám đốc đang hỏi “bao giờ xong”. Câu hỏi đầu tiên ai cũng muốn trả lời là: có nên đập đi làm lại không?

Đó là câu hỏi sai để bắt đầu. Bài viết về scoping trên AI Codex nhận xét rằng phần lớn engagement forward-deployed đi chệch hướng thì đã chệch ngay khi kết thúc tuần đầu tiên. Với một dự án tiếp quản, tuần đầu càng nặng ký: bạn nhận lại không chỉ hệ thống mà cả sự nghi ngại khách hàng còn mang sau một lần hợp tác dang dở.

Phần dưới đây đi qua năm ngày đầu: kiểm kê hiện trạng, rồi chốt danh sách việc phải làm lại theo cách bạn bảo vệ được trước khách hàng bằng số liệu.

Việc đầu tiên không phải là sửa

Thoughtworks, khi kể về một lần tiếp quản hệ thống legacy quy mô lớn, đặt mục tiêu trước mắt rất khiêm tốn: ít nhất phải giữ cho hoạt động kinh doanh chạy như thường (business as usual). Chưa cải thiện, chưa tối ưu. Chỉ là không làm sập thứ đang chạy.

Nghe hiển nhiên, nhưng áp lực tại chỗ khách hàng kéo bạn theo hướng ngược lại. Khách muốn thấy tiến độ, và cách nhanh nhất để “thấy tiến độ” là commit. Vấn đề là mỗi thay đổi trước khi bạn hiểu hệ thống đều là một canh bạc, và nếu thua, lỗi sẽ được ghi vào tên bạn chứ không phải nhà thầu cũ.

Vì thế tuần đầu có ba sản phẩm: một bảng kiểm kê quyền sở hữu, một baseline production, và một bản đánh giá bằng văn bản. Danh sách việc làm lại rút ra từ ba thứ đó.

Ai thực sự giữ chìa khóa?

Kế hoạch tiếp quản 30 ngày của Wavect yêu cầu, trong ngày 1 đến 5, ghi lại cho từng tài sản: chủ sở hữu pháp lý của tài khoản, người trả tiền, các admin, liên hệ khôi phục và con đường chuyển giao.

Tài sản ở đây là mọi thứ: domain, tài khoản cloud, repo, API key của bên thứ ba, tài khoản gửi email, cả workspace của công cụ quản lý công việc.

Thử hình dung một khách hàng logistics có một hệ thống phân loại đơn hàng do nhà thầu cũ dựng dở. Bảng kiểm kê sau ngày thứ hai có thể trông như sau:

Tài sản Chủ pháp lý Người trả tiền Admin Khôi phục Chuyển giao
Domain chính Khách hàng Khách hàng Nhà thầu cũ Email nhà thầu Đổi admin qua registrar
Tài khoản cloud Nhà thầu cũ Nhà thầu cũ, tính lại phí Nhà thầu cũ Chưa rõ Chuyển tài khoản hoặc dựng lại
Repo Tổ chức của khách Khách hàng Hai dev nhà thầu Khách hàng Gỡ quyền, thêm đội mới
API key dịch vụ LLM Chưa rõ Thẻ của nhà thầu Chưa rõ Chưa rõ Cần xác minh

Mỗi ô “chưa rõ” là một rủi ro cụ thể mà giờ bạn đã gọi được tên. Hai dòng giữa của ví dụ này nguy hiểm hơn mọi dòng code xấu: nếu nhà thầu ngừng trả tiền tài khoản cloud, hệ thống tắt mà không ai trong công ty khách có quyền bật lại.

Khi bắt đầu xoay vòng mật khẩu và khóa truy cập, Wavect lưu ý một điểm dễ bỏ qua: quyền rollback phải nằm trong tay khách hàng. Đừng để chính bạn trở thành nhà thầu cũ tiếp theo, người duy nhất giữ chìa khóa.

Đo trước, rồi mới được đổi

Sản phẩm thứ hai là baseline. Wavect liệt kê những gì cần ghi lại trước bất kỳ thay đổi nào: lưu lượng, tỉ lệ lỗi, độ trễ, độ sâu hàng đợi, trạng thái backup, sự cố đang mở, khối lượng ticket hỗ trợ và trạng thái bản phát hành đã biết.

Lý do là để về sau phân biệt được lỗi do bạn gây ra với lỗi thừa hưởng. Thử hình dung: hệ thống phân loại đơn đang lỗi 4% request.

Không đo, bạn deploy bản vá đầu tiên vào thứ Năm, tuần sau khách thấy 4% lỗi và hỏi vì sao bạn làm hỏng. Có baseline ghi ngày giờ, bạn chỉ vào con số và nói: hệ thống đã ở mức này từ trước, và đây là kế hoạch kéo nó xuống.

Baseline còn là nền cho mọi cuộc nói chuyện về giá trị sau này. Không có điểm xuất phát thì không ai chứng minh được mình đã cải thiện bao nhiêu.

Tin database, đừng tin tài liệu

Nhà thầu cũ thường để lại tài liệu, và tài liệu thường đẹp hơn thực tế. AI Codex khuyên xin quyền đọc vào hệ thống thật trước khi xin tài liệu, vì tài liệu mô tả ý định còn database mô tả thực tế, và khi hai bên vênh nhau thì database đúng.

Trong ví dụ logistics, tài liệu có thể nói mọi đơn hàng được phân loại tự động. Một câu query đếm đơn theo trạng thái có thể cho thấy một phần lớn đơn đang nằm ở trạng thái chờ người duyệt tay. Chênh lệch đó chính là thứ khách hàng đang trả tiền để sửa, và nó không xuất hiện ở trang nào của tài liệu.

Một hướng dẫn tiếp quản codebase từ agency trên dev.to đề xuất dành 48 giờ đầu chỉ để đọc. Trong khoảng thời gian ấy, bạn nên đọc code, log, lịch sử commit và schema trước khi chạm vào bất cứ thứ gì.

Để giữ được bức tranh tổng thể, Thoughtworks vẽ kiến trúc thừa hưởng bằng sơ đồ C1/C2 và theo dõi tiến độ tiếp quản trên một bản đồ, với marker xanh cho dịch vụ đã xong và xám cho dịch vụ còn chờ.

Một bản đồ như vậy cũng là công cụ báo cáo tốt nhất bạn có thể đưa cho khách mỗi chiều thứ Sáu.

Chốt việc làm lại bằng một tiêu chí, không bằng cảm giác

Đến ngày thứ tư, bạn có đủ dữ liệu để phân loại từng thành phần. Wavect viết rằng “viết lại toàn bộ” là một kết luận, không phải phương pháp khởi đầu.

Redwerk đưa ra quy tắc gọn hơn: refactor khi kiến trúc vững và mớ hỗn độn nằm ở chi tiết, và phần lớn quyết định về code thừa hưởng kết thúc bằng refactor vì code bừa bộn phổ biến hơn nhiều so với code hỏng thật sự.

Áp vào ví dụ: nếu luồng dữ liệu từ hệ thống đơn hàng sang bộ phân loại đúng hướng nhưng code lặp và thiếu test, đó là refactor.

Nếu bộ phân loại ghi thẳng vào database production mà không có hàng đợi, khiến mỗi lần nó lỗi là mất đơn, đó là vấn đề kiến trúc và có lý do để làm lại phần đó.

Hai kết luận khác nhau cho hai thành phần, không phải một câu “đập đi” cho cả hệ thống.

Thoughtworks dùng một template chuẩn làm tiêu chí nghiệm thu cho việc tiếp quản từng dịch vụ. Bạn có thể làm tương tự: một dịch vụ chỉ chuyển sang “xanh” khi đã rõ chủ sở hữu mọi tài sản, có baseline, có người trong đội mới deploy và rollback được, và đã được xếp vào một trong ba nhóm giữ nguyên, refactor hoặc làm lại.

Bản đánh giá bằng văn bản và người ký

Hướng dẫn trên dev.to nhấn mạnh: trước khi đổi bất cứ thứ gì, hãy viết ra một tài liệu. Bản đánh giá ngày thứ năm gồm bảng kiểm kê, baseline, bản đồ dịch vụ và danh sách phân loại kèm lý do cho từng mục.

Nhưng tài liệu chưa đủ nếu sai người đọc. AI Codex khuyên đẩy đến khi có một định nghĩa thành công đo được, được chính người kiểm soát ngân sách đồng ý.

Trong ví dụ logistics, đó có thể là “tỉ lệ đơn phải duyệt tay giảm xuống mức X trong Y tuần”, với X và Y do khách chốt dựa trên baseline bạn vừa đo.

Khi người ký ngân sách gật đầu, danh sách làm lại không còn là ý kiến riêng của bạn mà trở thành cam kết chung.

Những lỗi hay gặp

Lỗi phổ biến nhất là sửa ngay ngày đầu để “lấy điểm”, rồi không chứng minh được hệ thống trước đó đã tệ thế nào. Kế đến là tin tài liệu bàn giao mà không mở database.

Cũng hay gặp chuyện xoay vòng toàn bộ credential nhưng giữ quyền admin cho riêng mình, lặp lại đúng vấn đề bạn được thuê để giải quyết. Và cuối cùng là chốt phạm vi với người dùng thân thiện nhất thay vì người cầm ngân sách.

Kỹ năng tiếp quản nên nằm trong CV của bạn

Khi đọc tin tuyển dụng FDE, bạn nên để ý những dòng nhắc đến việc làm trên hệ thống sẵn có của khách: đó là chỗ kỹ năng tiếp quản sẽ được dùng đến, và là chỗ đáng đưa một ví dụ cụ thể vào CV.

Bài tập tuần này: chọn một hệ thống bạn đang giữ nhưng không tự xây, giả định nhà thầu của nó biến mất sáng mai, và viết bản đánh giá một trang trong một buổi chiều. Số ô “chưa rõ” bạn đếm được chính là độ rủi ro mà khách hàng đang mang mà không biết.

Bài này có hữu ích không?

Dùng cùng trợ lý AIHỏi Claude ↗Hỏi ChatGPT ↗
6 nguồn
Đọc tiếp trên lộ trình · Chặng 4: Khách hàng45 phút lập RACI và bản đồ stakeholder trước dòng code đầu tiênHai tờ giấy chỉ ra người duyệt việc, người dùng sản phẩm và người có thể lặng lẽ chặn dự án.