Workspace Oluşturma¶

Bu rehber, Harmonia'nın scaffold-demo-commercial.ps1 scripti ile yeni bir workspace iskeletinin nasıl üretildiğini açıklar.

Gereksinimler¶

PowerShell 7+ — Linux/WSL'de ve Windows'ta pwsh
Harmonia meta-workspace'in lokal kopyası (drokian/harmonia-platform)

Scaffold Akışı¶

flowchart TD
    A["Script çalıştırılır\n-TargetPath · -Stack · -InitGitRepos"] --> B["Base template kopyalanır\ndemo-commercial-template/"]
    B --> C["Stack overlay uygulanır\nstacks/<stack>/demo → demo/\nstacks/<stack>/commercial → commercial/"]
    C --> D{"-InitGitRepos\nbelirtildi mi?"}
    D -->|"Evet"| E["İki git repo başlatılır\ndemo/ ve commercial/"]
    D -->|"Hayır"| F["Dosyalar hazır\ngit init manuel yapılır"]
    E --> G["development/ .gitignore'a eklenir\n(workspace notları remote'a gitmez)"]
    F --> G
    G --> H["✅ Workspace hazır"]

Komut¶

powershell pwsh -File ./templates/demo-commercial-template/development/scripts/scaffold-demo-commercial.ps1 ` -TargetPath "<hedef-dizin>" ` -Stack <stack-adı> ` -InitGitRepos

Parametreler¶

Parametre	Zorunlu	Açıklama
`-TargetPath`	Evet	Workspace'in oluşturulacağı dizin (örn. `D:\work\my-product`)
`-Stack`	Hayır (varsayılan: `node-service`)	Stack tipi: `node-service` · `python-service` · `nextjs-app`
`-InitGitRepos`	Hayır	Belirtilirse `demo/` ve `commercial/` altında `git init` çalıştırılır
`-KeepDevelopmentLocal`	Hayır	Varsayılan: açık. `development/` klasörünü `.gitignore`'a ekler

Örnek¶

powershell pwsh -File ./templates/demo-commercial-template/development/scripts/scaffold-demo-commercial.ps1 ` -TargetPath "D:\work\acme-product" ` -Stack node-service ` -InitGitRepos

Bu komut aşağıdaki yapıyı üretir:

D:\work\acme-product\ ├── demo\ → public repo kökü (node-service başlangıç dosyaları) ├── commercial\ → private repo kökü (node-service başlangıç dosyaları) └── development\ → lokal operasyon notları (.gitignore'da)

Sonraki Adımlar¶

Workspace oluşturulduktan sonra:

demo/ ve commercial/ dizinleri için remote GitHub repoları açın
git remote add origin <url> ile remote'ları bağlayın
İlk commit ve push: İlk Template Kullanımı sayfasına gidin