Yêu cầu Phi chức năng (Non-Functional Requirements - NFR)

Tài liệu này tổng hợp các yêu cầu phi chức năng cốt lõi cho toàn bộ hệ thống danghong.me, bao gồm Main Web, Docs Portal và API Worker.

1. Hiệu năng & Tốc độ (Performance)

Core Web Vitals:
- LCP (Largest Contentful Paint): < 1.2s.
- FID / INP (Interaction to Next Paint): < 50ms.
- CLS (Cumulative Layout Shift): 0 (không bị giật khung hình).
Lighthouse Score: Đạt >= 95 trên tất cả các tiêu chí (Performance, Accessibility, Best Practices, SEO).
API Latency: Thời gian phản hồi trung bình của api.danghong.me qua Cloudflare Workers < 20ms tại các nút Edge châu Á (Hà Nội, TP.HCM, Singapore).
Zero Runtime Overhead: Cả website chính và tài liệu docs đều sử dụng SSG (Static Site Generation), không yêu cầu xử lý phía server Node.js khi có lượt truy cập.

Uptime SLA: Đạt mức tối thiểu 99.9% thông qua hạ tầng phân tán toàn cầu của Cloudflare.
Failover & Caching: Cache HTML tại Cloudflare Edge; trường hợp source repo đang build lại hoặc gặp sự cố, Edge Caching vẫn phục vụ nội dung ổn định cho người dùng.
Disaster Recovery: Toàn bộ nội dung tài liệu, cấu hình hệ thống và mã nguồn được lưu trữ trực tiếp trên Git repo với lịch sử commit rõ ràng.

Kiến trúc Jamstack + Serverless Worker cho phép hệ thống chịu tải đột biến (Spike Traffic) từ hàng ngàn người truy cập đồng thời mà không bị nghẽn CPU/RAM và không phát sinh chi phí duy trì máy chủ đắt đỏ.

Zero Authentication Requirement: Người dùng không cần tạo tài khoản hay đăng nhập để xem nội dung (Trial-all Philosophy), hạn chế tối đa nguy cơ rò rỉ dữ liệu tài khoản (Credential Leakage).
HTTPS Everywhere: Tự động chuyển hướng HTTP sang HTTPS thông qua Cloudflare HSTS.
Content Security Policy (CSP) & Bảo vệ Headers: Cấu hình X-Frame-Options: DENY, X-Content-Type-Options: nosniff, Referrer-Policy: strict-origin-when-cross-origin.
Sanitization: Tất cả dữ liệu đầu vào gửi tới API Worker được kiểm tra và làm sạch bằng Zod/Schema validator trước khi xử lý.

WCAG 2.1 AA Compliance: Tỉ lệ tương phản màu sắc (Color Contrast Ratio) giữa nền và văn bản tối thiểu 4.5:1.
Keyboard Navigation: Hỗ trợ đầy đủ phím Tab, phím tắt tìm kiếm (Ctrl + K hoặc Cmd + K trên Docs).
Semantic HTML: Cấu trúc đầy đủ các thẻ semantic <header>, <main>, <nav>, <article>, <aside>, <footer>.
SEO Metadata: Khai báo đầy đủ thẻ Meta Open Graph (OG), Twitter Card, Canonical URL và Sitemap XML tự động.