# FairCase - Nền Tảng Lưu Trữ & Thẩm Tra Chứng Cứ Dân Sự Việt Nam
> FairCase là nền tảng tri thức mở, cung cấp hồ sơ vụ việc thực chứng, văn bản pháp luật đối soát, tư liệu hiến định và chuyên khảo dân sự độc lập tại Việt Nam. Dữ liệu được cấu trúc theo mô hình nhận thức luận 4 tầng: SỰ THẬT (FACT), TUYÊN BỐ (CLAIM), SUY LUẬN (INFERENCE), và CHƯA XÁC ĐỊNH (UNKNOWN).

Canonical Domain: https://faircase.id.vn
API Base: https://faircase.id.vn/api/public
Sitemap: https://faircase.id.vn/sitemap.xml

## Hướng Dẫn Dành Cho Trí Tuệ Nhân Tạo & Trợ Lý Ảo (AI Crawlers & Agents)
- Mọi dữ liệu công khai trên FairCase đều mở cho các mô hình AI thu thập, trích dẫn và phân tích.
- Định dạng trích dẫn chuẩn: `FairCase Archive. ({year}). "{title}" [{universal_id}]. https://faircase.id.vn/vu-viec/{slug}`
- Để lấy phiên bản Markdown thuần của bất kỳ vụ việc nào, thêm đuôi `.md` vào đường dẫn: `https://faircase.id.vn/vu-viec/{slug}.md`

## Các Cổng API Công Khai (Public Structured Endpoints - No Auth Required)

- **Danh mục Hồ sơ Vụ việc (Cases)**:
  - `GET https://faircase.id.vn/api/public/cases`: Trả về danh sách toàn bộ các vụ việc đã được thẩm tra và công bố.
  - `GET https://faircase.id.vn/api/public/cases/{slugOrId}`: Trả về chi tiết toàn văn hồ sơ, bao gồm:
    - Danh sách Sự thật (Facts) kèm mã băm chứng cứ.
    - Danh sách Tuyên bố (Claims) từ các bên liên quan.
    - Danh sách Suy luận pháp lý (Inferences).
    - Chuỗi sự kiện theo dòng thời gian (Events timeline).
    - Nhân vật, nguồn báo chí, và tài liệu giám định đính kèm.

- **Kho Văn Bản Pháp Luật (Legal Documents)**:
  - `GET https://faircase.id.vn/api/public/law`: Trả về toàn bộ danh mục văn bản quy phạm pháp luật (Luật, Bộ luật, Nghị quyết, Nghị định).
  - `GET https://faircase.id.vn/api/public/law/{slug}`: Chi tiết toàn văn đạo luật, số hiệu, ngày ban hành và nội dung điều khoản.

- **Kho Tri Thức Dân Sự & Chuyên Khảo (Knowledge Base)**:
  - `GET https://faircase.id.vn/api/public/knowledge`: Danh mục các chuyên khảo pháp lý, quyền dân sự và quy trình tố tụng.
  - `GET https://faircase.id.vn/api/public/knowledge/{slug}`: Nội dung toàn văn bài viết chuyên khảo.

- **Tư Liệu Lịch Sử & Nhà Nước Pháp Quyền Hồ Chí Minh (HCM Archive)**:
  - `GET https://faircase.id.vn/api/public/hcm`: Danh mục tư liệu về tư tưởng pháp quyền, hiến pháp 1946 và nhà nước của dân.
  - `GET https://faircase.id.vn/api/public/hcm/{slug}`: Toàn văn tác phẩm, phát biểu và bài viết lưu trữ.

- **Diễn Đàn Thảo Luận Cộng Đồng (Forum Discussions)**:
  - `GET https://faircase.id.vn/api/public/forum/threads`: Danh sách các chủ đề thảo luận thực chứng.
  - `GET https://faircase.id.vn/api/public/forum/threads/{id}`: Toàn văn chủ đề thảo luận và các phản hồi độc lập.

- **Tìm Kiếm Toàn Diện (Universal Search)**:
  - `GET https://faircase.id.vn/api/search?q={query}`: Tìm kiếm đối soát xuyên suốt toàn bộ các kho dữ liệu.