Tu Tiên Không Docs

Quyển 1: Onboarding

Chương 11: Tổng Kết Quyển 1 - Onboarding

Đăng: 09/07/2026 19:36 1,471 từ 5 lượt đọc

Chào mấy bạn. Vừa thấy một bình luận khá hay: "Kiểm phẩm phải ghi chú bằng tiếng Anh à sốp? Nói chung truyện khá ổn, mô-tip lạ, trừ kiểu viết nửa Anh nửa Việt không quen lắm." Tui đọc, gật đầu. Cảm ơn đã khen mô-tip. Phần "không quen" - tui hiểu, và muốn nói một chút, nhân dịp khép lại quyển 1.


# Vì sao tiếng Anh lấp ló khắp truyện?


Không phải để cho sang. Vinh là backend developer ở Sài Gòn: tám tiếng một ngày (thực tế mười bốn) dán vào màn hình, Slack nổ tin, Jira chuyển board, code review, deploy, hotfix. Đó là ngôn ngữ anh thở. Thử vào bất kỳ group chat công ty tech nào ở Việt Nam - chục tin đầu tiên đã rải rải *deploy*, *ticket*, *review*, *deadline*. Không ai nói "triển khai lên môi trường sản xuất" hay "giao việc theo vé". Cố dịch ra tiếng Việt thuần nghe như phim thuyết minh: đúng nghĩa, sai nhịp.


Vinh nghĩ bằng tiếng Anh của nghề, nên khi anh ghi chép, suy nghĩ, tự mắng mình - anh viết đúng như não anh chạy. Mỗi dòng commit, mỗi note trong Moleskine là não dev tự động dịch thế giới ra thuật ngữ dev. Bắt anh nói thuần Việt là bắt anh đóng vai một người khác.


Còn một lớp nữa: tui đặt tên quyển bằng cách Vinh (cách tui) dịch cảnh giới tu tiên ra ngôn ngữ dev. **Onboarding = Luyện khí** - giai đoạn làm quen, cài đặt lần đầu, "chạy được" là may. Quyển sau, **Local Environment Setup = Trúc cơ** - chuyển từ máy thử sang môi trường thật.


Nói vậy rồi, cũng biết không phải ai cũng trong nghề với mình, nên tui tổng kết lại 10 chương theo các mốc tu luyện, và giải nghĩa mấy thuật ngữ dev lặp lại nhiều nhất - từng cái gắn đúng chỗ nó xuất hiện, để ai ngoài ngành cũng nắm được Vinh đang nghĩ gì.


---


## Mốc 1 — Cuốn sách ba chục càng (Chương 1)


Vinh mua một cuốn sách Hán Nôm cũ rích, rách, không tựa, không đọc được, ba mươi ngàn. Anh không vứt đi. Anh xử lý nó đúng như xử lý một project cũ rớt vào tay: mò, tra, ghi chép.


- **Bug**: lỗi trong phần mềm. Vinh gọi mọi trục trặc khi tu luyện - dịch sai chữ, tê chân, không thấy khí - là bug. Với anh, thứ gì bất ổn cũng là thứ cần sửa, bất kể nó là code hay hơi thở.

- **Repo / version control**: cách lưu lịch sử thay đổi của một project, để lúc nào cũng quay lại mốc cũ được. Cuốn sách Hán Nôm chính là một "repo" rách nát: nhiều thế hệ viết chú thích tay vào lề, mỗi người một mảnh, không có bản gốc - Vinh lật qua lật lại giữa các "phiên bản" như ai đó đọc nhật ký mà mất nửa commit.


## Mốc 2 - Bà cụ sửa config (Chương 2–3)


Vinh tự dịch sách bằng Google Translate, chép nhịp thở ra sổ, chạy thử. Năm phiên đầu toàn thất bại. Rồi một bà cụ bảy mươi ở công viên nhìn anh thở bốn phút, nói đúng hai chữ: "Sai rồi." Sửa một chi tiết nhỏ - thở bằng mũi chứ không phải miệng - mọi thứ thay đổi.


- **Config**: tập cấu hình, những tham số bảo app chạy thế nào. Vinh coi cuốn sách là một file config: ghi thông số (nhịp thở, tư thế, giờ giấc) mà không giải thích lý do, như đọc hướng dẫn không lời.

- **Commit**: lưu một mốc phiên bản kèm ghi chú. Mỗi phiên tu Vinh commit như ghi nhật ký - *"phiên 6, ấm năm giây"* - để sau này đối chiếu, tìm ra quy luật.

- **Bug report**: bản ghi lỗi kèm nguyên nhân và cách sửa. Cuốn Moleskine của Vinh, về bản chất, là một chuỗi bug report cho chính cơ thể anh.


## Mốc 3 - Gốc bàng di sản (Chương 5–7)


Vinh ngồi gốc phượng, gốc me, ghế đá trống, không chỗ nào cho kết quả thật. Phải tìm tới gốc bàng di sản trồng năm 1952 - bảy mươi hai tuổi - thì khí mới đặc, mới chạy được. Nhưng gốc bàng chỉ có một.


- **Protocol**: bộ quy trình chuẩn để kết quả lặp lại được. Vinh tự viết "protocol v1.0": năm điều kiện (không cafein, bụng rỗng, năm giờ sáng, tư thế đúng, nhịp thở). Đủ xanh (thoả điều kiện) thì chạy, một mục đỏ (không thoả mãn điều kiện) thì hủy.

- **Single point of failure (SPOF)**: điểm mà cả hệ thống phụ thuộc vào; mất nó thì sập hết. Gốc bàng bị thành phố rào lại cắt tỉa ba ngày - Vinh mất luôn khả năng tu luyện. Một cái cây, không có đồ dự phòng.


## Mốc 4 - Lần đầu chạy sạch (Chương 7)


Mười bảy phiên đầu, Vinh lúc nào cũng có một biến ngoài tầm kiểm soát: hôm nóng, hôm ồn, hôm đói. Phiên 18 là lần đầu anh chuẩn bị đủ kỹ để hệ thống chạy một mạch không lỗi: khí ấm kéo dài ba mươi giây liên tục.


- **Localhost**: môi trường chạy thử trên máy riêng, trước khi đưa ra ngoài. *"Localhost ổn"* - lần đầu toàn bộ hệ thống lên, chạy, không crash.

- **Production / staging**: production là môi trường thật phục vụ người dùng; staging là bản thử trước đó. Vinh nhận ra mười bảy phiên đầu anh tu trên "production" không kiểm soát, giờ mới có "staging" trong đầu.

- **Smoke test**: phép thử nhanh xem hệ thống có "bốc khói" không. Sau mỗi phiên Vinh tự smoke test: tay có đỏ không, lưng có đau không, mắt có sáng không.


## Mốc 5 - Ba ngày deadline đánh rơi hết (Chương 8)


Sprint cuối của dự án công ty, Vinh code mười bốn tiếng một ngày suốt ba ngày. Tu luyện đứt. Hệ quả: lưng đau quay lại, mắt tối lại, khí biến mất. Duy nhìn ra ngay, dù không biết gì về tu tiên.


- **Memory leak**: app chạy lâu, rác tích tụ, ngày càng nặng và chậm - khởi động lại thì sạch. Duy mô tả đúng tình trạng Vinh bằng đúng từ này: *"trước mày như memory leak, mấy tuần trước như khởi động lại server."*

- **Deploy**: đưa phiên bản mới lên môi trường thật, chính thức. Vinh "deploy" tu luyện vào đời sống - ba ngày nghỉ tu là rollback về trước cả khi bắt đầu.

- **Sprint / retrospective**: sprint là một đợt làm việc ngắn cố định; retrospective là buổi nhìn lại sau mỗi sprint. Chương 9 chính là retrospective của Vinh sau sáu tuần.


## Mốc 6 - Dẫn khí, lần đầu (Chương 9–10)


Sáu tuần chỉ "sinh khí" rồi để nó tụ rồi tan. Phát hiện chú thích viết tay ở lề trang 14: phải *dẫn* khí đi theo kinh mạch. Phiên 33, gốc bàng, năm giờ sáng - lần đầu Vinh dẫn thành công nửa giây, lòng bàn tay trái đỏ bừng.


- **Route / endpoint**: tuyến đường và điểm đến mà dữ liệu chạy tới. Dẫn khí là mở route cho khí tự chảy, không phải đẩy. Vinh học: "dẫn" khác "đẩy" như mở đường khác nhồi dữ liệu cứng vào.

- **Database / query**: nơi dữ liệu nằm; query là câu truy vấn gửi tới. Vinh ví: dẫn khí trong phòng trọ không có linh khí = chạy query trên database rỗng - kết quả zero nhưng máy vẫn phải tốn công.

- **Overflow vs flow**: overflow là tràn vì đầy quá (khí đầy tràn ra tay = rỉ); flow là chảy có chủ đích, có đường đi. Hai lần đỏ tay trước đó (phiên 17–18) chỉ là overflow, phiên 33 mới là flow thật.


Tất cả những gì trên Vinh ghi vào một repo GitHub private tên **project_x** — không collaborator, không ai review, tự commit tự push. Ba mươi hai phiên một mình. Anh là dev, nên anh log đời mình như log code.


---


## Giới thiệu sơ Quyển 2 - Local Environment Setup


Onboarding khép lại: localhost chạy được rồi, Vinh biết dẫn khí là gì. Nhưng chạy trên máy thử là một chuyện, chạy trên môi trường thật là chuyện khác.


Quyển 2 - *Local Environment Setup* (= Trúc cơ) - Vinh muốn tiến lên cảnh giới tiếp theo, nhưng phát hiện Sài Gòn khó đủ "linh khí" để anh tu Trúc cơ. Phải đi tìm những "ốc đảo" linh khí bất ngờ, gặp người và nơi chốn lạ. Tu luyện bắt đầu có tác dụng phụ đời thật khó giải thích. Duy - thằng bạn frontend tinh ý - ngày càng nghi ngờ nghiêm trọng hơn. Và ông già tiệm sách Tư Hùng bắt đầu lộ mấy chi tiết bí ẩn.


Mốt kể tiếp. Cảm ơn mấy bạn đọc đến đây - cả bạn đã để lại bình luận kia. Chính comment đó giúp tui có động lực viết thêm phần này :D



0