poyraz-portfolio/README.md

Portfolio New

Bu monorepo, Next.js tabanlı portfolyo web uygulaması ve Electron ile geliştirilen veri yönetim panelini bir arada sunar.

Mimari

flowchart TD
  subgraph Web Uygulama (Next.js)
    A[app/] --> B[components/]
    A --> C[content/]
    A --> D[data/]
    A --> E[public/]
    B --> F[UI Bilesenleri]
    C --> G[Markdown Blog/Podcast]
    D --> H[TypeScript Veri Kaynaklari]
    E --> I[Statik Dosyalar]
  end
  subgraph Electron Data Panel
    J[apps/data-panel/]
    J --> K[renderer/]
    J --> L[main.cjs]
    J --> M[preload.cjs]
    K --> N[configs.js]
    J --> O[assets/]
    J --> P[Electron build scripts]
  end
  J --> D
  J --> E
  J --> C
  J --> Q[Git ile publish]
  Q --> D
  Q --> E
  Q --> C
  A -.-> E
  A -.-> D
  A -.-> C

Klasörler ve Akış

• app/: Next.js route ve sayfa yapısı
• components/: UI bileşenleri (React)
• content/: Markdown içerikler (blog, podcast)
• data/: TypeScript veri kaynakları (projeler, referanslar, eğitim vb.)
• public/: Statik dosyalar (görseller, pdf, avatar)
• apps/data-panel/: Electron tabanlı içerik yönetim paneli
  • renderer/: Panelin arayüzü ve form konfigürasyonları
  • main.cjs: Electron ana süreç, dosya ve git işlemleri
  • configs.js: Koleksiyon ve form alanı yönetimi

Akış

1. Web uygulaması Next.js ile çalışır, içerik ve veri dosyalarını okur.
2. Electron paneli ile içerik (blog/podcast), veri (data/*.ts) ve medya (public/) yönetimi yapılır.
3. Panelde yapılan değişiklikler git ile commit/push edilerek yayınlanır.
4. Paneldeki koleksiyonlar ve form alanları configs.js ile özelleştirilebilir.

Gereksinimler

• Node.js 20+
• pnpm 9+
• Git

Kurulum

pnpm install

Frontend Komutları

pnpm dev        # Next.js local
pnpm lint       # ESLint
pnpm build      # Production build
pnpm start      # Production run

Electron Data Panel Komutları

pnpm panel:dev            # Electron panel (development)
pnpm panel:clean          # apps/data-panel/dist temizle
pnpm panel:pack           # Paket test (unpacked)
pnpm panel:dist           # Tüm hedefler için distributable
pnpm panel:dist:win       # Windows NSIS installer
pnpm panel:dist:portable  # Windows portable exe

İçerik Kaynakları

• Blog markdown: content/blog/*.md
• Podcast markdown:
  • content/podcasts/yazilim/*.md
  • content/podcasts/masa-basi/*.md
• Site verileri: data/*.ts

Electron Panel Özellikleri

• Blog/podcast içeriği oluşturma-güncelleme-silme
• data/*.ts export dizilerini form tabanlı yönetme
• public/ altına medya yükleme/silme
• git add + commit + push ile yayınlama akışı

Özelleştirme ve Açık Kaynak

Dashboard tab/field özelleştirme

Paneldeki koleksiyonlar ve form alanları apps/data-panel/renderer/configs.js dosyasından yönetilir.

• Yeni tab/collection ekleyebilir
• Alan tiplerini (text, textarea, number, url) değiştirebilir
• Kart görünümünü özelleştirebilirsin

Farklı repo kökü ile çalıştırma

Panel varsayılan olarak bu monorepo kökünü kullanır. Farklı klasör için:

• Çevresel değişken: PORTFOLIO_WORKSPACE_ROOT
• veya CLI argüman: --workspace-root=<path>

Örnek (PowerShell):

$env:PORTFOLIO_WORKSPACE_ROOT = "D:\my-portfolio-repo"
pnpm panel:dev

Örnek (packaged exe):

.\apps\data-panel\dist\portfolio-data-panel-0.1.0-x64-portable.exe --workspace-root="D:\my-portfolio-repo"

Panel başlarken data, public, content/blog, content/podcasts klasörlerini doğrular.

Publish akışını değiştirme

Git publish akışı apps/data-panel/main.cjs içindeki publishChanges fonksiyonunda yönetilir. Varsayılan akış:

• git add data public content
• Otomatik/manuel commit message
• git push Branch seçimi, PR tabanlı akış veya sadece commit modları eklenebilir.

Yayın ve Kontrol Listesi

1. pnpm lint
2. pnpm build
3. İçerik/veri kontrolü (content/, data/, public/)
4. Electron panel akışı kontrolü (pnpm panel:dev)
5. Gerekirse distributable kontrolü (pnpm panel:pack / pnpm panel:dist)

Sorun Giderme

YouTube cookie/SameSite uyarıları

Embed URL'ler youtube-nocookie.com formatına çekildi. Bu değişiklik cross-site cookie kaynaklı konsol gürültüsünü azaltır. Tarayıcı güvenlik politikası nedeniyle bazı 3rd-party loglar tamamen sıfırlanamayabilir; bu durumda uygulama davranışı etkilenmez.