Útvonaltérkép
Alkalmazáshéj
Szekció neve “Alkalmazáshéj”Az alkalmazáshéj (ControlCenterLayout) egy ShellRoute segítségével csomagolja az összes munkaterületen belüli útvonalat. A héjon belüli célpontok mindegyike munkaterület-előtagot kap — /workspaces/:workspaceId/… —, és az URL-ben szereplő munkaterület-azonosító az aktív munkaterület egyetlen igazságforrása. Előtag nélkül csak a kontextus előtti felületek vannak: /splash, /onboarding, /signed-out és a puszta /workspaces választó — mind teljes képernyős, a héjon kívül.
A kapu akkor teljes, ha legalább egy kódhoszt csatlakoztatva van a bejelentkezett felhasználó számára, és létezik legalább egy munkaterület.
A hiányzó hitelesítő adat és a hiányzó beállítás különböző képernyő, a megkülönböztető pedig a users.onboarding_finished_at, amelyet a hívó saját identity.me válaszából olvasunk ki — soha nem a „léteznek munkaterületek” feltétel, mert az abban a pillanatban téves, amikor valakit olyan munkaterületbe hívnak meg, amelyet ő soha nem hozott létre. Csatlakoztatott kódhoszt nélkül az a fiók, amely már átesett a bevezetésen, a /signed-out oldalra kerül, hogy újra hitelesítse magát; amelyik még nem, az a /onboarding oldalra. Amíg a jelző ismeretlen, az őr az indítási képernyőn tart, ahelyett hogy találgatna, mert soha nem irányít vissza a bevezetésből.
Előtag nélküli útvonalak
Szekció neve “Előtag nélküli útvonalak”| Útvonal | Képernyő |
|---|---|
/splash |
Indítási képernyő, amely feloldja a bevezetési kaput |
/onboarding |
Kódhoszt csatlakoztatása, munkaterület létrehozása vagy csatlakozás egy meglévőhöz, homokozó, alapértelmezett adapter, majd hang. A munkaterület lépés kimarad, ha a fiók már tartozik egyhez |
/signed-out |
Újrahitelesítés: ugyanaz a Kódtárhely kártya, amelyet a Beállítások megjelenít, lépéssáv és folytatás gomb nélkül — az útválasztó magától továbblép, amint egy kódhoszt jelentkezik |
/workspaces |
Munkaterület-lista és választó |
/workspaces/:workspaceId |
Átirányít a /workspaces/:workspaceId/inbox címre |
Munkaterület-útvonalak
Szekció neve “Munkaterület-útvonalak”Az alábbi útvonalak elhagyják a /workspaces/:workspaceId előtagot.
| Útvonal | Lekérdezési paraméterek | Képernyő |
|---|---|---|
/inbox |
— | Egységes Beérkezett: az átnézési életciklus szerint osztályozott PR-ek, valamint az üzemeltetőt blokkoló, nem PR-jellegű munka. Az őr utáni landolási útvonal; a puszta /workspaces/:workspaceId ide irányít |
/spaces |
— | Térfelület, nincs kiválasztott tér |
/spaces/:spaceId |
?m=<messageId>, ?tab=<key> |
Egy tér; az m egy üzenetre mutató mélyhivatkozás, amely a megnyitáskor egyszer használódik fel |
/tickets |
— | Jegytábla |
/tickets/:ticketId |
— | Jegy mester–részlet nézet |
/projects/:projectId |
— | Projekt áttekintése |
/pull-requests |
?repo=<owner/name> |
PR-lista; a repo a bal oldali sávban jelöli ki azt a repót |
/pull-requests/compose |
?space=<spaceId> |
Új pull request összeállítása; a space megnevezi azt a teret, amelynek elszigetelt worktree-je adja az ágat |
/pull-requests/:owner/:repo/:prNumber |
?tab=<key>, ?comment=<id> |
PR részletei diffnézegetővel; a comment egy megjegyzés numerikus REST-azonosítója |
/pipelines |
— | Pipeline-futtatások listája |
/pipelines/run |
?templateId=<id> |
Kézi futtatás indítója |
/pipelines/:runId |
— | Pipeline-futtatás részletei (lépések idővonala) |
/plans |
— | Plan Studio központ: aktív tervek, tervdokumentumok, playbookok |
/plans/:kind/:id |
— | Plan Studio egy tervhez; a kind értéke orchestration vagy document |
/meetings |
— | Megbeszélések listája |
/meetings/record |
— | Élő megbeszélésrögzítő képernyő |
/meetings/:meetingId |
— | Megbeszélés részletei: jegyzetek, átirat, teendők, döntések |
/calendar |
— | Naptár: havi, heti és napirend nézetek |
/calendar/:eventId |
— | Naptáresemény részletei (testvér-útvonal; a naptároldal kulcsát osztja meg) |
/newsfeed |
— | Hírfolyam listája |
/newsfeed/article/:articleId |
— | Cikkolvasó |
/observability |
— | Megfigyelhetőségi központ: Használat, Betekintések, Élő és Minőség lapok a munkaterület futtatásinapló-folyama fölött. Alapértelmezésben a Használat lap |
/users/:login |
— | GitHub-felhasználói profil |
/teams/:organization/:slug |
— | GitHub-szervezeti csapatprofil |
/api-keys |
— | API-kulcsok kezelése. Nincs navigációs belépési pont — csak URL-lel érhető el |
/settings/… |
— | Beállítások képernyői (lentebb) |
A beszélgetéseknek és a szálaknak nincs saját útvonaluk — egy szál egy beszélgetés a /spaces/:spaceId felületen belül, amely szerkesztőfülként nyílik meg, nem pedig URL-lel címezhető.
Nincs /dashboard útvonal és nincs irányítópult-képernyő sem. Az elemzőfelület a /observability, amely az oldalsáv láblécéből érhető el.
Nincs „Tervek” bejegyzés az oldalsávban. A Plan Studio szerkesztőfülként nyílik meg abból a beszélgetésből, amely létrehozta a tervet, annak sorából; a /plans és a /plans/:kind/:id mélyhivatkozás.
A /observability és a /pull-requests/compose nem szerepel az útvonalcím- vagy morzsamenü-nyilvántartásban, ezért mindkettő a puszta alkalmazásnevet mutatja az ablak címében, és nincs morzsamenü-nyomvonaluk sem.
Beállítások útvonalai
Szekció neve “Beállítások útvonalai”A /settings a /settings/you/appearance címre irányít. Az oldalsáv beállítások gombja és a Cmd/Ctrl + , is a /settings/you/appearance címre visz.
A beállítások útvonalai hatókör szerint kapnak névteret — you/, workspace/, server/ —, mert a szegmens megmondja, kire hat ki egy módosítás. Két útvonal régebbi a névtérhasználatnál, ezért az URL-ben nincs hatóköre: a /settings/memory és a /settings/pipelines.
| Útvonal | Képernyő |
|---|---|
/settings/you/appearance |
Téma, nyelv, tipográfia, szerkesztőtéma (a beállítások nyitóképernyője) |
/settings/you/notifications |
Eseményenkénti kapcsolók, csendes órák |
/settings/you/keybindings |
Billentyűparancs-referencia (csak olvasható) |
/settings/you/audio |
Mikrofon, diktálás, megbeszélésészlelés és hangtáj-kimenet |
/settings/you/devices |
Párosított telefonok és távirányítás |
/settings/you/newsfeed |
Hírfolyam kezelése: források, frissítés, olvasási állapot |
Munkaterület
Szekció neve “Munkaterület”| Útvonal | Képernyő |
|---|---|
/settings/workspace/profile |
Profil és identitás ebben a munkaterületben: név, git-szerző, kódtárhely, naptár |
/settings/workspace/general |
Név, logó, titkos útvonalak kizárása, átnézési párhuzamosság, ágelnevezés, szinkronizálás állapota, csevegőhidak, veszélyzóna |
/settings/workspace/meetings |
Megbeszélésjegyzet-sablonok és mentett hangprofilok |
/settings/workspace/members |
Névsor, meghívók, auditnapló. Az auditnapló opcionális ?cursor= paraméterrel lapozható |
/settings/workspace/repositories |
Az ebben a munkaterületben regisztrált repók |
/settings/workspace/agents |
Regisztrált ügynökidentitások |
/settings/workspace/skills |
Készségkonfiguráció |
/settings/memory |
Munkaterület-memória: tények, szabályzatok, tudásgráf |
/settings/workspace/permissions |
Ügynökjogosultságok: korlátmátrix és mi-lenne-ha próba |
/settings/pipelines |
Pipeline-sablonok |
/settings/pipelines/:templateId |
Pipeline-sablon szerkesztője (húzd és ejtsd vászon) |
Szerver
Szekció neve “Szerver”| Útvonal | Képernyő |
|---|---|
/settings/server/connection |
Kapcsolat és állapot |
/settings/server/sso |
Egyszeri bejelentkezés (SAML, OIDC, SCIM-provisionálás) |
/settings/server/providers |
Modellszolgáltatók és adapterek |
/settings/server/mcp |
Beépített és külső MCP-szerverek |
/settings/server/voice |
Hang- és megbeszélésmodellek (ASR, beszélőszétválasztás) |
/settings/server/rigs |
Állomások: mit tud elindítani ez a gazdagép, alap image-ek, egyéni image-ek, futó gépek |
/settings/server/sandbox |
Homokozó exec-engedélyek: programok, amelyeket az ügynökök a repóik munkapéldányából futtathatnak |
/settings/server/diagnostics |
Diagnosztika és adatvédelem: homokozás, beágyazás, naplózás, összeomlásjelentés |
/settings/server/backup |
Biztonsági mentés és visszaállítás: telepítési pillanatképek, munkaterületenkénti export, importálás és törlés |
/settings/server/about |
Névjegy és frissítések |
A lib/features/settings/settings_nav.dart fájlban lévő kSettingsNav az egyetlen igazságforrás ehhez a listához. A settings_nav_test.dart rögzíti az egyedi azonosítókat, az egyedi útvonalakat, a lapított J/K sorrendet és a három hatókört. Nem járja be az összes regisztrált GoRoute-ot.
Útvonalkonfiguráció
Szekció neve “Útvonalkonfiguráció”| Vonatkozás | Fájl |
|---|---|
| Útválasztó | lib/router/app_router.dart |
| Útvonalépítők | lib/router/routes.dart |
| Hitelesítési őrök | lib/router/guards.dart |
| Bevezetési kapu | lib/features/auth/providers/onboarding_providers.dart |
| Beállítások navigációja | lib/features/settings/settings_nav.dart |