# Speckle Server Docs

> Đây là file định tuyến cho các hệ thống LLMs/AI Agent đọc vào dự án.

## Core Conceptual Files
- [Architecture & Core Concepts](./README.md): Giải thích Stream, Branch, Commit, Object.
- [Backend GraphQL & Modules](./server/README.md): Node.js Express server logic & Postgres structure.
- [Frontend Nuxt 3](./frontend/README.md): Vue 3 structure.
- [Microservices](./services/README.md): Background jobs (webhook, preview, fileimport).
- [Viewer & Objectloader](./viewer/README.md): 3D Streaming via Three.js.

## Data Philosophy
Speckle là *Object-based Hub*. File 3D (Revit, Rhino) được plugin Speckle đập vỡ thành hàng triệu JSON/Object nodes (ví dụ: từng Cửa sổ, Cái ghế đóng vai trò một UUID riêng). Thay vì lưu file, Speckle lưu cây JSON khổng lồ (Directed Acyclic Graph). Do đó, nó có thể diff commit (so sánh sự thay đổi của thiết kế) một cách hoàn hảo.
