Cụm bài Code review: 1. Mục tiêu, quy trình và cách viết comment · 2. Giải quyết bất đồng và review mẫu
Bài 1 nói về mục tiêu, checklist, quy trình và comment có nhãn (TODO chặn merge; NIT, OPTIONAL, FYI không chặn). Bài này trả lời hai câu khó hơn: làm gì khi reviewer và tác giả không đồng ý, và một buổi review thật trông ra sao. Hai review mẫu dùng code đi kèm khoá học (luồng đặt phòng homestay bằng Spring Boot 3, distributed lock bằng Redis); phần ghi lại quyết định xem thêm ADR và quality requirement.
Sơ đồ tóm tắt:
flowchart TD
A[Nghe và tóm lại] --> B[Viết ưu nhược]
B --> C[Xác lập bối cảnh]
C --> D["Đo / PoC"]
D --> E["Đưa ra nhóm, leo thang"]
E --> F["Disagree and commit + ADR"]
R["2 vòng comment cùng điểm"] -->|nói trực tiếp 15 phút| G[Ghi kết luận vào MR]
L["Little: thread = tốc độ × chờ"] --> TO["Timeout nghiệp vụ theo SLA"]
TO --> FO{"Fail-open hay fail-closed?"}
1. Giải quyết bất đồng
Ý chính: bất đồng là bình thường; cần một quy trình để đi từ ý kiến sang dữ kiện, rồi tới một quyết định cả nhóm làm theo. Các bước dưới đây là của khoá học, mình thêm cách làm cụ thể.
- Nghe cả hai phía. Mỗi bên tóm tắt lập luận của bên kia cho đến khi bên kia đồng ý “đúng, đó là ý mình”.
- Phân tích ưu nhược của từng phương án, viết ra, không chỉ nói.
- Xác lập bối cảnh: team đang ưu tiên thuộc tính nào (đúng hạn, độ tin cậy, chi phí, dễ bảo trì)? Cùng một lựa chọn có thể đúng ở dự án này, sai ở dự án khác.
- Chọn phương án hợp bối cảnh, không phải phương án “đẹp nhất”.
- Làm PoC hoặc đo khi tranh luận xoay quanh một giả định kiểm chứng được (hiệu năng, độ phức tạp). PoC (proof of concept) là bản thử nhỏ để kiểm chứng giả định.
- Đưa ra cả nhóm, rồi leo thang nếu cần: tech lead hoặc solution architect, sau đó head of engineering.
- Disagree and commit: khi đã quyết, người không đồng ý vẫn làm theo hết sức. Quyết định được ghi thành ADR (Architecture Decision Record, văn bản ngắn ghi quyết định và lý do) cùng điều kiện để xem lại.
Quy tắc thực dụng: sau hai vòng comment qua lại cùng một điểm, chuyển sang nói chuyện trực tiếp 15 phút, rồi ghi kết luận vào MR cho người đọc sau.
Case study: chờ kết quả kiểm tra gian lận đến 5 phút
Ý chính: một endpoint đồng bộ chờ tới 5 phút làm cạn thread của cả service chỉ với dưới một request mỗi giây. Đo bằng định luật Little thay vì cãi, rồi tách một timeout nghiệp vụ 2–3 giây, hết giờ thì fail-closed.
Một PR trong dịch vụ ví điện tử thêm endpoint thanh toán đồng bộ. Service gửi command lên Kafka cho dịch vụ chống gian lận, rồi hỏi Redis lặp lại (ngủ giữa các lần, thời gian chờ tăng dần) cho tới khi có kết quả hoặc hết giờ. Thời gian chờ tối đa lấy từ timeout của Redis, đang đặt 300.000 ms.
- Reviewer (TODO): một request có thể giữ thread của Tomcat tới 5 phút.
- Tác giả: dịch vụ chống gian lận đôi khi chậm, và nghiệp vụ cần câu trả lời trước khi trả kết quả cho khách.
Đi theo các bước:
- Bối cảnh: endpoint nằm trên luồng thanh toán, mục tiêu p99 dưới 2 giây. Ưu tiên hiện tại là “không bao giờ duyệt giao dịch gian lận” hơn “luôn trả lời nhanh”.
- Đo thay vì tranh luận: định luật Little nói số việc đang xử lý = tốc độ đến × thời gian xử lý. Tomcat mặc định có 200 worker thread; mỗi request chờ 5 giây thì 40 request/giây là dùng hết, và mọi endpoint khác (kể cả health check) bắt đầu timeout. Chờ 5 phút thì chưa tới một request/giây đã đủ. Load test ngắn trên staging cho thấy đúng hiện tượng này.
- Phương án: (a) timeout nghiệp vụ riêng 2–3 giây, hết giờ trả
PENDING_REVIEW(fail-closed: chưa chắc thì không duyệt); (b) API bất đồng bộ: trả202 Acceptedkèm id, client hỏi trạng thái hoặc nhận webhook; (c) dùngReplyingKafkaTemplatecủa Spring thay vì tự hỏi Redis; (d) gọi thẳng HTTP sang dịch vụ chống gian lận nếu thật sự cần đồng bộ. - Quyết định: (a) ngay trong PR này, (b) là việc tiếp theo. Ghi ADR “Timeout của kiểm tra gian lận và hành vi khi hết giờ”: con số, lý do fail-closed, điều kiện xem lại (ví dụ p99 dịch vụ chống gian lận dưới 300 ms). Bản ADR đầy đủ ở Bài tập 2.
2. Review mẫu 1: luồng đặt phòng v2
Ý chính: sáu lỗi chặn merge (TODO) nằm ở những chỗ code chạy “có vẻ đúng”: dependency không được inject, retry tạo booking trùng, side effect trước commit, checked exception làm transaction vẫn commit, khoá dòng không thứ tự, và “hôm nay” theo múi giờ JVM.
Code của dự án đặt homestay mẫu (Spring Boot 3, PostgreSQL), bản dùng Template Method (phân tích pattern ở bài Template Method và composition). Chỉ trích những dòng cần cho comment.
// BookingV2Controller
@RestController
@RequiredArgsConstructor
public class BookingV2Controller {
private BookingFactory bookingFactory;
// BookingFactory
@Service
@RequiredArgsConstructor
public class BookingFactory { // Abstract Factory
private final VillaBookingService villaBookingService;
private HomestayService homestayService;
private BaseBookingService baseBookingService;
private ApartmentBookingService apartmentBookingService;
// BaseBookingService
private BookingRepository bookingRepository;
private HomestayAvailabilityRepository availabilityRepository;
// ...
@SneakyThrows
@Transactional // jakarta.transaction.Transactional
public BookingResponse execute(BookingRequest request) {
// validate, lock nights, price, save
sendNotifications(booking);
postProcess(booking); // ApartmentBookingService: produce event to Kafka
// validateRequest
final var currentDate = LocalDate.now();
if (checkinDate.isBefore(currentDate) || checkinDate.isAfter(checkoutDate)) { ... }
// HomestayAvailabilityRepository
@Query("""
SELECT new HomestayAvailability(ha.homestayId, ha.date, ha.price, ha.status)
FROM HomestayAvailability ha
WHERE ha.homestayId = :homestayId AND ha.status = :status
AND ha.date BETWEEN :checkinDate AND :checkoutDate
""")
@Lock(LockModeType.PESSIMISTIC_WRITE)
List<HomestayAvailability> findAndLockHomestayAvailability(...);
Cộng thêm: bảng booking có cột request_id text not null nhưng không có ràng buộc UNIQUE; DiscountService trả tiền giảm âm (subtotal × -0.05); PricingService có hai overload calculate giống hệt nhau, một bản nhận homestay nhưng không dùng.
Các comment chặn merge, theo mức độ:
- TODO (
BookingV2Controller,BookingFactory,BaseBookingService): field dependency khôngfinal, nên@RequiredArgsConstructorkhông đưa chúng vào constructor (kiểm tra với Lombok 1.18.42: class không có fieldfinalnào nhận constructor rỗng). Spring không inject, app vẫn khởi động, request đầu tiên vào/api/v2/bookingsgặp NPE (NullPointerException) ởbookingFactory.build. Đề nghịprivate finalcho mọi dependency, một test@SpringBootTestgọi endpoint này, và luật ArchUnit ở bài 1, mục 6. - TODO (schema
booking.request_id): không có UNIQUE nên client retry (mạng chập, bấm hai lần) tạo hai booking. Đề nghịUNIQUE (request_id)(tạo indexCONCURRENTLYtrên bảng đang chạy), gặp trùng thì trả booking đã có. Chi tiết ở Idempotency trong hệ thống phân tán. - TODO (
execute,postProcess): gửi email và phát event Kafka bên trong transaction. Commit thất bại thì khách đã nhận email cho booking không tồn tại; chuyển sang gửi sau commit thì crash giữa chừng làm mất event. Đề nghị outbox cho Kafka,@TransactionalEventListener(AFTER_COMMIT)cho email (xem Observer và Spring event). - TODO (
@SneakyThrows+jakarta.transaction.Transactional): mặc định chỉ rollback với unchecked exception. Checked exception ném lén qua@SneakyThrowslàm transaction commit dù method thất bại. Đề nghị bỏ@SneakyThrows, hoặcrollbackOn = Exception.class. - TODO (query khoá đêm): thiếu
ORDER BY ha.date. Hai booking chồng một phần khoảng ngày có thể khoá dòng theo thứ tự khác nhau và deadlock; Postgres huỷ một bên vớideadlock detected, người dùng thấy 500. ThêmORDER BYđể mọi transaction khoá cùng thứ tự (xem Transaction, isolation level và locking). - TODO (
validateRequest):LocalDate.now()dùng múi giờ mặc định của JVM. Server chạy UTC thì từ 0h đến 7h sáng giờ Việt Nam, “hôm nay” của server vẫn là hôm qua, và hệ thống nhận check-in ngày đã qua. Đề nghị injectClockvà tính hôm nay theo múi giờ của homestay.
Các comment không chặn merge: QUESTION, OPTIONAL, NIT, FYI, PRAISE
- QUESTION (query khoá đêm):
SELECT new HomestayAvailability(...)là constructor expression (JPQL tạo object mới từ các cột), nên kết quả không phải entity được persistence context quản lý. VậysaveAll(aDays)sẽmergetừng dòng (thêm một SELECT mỗi đêm), và mình chưa chắc Hibernate có gắnFOR UPDATEcho dạng query này không. Bạn đã xem SQL log chưa? Nếu không cần constructor expression,SELECT ha FROM HomestayAvailability ha ... ORDER BY ha.datevừa được khoá vừa được dirty checking (Hibernate tự phát hiện field đổi và ghi lại). - OPTIONAL (
BookingFactory.buildvàvalidateHomestay): homestay được đọc hai lần mỗi request. Có thể truyền homestay đã đọc vào service. - NIT (
PricingService): hai overloadcalculategiống hệt nhau, bản nhậnhomestaykhông dùng tham số. Xoá một bản. - NIT (
DiscountService): quy ước tiền giảm là số âm rồi cộng vào subtotal dễ bị người sau đảo dấu; kết quả cũng không làm tròn (100.00 × -0.05 = -5.0000). Đề nghị tiền giảm không âm vàsetScaletheo tiền tệ. - FYI (
BookingFactory): comment ghi “Abstract Factory” nhưng class chỉ chọn một bean theo loại, tức simple factory. TênBookingServiceSelectorđỡ gây hiểu nhầm; nhánhdefaultcũng làm loại chỗ ở mới lặng lẽ đi theo luồng mặc định. - PRAISE: bảng availability một dòng mỗi đêm cộng khoá dòng là thiết kế đúng cho bài toán (kiểm tra chồng ngày thành đếm dòng, giá theo từng đêm), và log có
request_idở mọi bước rất dễ truy vết.
Vì sao side effect phải ra khỏi transaction
Bản sau review: code Java chạy được và kết quả kiểm tra
Sau khi áp các comment, phần cốt lõi trông như sau (Java thuần, database giả lập bằng map để chạy được bằng java ReviewedBooking.java):
static final class BookingService {
private static final int MAX_NIGHTS = 365;
private static final BigDecimal LONG_STAY_RATE = new BigDecimal("0.05");
private final FakeDb db; // final: constructor injection, Lombok sẽ đưa vào constructor
private final Clock clock; // inject để test điều khiển được "hôm nay"
BookingService(FakeDb db, Clock clock) { this.db = db; this.clock = clock; }
/** Trong Spring: @Transactional(rollbackFor = Exception.class) trên method public này. */
synchronized Booking book(BookingRequest r) {
Booking existing = db.bookingsByRequestId.get(r.requestId());
if (existing != null) return existing; // retry của cùng request
Homestay h = db.homestays.get(r.homestayId());
if (h == null) throw new BusinessException("HOMESTAY_NOT_FOUND");
LocalDate todayAtHomestay = LocalDate.now(clock.withZone(h.zone()));
if (r.checkin().isBefore(todayAtHomestay) || !r.checkin().isBefore(r.checkout()))
throw new BusinessException("DATES_INVALID");
if (r.guests() <= 0 || r.guests() > h.maxGuests()) throw new BusinessException("GUESTS_INVALID");
long nights = Duration.between(r.checkin().atStartOfDay(), r.checkout().atStartOfDay()).toDays();
if (nights > MAX_NIGHTS) throw new BusinessException("NIGHTS_INVALID");
// SELECT ... FOR UPDATE ... ORDER BY date: khoảng ngày đã sắp xếp, mọi booking khoá cùng thứ tự
SortedMap<LocalDate, BigDecimal> range = db.freeNights.subMap(r.checkin(), r.checkout());
if (range.size() < nights) throw new BusinessException("HOMESTAY_BUSY");
BigDecimal subtotal = range.values().stream().reduce(BigDecimal.ZERO, BigDecimal::add);
BigDecimal discount = nights >= 3
? subtotal.multiply(LONG_STAY_RATE).setScale(2, RoundingMode.HALF_EVEN)
: BigDecimal.ZERO.setScale(2);
var booking = new Booking(db.nextId++, r.requestId(), h.id(), r.checkin(), r.checkout(),
subtotal, discount, subtotal.subtract(discount));
new ArrayList<>(range.keySet()).forEach(db.freeNights::remove); // đánh dấu các đêm BOOKED
if (db.bookingsByRequestId.putIfAbsent(r.requestId(), booking) != null) // UNIQUE(request_id)
throw new IllegalStateException("duplicate request_id");
db.outbox.add(new OutboxEvent("BookingCreated", booking.id())); // cùng transaction
return booking; // email/Kafka: relay đọc outbox
}
}
Các kiểm tra chạy kèm, với đồng hồ cố định ở 2026-11-30T18:00Z (đã là 1h sáng ngày 1/12 ở Việt Nam):
PASS subtotal of 3 nights = 99.99
PASS 5% long-stay discount rounded to cents = 5.00
PASS total = 94.99
PASS same request_id returns the first booking
PASS retry does not emit a second event
PASS overlapping booking rejected with HOMESTAY_BUSY
PASS check-in 2026-11-30 rejected: it is already Dec 1 in Vietnam
synchronized ở đây chỉ giả lập transaction trong demo một process. Trên hệ thống thật, tính đúng đến từ khoá dòng của database và ràng buộc UNIQUE, không phải lock trong JVM (nhiều instance chạy song song).
3. Review mẫu 2: distributed lock bằng Redis
Ý chính: mỗi comment TODO nêu hậu quả cụ thể (“khoá 30 giây thành 8 tiếng”) và cách sửa, để tác giả không phải đoán reviewer muốn gì.
Cùng codebase có một service khoá phân tán bằng Redis. Phân tích đầy đủ và bản viết lại ở bài Review code distributed lock bằng Redis; ở đây chỉ là cách viết comment:
| Nhãn | Comment |
|---|---|
| TODO | Giá trị khoá là hằng số 1 và unlock là DEL không điều kiện: client có khoá đã hết hạn có thể xoá khoá của client khác. Dùng token ngẫu nhiên cho mỗi lần lấy khoá và script Lua so token rồi mới xoá. |
| TODO | TTL bị nhân 1000 hai lần (lúc khởi tạo và trong lock), khoá 30 giây thành khoá 8 tiếng. Ghi đơn vị trong kiểu dữ liệu (Duration) thay vì nhân tay. |
| TODO | Tên property trong YAML và trong code không khớp, app không khởi động nếu thiếu property. Dùng @ConfigurationProperties có validate. |
| TODO | Lấy nhiều khoá song song không theo thứ tự: hai request có tập khoá giao nhau có thể mỗi bên giữ một phần rồi cùng retry mãi (livelock: hai bên vẫn chạy nhưng không ai tiến được). Sắp xếp key và lấy tuần tự. |
| QUESTION | unlock chạy bất đồng bộ trên một newCachedThreadPool không giới hạn: caller trả về trước khi khoá được nhả, có chủ ý không? |
| FYI | Khoá trên một Redis node không an toàn khi failover (replication bất đồng bộ). Nếu khoá bảo vệ tính đúng của dữ liệu, cần fencing token (số tăng dần mà storage dùng để từ chối người giữ khoá cũ) hoặc khoá của database. |
Bài tập
Bài 1: Review ba lời giải cho bài nhóm chuỗi đảo chữ
Đề (bài tập về nhà của buổi học, diễn đạt lại): cho mảng chuỗi chữ thường (tối đa 10^4 chuỗi, mỗi chuỗi tối đa 100 ký tự), gom các chuỗi là đảo chữ (anagram) của nhau thành nhóm, thứ tự tuỳ ý. Ví dụ ["eat","tea","tan","ate","nat","bat"] cho [eat, tea, ate], [tan, nat], [bat]; [""] cho [[""]]. Ba bạn nộp ba lời giải; hãy review.
// Lời giải A: so từng cặp
static List<List<String>> pairwise(String[] words) {
List<List<String>> groups = new ArrayList<>();
boolean[] used = new boolean[words.length];
for (int i = 0; i < words.length; i++) {
if (used[i]) continue;
List<String> g = new ArrayList<>(List.of(words[i]));
for (int j = i + 1; j < words.length; j++) {
if (!used[j] && isAnagram(words[i], words[j])) { g.add(words[j]); used[j] = true; }
}
groups.add(g);
}
return groups;
}
// Lời giải B: key là chuỗi đã sắp xếp
static List<List<String>> bySortedKey(String[] words) {
Map<String, List<String>> groups = new HashMap<>();
for (String w : words) {
char[] cs = w.toCharArray();
Arrays.sort(cs);
groups.computeIfAbsent(new String(cs), k -> new ArrayList<>()).add(w);
}
return new ArrayList<>(groups.values());
}
// Lời giải C: key là tổng mã ký tự
static List<List<String>> bySumKey(String[] words) {
Map<Integer, List<String>> groups = new HashMap<>();
for (String w : words) groups.computeIfAbsent(w.chars().sum(), k -> new ArrayList<>()).add(w);
return new ArrayList<>(groups.values());
}
Lời giải Bài 1: kết quả chạy và comment cho từng lời giải
Mình chạy cả ba (kèm bản thứ tư dùng key là mảng đếm 26 chữ cái) trên ví dụ và trên 10.000 chuỗi ngẫu nhiên dài 1–8 ký tự (7.630 nhóm):
[[eat, tea, ate], [bat], [tan, nat]]
[[]] [[a]]
sum-key bug on [ad, bc]: [[ad, bc]]
groups: 7630
count key agrees: true
pairwise agrees: true
round 2: pairwise 219 ms, sorted 1 ms, counts 1 ms
Comment:
- A — PRAISE đúng và dễ đọc,
isAnagramdùng mảng đếm là O(k). TODO độ phức tạp O(n²·k): với n = 10^4 là khoảng 5×10^7 lần so sánh. Đo được 219 ms với chuỗi ngắn, nhưng chuỗi 100 ký tự sẽ chậm hơn nhiều, và nó tăng theo bình phương khi input lớn lên. Đề nghị gom theo key bằngHashMapđể còn O(n·k log k) hoặc O(n·k). - B — PRAISE O(n·k log k), ngắn, đúng với mọi ký tự (không chỉ a–z). OPTIONAL với k nhỏ (≤ 100) đây đã là lời giải nên chọn; key đếm 26 chữ cái chỉ đáng khi k lớn.
- C — TODO sai: hai chuỗi khác chữ cái vẫn có thể cùng tổng (
"ad"và"bc"đều là 197), nên bị gom chung. Hàm băm (tổng) chỉ là điều kiện cần; key của map phải là dạng chuẩn (canonical form: một giá trị xác định duy nhất nhóm), như chuỗi đã sắp xếp hay mảng đếm. Thêm test với cặp["ad","bc"].
Bài 2: Ghi lại quyết định sau tranh luận
Đề: viết ADR ngắn cho case study ở mục 1.
Lời giải Bài 2: ADR-017
# ADR-017: Timeout của kiểm tra gian lận trên luồng thanh toán đồng bộ
Trạng thái: Đã chấp nhận (2026-11-18)
## Bối cảnh
POST /payments/sync chờ kết quả từ dịch vụ chống gian lận qua Kafka. Thời gian chờ đang lấy từ
spring.redis.timeout (300 s). Mục tiêu p99 của endpoint là 2 s; Tomcat có 200 worker thread.
## Quyết định
- Timeout nghiệp vụ riêng: payment.fraud-check.timeout = 2s.
- Hết giờ: trả trạng thái PENDING_REVIEW (fail-closed), không duyệt giao dịch.
- Kết quả đến muộn được xử lý bất đồng bộ và cập nhật giao dịch.
## Phương án đã cân nhắc
- Giữ chờ 300 s: hết thread ở khoảng 1 request/s khi dịch vụ chống gian lận chậm.
- Fail-open khi hết giờ: rủi ro duyệt giao dịch gian lận, không chấp nhận được.
- API bất đồng bộ (202 + webhook): đúng hướng, cần thay đổi phía client, làm ở quý sau.
## Hệ quả
- Một phần giao dịch chuyển sang PENDING_REVIEW khi dịch vụ chống gian lận chậm; cần dashboard theo dõi tỉ lệ.
- Xem lại khi p99 của dịch vụ chống gian lận dưới 300 ms hoặc khi API bất đồng bộ ra mắt.
Ghi nhớ
- Kể được các bước đi từ bất đồng đến quyết định, và khi nào chuyển từ comment sang nói chuyện trực tiếp.
- Dùng được định luật Little để tính một endpoint chờ lâu làm cạn thread pool ở bao nhiêu request/giây.
- Giải thích được vì sao timeout nghiệp vụ phải tách khỏi timeout hạ tầng, và chọn fail-open hay fail-closed thế nào.
- Nhận ra được các bẫy Spring trong review mẫu: field không
final,@SneakyThrowsvới@Transactional, side effect trước commit,LocalDate.now(). - Viết được một comment TODO có hậu quả cụ thể và cách sửa.
Câu hỏi phỏng vấn
Junior
Disagree and commit nghĩa là gì?
Khi quyết định đã được đưa ra đúng quy trình, người không đồng ý vẫn làm theo hết sức thay vì làm nửa vời hay cãi tiếp.
“Đúng quy trình” nghĩa là đã nghe các bên và đã cân nhắc phương án. Sự không đồng ý được ghi lại (thường trong ADR) kèm điều kiện xem lại, để nếu giả định sai thì có cơ sở mở lại quyết định.
Mid
Bạn tìm thấy một bug nghiêm trọng nằm ngoài phạm vi PR đang review. Làm gì?
Ghi FYI trên PR để tác giả biết, nhưng không bắt sửa trong PR đó (trừ khi PR làm bug tệ hơn).
Tạo issue riêng có mức ưu tiên, hoặc báo ngay nếu nó đang gây sự cố. Mở rộng phạm vi PR làm review khó hơn và trì hoãn thay đổi đang cần merge.
Bạn review code so ngày check-in với LocalDate.now(). Comment gì?
LocalDate.now() dùng múi giờ của JVM, nên đề nghị inject Clock và tính ngày theo múi giờ nơi diễn ra nghiệp vụ.
JVM thường chạy UTC trong container, nên từ 0h đến 7h sáng giờ Việt Nam “hôm nay” của server vẫn là hôm qua. Sửa bằng LocalDate.now(clock.withZone(zone)), kèm test với đồng hồ cố định quanh nửa đêm.
Một lời giải gom anagram dùng tổng mã ký tự làm key. Bạn review thế nào?
Sai: hai chuỗi khác chữ cái có thể cùng tổng ("ad" và "bc" đều là 197) nên bị gom chung.
Tổng chỉ là một hàm băm, điều kiện cần. Key của map phải là dạng chuẩn xác định duy nhất nhóm, như chuỗi đã sắp xếp (O(k log k)) hay mảng đếm 26 chữ cái (O(k)). Kèm một test với cặp đó để lỗi không quay lại.
Senior
Bạn và tác giả không đồng ý về một thiết kế trong PR. Bạn xử lý thế nào?
Hiểu đúng ý nhau trước, đưa tranh luận về bối cảnh và dữ kiện, rồi quyết, disagree and commit và ghi ADR.
- Tóm tắt lập luận của nhau cho đến khi hai bên đồng ý mình đã hiểu đúng; viết ưu nhược từng phương án.
- Xác định bối cảnh và thuộc tính đang được ưu tiên; giả định đo được thì làm PoC hoặc đo.
- Sau hai vòng comment thì nói chuyện trực tiếp. Vẫn không thống nhất thì đưa ra nhóm hoặc tech lead.
- Khi đã quyết: disagree and commit, ghi ADR với điều kiện xem lại.
Viết comment cho một lỗi nghiêm trọng của đồng nghiệp mới thế nào cho hiệu quả?
Gắn nhãn TODO, nói hậu quả cụ thể, nguyên nhân và cách sửa; viết về code chứ không về người.
Hậu quả cụ thể như “request đầu tiên sẽ NPE”, “khách bị trừ tiền hai lần”. Đưa cách sửa hoặc đoạn code gợi ý, kèm link tài liệu, và nhắc cả điểm tốt trong PR. Nếu nhiều lỗi cùng gốc (ví dụ hiểu sai @RequiredArgsConstructor), nói chuyện trực tiếp 10 phút hiệu quả hơn 10 comment.
Review phát hiện một endpoint đồng bộ chờ kết quả từ Kafka tới 5 phút. Bạn lập luận thế nào?
Dùng định luật Little: thread bận = tốc độ request × thời gian chờ, nên chờ 5 phút thì dưới một request/giây đã cạn thread.
200 worker thread của Tomcat với mỗi request chờ 5 giây chỉ chịu được 40 request/giây; chờ 5 phút thì cả service ngừng trả lời. Đề nghị timeout nghiệp vụ riêng theo SLA, hành vi khi hết giờ được quyết rõ (fail-closed với giao dịch tài chính), và về lâu dài là API bất đồng bộ.
Từ vựng tiếng Anh
| Term | Phát âm | Nghĩa | Ví dụ câu tiếng Anh dùng trong phỏng vấn |
|---|---|---|---|
| disagree and commit | /ˌdɪsəˈɡriː ənd kəˈmɪt/ | không đồng ý nhưng vẫn làm theo quyết định chung | “I argued for the async API, then disagreed and committed to the timeout fix.” |
| escalate | /ˈeskəleɪt/ | đưa lên cấp cao hơn để quyết | “After two rounds we escalated to the tech lead with both options written down.” |
| proof of concept | /pruːf əv ˈkɒnsept/ | bản thử để kiểm chứng giả định | “A small proof of concept settled the performance argument.” |
| Little’s law | /ˈlɪtlz lɔː/ | số việc đang xử lý = tốc độ đến × thời gian xử lý | “By Little’s law, 40 requests per second waiting 5 seconds each need 200 threads.” |
| fail-closed | /feɪl kləʊzd/ | khi lỗi thì chọn trạng thái an toàn (từ chối, chờ) | “For payments we fail closed when the fraud check times out.” |
| fail-open | /feɪl ˈəʊpən/ | khi lỗi thì cho qua | “Recommendations can fail open; payments can’t.” |
| side effect | /saɪd ɪˈfekt/ | tác động ra ngoài (email, event, gọi API) | “Side effects move after the commit or into the outbox.” |
| canonical form | /kəˈnɒnɪkl fɔːm/ | dạng chuẩn duy nhất đại diện cho một nhóm | “The map key must be a canonical form, not just a hash.” |
| time zone | /taɪm zəʊn/ | múi giờ | “Today has to be computed in the homestay’s time zone, not the server’s.” |
Ghi chép dựa trên khoá Advanced Backend (Ronin Engineer), viết lại theo cách hiểu của mình.