Nexus Command Center

Proje yönetimi ve operasyon paneli. Gerçekten çalışır — mockup değil: veri modeli, durum yönetimi, kalıcılık, filtreleme, sürükle-bırak ve aktivite günlüğü dahil.

Çalıştırma

npm install
npm start

Terminalde çıkan adresi aç (örn. http://localhost:4173). Port doluysa sunucu otomatik olarak bir sonraki boş porta geçer.

Demo veriyi başlangıç haline döndürmek için:

npm run reset

Mimari

┌─────────────────────────────────────────────────────────────┐
│  Tarayıcı  (public/)                                        │
│   index.html                                                │
│   ├── js/api.js         fetch sarmalayıcı (tek hata biçimi) │
│   ├── js/state.js       istemci durumu + filtreler (LS)     │
│   ├── js/ui.js          DOM/kaçış/toast/modal/doğrulama UI  │
│   ├── js/chart.js       Canvas grafikler (harici lib YOK)   │
│   ├── js/dnd.js         HTML5 sürükle-bırak + klavye        │
│   ├── js/views/*.js     5 görünüm modülü                    │
│   └── js/app.js         denetleyici: yönlendirme + eylemler │
└──────────────────────────┬──────────────────────────────────┘
                           │  /api/*  (JSON)
┌──────────────────────────▼──────────────────────────────────┐
│  server/index.js   Express — statik + API, dinamik port     │
│   ├── src/routes/dashboard.js  /api/summary  (türetilmiş)   │
│   ├── src/routes/projects.js   /api/projects CRUD           │
│   ├── src/routes/tasks.js      /api/tasks    CRUD + move    │
│   ├── src/routes/team.js       /api/team     CRUD           │
│   ├── src/routes/activity.js   /api/activity günlük         │
│   ├── src/lib/validate.js      sunucu tarafı doğrulama      │
│   └── src/store/db.js          JSON depo (atomik yazma)     │
└──────────────────────────┬──────────────────────────────────┘
                           ▼
                    data/nexus.json

Tasarım kararları

Tek doğruluk kaynağı sunucudur. İstemci sayı uydurmaz; metrikler /api/summary'den gelir. Sayfa yenilenince her şey yeniden türetilir.

İlerleme yüzdesi türetilir, saklanmaz. Bir projenin ilerlemesi done görev sayısı / toplam görev sayısıdır (db.projectProgress). Görev taşıdığında proje ilerlemesi kendiliğinden değişir — çift veri tutarlılığı sorunu oluşmaz.

Aktivite kaydı tek noktadan düşer. Tüm mutasyonlar db.mutate() üzerinden geçer; fonksiyon hem değişikliği uygular hem günlük satırını üretir. Böylece "kaydı unutulan olay" olmaz.

Doğrulama iki katmanda. İstemci doğrulaması UX içindir (anında geri bildirim), gerçek kapı src/lib/validate.js'tedir. API'ye doğrudan kötü veri gönderilemez.

Yüzdeler null'a dayanıklı. Görevi olmayan proje %0 döner, sıfıra bölme hatası yok.

Atomik yazma. Veri önce nexus.json.tmp'ye yazılıp rename ile yerine konur; süreç yarıda kesilse bile bozuk JSON kalmaz. Bozuk dosya tespit edilirse yedeklenir ve temiz tohum veriyle başlanır.

Filtreler iki taraflı tutarlı. Arama/filtre sunucuya sorgu parametresi olarak gider; kanban ve liste görünümü aynı sonucu gösterir (iki ayrı filtre mantığı yok).

Sürükle-bırak iyimser çalışır. Kart anında taşınır, sunucu reddederse eski yerine geri döner. Klavye ile de taşınabilir: kartı seç, ← / →.

API

Yöntem	Yol	Açıklama
GET	/api/health	Servis durumu + veri sayıları
GET	/api/summary	Dashboard metrikleri, proje ilerlemeleri
GET	/api/projects	?status=&q=
POST	/api/projects	Yeni proje
PUT	/api/projects/:id	Güncelle
DELETE	/api/projects/:id	Sil (görevler "Projesiz" kalır)
GET	/api/tasks	?q=&priority=&projectId=&status=&assignee=&sort=
POST	/api/tasks	Yeni görev
PUT	/api/tasks/:id	Güncelle
PATCH	/api/tasks/:id/status	Kanban taşıma
DELETE	/api/tasks/:id	Sil
GET	/api/team	Kişi başı iş yükü ile
POST	/api/team	Üye ekle
DELETE	/api/team/:id	Üye çıkar (açık görevi varsa engellenir)
GET	/api/activity	?type=&limit=

Tüm yanıtlar { ok: true, data } veya { ok: false, error } biçimindedir.

Klavye kısayolları

• Ctrl/Cmd + N — yeni görev
• Esc — açık modalı kapat
• Kanban kartı seçili iken ← / → — kolon değiştir

Veri modeli

Project { id, name, description, status: planlandi|devam|tamamlandi,
          color, owner, deadline, createdAt }

Task    { id, title, description, priority: dusuk|orta|yuksek|kritik,
          assignee, due, status: todo|in_progress|done,
          projectId|null, createdAt, completedAt }

Member  { id, name, role, email, color }

Activity{ id, type: gorev|proje|ekip|sistem|hata,
          actor, action, detail, at }

Sınırlamalar

• Kimlik doğrulama yok — tek kullanıcılı, yerel/ekip içi kullanım için tasarlandı.
• Veri deposu tek JSON dosyası; çok yazarlı eşzamanlı kullanım için veritabanına taşınmalı (src/store/db.js arayüzü bunu kolaylaştırır).
• Aktivite günlüğü son 400 kaydı tutar (sınırsız büyümeyi engellemek için).