Tới nội dung chính
Tài liệu

Web công khai

Bề mặt công khai của ecoma.io tuân theo một mô hình URL duy nhất:

/<locale>/<mount>/<path>

Giải phẫu một public web URL: ba segment /locale, /mount và /path, với ví dụ /en/docs/getting-started và /vi/docs/getting-started

Ba segment

  • locale — segment đầu tiên, luôn hiện diện. Các locale được hỗ trợ nằm trong locale registry (PUBLIC_LOCALES trong app/i18n). Tiếng Anh là /en/..., tiếng Việt là /vi/...; không có biến thể không prefix.
  • mount — application công khai. Các mount hiện có trong app/layout là blog, docs và docs/api. Mount khớp theo full segment boundary: /en/docs là docs, còn /en/blogging không phải blog.
  • path — phần sau mount. Nó opaque với nền tảng; application sở hữu mount quyết định resource đó có tồn tại hay không.

Ví dụ

URLNghĩa
/enLocale root tiếng Anh
/en/docsDocs tiếng Anh, docs root
/en/docs/getting-startedDocs tiếng Anh, Getting Started
/vi/docs/getting-started/installationDocs tiếng Việt, trang Cài đặt

Parse nghiêm ngặt

Path không được normalize hay sửa giúp. Trailing slash, empty segment, hay locale không được hỗ trợ đều bị từ chối với lý do đã định kiểu (typed reason) thay vì âm thầm sửa:

/en        → localized (en)
/EN/docs   → invalid (unsupported_locale)
/en/docs/  → invalid (trailing_slash)
/en//docs  → invalid (empty_segment)

Ranh giới

  • / là locale-resolution entry point. Nó không phục vụ nội dung và không tự redirect; policy resolve thuộc về caller.
  • docs/api là mount lồng nhau được dành riêng cho bề mặt api-reference. Ứng dụng home không phục vụ nó — request tới /en/docs/api bị từ chối trước khi lookup content.

Mô hình nằm ở đâu

Mô hình URL không phải là một quy ước mà mỗi trang tự tuân theo — nó được thực thi trong hai module nhỏ của apps/home mà mọi bề mặt public đều đi qua:

  • app/i18n sở hữu locale dimension: registry PUBLIC_LOCALES, parse segment đầu tiên và locale switching. Nó không biết gì về mount hay application.
  • app/layout sở hữu mount topology: registry PUBLIC_MOUNTS (blog, docs, docs/api), khớp một pathname với một mount và dựng liên kết ngược lại.

Thêm một locale hay một mount nghĩa là thêm một entry vào registry tương ứng; phần còn lại của nền tảng suy ra từ chính dữ liệu đó.

Tiếp: Nội dung và ngôn ngữ

Nội dung