Upload README.md with huggingface_hub

README.md

@@ -37,3 +37,106 @@ ADMIN_USERNAME=admin
 ADMIN_PASSWORD=...
 NODE_ENV=production
 ```
+
+---
+
+# 🌐 Lyvuha.com — Hệ Thống Portfolio & Giới Thiệu Sản Phẩm
+
+Trang giới thiệu sản phẩm và portfolio công nghệ của **Lý Vũ Hà** (lyvuha.com), xây dựng trên kiến trúc Full-stack hiện đại, bảo mật và hiệu năng cao.
+
+## 🚀 Kiến Trúc Hệ Thống (Architecture)
+
+Hệ thống được thiết kế chạy 100% online trên các hạ tầng đám mây tối ưu chi phí và mở rộng tốt:
+
+```mermaid
+graph TD
+    User([Người dùng]) -->|Truy cập HTTPS| Frontend[Vercel Frontend - React + Vite]
+    Frontend -->|Gọi API| Backend[Hugging Face Space - Node.js + Express + Docker]
+    Backend -->|Truy vấn dữ liệu| DB[Supabase - Managed PostgreSQL Database]
+    Backend -->|Fallback khi Dev local| SQLite[Local SQLite database.sqlite]
+```
+
+- **Frontend**: Single Page Application (SPA) viết bằng **React** và **Vite**, deploy tĩnh lên **Vercel** tại domain chính `https://lyvuha.com`.
+- **Backend**: **Node.js** + **Express** server chạy dưới dạng container Docker trên **Hugging Face Spaces** (Port 7860).
+- **Database**: **Supabase PostgreSQL** cho môi trường production để lưu trữ dữ liệu các sản phẩm/tin nhắn một cách bền vững.
+- **Bộ chuyển đổi cơ sở dữ liệu kép (Dual-mode Database Adapter)**: Tự động chuyển đổi giữa **PostgreSQL** (production) và **SQLite** (development local) tùy thuộc vào sự có mặt của `DATABASE_URL` trong môi trường.
+
+---
+
+## ✨ Các Tính Năng Chính (Core Features)
+
+1. **Portfolio & Danh Sách Sản Phẩm**: Hiển thị các dự án công nghệ, IoT, AI, DevOps đã làm.
+2. **Admin Dashboard (Trang Quản Trị)**:
+   - Thêm, sửa, xoá dự án trực quan (CRUD).
+   - Xem hòm thư liên hệ, đánh dấu đã đọc hoặc xoá thư.
+   - Bảo mật đầu cuối bằng mã hoá **JWT (JSON Web Token)**.
+3. **Form Liên Hệ (Contact Form)**: Gửi tin nhắn trực tiếp tới cơ sở dữ liệu và gửi thông báo qua email cá nhân/công việc (`havucong25@gmail.com` và `havucong@lyvuha.com`).
+4. **Giao Diện Premium**: Thiết kế hiện đại dạng Dark mode, Neon cyan-to-purple gradient, glassmorphism cao cấp, tương thích mọi thiết bị (Responsive).
+
+---
+
+## 🛠️ Hướng Dẫn Phát Triển Local (Local Development)
+
+### 1. Cài đặt môi trường
+Cài đặt dependencies cho cả Backend và Frontend:
+```bash
+# Backend dependencies
+cd backend && npm install
+
+# Frontend dependencies
+cd ../frontend && npm install
+```
+
+### 2. File cấu hình môi trường local (`backend/.env`)
+Tạo file `backend/.env` với nội dung mẫu:
+```env
+PORT=5000
+JWT_SECRET=your_jwt_secret_key
+ADMIN_USERNAME=admin
+ADMIN_PASSWORD=your_password
+NODE_ENV=development
+```
+*Lưu ý: Nếu không có `DATABASE_URL`, hệ thống sẽ tự động tạo file cơ sở dữ liệu `database.sqlite` ở thư mục gốc backend để phát triển local.*
+
+### 3. Chạy chế độ Development
+Chạy cả frontend và backend đồng thời qua proxy:
+```bash
+# Terminal 1: Chạy Backend
+cd backend && npm run dev
+
+# Terminal 2: Chạy Frontend
+cd frontend && npm run dev
+```
+Truy cập: `http://localhost:3000` (Frontend) proxy tới `http://localhost:5000` (Backend).
+
+---
+
+## 📦 Hướng Dẫn Deploy (Deployment Guide)
+
+### 1. Deploy Backend (Hugging Face Spaces)
+1. Tạo một **Space** mới trên Hugging Face với SDK là **Docker**.
+2. Đẩy toàn bộ mã nguồn lên Space (bỏ qua `node_modules` và file `.env`).
+3. Truy cập **Settings** -> **Variables and secrets** của Space đó và cấu hình:
+   - `DATABASE_URL`: Đường dẫn kết nối PostgreSQL của Supabase.
+   - `JWT_SECRET`: Chuỗi khóa bảo mật JWT.
+   - `ADMIN_USERNAME`: Tài khoản admin mong muốn.
+   - `ADMIN_PASSWORD`: Mật khẩu admin mong muốn.
+   - `NODE_ENV`: `production`.
+
+### 2. Deploy Frontend (Vercel)
+1. Cập nhật URL backend của bạn trong `frontend/.env.production`:
+   ```env
+   VITE_API_URL=https://your-space-name.hf.space
+   ```
+2. Build và deploy bằng Vercel CLI hoặc GitHub Integration:
+   ```bash
+   cd frontend
+   npm run build
+   npx vercel --prod
+   ```
+3. Cấu hình domain `lyvuha.com` trỏ về dự án Vercel.
+
+---
+
+*Hệ thống được phát triển và tối ưu hóa bởi Antigravity AI.*
+