---
url: https://docs.nemo12.com/engineering/incident-log.md
description: >-
  Sổ sự cố vận hành: mỗi lỗi đã xảy ra thật và cổng hoặc luật sinh ra sau đó để
  nó không tái diễn.
---

# Sổ sự cố vận hành

Đây **không phải nhật ký**. Mỗi mục dưới đây là một lỗi đã xảy ra thật, và điều đáng đọc nhất
không phải "chuyện gì hỏng" mà là **cổng hoặc luật nào ra đời để nó không tái diễn**. Phiên sau
đọc file này để khỏi trả lại cùng một cái giá.

Mỗi mục theo bốn ô: **Triệu chứng** (thứ quan sát được) → **Nguyên nhân gốc** → **Cách sửa** →
**Cổng/luật**.

Có một họ lỗi lặp lại nhiều lần đến mức đáng gọi tên trước: **máy local nói dối theo hướng dễ dãi**.
Cây làm việc của một phiên luôn có nhiều thứ hơn kho sạch của CI — file chưa commit, thư mục rơi
rớt, `node_modules` đã cài. Nên "xanh trên máy tôi" chưa bao giờ là bằng chứng. SRC-431 là ca kinh
điển; xem thêm mục cùng họ trong [dependency-hygiene](../dependency-hygiene.md) §1.

## Các trang con

| Trang | Nội dung |
| --- | --- |
| [Sổ sự cố vận hành · Mục 1 đến 8 (21.08 đến 25.08.2026)](incidents-01-08.md) | Mục 1 đến 8: SRC-431, SRC-457, SRC-464, SRC-490/491, SRC-500, SRC-504, SRC-546, SRC-583. |
| [Sổ sự cố vận hành · Mục 9 trở đi (26.08.2026 trở đi)](incidents-09-plus.md) | Mục 9 trở đi: SRC-603, `git add -A`, file dở lên main, cron chung nhịp, fixture e2e, test ăn đĩa, nhánh treo SRC-949. Mục mới thêm vào cuối trang này. |