Tester Module — SSOT

v1.0 | Cập nhật: 2026-03-04 (S102 — Tầng 4 doc freshness check added, TD-066) MỌI AGENT đọc file này trước khi làm việc liên quan đến kiểm tra tự động. search_knowledge("tester module SSOT")

---

I. QUY TẮC VÀNG

Sau MỖI deploy = chạy auto test. Không ngoại lệ.

Quy trình 2 mũ mở rộng:

Mũ 1: Code → Push → CI GREEN
Mũ 2: Merge → Deploy VPS → AUTO TEST → Verify báo cáo → Fix nếu fail → BÁO CÁO

Vi phạm = deploy chưa hoàn thành:

• ❌ Deploy xong mà không chạy auto test
• ❌ Auto test fail mà không fix
• ❌ Kết quả test chỉ in terminal, không upload Agent Data

---

II. CÔNG CỤ HIỆN TẠI

Tầng 1 — Infrastructure Tests (✅ HOẠT ĐỘNG)

Tool	Vị trí	Chạy	Tần suất
test-mcp-connectivity.sh	/opt/incomex/scripts/	Cron	5 phút
test-all-connections.sh	/opt/incomex/scripts/	Manual + sau deploy	Mỗi deploy
test-agent-connections.sh	/opt/incomex/scripts/	Manual + sau deploy	Mỗi deploy
check-config-integrity.sh	/opt/incomex/scripts/	Manual	Sau sửa config

Tầng 2 — Web Tests (⚠️ CẦN KIỂM TRA / KHÔI PHỤC)

Tool	Vị trí	Mô tả	Trạng thái
dot-spider	dot/bin/dot-spider	Crawl tất cả trang, tìm 403/404/500	⚠️ Cũ (WEB-72)
dot-health-check	dot/bin/dot-health-check	Server alive check	⚠️ Cũ
dot-test-login	dot/bin/dot-test-login	Auth test	⚠️ Cũ

Tầng 3 — Interactive Tests (🔵 CHƯA CÓ — Phase 2)

Chưa có. Cần xây dựng: click buttons, submit forms, check dead ends.

Tầng 4 — Data Integrity Tests (🔵 CHƯA CÓ — Phase 3)

Chưa có. Cần xây dựng:

• Permissions check (AI Agent role có đủ quyền không?)
• Relations integrity (nested data không null/undefined)
• Search quality (vector search trả kết quả)
• Doc freshness (TD-066): Các SSOT core file có last-updated trong vòng 60 ngày không? Files quá hạn → WARN trong báo cáo
  • Files cần check: operating-rules.md, tech-debt.md, connection-dashboard.md, current-state/index.md, directus-schema.md
  • Logic: parse dòng Cập nhật: → so với ngày hiện tại → nếu > 60 ngày → FLAG

---

III. QUY TRÌNH CHẠY TEST

Sau mỗi deploy:

Bước 1: test-all-connections.sh → infrastructure OK?
Bước 2: dot-spider (nếu hoạt động) → tất cả routes 200?
Bước 3: Ghi kết quả → upload Agent Data
Bước 4: Nếu FAIL → fix → deploy lại → test lại

Sau mỗi mission hoàn thành:

Bước 1: Tất cả bước trên
Bước 2: + Kiểm tra routes mới liên quan đến mission
Bước 3: + Kiểm tra forms/buttons mới

---

IV. FORMAT BÁO CÁO

Upload vào: knowledge/current-state/reports/auto-test-[YYYY-MM-DD].md

# Auto Test Report — [DATE]
## Summary: 🟢 ALL PASS / 🔴 X FAILURES
## Tầng 1 — Infrastructure: X/X PASS
## Tầng 2 — Routes: X/X PASS
## Tầng 3 — Interactive: N/A (chưa có)
## Tầng 4 — Data: N/A (chưa có)
## Failures:
- [FAIL] URL → error code → root cause dự đoán

---

V. REGISTRY — Danh sách tests

Test	Tầng	Tần suất	Trạng thái
MCP connectivity	1	Cron 5min	✅ ACTIVE
All connections 20/20	1	Mỗi deploy	✅ ACTIVE
Agent connections	1	Mỗi deploy	✅ ACTIVE
Config integrity	1	Sau sửa config	✅ ACTIVE
dot-spider (crawl routes)	2	Mỗi deploy	⚠️ CẦN KIỂM TRA
dot-health-check	2	Mỗi deploy	⚠️ CẦN KIỂM TRA
dot-test-login	2	Mỗi deploy	⚠️ CẦN KIỂM TRA
TC-AUTO-POS: Auto-position bước đang làm	2	Mỗi deploy	✅ MANUAL (PR #436)
Interactive buttons test	3	—	🔵 CHƯA CÓ
Forms submit test	3	—	🔵 CHƯA CÓ
Dead ends check	3	—	🔵 CHƯA CÓ
Doc freshness check	4	Mỗi deploy	🔵 CHƯA CÓ (TD-066)
Permissions audit	4	—	🔵 CHƯA CÓ
Relations integrity	4	—	🔵 CHƯA CÓ

---

VI. NỢ KỸ THUẬT TESTER

ID	Mô tả	Trạng thái
TT-010	Khôi phục dot-spider cho hệ thống hiện tại	🔴 OPEN
TT-011	Tích hợp auto test vào CI pipeline	🔵 PLANNED (Phase 2)
TT-012	Interactive element testing (buttons, forms)	🔵 PLANNED (Phase 2)
TT-013	Data integrity testing (permissions, relations)	🔵 PLANNED (Phase 3)
TT-014	Snapshot regression testing	🔵 PLANNED (Phase 3)

---

Cập nhật: BẮT BUỘC mỗi khi thêm test mới hoặc thay đổi quy trình test.