54 lines
2.0 KiB
Markdown
54 lines
2.0 KiB
Markdown
# 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](docs/PROMPT.md)
|
||
- Sürüm geçmişi: [CHANGELOG.md](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
|
||
|
||
```bash
|
||
# 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ı
|
||
|
||
```bash
|
||
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.
|