lab/belgeler/spec.md

# DLS — Ürün Tasarım Spec'i

Bu dosya `dls-ui-tasarim.pdf` (orijinal Figma export) baz alınarak hazırlanmış geliştirilmiş ürün spec'idir. PDF UI mock'ları içerir; bu doküman akış, veri modeli, rol ayrımı ve karar gerektiren noktaları somutlaştırır.

## Sistem özeti

DLS, **diş klinikleri** ile **diş laboratuvarları** arasındaki iş alışverişini dijitalleştirir:

- Klinik bir hasta için protez işi açar (tür, üye sayısı, renk, ölçü taraması, görseller).
- İşi bağlı bir laboratuvara yollar.
- Laboratuvar gelen kutusundan görür, durum adımlarını işler (Ölçü → Alt Yapı → Üst Yapı → Cila/Bitim).
- Tamamlandığında klinik gönderim aşamasına geçer.
- Her iki taraf finansal akışı (ödenmiş/bekleyen) kendi tarafında izler.

## Roller

Tek bir hesap modeli, iki tenant türü (`kind`):

| `kind` | İlgili eylemler |
|---|---|
| `clinic` | İş yayınla, kendi gönderdiklerini takip et, lab bağlantısı talep et, ödeme yap |
| `lab` | Ürün katalog yönet, gelen işleri al/onayla, durum güncelle, fatura kes |

`requireTenantKind(ctx, ['lab' \| 'clinic'])` server-side route guard — sayfa render edilmeden önce yetki sorgular.

## Sayfa haritası (PDF'e göre)

| URL | PDF sayfa | İçerik |
|---|---|---|
| `/dashboard` | 1 | Anasayfa — özet kartlar (açık işler, işlem bekleyen, bildirimler, istatistik chart) |
| `/jobs/inbound` | 2 | Gelen İşler tablosu (Klinik / Hasta Kodu / Üye / Renk / Tür / Açıklama / İşlem) |
| `/jobs/[id]` | 3 | İş detay — bilgiler + durum stepper (Ölçü / Alt Yapı Prova / Üst Yapı Prova / Cila/Bitim) + Görselleri Görüntüle / Taranan Dosyalar / Kaydet |
| `/jobs/outbound` | 4 | Giden İşler tablosu (aynı sütunlar) |
| `/jobs/new` | (header CTA) | "Yeni İş Yayınla" formu — klinik tarafı |
| `/products` | 5 | Eklenen Ürünler (sadece lab) — Protez Türü / Fiyat tablo + ekleme formu |
| `/finance` | 6 | Finans (Bekliyor) — tahsilat/ödeme listesi |
| `/connections` | 7 | Bağlantı Kur — kendi bağlantı kodun + bekleyen talepler + onaylı bağlantılar |
| `/settings/*` | 8 | Ayarlar (workspace, üye, hesap, görünüm) |
| `/sign-in`, `/sign-up` | 9 | Giriş/kayıt — PDF "Labaratuvar Giriş" + "Klinik Giriş" iki ayrı form gösteriyor; biz tek form + onboarding'de `kind` seçimi yapıyoruz |

> PDF'teki "Üye Numarası" alanı login'de **kullanılmıyor**. Üye numarası `tenant_settings.memberNumber` olarak sistem tarafından üretiliyor ve **bağlantı kodu** olarak işlev görüyor (PDF'teki "Bağlantı Kodu" panelinin de aynısı).

## Veri modeli (`lib/appwrite/schema.ts`)

Tüm collection'lar `tenant_settings.tenantId = Appwrite Team.$id`.

### `tenant_settings`
- `tenantId` (unique, indexed)
- `kind: 'lab' | 'clinic'`
- `memberNumber: string` (6 hane, unique, indexed) — bağlantı kodu
- `companyName`, `companyTaxId`, `companyAddress`, `companyEmail`, `companyPhone`, `logo`
- `defaultCurrency` (varsayılan `TRY`)

### `profiles`
Kullanıcı başına ek bilgi (display name, telefon, ünvan). Auth identity Appwrite Auth'tadır; ek alanlar burada.

### `connections`
İki tenant arası bağlantı.
- `clinicTenantId`, `labTenantId`
- `status: 'pending' | 'approved' | 'rejected'`
- `requestedBy`, `requestedAt`, `approvedAt?`, `rejectedAt?`
- Permission: `Role.team(clinicTenantId)` + `Role.team(labTenantId)` (her ikisi de görür)

### `jobs`
- `clinicTenantId`, `labTenantId`, `createdBy`
- `patientCode`, `prostheticType` (`metal_porselen`, `zirkonyum`, `implant_ustu_zirkonyum`, `gecici`, `e_max`, `diger`)
- `memberCount` (üye sayısı), `color` (Vita renk kodu örn. A2), `description?`, `price?`, `currency?`, `dueDate?`
- `status: 'pending' | 'in_progress' | 'sent' | 'delivered' | 'cancelled'`
- `currentStep: 'olcu' | 'alt_yapi_prova' | 'ust_yapi_prova' | 'cila_bitim'`
- Permission: `Role.team(clinicTenantId)` + `Role.team(labTenantId)`

### `job_files`
- `jobId`, `clinicTenantId`, `labTenantId`, `uploadedBy`
- `kind: 'scan' | 'image' | 'document'`
- `fileId` (Appwrite Storage bucket: `job-files`), `name`, `size`, `mimeType?`
- Permission: aynı job permission'ı

### `job_status_history`
Stepper geçişleri — denetim izi.
- `jobId`, `clinicTenantId`, `labTenantId`, `step`, `completedBy`, `completedAt`, `note?`

### `prosthetics` (lab katalog)
- `tenantId` (lab'in tenant id'si), `createdBy`
- `name`, `type`, `unitPrice`, `currency?`, `archived?`
- Permission: `Role.team(tenantId)` (sadece kendi tarafı)

### `finance_entries`
- `tenantId`, `createdBy`, `jobId?`, `counterpartTenantId?`
- `type: 'income' | 'expense' | 'receivable' | 'payable'`
- `amount`, `currency?`, `status: 'pending' | 'paid' | 'cancelled'`, `date`, `description?`
- Permission: `Role.team(tenantId)` (klinik ve lab kendi defterlerini görür; karşı taraf görmez)

### `notifications`
- `tenantId`, `userId?`, `jobId?`, `connectionId?`, `message`, `read`

### `audit_logs`, `invite_links`, `password_resets`, `user_preferences`
CRM'den birebir kullanılıyor.

## Bağlantı akışı (`connections` yaşam döngüsü)

1. **Klinik** → `/connections` → "Bağlantı talep et" → karşı tarafın `memberNumber`'ını gir.
2. Server action `connections` row yaratır (`status: pending`), her iki team'e permission açar.
3. **Lab** → `/connections` → bekleyen talepler listesinde görür → **Onayla** veya **Reddet**.
4. Onaylanırsa `status: approved`. Klinik artık `/jobs/new` formunda bu lab'i seçebilir.
5. Reddedilirse `status: rejected`, tekrar talep edilebilir.

## İş akışı (`jobs` yaşam döngüsü)

1. Klinik `/jobs/new` formuyla iş açar (lab seçimi onaylı bağlantılardan), durum `pending`.
2. Lab gelen kutusunda görür, **İşleme Al** → `status: in_progress`, `currentStep: olcu`.
3. Lab her aşamayı tamamlayınca `job_status_history` row eklenir + `currentStep` ilerler.
4. Cila/Bitim sonrası `status: sent`. Klinik teslim alınca `delivered`.
5. Tamamlandığında lab `finance_entries` (income, pending) açar; klinik tarafında (expense, pending) açılır (idempotent sync helper ile).

## Onboarding akışı

`/onboarding` sayfası:
1. Kayıt sonrası ilk girişte. Mevcut workspace'i yoksa zorunlu.
2. **Hesap türü seç** (Klinik / Lab) → state.
3. Şirket adı + opsiyonel vergi/telefon.
4. Submit → `createWorkspaceAction`:
   - Appwrite Team yarat
   - `tenant_settings` row yarat (`kind`, `memberNumber` üretilmiş)
   - Active tenant cookie + user prefs
5. Redirect `/dashboard`.

İmport akışı (cross-app team import) için de `kind` seçimi zorunlu.

## Açık tasarım kararları

- **Login formunda "Üye Numarası"** PDF'te var; biz e-posta+şifre kullanıyoruz. `memberNumber` register/login için **kullanılmaz**, sadece bağlantı kurmak için.
- **Cila/Bitim** sonrası kargo/teslim alanı PDF'te yok; spec'te `status: sent → delivered` ile temsil edildi. Kargo takip eklenirse `jobs.shipmentTracking?` opsiyonel field eklenir.
- **Finans entegrasyonu** PDF'te "Finans (Bekliyor)" başlığı dışında detay vermiyor. Spec'te `finance_entries` (income/expense/receivable/payable) ile başlattık; faturalama, ödeme provider entegrasyonu sonraki faz.
- **PDF'in "Bağlantı Kodu" tek bir kalıcı kod** olarak modellendi (`memberNumber`). Her connection için ayrı OTP/kod istenirse `connection_codes` collection eklenir.

## Yapılacaklar (oturum kapanışı sonrası)

- [ ] Appwrite MCP ile `lab` database + collection'lar (bu commit'te schema TS hazır, fiziksel oluşturma bir sonraki adım)
- [ ] `jobs` modülü (liste + form + detay)
- [ ] `connections` modülü (request/approve akışı)
- [ ] `products` modülü (lab katalog CRUD)
- [ ] `finance` modülü (cross-tenant idempotent sync helper)
- [ ] Coolify app + DNS `lab.kovakcrm.com`
- [ ] Landing page DLS'e uyarla