Incomex AI Portal
KB-68E6 rev 3

Tester Module — Kế hoạch Tổng thể

5 min read Revision 3
planningtester-moduleauto-testdot-spiderTD-065

Tester Module — Kế hoạch Tổng thể

v1.1 | 2026-03-04 (S102) | Cập nhật: 2026-03-04 TD-065 | Gốc: dot-spider + dot-health-check (WEB-72) Module kiểm tra tự động — không cần con người bấm từng nút. search_knowledge("tester module plan")

Tầm nhìn

Chạy 1 lệnh → hệ thống tự bấm mọi nút, mọi link, mọi form trên toàn bộ trang web → báo cáo: dead end, nút mồ côi, quy trình mồ côi, 403/404/500, form không submit được. Tin cậy, tự động, nhanh.

Tại sao cần: Hiện tại mỗi lần deploy, con người phải vào bấm thử từng trang, từng nút. Với hệ thống ngày càng lớn (50+ routes, hàng ngàn bảng, hàng trăm nút), cách này không scale và không tin cậy. Cần công cụ tự động thay thế.

Nguyên tắc

  1. Assembly First — kiểm tra dot-spider, dot-health-check, dot-test-login có sẵn TRƯỚC. Khôi phục trước, code mới sau.
  2. Báo cáo vào Agent Data — kết quả test PHẢI upload tự động vào reports/, không chỉ in ra terminal.
  3. Chạy sau MỖI deploy — tích hợp vào quy trình 2 mũ: Mũ 2 = deploy + verify (auto test) + báo cáo.
  4. Không cần con người — 100% tự động. Con người chỉ đọc báo cáo.
  5. Module độc lập — không phụ thuộc business logic cụ thể. Chỉ cần biết URL gốc + credentials.

Công cụ đã có (cần kiểm tra)

Tool File Mô tả Trạng thái
dot-spider dot/bin/dot-spider Crawler bò tất cả trang, tìm lỗi crash/403/404 ⚠️ Cũ (WEB-72, 2026-02-13), cần kiểm tra
dot-health-check dot/bin/dot-health-check Server alive check (Docker, services) ⚠️ Cũ, cần kiểm tra
dot-test-login dot/bin/dot-test-login Đăng nhập test ⚠️ Cũ, cần kiểm tra
test-mcp-connectivity.sh /opt/incomex/scripts/ MCP connectivity test 5 checks ✅ Đang dùng (cron 5 phút)
test-all-connections.sh /opt/incomex/scripts/ 20/20 connection tests ✅ Đang dùng
test-agent-connections.sh /opt/incomex/scripts/ Per-agent connection verify ✅ Đang dùng

Phạm vi kiểm tra

Tầng 1 — Infrastructure (đã có)

  • Server health (Docker containers, services alive)
  • MCP connectivity (Agent Data, Directus, OPS Proxy)
  • Agent connections (từng agent kết nối đúng phương pháp)

Tầng 2 — Routes & Pages (dot-spider nâng cấp)

  • Tất cả routes → 200 (không 403/404/500)
  • Ghost routes → phát hiện trang 404
  • Redirect chains → phát hiện vòng lặp
  • SSR rendering → HTML trả về có nội dung (không blank)

Tầng 3 — Interactive Elements (MỚI — Phase 2)

  • Tất cả buttons → click → verify response
  • Tất cả links → click → verify destination
  • Tất cả forms → submit với data mẫu → verify không crash
  • Dead ends → trang không có link thoát
  • Orphan buttons → nút click không làm gì
  • Orphan workflows → quy trình không ai gọi

Tầng 4 — Data Integrity (MỚI — Phase 3)

  • Directus collections → đọc được (permissions OK)
  • Deep relations → nested data trả về (không null/undefined)
  • Search → trả kết quả (không crash)
  • Pagination → trang 2+ hoạt động

Roadmap

Phase 1 — Khôi phục & Nâng cấp (S101-S102)

  • Kiểm tra dot-spider, dot-health-check, dot-test-login còn chạy không
  • Nâng cấp dot-spider: thêm tất cả routes mới (workflows, modules detail...)
  • Thêm SSR content check (HTML không blank)
  • Báo cáo tự động vào Agent Data (reports/auto-test-*.md)
  • Tích hợp vào deploy workflow: Mũ 2 bao gồm chạy auto test

Phase 2 — Interactive Testing

  • Click tất cả buttons → verify response
  • Submit tất cả forms → verify data
  • Navigate tất cả internal links → verify destination
  • Check dead ends, orphan buttons, orphan workflows
  • Tích hợp CI: chạy sau mỗi PR merge

Phase 3 — Regression & Data

  • Snapshot comparison (UI thay đổi → alert)
  • Data integrity checks (permissions, relations, search)
  • Performance baseline (response time)
  • Accessibility audit

Báo cáo Format

Mỗi lần chạy → upload 1 report:

# Auto Test Report — [DATE]

## Summary: 🟢 ALL PASS / 🔴 X FAILURES

## Infrastructure (Tầng 1): X/X PASS
## Routes (Tầng 2): X/X PASS  
## Interactive (Tầng 3): X/X PASS
## Data (Tầng 4): X/X PASS

## Failures Detail:
- [FAIL] /knowledge/workflows/undefined → 404
- [FAIL] Tab WCR → 403 Forbidden

Liên kết

  • SSOT: knowledge/dev/ssot/tester-module/index.md
  • Operating Rules §IV Quy trình 2 mũ — Mũ 2 bao gồm auto test
  • WEB-72 audit gốc: knowledge/other/sessions/web-72-full-system-audit.md
  • DOT tools: dot/bin/ trong repo codex-web
  • TD-065: Tester Module