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) Uygulama
npm run dev # http://localhost:3000
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) |
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.