Yeni proje kurulumu

Ne zaman

• "Yeni bir API kur", "şu iş için ayrı bir uygulama aç", "boş bir Vite projesi başlat" gibi, henüz reposu olmayan işler.
• Juno coolify_create_app isterken core eksik standart dosya döndürdüyse ve repo neredeyse boşsa.
• Kullanılmaz: tasarım ve içerik belgesinden site yapmak (site-yapimi; o yöntem repo açarken bu yöntemin 1–7. adımlarını kullanır), var olan repoya özellik (ozellik-gelistirme).

Girdi

• Projenin adı ve ne yapacağı (tek cümle), yığın (ör. Vite + React, Node API). Yığın verilmemişse proje kartına ve kullanıcının bilinen tercihlerine bak; yoksa sor.
• Görevde "X'i temel al" yazmıyorsa başka bir projemizden kod, tasarım, renk ya da bileşen ALINMAZ.
• Yayın isteniyor mu, alt alan adı önerisi (Juno izinli köklerden seçer).
• recall "proje standardı" ile vault knowledge/Proje-Standardı.md; ayrıntı orada, bu yöntem özetini uygular.

Adımlar

1. recall "<ad>" ile aynı adda proje ya da repo var mı bak. Varsa yeni repo açma; görev sahibine sor.
2. Repo adını küçük harf-tire ile seç. request_approval ile create_repo iste: params {name, private: true, description}. Gerekçeye ne için açıldığını yaz. Onay gelmeden kod yazmaya başlama; outcome "blocked" ve "create_repo onayı bekleniyor" de.
3. Onaydan sonra checkout_repo({repo: "sahip/<ad>"}).
4. İskeleti kur: yığının resmî başlangıç yapısı, en az bir çalışan sayfa ya da uç nokta, bir test. Yer tutucu içerik (lorem, [email protected], "Proje 1") yazma; bilinmeyen alanı çıkar.
5. Proje standardı dosyalarını ekle:
   • Dockerfile çok aşamalı. Statik/Vite/React: node:22-alpine ile npm ci + npm run build → nginx:alpine, SPA için nginx.conf (try_files $uri /index.html), EXPOSE 80. Sunucu uygulaması kendi portunu EXPOSE eder.
   • .dockerignore: node_modules, dist, .git, .env*.
   • README.md: ne yapar, yerelde nasıl çalışır, "## Yayın" bölümü (adres, port, Coolify adı; adres henüz yoksa "Juno açacak" yaz).
   • .env.example: anahtar adları, değersiz.
   • Lockfile: npm install ile üret, elle düzenleme.
   • Tek servisli projede docker-compose.yml YOK.
6. Bağımlılıkları aynı nesilden seç (ör. bir çatı ve onun resmî eklentileri aynı ana sürüm ailesi). Sunucu ARM64: platforma özel paket zorunlu bağımlılık olmamalı.
7. Yayın derlemesini kendin dene: node_modules'u sil, Dockerfile komutlarını sırayla koş (npm ci, npm run build), testleri koş. Düşerse düzelt; --force/--legacy-peer-deps yok.
8. Gönder: yeni repoda ilk sürüm push_main({repo, message: "İlk sürüm: iskelet ve proje standardı"}). Görev Yayın: önizlemeli diyorsa open_pr.
9. Yayını devret (Atlas'ın create_task aracı yok): Juno'ya send_message ile repo adı, dal (main ya da PR dalı), port, önerilen alt alan adı ve "yeni uygulama yayını" isteği. Juno coolify_create_app ister; standart dosya eksikse core onu reddeder ve iş sana döner.
10. update_task ile kanıt (repo ve commit adresi) ver, turu özetle bitir.

Kontrol listesi

• Repo create_repo onayıyla açıldı; başka projenin reposu kullanılmadı.
• Dockerfile çok aşamalı ve EXPOSE var; .dockerignore, README "## Yayın", .env.example, lockfile var.
• Tek servisli projede docker-compose.yml yok.
• Temiz npm ci + npm run build ve testler geçti.
• .env.example'da değer yok; repoda secret yok.
• Yer tutucu içerik yok; bilinmeyenler "kullanıcıdan gerekenler"de.
• Juno'ya yayın için repo, dal ve port gitti.

Çıktı

## Yeni proje: <sahip/ad>
<tek cümle: ne yapar>

## Kurulanlar
- Yığın: <çatı ve ana sürüm>
- Standart dosyalar: Dockerfile (<taban imajlar>, EXPOSE <port>), .dockerignore, README ## Yayın, .env.example, <lockfile>

## Doğrulama
- `npm ci && npm run build` (temiz): <geçti>
- `npm test`: <geçti / N test>

## Yayın
- Commit/PR: <adres>
- Juno'ya iletildi: dal <ad>, port <port>, önerilen adres <alt>.<alan adı>

## Kullanıcıdan gerekenler
- <ör. .env değerleri, içerik; yoksa "yok">

Bitti sayılır

• Repo açık, iskelet ve standart dosyalar ana dalda (ya da PR'da), temiz derleme geçti.
• Juno'ya yayın bilgisi gitti; görev kanıtla güncellendi.