Rota haritası
Uygulama kabuğu
Bölüm başlığı “Uygulama kabuğu”Uygulama kabuğu (ControlCenterLayout), çalışma alanı içindeki her rotayı bir ShellRoute üzerinden sarar. Kabuk içindeki her hedef çalışma alanı öneki taşır — /workspaces/:workspaceId/… — ve etkin çalışma alanı için tek doğruluk kaynağı, URL’deki çalışma alanı kimliğidir. Öneksiz kalan yalnızca bağlam öncesi yüzeylerdir: /splash, /onboarding, /signed-out ve yalın /workspaces seçicisi; hepsi tam ekran ve kabuğun dışındadır.
Kapı, oturum açmış kullanıcı için en az bir forge bağlı olduğunda ve en az bir çalışma alanı var olduğunda tamamlanır.
Eksik bir kimlik bilgisi ile eksik bir kurulum farklı ekranlardır ve ayırt edici ölçüt, çağıranın kendi identity.me değerinden okunan users.onboarding_finished_at alanıdır — asla “çalışma alanları var”, çünkü bu, biri hiç oluşturmadığı bir çalışma alanına davet edildiği anda yanlış olur. Bağlı forge yokken kurulumu tamamlamış bir hesap yeniden kimlik doğrulamak için /signed-out adresine gider; tamamlamamış olan ise /onboarding adresine gider. Bayrak hâlâ bilinmezken koruma tahmin yürütmek yerine açılış ekranını tutar, çünkü onboarding’den geri asla yönlendirme yapmaz.
Öneksiz rotalar
Bölüm başlığı “Öneksiz rotalar”| Yol | Ekran |
|---|---|
/splash |
Onboarding kapısını çözen açılış ekranı |
/onboarding |
Bir forge bağlayın, bir çalışma alanı oluşturun veya mevcut olana katılın, sandbox, varsayılan adaptör, ardından ses. Hesap zaten bir çalışma alanına aitse çalışma alanı adımı atlanır |
/signed-out |
Yeniden kimlik doğrulama: Ayarlar’ın işlediği aynı forge bağlantıları kartı, adım çubuğu ve devam düğmesi olmadan — bir forge bildirim verdiğinde yönlendirici kendi kendine ayrılır |
/workspaces |
Çalışma alanı listesi ve seçici |
/workspaces/:workspaceId |
/workspaces/:workspaceId/inbox adresine yönlendirir |
Çalışma alanı rotaları
Bölüm başlığı “Çalışma alanı rotaları”Aşağıdaki yollar /workspaces/:workspaceId önekini içermez.
| Yol | Sorgu parametreleri | Ekran |
|---|---|---|
/inbox |
— | Birleşik gelen kutusu: inceleme yaşam döngüsüne göre sınıflandırılmış PR’lar ve operatörü engelleyen PR dışı işler. Koruma sonrası varış rotası; yalın /workspaces/:workspaceId buraya yönlendirir |
/spaces |
— | Alan yüzeyi, seçili alan yok |
/spaces/:spaceId |
?m=<messageId>, ?tab=<key> |
Tek bir alan; m bir iletiye derin bağlantı verir ve açılışta bir kez tüketilir |
/tickets |
— | Bilet panosu |
/tickets/:ticketId |
— | Bilet ana-ayrıntı görünümü |
/projects/:projectId |
— | Proje genel bakışı |
/pull-requests |
?repo=<owner/name> |
PR listesi; repo, sol kenar çubuğunda o depoyu seçer |
/pull-requests/compose |
?space=<spaceId> |
Yeni bir pull request oluşturun; space, dalı sağlayan yalıtılmış çalışma ağacına sahip alanı adlandırır |
/pull-requests/:owner/:repo/:prNumber |
?tab=<key>, ?comment=<id> |
Diff görüntüleyicili PR ayrıntısı; comment, tek bir yorumun sayısal REST kimliğidir |
/pipelines |
— | Pipeline çalıştırma listesi |
/pipelines/run |
?templateId=<id> |
Elle çalıştırma başlatıcısı |
/pipelines/:runId |
— | Pipeline çalıştırma ayrıntısı (adım zaman çizelgesi) |
/plans |
— | Plan Studio merkezi: aktif planlar, plan belgeleri ve playbook’lar |
/plans/:kind/:id |
— | Tek bir plan için Plan Studio; kind değeri orchestration ya da document olur |
/meetings |
— | Toplantı listesi |
/meetings/record |
— | Canlı toplantı kaydı ekranı |
/meetings/:meetingId |
— | Toplantı ayrıntısı: notlar, transkripsiyon, eylem öğeleri, kararlar |
/calendar |
— | Takvim: ay, hafta ve gündem görünümleri |
/calendar/:eventId |
— | Takvim etkinliği ayrıntısı (kardeş rota; takvim sayfası anahtarını paylaşır) |
/newsfeed |
— | Haber akışı listesi |
/newsfeed/article/:articleId |
— | Makale okuyucusu |
/observability |
— | Gözlemlenebilirlik merkezi: çalışma alanı çalıştırma günlüğü akışı üzerinde Kullanım, İçgörüler, Canlı ve Kalite sekmeleri. Varsayılan olarak Kullanım sekmesi açılır |
/users/:login |
— | GitHub kullanıcı profili |
/teams/:organization/:slug |
— | GitHub organizasyon ekibi profili |
/api-keys |
— | API anahtarı yönetimi. Gezinmede giriş noktası yok — yalnızca URL ile ulaşılabilir |
/settings/… |
— | Ayarlar ekranları (aşağıda) |
Sohbetlerin ve ileti dizilerinin kendi rotası yoktur — bir ileti dizisi /spaces/:spaceId içindeki bir sohbettir ve URL ile adreslenmek yerine bir düzenleyici sekmesi olarak açılır.
/dashboard rotası ve gösterge paneli ekranı yoktur. Analitik yüzeyi, kenar çubuğunun altbilgisinden ulaşılan /observability adresidir.
Kenar çubuğunda “Planlar” öğesi yoktur. Plan Studio, planı üreten konuşmadaki plan satırından bir düzenleyici sekmesi olarak açılır; /plans ve /plans/:kind/:id derin bağlantılardır.
/observability ve /pull-requests/compose, rota başlığı veya gezinti izi kayıtlarında yer almaz; bu yüzden ikisi de pencere başlığında yalın uygulama adını gösterir ve hiçbir gezinti izi sunmaz.
Ayarlar rotaları
Bölüm başlığı “Ayarlar rotaları”/settings, /settings/you/appearance adresine yönlendirir. Kenar çubuğundaki ayarlar düğmesi ve Cmd/Ctrl + , de /settings/you/appearance adresine gider.
Ayarlar yolları kapsama göre ad alanına ayrılır — you/, workspace/, server/ — çünkü bu bölüm bir değişikliğin kimi etkilediğini belirtir. İki yol bu ad alanı düzeninden öncesine aittir ve URL’de kapsamlı değildir: /settings/memory ve /settings/pipelines.
| Yol | Ekran |
|---|---|
/settings/you/appearance |
Tema, dil, tipografi, düzenleyici teması (ayarların açılış sayfası) |
/settings/you/notifications |
Olay bazında anahtarlar, sessiz saatler |
/settings/you/keybindings |
Klavye kısayolu başvurusu (salt okunur) |
/settings/you/audio |
Mikrofon, dikte, toplantı algılama ve ses manzarası çıkışı |
/settings/you/devices |
Eşleştirilmiş telefonlar ve uzaktan kontrol |
/settings/you/newsfeed |
Akış yönetimi: kaynaklar, yenileme, okundu durumu |
Çalışma alanı
Bölüm başlığı “Çalışma alanı”| Yol | Ekran |
|---|---|
/settings/workspace/profile |
Bu çalışma alanındaki profil ve kimlik: ad, git yazarı, kod barındırma, takvim |
/settings/workspace/general |
Ad, logo, gizli yol dışlamaları, inceleme yayılımı, dal adlandırma, eşitleme sağlığı, sohbet köprüleri, tehlikeli bölge |
/settings/workspace/meetings |
Toplantı notu şablonları ve kayıtlı ses profilleri |
/settings/workspace/members |
Kadro, davetler, denetim kaydı. Denetim kaydı isteğe bağlı ?cursor= ile sayfalanır |
/settings/workspace/repositories |
Bu çalışma alanında kayıtlı depolar |
/settings/workspace/agents |
Kayıtlı ajan kimlikleri |
/settings/workspace/skills |
Beceri yapılandırması |
/settings/memory |
Çalışma alanı belleği: olgular, politikalar, bilgi grafiği |
/settings/workspace/permissions |
Ajan izinleri: koruma matrisi ve “Ne olur?” sondası |
/settings/pipelines |
Pipeline şablonları |
/settings/pipelines/:templateId |
Pipeline şablonu düzenleyicisi (sürükle-bırak tuvali) |
Sunucu
Bölüm başlığı “Sunucu”| Yol | Ekran |
|---|---|
/settings/server/connection |
Bağlantı ve durum |
/settings/server/sso |
Tek oturum açma (SAML, OIDC, SCIM ile kullanıcı sağlama) |
/settings/server/providers |
Model sağlayıcıları ve adaptörler |
/settings/server/mcp |
Yerleşik ve harici MCP sunucuları |
/settings/server/voice |
Ses ve toplantı modelleri (ASR, konuşmacı ayırma) |
/settings/server/rigs |
Rigs: bu ana makinenin açabildikleri, temel imajlar, özel imajlar, çalışan makineler |
/settings/server/sandbox |
Sandbox çalıştırma izinleri: ajanların depolarınızın çalışma kopyasından çalıştırabileceği programlar |
/settings/server/diagnostics |
Tanılama ve gizlilik: sandbox, gömme, günlükleme, çökme raporlama |
/settings/server/backup |
Yedekleme ve geri yükleme: kurulum anlık görüntüleri, çalışma alanı başına dışa aktarma, içe aktarma ve silme |
/settings/server/about |
Hakkında ve güncellemeler |
lib/features/settings/settings_nav.dart içindeki kSettingsNav, bu listenin tek doğruluk kaynağıdır. settings_nav_test.dart benzersiz kimlikleri, benzersiz rotaları, düzleştirilmiş J/K sırasını ve üç kapsamı sabitler. Kayıtlı her GoRoute’u dolaşmaz.
Rota yapılandırması
Bölüm başlığı “Rota yapılandırması”| Konu | Dosya |
|---|---|
| Yönlendirici | lib/router/app_router.dart |
| Rota oluşturucuları | lib/router/routes.dart |
| Kimlik doğrulama korumaları | lib/router/guards.dart |
| Onboarding kapısı | lib/features/auth/providers/onboarding_providers.dart |
| Ayarlar gezinmesi | lib/features/settings/settings_nav.dart |