İçeriğe atla
supastack
Dokümanlara göz atın
MasaüstüTauri

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/desktop/project-structure.md (or send Accept: text/markdown).

Proje yapısı

Rust kabuğunu, önyükleme sayfasını, sürüm betiklerini ve web uygulamasıyla sınırı bulun.

Bu kılavuz hakkında sor
Şurada aç

Kurulum ve yapılandırma

Herhangi bir adımdan önce Başlamadan önce ve Terminal temelleri'ni okuyun. supastack klasörünü kökünde açın — package.json içeren klasör. Bir Desktop checkout, apps/desktop'ı ve sürüm betiklerini içerir; All Platforms monorepo'su Web arka ucunu ve mobil uygulamayı ekler. Ortam değişkeni, yerel bir .env dosyasında veya barındırma panelinizde saklanan adlandırılmış bir ayardır; kabuk, SUPASTACK_APP_URL'yi bir dosyadan değil, bir terminal ayarı olarak okur.

1. apps/desktop/src-tauri/src/lib.rs'i açın — tüm yerel davranış bu tek dosyada yaşar.

2. apps/desktop/src-tauri/'yi gözden geçirin — yapılandırma, capabilities ve simgeler.

3. Depo kökünden corepack pnpm --filter @supastack/desktop dev çalıştırın, erişilebilir bir arka uçla.

Checkout yalnızca Tauri kabuğunu içerir: Rust kaynağı, yapılandırması, önyükleme sayfası ve sürüm betikleri. Ürün ekranları, pencerenin yüklediği web uygulamasında yaşar — yalnızca Desktop checkout'un kendi uygulama ekranları yoktur. Davranışı değiştirmeden önce AGENTS.md ve .ai/PROJECT_CONTEXT.md'yi okuyun; .ai/ yansıma belgeleri tek bir dosyadan görünmeyen kararları kaydeder.

apps/desktop/src-tauri/src/    Rust — window, tray, menus, deep links, updater
apps/desktop/src-tauri/        tauri.conf.json, capabilities/, Cargo.toml, icons
apps/desktop/ui/               Boot page (index.html + boot.js) shown while loading
apps/desktop/scripts/          Release preflight + update manifest
docs/                          Runbooks incl. desktop updates
.agents/skills/                Task guides for coding agents

Değişikliğin ait olduğu yer

Düzenlemeden önce değişikliğin hangi tarafa ait olduğuna karar verin: bir kullanıcının ürün UI'si olarak gördüğü her şey web uygulamasına aittir; yalnızca işletim sistemi düzeyindeki davranış Rust'a aittir.

  • Pencere, tepsi, menü, kısayol veya tek örnek davranışı → apps/desktop/src-tauri/src/lib.rs.
  • Yeni bir webview izni → apps/desktop/src-tauri/capabilities/default.json — yalnızca bir yerel özellik ihtiyaç duyduğunda genişletin.
  • Paket tanımlayıcısı, sürüm, güncelleyici uç noktası veya eklenti seçenekleri → apps/desktop/src-tauri/tauri.conf.json.
  • Yer tutucu ürün simgeleri → placeholder-icon.png'yi değiştirin ve simge betiğini çalıştırın.
  • Önyükleme, yükleme veya çevrimdışı kaplama davranışı → apps/desktop/ui/.
  • Herhangi bir ürün ekranı, ayar veya veri → web uygulaması deposu — kabuk asla ürün UI'sini çatallamaz.

Uygulama iş akışı

Yerel bir değişiklik için lib.rs'i düzenleyin, cargo check ve Rust testlerini çalıştırın, ardından pencereyi her hedef işletim sisteminde egzersiz edin — tepsi, kısayol ve derin bağlantı davranışı platforma göre değişir. .agents/skills/'deki add-a-desktop-capability becerisi aynı sırayı izler.

Doğrulama ve sorun giderme

cargo check derleme hatalarını yakalar ve cargo test saf mantığı kapsar. Gerçek doğrulama, Windows, macOS ve Linux'ta çalışan penceredir — tepsi, kısayol ve derin bağlantılar yalnızca testlerle kanıtlanamaz.

corepack pnpm --filter @supastack/desktop test
corepack pnpm --filter @supastack/desktop typecheck