Vše níže je odvozeno z vyřešené webové topologie, ze které spustitelný soubor poskytuje obsah. Povrch se deklaruje jednou, tam, kde je jeho producent; router, úvodní stránka, strojově čitelný index i tato tabulka jsou projekce toho jediného vyřešení. Přidat sem povrch není krok — je to to, co se stane.
Vyhrazená jména
Tyto cesty znamenají jednu věc. /docs jednou servírovalo Swagger UI a ve dnech, kdy dorazila skutečná dokumentace, jméno znamenalo dvě věci; pravidlo project.web-surface-declared-once existuje, aby se to nemohlo opakovat.
| Role | Cesta |
|---|---|
| home | / |
| dokumentace | /docs |
| rustdoc | /rustdoc |
| swagger | /swagger |
| openapi | /openapi.json |
| capabilities | /api/v1/ |
| events | /events |
Povrchy
| Povrch | Cesta | Druh | Kategorie | Nabídnuto komu | Dostupnost | Producent |
|---|---|---|---|---|---|---|
| Registr schopností přes HTTP | /api/v1 | native-route | api | veřejné | served-only | capability registry |
| Registr vykreslený pro člověka | /cockpit | native-route | rozhraní | veřejné | served-only | cockpit |
| Dokumentace, jak ji tento proces poskytuje | /docs | static-directory | dokumentace | veřejné | served-only | scripts/site-build --serve |
| Živý kanál: co dělají provádění tohoto procesu | /events | native-route | protocol | interní | served-only | http::events |
| MCP přes HTTP pro připojené klienty | /mcp | native-route | protocol | interní | served-only | mcp endpoint |
| Dokument OpenAPI registru schopností | /openapi.json | native-route | api | veřejné | obojí | capability registry |
| Dokumentace Rust crate tak, jak ji vykresluje rustdoc | /rustdoc | static-directory | dokumentace | veřejné | obojí | scripts/rust-check --doc |
| Swagger UI nad dokumentem OpenAPI | /swagger | native-route | dokumentace | veřejné | served-only | http::swagger |
| Doručení, pro člověka: majordomus ui | /ui | native-route | rozhraní | veřejné | served-only | ui |
| Web tak, jak je nasazen | / | static-directory | dokumentace | veřejné | pouze zveřejněné | scripts/site-build |
| Tento proces a vše, co obsluhuje | / | native-route | rozhraní | veřejné | served-only | web::home |
Dostupnost říká, do kterého světa povrch patří: served-only odpovídá běžící proces, published-only se nahrává jako soubory, both je obojí. Nabízeno určuje, zda se povrch člověku ukazuje na úvodní stránce; povrch internal se přesto servíruje a lze jej introspektovat, protože skrytí trasy před jejími správci ji neskryje před nikým jiným.
Zeptejte se běžícího procesu na totéž na /api/v1/web/surfaces nebo repozitáře na majordomus web list; majordomus web explain říká, odkud každá hodnota pochází.