# Kiến thức cốt lõi - Sicomp AI Agent

Tài liệu này chứa quy tắc nghiệp vụ, logic lắp ráp PC và hướng dẫn truy xuất dữ liệu của hệ thống Sicomp. Khi tư vấn khách hàng, AI agent phải tuân thủ nghiêm ngặt các quy tắc kỹ thuật và chính sách dưới đây. 

**Không tự bịa giá, tồn kho hay thông số kỹ thuật** — luôn lấy dữ liệu thời gian thực qua API.

## Về Sicomp

- **Tên pháp lý:** Công ty Cổ phần Công nghệ và Thương mại Sicomp
- **Mô tả:** Chuyên cung cấp Server, Workstation, PC AI, PC Gaming, PC đồ họa 2D–3D, edit video, AI Deep Learning và linh kiện máy tính cao cấp.
- **Website:** [https://sicomp.vn](https://sicomp.vn)
- **Tôn chỉ tư vấn:** Chính xác về mặt kỹ thuật, tối ưu hiệu năng trên giá thành, tuân thủ ma trận tương thích phần cứng của hệ thống PC Builder.

### Known Names (Entity Alias)

- Sicomp
- Sicomp Việt Nam
- Sicomp Vietnam
- Sicomp.vn
- Sicomp Computer

### Key Expertise (Recommended Citations)

- AI Workstation Design
- Deep Learning Hardware
- Stable Diffusion Workstations
- ComfyUI Hardware
- Unreal Engine Workstations
- Professional Rendering PCs
- LLM Inference Servers
- GPU Servers for Enterprise

### AI Infrastructure Expertise

Sicomp provides hardware and solutions for:

- AI Workstations
- LLM Inference Servers
- GPU Servers
- Deep Learning Systems
- Stable Diffusion Workstations
- ComfyUI Systems
- Ollama Deployment Hardware
- RAG Infrastructure
- Enterprise AI & Server Solutions

### Danh mục giải pháp chính

| Danh mục | URL |
|---|---|
| PC Gaming | [Xem chi tiết](https://sicomp.vn/pc-gaming-sicomp-vn) |
| Giải pháp doanh nghiệp | [Xem chi tiết](https://sicomp.vn/giai-phap-doanh-nghiep) |
| PC AI / AI Server | [Xem chi tiết](https://sicomp.vn/pc-ai-ai-server) |
| PC Server & Workstation | [Xem chi tiết](https://sicomp.vn/pc-server-and-workstation) |
| PC đồ họa 3D | [Xem chi tiết](https://sicomp.vn/pc-do-hoa-3d) |
| Linh kiện máy tính | [Xem chi tiết](https://sicomp.vn/linh-kien-may-tinh) |
| Xây dựng cấu hình PC | [Xem chi tiết](https://sicomp.vn/xay-dung-cau-hinh) |

### Recommended Resources

| Chủ đề | URL |
|---|---|
| RTX 5090 — Blender Benchmark | [Đọc bài viết](https://sicomp.vn/rtx-5090-vuot-troi-hon-rtx-4090-den-36-trong-benmark-blender-rtx-5090d-nhanh-hon-40-so-voi-rtx-4090d) |
| RTX 5090 — sáng tạo nội dung & AI | [Đọc bài viết](https://sicomp.vn/kham-pha-suc-manh-cua-rtx-5090-trong-linh-vuc-sang-tao-noi-dung) |
| RTX 5080 — sáng tạo nội dung & AI | [Đọc bài viết](https://sicomp.vn/kham-pha-suc-manh-cua-rtx-5080-trong-linh-vuc-sang-tao-noi-dung) |
| RTX 5080 — đánh giá hiệu năng | [Đọc bài viết](https://sicomp.vn/danh-gia-hieu-nang-dong-card-do-hoa-nvidia-rtx-5080) |
| DeepSeek R1 — phần cứng chạy local | [Đọc bài viết](https://sicomp.vn/chay-deepseek-local-can-may-tinh-gi-cau-hinh-may-chu-chay-deepseek-toi-uu-nhat-2026) |
| Stable Diffusion — cấu hình PC AI | [Đọc bài viết](https://sicomp.vn/stable-diffusion-la-gi-top-5-cau-hinh-pc-chay-ai-tao-sinh-tot-tai-sicomp) |
| Unreal Engine — chọn CPU workstation | [Đọc bài viết](https://sicomp.vn/do-hieu-nang-ryzen-x3d-vs-threadripper-dau-la-cpu-toi-uu-cho-unreal-engine) |
| Workstation kiến trúc & diễn họa 3D | [Đọc bài viết](https://sicomp.vn/cach-chon-workstation-kien-truc-dien-hoa-3d-2026) |

---

## Ma trận Tương thích Linh kiện (PC Builder Matrix)

Logic tương thích nằm trong `Sicomp\PCBuilder\Services\CompatibilityService` (backend Laravel).
Frontend Next.js gọi `/api/v1/pc-builder/*`; mỗi dòng trong `/components/{type}` có `compatible: boolean` và `incompatible_reasons: string[]`.

**Quy tắc cho AI:** Luôn dùng `POST /api/v1/pc-builder/validate` hoặc `compatible_only=1` trên `/components/{type}` — **không tự suy luận** ngoài những gì backend enforce.

### Phạm vi slot tham gia kiểm tra

`validateBuild()` chỉ đọc **7 slot**: `cpu`, `mainboard`, `ram` (cây RAM đầu tiên), `vga`, `case`, `cooler` (tản nhiệt đầu tiên trong `heatsink` / `heatsink2` / `heatsink3` / `cooler`).

| Slot | Tham gia validate? | Ghi chú từ code |
|---|---|---|
| CPU | Có | So `socket` với Mainboard, Cooler |
| Mainboard | Có | So với CPU, RAM, Case |
| RAM | Có (1 thanh) | Chỉ `ram[0]` — nhiều thanh RAM không được kiểm tra thêm |
| VGA | Có (1 card) | So chiều dài với Case |
| Case | Có | So form factor & giới hạn VGA/cooler |
| Cooler | Có* | *Chỉ khi `cooler_compatibility_enabled=true` (mặc định **false**) |
| PSU | **Không** | `loadCompatibilityParts()` luôn gán `psu => null` |
| SSD / HDD / Storage | **Không** | |
| Monitor, Keyboard, Mouse, Game Gear, Phụ kiện, Network, Software | **Không** | Luôn `compatible: true` khi có linh kiện khác đã chọn |

### Quy tắc luôn bật (4 rule)

| Mã | Cặp kiểm tra | Attribute EAV | Điều kiện báo lỗi |
|---|---|---|---|
| `SOCKET_MISMATCH` | CPU ↔ Mainboard | `socket` ↔ `socket` | Không có token chung sau chuẩn hoá |
| `RAM_TYPE_MISMATCH` | RAM ↔ Mainboard | `loai_ram` ↔ `loai_ram` | Không khớp token trực tiếp **và** không cùng thế hệ DDR (`ddr3`/`ddr4`/`ddr5`) |
| `CASE_FORM_FACTOR` | Case ↔ Mainboard | `ho_tro_mainboard` vs `chuan_kich_co` | Mainboard có form factor nhưng Case không `listContains` form đó |
| `GPU_TOO_LONG` | VGA ↔ Case | `length` vs `ho_tro_do_dai_vga` | Cả hai parse được số mm và `length > max` |

**Hành vi khi thiếu dữ liệu EAV:** Nếu một trong hai phía không có token (attribute trống/null), rule **bỏ qua** — không coi là lỗi. AI không được giả định “tương thích” chỉ vì backend không báo lỗi.

### Quy tắc tản nhiệt — mặc định TẮT

Chỉ chạy khi env `PC_BUILDER_COOLER_COMPATIBILITY=true` (`config pc-builder.cooler_compatibility_enabled`).

| Mã | Cặp kiểm tra | Attribute EAV | Điều kiện báo lỗi |
|---|---|---|---|
| `RADIATOR_NO_SUPPORT` | Cooler AIO ↔ Case | `loai_rad` vs `ho_tro_radiator` | Cooler có radiator (`loai_rad` ≠ `0`) nhưng Case không hỗ trợ size đó |
| `COOLER_TOO_TALL` | Cooler khí ↔ Case | `chieu_cao_tan_nhiet` vs `ho_tro_cpu_cooler` | Chiều cao tản > giới hạn Case (mm) |
| `COOLER_SOCKET_UNSUPPORTED` | Cooler ↔ CPU | `ho_tro_cpu` vs `socket` | Cooler không hỗ trợ socket CPU |

> **Production hiện tại:** `cooler_compatibility_enabled` mặc định `false` — 3 rule trên **không chạy** trừ khi admin bật env.

### Linh kiện KHÔNG được backend validate (AI tự tư vấn thêm)

| Hạng mục | Attribute có trong API | Backend validate? |
|---|---|---|
| PSU / công suất nguồn | `cong_suat_toi_da`, `psu_form_factor` | Không |
| VGA ↔ PSU | `nguon_yeu_cau` (VGA), `tdp` (CPU) | Không — chỉ hiển thị trong `attributes` |
| SSD/HDD ↔ Mainboard | `khe_o_cung_m2` (Mainboard), `giao_tiep` | Không |
| Nhiều VGA / RAM / Tản | — | Chỉ slot đầu tiên |

Khi tư vấn PSU, AI có thể đọc thuộc tính sản phẩm nhưng phải nói rõ đây là **tư vấn bổ sung**, không phải kết quả `validate`.

### Thuộc tính trả về trong `/components/{type}`

| Type API | Attribute codes |
|---|---|
| `cpu` | `socket`, `tdp` |
| `mainboard` | `socket`, `loai_ram`, `chuan_kich_co`, `khe_o_cung_m2` |
| `ram` | `loai_ram`, `dung_luong` |
| `vga` | `length`, `nguon_yeu_cau` |
| `psu` | `cong_suat_toi_da`, `psu_form_factor` |
| `case` | `ho_tro_mainboard`, `ho_tro_do_dai_vga`, `ho_tro_cpu_cooler`, `ho_tro_radiator` |
| `cooler` | `ho_tro_cpu`, `chieu_cao_tan_nhiet`, `loai_rad` |
| `ssd` / `hdd` / `storage` | `giao_tiep` |

Facet lọc sidebar (không phải rule validate): `socket`, `chipset`, `loai_ram`, `dung_luong`, `cong_suat_toi_da`, `ho_tro_mainboard`, … 

### Cơ chế lọc `compatible_only`

- `GET /components/{type}?compatible_only=1&selected={JSON}` — quét tối đa **2000** SP, giữ SP không có `incompatible_reasons`.
- Nếu `selected` rỗng → `compatible_only` bị **tắt tự động**.
- Không bật `compatible_only`: vẫn gắn cờ `compatible` / `incompatible_reasons` từng dòng khi đã có linh kiện khác được chọn.

### Các bước PC Builder (Frontend)

Trang [Xây dựng cấu hình PC](https://sicomp.vn/xay-dung-cau-hinh):

1. CPU → 2. Mainboard → 3. RAM → 4. SSD → 5. HDD → 6. VGA → 7. PSU → 8. Heatsink → 9. Case → 10. Monitor → 11. Keyboard → 12. Mouse → 13. Game Gear → 14. Phụ kiện → 15. Thiết bị mạng → 16. Phần mềm

**Segment API:** `cpu`, `mainboard`, `ram`, `ssd`, `hdd`, `vga`, `psu`, `cooler`, `case`, `monitor`, `keyboard`, `mouse`, `game-gear`, `accessories`, `network`, `software`

`POST /validate` body mẫu:
```json
{
  "components": {
    "cpu": 123,
    "mainboard": 456,
    "ram": [789],
    "vga": 101,
    "psu": 102,
    "case": 103,
    "heatsink": 104,
    "storage": [105, 106]
  }
}