         DEVELOPER DOCUMENTATION • API & SYSTEM ARCHITECTURE
    

Creative Vietnam Developer Documentation & System Architecture

Chào mừng các kỹ sư phần mềm, nhà tích hợp hệ thống và các tác nhân AI Agent đến với cổng tài liệu kỹ thuật chính thức của Creative Vietnam. Tài liệu này cung cấp chi tiết về kiến trúc hạ tầng, chuẩn giao tiếp nội dung Markdown theo RFC 9110, đặc tả OpenAPI và các giao thức tích hợp trực tiếp.

1. Kiến Trúc Hạ Tầng Cốt Lõi (System Architecture)

Application Core: Nền tảng CMS tối ưu hóa cao chạy trên PHP 8.3 với OPcache và JIT compilation enabled.
Web Server Engine: OpenLiteSpeed (OLS) kết hợp module LSAPI cho hiệu năng xử lý I/O đồng thời vượt trội.
Giao thức Mạng: HTTP/3, QUIC, TLS 1.3 với độ trễ kết nối (RTT) tối thiểu dưới 35ms tại toàn bộ các node CDN nội địa.
Bộ đệm & Cache: Kiến trúc đệm đa tầng (Multi-tier Cache) với kiểm soát vô hiệu hóa tự động khi cập nhật dữ liệu.

2. Chuẩn Đàm Phán Nội Dung (RFC 9110 Markdown Content Negotiation)

Hệ thống Creative Vietnam hỗ trợ chuẩn đàm phán nội dung máy học (Agentic Content Negotiation). Khi client truyền tiêu đề Accept: text/markdown, máy chủ sẽ tự động phản hồi dữ liệu cấu trúc Markdown thuần, tối ưu hóa hơn 80% dung lượng token so với HTML thông thường:

# Ví dụ cURL truy vấn Trang chủ ở định dạng Markdown:
curl -sS -L -H "Accept: text/markdown" https://creativevietnam.vn/

# Ví dụ cURL truy vấn Tài liệu Kỹ thuật ở định dạng Markdown:
curl -sS -L -H "Accept: text/markdown" https://creativevietnam.vn/docs

Lưu ý: Mọi phản hồi đều chứa tiêu đề Vary: Accept để đảm bảo các bộ nhớ đệm biên (Edge Caches / CDNs) không gây xung đột giữa định dạng HTML và Markdown.

3. Chuẩn Chỉ Mục Hóa LLMs (/llms.txt & /llms-full.txt)

Tuân thủ hướng dẫn kỹ thuật toàn cầu dành cho AI Crawlers, website phân phối hai điểm cuối chuyên trách:

https://creativevietnam.vn/llms.txt: Bản tóm lược cấu trúc, định danh năng lực, hướng dẫn thời điểm nên/không nên sử dụng và liên kết đến các tài nguyên cốt lõi.
https://creativevietnam.vn/llms-full.txt: Văn bản toàn phần chứa toàn bộ nội dung bài viết chuyên sâu và trang dữ liệu tin cậy (Trust Anchors) phục vụ việc nhúng vector (RAG embedding).

4. Đặc Tả OpenAPI & Điểm Cuối Dịch Vụ (/openapi.json)

Hồ sơ đặc tả API chuẩn OpenAPI 3.1.0 được công bố tại: https://creativevietnam.vn/openapi.json.

GET /api/v1/health: Trả về trạng thái hoạt động của hệ thống, thời gian phản hồi máy chủ và phiên bản engine.
POST /api/v1/contact: Cổng nhận thông điệp tự động hóa (JSON payload) dành cho các Agent gửi yêu cầu hợp tác doanh nghiệp.