butcem/README.md

BÜTÇEM

Aile bütçesi, banka/kart/cari hesapları, birikimler (altın, döviz, ziynet), aylık bütçe, ev stoğu ve akıllı alışveriş listelerini tek yerde yöneten, çok kullanıcılı web uygulaması.

• Ürün tanımı, mimari kurallar ve faz planı: docs/PROMPT.md
• Sürüm geçmişi: CHANGELOG.md

Teknoloji

Next.js 16 (App Router, Turbopack, Cache Components) · React 19 · TypeScript (strict) · Tailwind CSS 4 · shadcn/ui (Radix) · Better Auth · MongoDB 9 (native driver + Mongoose) · zod · Vitest

Gereksinimler

• Node.js 26 (Active LTS) — nvm use (.nvmrc)
• Docker + Docker Compose (lokal MongoDB replica set)

Lokal geliştirme

# 1) Bağımlılıklar
npm install

# 2) Ortam değişkenleri — BETTER_AUTH_SECRET için: openssl rand -base64 32
cp .env.example .env.local

# 3) MongoDB (tek düğümlü replica set rs0, host portu 27019) — sağlıklı olana kadar bekler
npm run db:up

# 4) İlk admin (SEED_ADMIN_EMAIL / SEED_ADMIN_PASSWORD; kullanıcı adı: admin)
npm run seed

# 5) Uygulama
npm run dev   # http://localhost:3000 → /login

Giriş kullanıcı adı veya e-posta ile yapılır. Kayıt kapalıdır; kullanıcıları admin /admin/kullanicilar sayfasından oluşturur.

Scriptler

Komut	Açıklama
npm run dev	Geliştirme sunucusu
npm run build / start	Üretim build'i / sunucusu
npm run lint	ESLint
npm run typecheck	tsc --noEmit
npm run test	Vitest birim testleri
npm run format	Prettier
npm run db:up / db:down	Lokal MongoDB'yi başlat / durdur
npm run seed / seed:reset	Örnek veri (Faz 4)

Marka dosyaları

public/brand/: logo.svg (açık tema), logo-dark.svg (koyu tema), icon.svg (uygulama ikonu), icon-maskable.svg (Android/iOS, köşesiz). Yazı Noto Sans Bold (OFL) harf yollarıdır. İkonları değiştirdikten sonra npm run icons çalıştırın; favicon ve PWA ikonları bu kaynaklardan üretilir.

Docker imajı

docker build --build-arg APP_VERSION=$(node -p "require('./package.json').version") \
  --build-arg APP_COMMIT=$(git rev-parse --short HEAD) -t butcem .

Canlı ortam (Dokploy, butcem.ta1sph.website) kurulumu Faz 15'te docs/DEPLOY.md içinde anlatılacak.