⌨️ Thế Giới Keycap Docs Hub
📊 Dashboard Hub Kiến Trúc Registry Protocol Môi Trường Vận Hành Tích Hợp

Cổng Tra Cứu Kỹ Thuật Thế Giới Keycap

Tài liệu đặc tả kiến trúc, registry mã nguồn, sổ tay vận hành và quy chuẩn kỹ thuật cho hệ thống bán lẻ WooCommerce thuần thegioikeycap.vn.

🗺️ Architecture
Kiến Trúc & Bản Đồ Module Hệ Thống
Cấu trúc thư mục, luồng dữ liệu khách hàng, WooCommerce hooks và module map.
project-map.html Mở tài liệu →
🧩 Registry
Registry Hàm, Hook & Helper Tái Sử Dụng
Danh mục source-of-truth cho các hàm tgk_*, SVG icon, permalinks, và xác thực.
function-registry.html Mở tài liệu →
📋 Protocol
Quy Chuẩn Kỹ Thuật & Quy Trình An Toàn
Quy trình trước/trong/sau khi code, 6 bước test đơn hàng bắt buộc và các bẫy kỹ thuật.
task-protocol.html Mở tài liệu →
🔐 Configuration
Ma Trận Biến Môi Trường & Bảo Mật (.env)
Đặc tả các biến môi trường trong .env, hằng số wp-config.php và phân quyền truy cập.
environment-config.html Mở tài liệu →
⚡ Operations
Sổ Tay Vận Hành & Khắc Phục Sự Cố
Lệnh WP-CLI, cấu hình container Docker, log rotation, sao lưu hàng ngày và chẩn đoán lỗi.
operations.html Mở tài liệu →
🎨 Theme
Đặc Tả Theme WooCommerce Cổ Điển
Template hierarchy, WooCommerce override, cấu trúc main.css và tối ưu trải nghiệm Safari iOS.
wp-theme.html Mở tài liệu →
🔌 Integrations
Tích Hợp Dịch Vụ: Pancake, SPX & SePay
Cơ chế đồng bộ tồn kho Pancake POS, bảng cước SPX theo cân nặng, cổng VietQR SePay.
integrations.html Mở tài liệu →
🎯 Tracking
Đặc Tả Meta Pixel & Conversions API (CAPI)
Cơ chế Multi-touch Attribution qua LocalStorage, deduplication qua event_id tất định.
tracking.html Mở tài liệu →
📐 Design
Design Tokens & Hệ Thống CSS
Bảng màu coral, typography, spacing, thiết kế Shopee checkout và BEM class rules.
design.html Mở tài liệu →
✉️ Mail
Hạ Tầng Email Giao Dịch & Brevo
FluentSMTP tích hợp Brevo API v3, Cloudflare Email Routing và kiểm thử gửi mail.
mail.html Mở tài liệu →
🔍 SEO
Chiến Lược Nội Dung SEO & Schema
Mô tả danh mục SEO, Rank Math filter, Schema Organization & Product Brand.
seo-content.html Mở tài liệu →
📊 Intelligence
Tình Báo Nội Dung Đối Thủ & CSDL FTS5
Phân tích 5 đối thủ keycap, kho dữ liệu bài viết SQLite FTS5 và từ khóa tiềm năng.
competitor-research.html Mở tài liệu →

Quy tắc tra cứu dành cho AI Agent & Kỹ sư

  • Không duplicate logic: Tra cứu function-registry.html trước khi tạo hàm mới.
  • Pancake POS là nguồn sự thật: Giá và tồn kho do POS làm chủ, không sửa tay trong database WooCommerce.
  • Quy tắc test an toàn: Thực hiện đủ 6 bước tại task-protocol.html (tắt webhook send-app, gắn mã test event, hoàn kho khi hủy).
  • Chống iOS zoom: Mọi ô nhập form mobile bắt buộc giữ font-size: 16px theo chuẩn Apple HIG.