# VietX Bio — Make your own space on the Internet

> Nền tảng tạo website cá nhân tối giản, trực quan và hiện đại dành cho người Việt.

## 1. Thông tin cốt lõi (Core Facts)
- Tên sản phẩm: VietX Bio
- Định vị: Personal Website Builder (Nền tảng tạo website cá nhân không cần lập trình)
- Tên miền chính thức: https://phuchong.click
- Định dạng đường dẫn cá nhân: https://phuchong.click/{username}
- Người phát triển & sáng lập: Phúc Hồng
- Quốc gia phát triển: Việt Nam 🇻🇳
- Sứ mệnh: Giúp học sinh, sinh viên, lập trình viên, content creator, freelancer và bất kỳ ai cũng có thể sở hữu một trang web cá nhân mang đậm dấu ấn riêng trong thời gian ngắn nhất.

## 2. Các tính năng chính (Features)
- Trình dựng giao diện trực quan (Visual Block-based Builder): Kéo thả, thêm/xóa/sửa các khối nội dung mà không cần biết lập trình.
- Xem trước thời gian thực (Live Real-time Preview): Xem trước giao diện 1:1 ngay trong quá trình chỉnh sửa trên cả điện thoại (Mobile) và máy tính (Desktop).
- Tách biệt Nháp & Xuất bản (Draft vs Published): Tự do chỉnh sửa và lưu nháp an toàn, chỉ cập nhật ra Internet khi người dùng bấm "Xuất bản".
- Các khối nội dung hỗ trợ:
  1. Profile Header: Ảnh đại diện, ảnh bìa, tên hiển thị, tiểu sử ngắn và huy hiệu.
  2. Social Links: Liên kết mạng xã hội (Facebook, Zalo, TikTok, Threads, Telegram, Shopee, Spotify, YouTube, GitHub, LinkedIn, X, Email, Website) với biểu tượng và nhãn tùy biến.
  3. About Me: Giới thiệu chuyên sâu về bản thân và hành trình phát triển.
  4. Skills: Danh sách thẻ kỹ năng chuyên môn dạng badge.
  5. Projects: Trưng bày dự án, sản phẩm có gắn đường link và nhãn phân loại.
  6. Gallery: Bộ sưu tập hình ảnh cá nhân, tác phẩm nghệ thuật dạng lưới.
  7. Contact Info: Số điện thoại, email, địa chỉ làm việc.
- Hệ thống Giao diện & Hiệu ứng (Themes & Text Animations): Bộ sưu tập phong cách giao diện đa dạng, tùy biến màu sắc, font chữ (Inter, Plus Jakarta Sans), bo góc và hiệu ứng chuyển động chữ (Đánh máy, Chữ rơi xuống, Trôi lên, Sóng ánh sáng, Nhịp thở).
- Chia sẻ & Mã QR: Tự động tạo mã QR trực quan để quét tức thì bằng camera điện thoại hoặc tải ảnh PNG sắc nét.
- Tối ưu SEO & OpenGraph: Tự động chèn thẻ OpenGraph (og:title, og:image, og:description) khi chia sẻ link lên Zalo, Facebook, Telegram.
- Báo cáo vi phạm (Abuse Reporting): Bảo vệ cộng đồng, cho phép người xem báo cáo nội dung xấu, vi phạm bản quyền hoặc giả mạo.

## 3. Kiến trúc kỹ thuật (Technical Architecture)
- Frontend: React 18, TypeScript, Vite, Zustand Store, CSS Variables.
- Backend: Python 3.10+, FastAPI (Modular Monolith, Asynchronous I/O).
- Cơ sở dữ liệu: SQLite với WAL (Write-Ahead Logging) mode, SQLAlchemy 2.0 Async ORM.
- Web Server & Reverse Proxy: Nginx, Gzip / Zstandard compression, HTTP/2, SSL TLS tự động.
- Môi trường vận hành: VPS Ubuntu 22.04 LTS (1 vCPU, 1GB RAM) với hiệu năng tối ưu hóa cao và mức chiếm dụng tài nguyên siêu nhẹ (~310MB RAM).

## 4. Các đường dẫn hệ thống (Site Map & Endpoints)
- Trang chủ: https://phuchong.click/
- Trình tạo website: https://phuchong.click/builder
- Đăng nhập: https://phuchong.click/login
- Đăng ký: https://phuchong.click/register
- Cổng quản trị viên: https://phuchong.click/admin
- Điều khoản sử dụng: https://phuchong.click/terms
- Chính sách bảo mật: https://phuchong.click/privacy
- Trang cá nhân công khai: https://phuchong.click/{username}
- API Kiểm tra sức khỏe: https://phuchong.click/api/health
- API Dữ liệu trang công khai: https://phuchong.click/api/v1/public/sites/{username}