> For the complete documentation index, see [llms.txt](https://www.dapps.io.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.dapps.io.vn/kien-truc-cong-nghe/editor-1.md).

# Các lớp: Giao diện – Smart Contract – Dữ liệu phân tán – Oracle/API

***

## 🧱 **Mô hình Kiến trúc 4 Lớp của dApps Vr9**

```
┌─────────────────────────────────────────────┐
│           1. 🖥️ GIAO DIỆN NGƯỜI DÙNG (UI)    │
├─────────────────────────────────────────────┤
│ • WebApp: React / Next.js / Tailwind        │
│ • Mobile App: Flutter / React Native        │
│ • Kết nối ví: WalletConnect, MetaMask,      │
│   Vr9.Wallet (hỗ trợ SSI/DID)               │
│ • Trải nghiệm người dùng cá nhân hóa theo   │
│   danh tiếng, quyền truy cập                │
└─────────────────────────────────────────────┘
                │ Gọi API / Giao diện Web3
                ▼
┌─────────────────────────────────────────────┐
│        2. ⚙️ SMART CONTRACT LAYER (Web3)     │
├─────────────────────────────────────────────┤
│ • Solidity / Vyper – triển khai trên:       │
│   Ethereum, BNB Chain, Polygon, Arbitrum    │
│ • Các module:                               │
│   - DAO (Vr9.DAO)                           │
│   - Market (Vr9.Market)                     │
│   - Launchpad (Vr9.Launchpad)               │
│   - Credit (Vr9.Credit)                     │
│   - NFT Chứng chỉ (Vr9.Academy)             │
│ • Quản lý logic minh bạch, bất biến, an toàn│
└─────────────────────────────────────────────┘
                │ Truy xuất dữ liệu / Lưu trữ
                ▼
┌─────────────────────────────────────────────┐
│ 3. 🗂️ LỚP DỮ LIỆU PHÂN TÁN (Distributed Data)│
├─────────────────────────────────────────────┤
│ • IPFS / Filecoin: lưu trữ dữ liệu lớn,     │
│   metadata, tài sản cộng sinh               │
│ • Ceramic / OrbitDB: lưu định danh DID,     │
│   dữ liệu người dùng linh hoạt              │
│ • NFT.storage: lưu trữ dữ liệu NFT, chứng chỉ│
│ • Đảm bảo: bất biến – truy cập phi tập trung │
└─────────────────────────────────────────────┘
                │ Kết nối dữ liệu ngoài chuỗi
                ▼
┌─────────────────────────────────────────────┐
│        4. 🔗 ORACLE / API GATEWAY LAYER      │
├─────────────────────────────────────────────┤
│ • Chainlink: lấy dữ liệu off-chain (giá token│
│   dữ liệu thị trường, thời gian, thời tiết…)│
│ • The Graph: truy vấn dữ liệu on-chain hiệu  │
│   quả qua GraphQL                            │
│ • NestJS / NodeJS API Gateway:               │
│   - Kết nối frontend & blockchain            │
│   - Tích hợp SSI, xác thực DID               │
│   - Giao tiếp với dApp giả lập (JSON Server) │
└─────────────────────────────────────────────┘
```

***

### 🔎 **Tóm tắt vai trò từng lớp**

| Lớp                     | Vai trò chính                                                |
| ----------------------- | ------------------------------------------------------------ |
| **1. Giao diện (UI)**   | Trải nghiệm người dùng, tương tác với ví và dApps            |
| **2. Smart Contract**   | Logic xử lý minh bạch, tự động hóa Web3                      |
| **3. Dữ liệu phân tán** | Lưu trữ nội dung, danh tính, metadata một cách phi tập trung |
| **4. Oracle/API Layer** | Cầu nối với thế giới off-chain và hệ thống truyền thống      |

***

### 🔐 **Tích hợp bảo mật – định danh – danh tiếng**

Tất cả lớp trên đều tích hợp công nghệ:

* **SSI/DID (Self-Sovereign Identity)**: định danh số cá nhân tự chủ
* **ZK Proof (Zero-Knowledge)**: xác minh mà không tiết lộ dữ liệu
* **Score Layer (Vr9.Credit)**: đo lường danh tiếng, tín nhiệm số

***

### 🧠 Ứng dụng trong hệ sinh thái Vr9

| dApp              | Giao diện | Smart Contract | Dữ liệu phân tán  | Oracle/API |
| ----------------- | --------- | -------------- | ----------------- | ---------- |
| **Vr9.Market**    | ✅         | ✅              | ✅                 | ✅          |
| **Vr9.Launchpad** | ✅         | ✅              | ✅                 | ✅          |
| **Vr9.Academy**   | ✅         | ✅              | ✅ (chứng chỉ NFT) | ✅          |
| **Vr9.DAO**       | ✅         | ✅              | -                 | ✅          |
| **Vr9.Wallet**    | ✅         | -              | ✅ (DID)           | ✅          |

***
