feat: Faz 14b - cari, birikim, alışveriş, birim fiyat ve fire raporları

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

CHANGELOG.md

@@ -6,6 +6,65 @@ Biçim [Keep a Changelog](https://keepachangelog.com/tr-TR/1.1.0/) esas alınır
 
 ## [Yayınlanmamış]
 
+## [0.14.0] - 2026-11-07
+
+Faz 14: dashboard ana grafiği ve raporlar (14a ve 14b alt fazları).
+
+### Eklendi — Faz 14b: cari, birikim, alışveriş, birim fiyat ve fire raporları
+
+- Cari ve aynî borçlar (`/raporlar/cari`): bakiyesi olan cariler (bana borçlu / ben borçluyum, vade durumu), açık aynî borç ve alacaklar kalan miktar ve güncel TL değeriyle; toplamlar.
+- Birikim kâr/zarar (`/raporlar/birikim`): varlık başına miktar, maliyet, güncel değer, gerçekleşmemiş ve gerçekleşen K/Z; son 3/6/12 ay veya tümü için dönem özeti (başlangıç değeri, yatırılan, satıştan alınan, bitiş değeri, dönem kârı).
+- Alışveriş (`/raporlar/alisveris`): tamamlanan listelerde planlanan / gerçekleşen / fark, eşleşme sayıları ve farkın nedenleri; mağaza bazlı harcama (alıcısı mağaza adıyla başlayan giderler, şubeler birlikte, "Alışverişi tamamla"dan gelen kısım ayrıca).
+- Birim fiyat geçmişi (`/raporlar/birim-fiyat`): ürün tipi seçimi, son 12 bütçe ayında aylık en düşük ve ortalama birim fiyat (grafik ve tablo), mağazalarda dönemin en düşük birim fiyatı.
+- Fire / zarar (`/raporlar/fire`): ürün tipi başına fire, alım, fire/alım oranı, nedenlere göre dağılım ve tahmini maliyet (fire × son bilinen birim fiyat).
+- Hepsinde CSV dışa aktarma; rapor ana sayfasında yeni rapor kartları.
+- Testler: mağaza adı eşleşmesi ve aylık birim fiyat özeti (birim); cari/aynî, birikim, alışveriş (tamamlanan liste dahil), birim fiyat ve fire raporları (entegrasyon).
+
+### Eklendi — Faz 14a: dashboard ana grafiği ve finans raporları
+
+- Dashboard ana çizgi grafiği: Planlanan gelir (yeşil), Planlanan gider / bütçe (mavi, kesikli), Gerçekleşen gider (kırmızı). Periyotlar: Haftalık (bu hafta, günlük), Aylık (bütçe ayı, günlük), Altı aylık ve Yıllık (bütçe ayları). Kümülatif / dönemsel görünüm; seçim URL'de (`?periyot=…&gorunum=…`). Bütçesi olmayan dönemde bütçe çizgisi boş, gelecek günlerde gerçekleşen çizilmez; grafiğin altında tablo görünümü.
+- Raporlar (`/raporlar`): bu bütçe ayının özeti (gelir, gider, net, tasarruf oranı, en çok harcanan kategoriler) ve rapor sayfaları; her raporda ay seçici ve CSV dışa aktarma (Türkçe Excel uyumlu).
+  - Kategori dağılımı: halka grafik ve tablo; üst kategori toplamları ve alt kategori kırılımı, toplam gidere oran (%14,3 gibi), önceki aya göre tutar ve yüzde değişim. Dilim renkleri kategorinin kendi rengi; 7'den fazla kategori "Diğer"de toplanır.
+  - Aylık trend: son 12 bütçe ayı gelir ve gider sütunları, ayrı grafikte tasarruf oranı (devam eden ay grafikte gösterilmez), net ve 12 ay toplamı.
+  - Kişi ve hesap bazlı: gideri kaydeden üyeye göre harcama ve pay; hesap başına gelir, gider, gelen/giden transfer ve net değişim. Başka üyelerin "yalnızca ben" hesapları hesap tablosunda hiç görünmez.
+  - Bütçe ve gerçekleşen: kategori bazında limit, gerçekleşen, kalan ve kullanım; son 6 ayın limit/gerçekleşen karşılaştırması.
+- Kurallar bütçeyle aynı: bütçe ayı, gerçekleşmiş işlemler, bölünmüş işlemler kalem bazında, taksit modu ve gizli hesap giderleri hane ayarına göre.
+- Testler: periyot aralıkları ve kümülatif dönüşüm, kategori payı/değişim/tasarruf oranı ve alt kategori kırılımı (birim); rapor toplamlarının bütçeyle tutarlılığı, gizli hesap görünürlüğü, dashboard periyotları (entegrasyon).
+
+### Değişti — Faz 14a
+
+- Dashboard'daki günlük plan kartı istatistik ve tabloya indi; kümülatif ay grafiği ana grafiğin "Aylık" görünümüne taşındı.
+- Bütçe, gelir planı ve günlük plan hesapları bağlam alan yardımcılara ayrıldı (raporlarda birden çok ay için yeniden kullanılır).
+
+## [0.13.0] - 2026-11-06
+
+Faz 13: alışveriş listeleri, akıllı mağaza önerisi, alışveriş modu ve alışveriş sonrası giriş (13a ve 13b alt fazları).
+
+### Eklendi — Faz 13b: alışveriş sonrası giriş, karşılaştırma ve "Alışverişi tamamla"
+
+- Alışveriş sonrası giriş (`/alisveris/:id/tamamla`): liste kalemleri tek tek işaretlenir; her biri için alınan ürün (aynı ya da aynı ürün tipinden muadil; ürün tipi kaleminde marka belirtmeden de), mağaza, paket adedi ve ödenen tutar. Tutar, bilinen paket fiyatıyla ön doldurulur. Listede olmayan ekstra ürünler eklenebilir. Mağaza başına ödeme hesabı (yemek kartı geçen mağazada uygun yemek kartı önseçili) ve fiş görselleri.
+- "Alışverişi tamamla" tek MongoDB transaction'ı: stok alım hareketleri, fiyat kayıtları (kaynak `receipt`; ürün × mağaza başına, paket fiyatı = tutar / paket), mağaza başına bölünmüş gider işlemi (kalemler stok kategorisinin eşlendiği gider kategorisine; eşlenmemiş ve serbest metin kalemleri seçilen yedek kategoriye), fiş görselleri işlemin eki, alınmayanların taşınması ve listenin kapanması. Herhangi bir adım başarısızsa hiçbir şey yazılmaz.
+- Alınmayanlar: başka aktif listeye taşı, yeni liste aç ya da bırak.
+- Karşılaştırma raporu (tamamlanan listede): planlanan (tamamlama anındaki akıllı öneri) vs. gerçekleşen tutar ve fark; farkın nedenleri (aynı üründe fiyat farkı, miktar farkı, muadil, alınmayanlar, plansız ekstralar, planda fiyatı olmayanlar; toplamları farka eşit); kalem bazında Aynı / Muadil / Alınmadı / Plansız ekstra; mağaza giderleri ve kullanılan hesaplar. Etiketler tamamlama anındaki hâliyle saklanır.
+- Liste sayfasında ve alışveriş modunda "Alışverişi tamamla" düğmesi.
+- Stok hareketleri ve işlemlerde `shoppingListId` (kaynağı izlemek için).
+- Testler: eşleşme ve fark ayrıştırması (birim); tamamlama ekranı verisi, doğrulamalar (muadil tipi, gelecek tarih, izleyici), ek dosya hatasında geri alma, stok/fiyat/mağaza başına bölünmüş gider, markasız kalem, kalanların taşınması ve rapor (entegrasyon).
+
+### Eklendi — Faz 13a: alışveriş listeleri, stok önerileri, akıllı mağaza önerisi, alışveriş modu
+
+- Alışveriş listeleri (`shoppingLists`, `/alisveris`): birden çok aktif liste; kalem olarak ürün tipi (genel), belirli ürün (marka/paket) ya da serbest metin. Miktar ürün tipinde tipin biriminde, üründe paket adedi; boşsa en az bir paket. Aynı ürün listede iki kez olamaz; kalem düzenleme, çıkarma ve başka aktif listeye taşıma. Liste silme soft delete ve denetim kaydı. Aile üyeleri aynı listeyi kullanır: sayfa odaklanınca ve 30 saniyede bir yenilenir.
+- Stok eşiği önerileri: eşiğin altındaki ürün tipleri hiçbir aktif listede yoksa liste sayfasında onayla/reddet önerisi olarak gelir (fire ayarlı önerilen miktar ve nedeni). Onaylanan önerilen miktarla eklenir ("Stok önerisi" rozeti), "Tümünü ekle" ile toplu. Reddedilen öneri, ürün için yeni alım girilene (stok yenilenene) kadar gösterilmez.
+- Akıllı mağaza önerisi (saf fonksiyon, birim testli): son bilinen fiyatlarla her kalem için mağaza ve marka; ihtiyacı karşılayan paket sayısı × paket fiyatı. Fiziksel mağaza ziyareti ve hacimli kalemler için zahmet skoruna bağlı maliyet cezası, online teslimat ücreti ve ücretsiz teslimat alt limiti, yemek kartı önceliği (kartın geçtiği mağazada kartla ödenebilecek tutar avantajlı sayılır; bakiye mağazalar arasında bir kez harcanır). En az mağazalı eksiksiz plandan başlanır; ek mağaza ancak tasarruf hane ayarındaki eşiği aşarsa eklenir. Çıktı: "Tek mağaza en iyi seçenek: X" ya da "Önerilen dağılım: A (7 ürün), B (3 ürün): Y (Z tasarruf)"; önerilen ve tek mağaza dağılımları, fiyatı bilinmeyen kalemler.
+- Alışveriş modu (`/alisveris/:id/mod`): plana göre mağazaya gruplanmış, büyük dokunma alanlı kontrol listesi; "sepete alındı" işareti anında görünür ve kaydedilir, ilerleme çubuğu; önerilen / tek mağaza planı arasında geçiş.
+- Ürün tipine "Ağır / hacimli" işareti (akıllı öneride taşıma cezası).
+- Dashboard'da "Alışveriş" kartı (aktif listeler ve bekleyen öneri sayısı); stok sayfasındaki "Alınması önerilenler" alışveriş listelerine bağlanır. Kenar menüde "Alışveriş".
+- Migration `015-shopping-lists`. Seed: "Haftalık market" (9 kalem: tip, marka, serbest metin, fiyatı olmayan domates) ve "Ay sonu toptan" listeleri; deterjan, yumuşatıcı, çamaşır suyu ve tuvalet kağıdı hacimli.
+- Testler: planlayıcı (paket yuvarlama, marka kısıtı, eşik, eksik kapsama, zahmet ve hacimli cezası, teslimat, yemek kartı), miktar ve öneri reddi kuralları (birim); liste/kalem işlemleri, yetki, öneri onay/red, plan çıktısı, silme ve denetim (entegrasyon).
+
+### Değişti — Faz 13a
+
+- Fiyat servisinde ürün tipi teklifleri ortak yükleyicide (`loadTypeOffers`); tüketim analizindeki son birim fiyat da bunu kullanır.
+
 ## [0.12.0] - 2026-11-06
 
 Faz 12: mağazalar, ürünler, fiyatlar ve birim fiyat (12a ve 12b alt fazları).

docs/PROMPT.md

@@ -324,6 +324,8 @@ Aşağıdakileri varsayılan olarak kabul ettim. Faz 0'da yalnızca bunlardan em
 - **Faz 10 kararları (2026-11-06):** 10a aylık bütçe, 10b gelir planı ve günlük plan; `v0.10.0` 10b sonunda. Limit her gider kategorisine verilebilir; üst kategori limiti alt kategorileri kapsar, alt kategori limiti üstün içinde alt sınırdır (toplamda iki kez sayılmaz). Başkasının "yalnızca ben" hesabından yapılan harcama hane ayarına (gizli hesapları toplamlara kat) göre yalnızca tutar olarak bütçeye girer.
 - **Faz 11 kararları (2026-11-06):** 11a stok kategorileri, ürün tipleri, hareketler, SKT ve %20 eşik; 11b periyodik sayım, fire ayarlı öneri ve tüketim analizi; `v0.11.0` 11b sonunda. Eşiğin altındaki ürünler Faz 11'de "Alınması önerilenler" listesinde gösterilir (koleksiyon yok); Faz 13'te aktif alışveriş listesine onayla/reddet önerisi olarak bağlanır. SKT alım hareketinde (isteğe bağlı) girilir; tüketim ve fire FIFO ile en eski alımdan düşülür.
 - **Faz 12 kararları (2026-11-06):** 12a mağazalar ve ürünler (marka/paket, görseller), 12b fiyat kayıtları, birim fiyat ve fiyat geçmişi; `v0.12.0` 12b sonunda. Mağazalar, ürünler ve fiyatlar hane bazlıdır (hane içinde ortak, başka hane görmez). Paket birimi ürün tipinin birimine kendiliğinden çevrilemiyorsa ürün kaydında dönüşüm zorunludur ("5 kg = 33 yıkama"); her fiyat ürün tipinin biriminde karşılaştırılır.
+- **Faz 13 kararları (2026-11-06):** 13a alışveriş listeleri, stok eşiği önerileri (onayla/reddet), akıllı mağaza önerisi ve alışveriş modu; 13b alışveriş sonrası giriş, karşılaştırma raporu ve "Alışverişi tamamla"; `v0.13.0` 13b sonunda. Birden çok mağazadan alışverişte mağaza başına ayrı bölünmüş gider (her mağaza için ayrı hesap ve fiş). Tamamlanınca liste kapanır ve rapor sabitlenir; alınmayanlar başka aktif listeye taşınır, yeni listeye alınır ya da bırakılır. Reddedilen öneri yeni alım girilene kadar gösterilmez. Markası belirtilmeyen ürün tipi kalemi (ör. pazardan domates) tipin biriminde stoğa işlenir, fiyat kaydı oluşmaz.
+- **Faz 14 kararları (2026-11-07):** 14a dashboard ana grafiği (Haftalık/Aylık/Altı aylık/Yıllık, kümülatif/dönemsel) ve finans raporları (kategori dağılımı, aylık trend, kişi ve hesap bazlı, bütçe vs. gerçekleşen); 14b cari ve aynî borçlar, birikim kâr/zarar, alışveriş (liste vs. gerçekleşen, mağaza bazlı harcama), birim fiyat geçmişi, fire/zarar; `v0.14.0` 14b sonunda. Raporlar `/raporlar` altında ayrı sayfalar; dönem ve filtreler URL'de, her raporda CSV. "Ay" bütçe ayıdır; gider kuralları bütçeyle aynı (taksit modu, gizli hesap ayarı). Kişi bazlı harcama gideri kaydeden üyeye göre; mağaza bazlı harcama gider alıcısının mağaza adıyla başlamasına göre (şubeler birlikte).
 - **Lokal MongoDB portu:** host'ta `27019` (27017 ve 27018 geliştirme makinesinde dolu). `BUTCEM_MONGO_PORT` ile değiştirilebilir.
 
 ---

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "butcem",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "butcem",
-      "version": "0.12.0",
+      "version": "0.14.0",
       "dependencies": {
         "@hookform/resolvers": "^7.0.2",
         "@tanstack/react-table": "^9.3.1",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "butcem",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "private": true,
   "description": "BÜTÇEM — aile bütçe, cari, birikim, ev stoğu ve akıllı alışveriş uygulaması",
   "engines": {

scripts/migrations/015-shopping-lists.ts

@@ -0,0 +1,10 @@
+import { ShoppingListModel } from "@/models/shopping-list";
+import type { Migration } from "./types";
+
+export const migration: Migration = {
+  name: "015-shopping-lists",
+  description: "alışveriş listeleri (shoppingLists) index'leri",
+  async up() {
+    await ShoppingListModel.createIndexes();
+  },
+};

scripts/migrations/index.ts

@@ -14,6 +14,7 @@ import { migration as m011 } from "./011-stock";
 import { migration as m012 } from "./012-stock-counts";
 import { migration as m013 } from "./013-stores-products";
 import { migration as m014 } from "./014-product-prices";
+import { migration as m015 } from "./015-shopping-lists";
 import type { Migration } from "./types";
 
 /** Sıralı migration listesi. Yeni migration: dosyayı ekle ve buraya sırayla ekle. */
@@ -32,6 +33,7 @@ export const MIGRATIONS: Migration[] = [
   m012,
   m013,
   m014,
+  m015,
 ];
 
 const COLLECTION = "migrations";

scripts/seed/run.int.test.ts

@@ -61,6 +61,7 @@ describe("seed", () => {
       stores: 0,
       products: 0,
       prices: 0,
+      shoppingLists: 0,
     });
     expect(await getDb().collection("user").countDocuments()).toBe(SEED_USERS.length + 1);
     expect(await HouseholdModel.countDocuments()).toBe(SEED_HOUSEHOLDS.length);

scripts/seed/run.ts

@@ -13,7 +13,7 @@ import { runMigrations } from "../migrations";
 import { seedContacts } from "./contacts";
 import { seedAssets } from "./assets";
 import { seedBudgets } from "./budgets";
-import { seedProductPrices, seedShopping } from "./shopping";
+import { seedProductPrices, seedShopping, seedShoppingLists } from "./shopping";
 import { seedStock } from "./stock";
 import { seedInKind } from "./in-kind";
 import { seedInstallments } from "./installments";
@@ -61,6 +61,7 @@ export type SeedSummary = {
     stores: number;
     products: number;
     prices: number;
+    shoppingLists: number;
   };
   accounts: SeedAccountRow[];
 };
@@ -91,6 +92,7 @@ const DOMAIN_COLLECTIONS = [
   "stores",
   "products",
   "productPrices",
+  "shoppingLists",
 ];
 
 type AuthApi = ReturnType<typeof getAuth>["api"];
@@ -150,6 +152,7 @@ export async function runSeed({
       stores: 0,
       products: 0,
       prices: 0,
+      shoppingLists: 0,
     },
     accounts: [],
   };
@@ -341,6 +344,9 @@ export async function runSeed({
     log(`✓ Örnek mağazalar ve ürünler: ${shopping.stores} / ${shopping.products}`);
   summary.created.prices = await seedProductPrices(householdIds, userIdMap);
   if (summary.created.prices) log(`✓ Örnek ürün fiyatları: ${summary.created.prices}`);
+  summary.created.shoppingLists = await seedShoppingLists(householdIds, userIdMap);
+  if (summary.created.shoppingLists)
+    log(`✓ Örnek alışveriş listeleri: ${summary.created.shoppingLists}`);
 
   // 7) Geliştirme hesapları tablosu
   const all = [

scripts/seed/shopping.ts

@@ -2,6 +2,7 @@ import { Types } from "mongoose";
 import { ProductModel } from "@/models/product";
 import { ProductPriceModel } from "@/models/product-price";
 import { ProductTypeModel } from "@/models/product-type";
+import { ShoppingListModel } from "@/models/shopping-list";
 import { StoreModel } from "@/models/store";
 import type { MealCardProvider } from "@/shared/accounts";
 import { autoConvertible } from "@/shared/products";
@@ -492,3 +493,88 @@ export async function seedProductPrices(
   if (docs.length) await ProductPriceModel.collection.insertMany(docs);
   return docs.length;
 }
+
+type SeedListItem =
+  | { type: string; qty?: number }
+  | { product: string; qty?: number }
+  | { text: string; qty?: number; unit?: string; note?: string };
+
+/**
+ * Örnek alışveriş listeleri (Faz 13). Eşiğin altındaki ürünler (mercimek, tablet deterjan, diş
+ * macunu) listelere eklenmez; liste sayfasında öneri olarak görünür. Domatesin fiyatı yok:
+ * akıllı öneride "fiyatı bilinmeyen" örneği.
+ */
+const SHOPPING_LISTS: { ref: string; name: string; note?: string; items: SeedListItem[] }[] = [
+  {
+    ref: "haftalik",
+    name: "Haftalık market",
+    items: [
+      { type: "sut", qty: 4 * K },
+      { type: "yumurta", qty: 30 * K },
+      { type: "pirinc", qty: 2_500 },
+      { type: "beyaz-peynir", qty: 500 },
+      { type: "domates", qty: 2 * K },
+      { type: "toz-deterjan", qty: 40 * K },
+      { type: "tuvalet-kagidi", qty: 32 * K },
+      { product: "yumos-1440", qty: 1 * K },
+      { text: "Doğum günü mumu", qty: 1 * K, unit: "paket", note: "Rakam mum: 7" },
+    ],
+  },
+  {
+    ref: "ay-sonu",
+    name: "Ay sonu toptan",
+    note: "Metro'ya arabayla.",
+    items: [{ type: "camasir-suyu", qty: 4 * K }],
+  },
+];
+
+export async function seedShoppingLists(
+  householdIds: Map<string, Types.ObjectId>,
+  users: Map<string, string>,
+): Promise<number> {
+  const actor = new Types.ObjectId(users.get("ayse")!);
+  const householdId = householdIds.get("Çakır Ailesi")!;
+  const [types, products] = await Promise.all([
+    ProductTypeModel.find({ householdId, seedRef: { $type: "string" } })
+      .select({ seedRef: 1 })
+      .lean<{ _id: Types.ObjectId; seedRef: string }[]>(),
+    ProductModel.find({ householdId, seedRef: { $type: "string" } })
+      .select({ seedRef: 1 })
+      .lean<{ _id: Types.ObjectId; seedRef: string }[]>(),
+  ]);
+  const typeByRef = new Map(types.map((x) => [x.seedRef, x._id]));
+  const productByRef = new Map(products.map((x) => [x.seedRef, x._id]));
+  let created = 0;
+  for (const l of SHOPPING_LISTS) {
+    if (await ShoppingListModel.exists({ householdId, seedRef: l.ref })) continue;
+    const items = l.items.flatMap((i): Record<string, unknown>[] => {
+      const common = {
+        _id: new Types.ObjectId(),
+        quantity: i.qty ?? null,
+        source: "manual",
+        addedBy: actor,
+        addedAt: new Date(),
+      };
+      if ("type" in i) {
+        const id = typeByRef.get(i.type);
+        return id ? [{ ...common, kind: "type", productTypeId: id }] : [];
+      }
+      if ("product" in i) {
+        const id = productByRef.get(i.product);
+        return id ? [{ ...common, kind: "product", productId: id }] : [];
+      }
+      return [{ ...common, kind: "text", text: i.text, unit: i.unit ?? "", note: i.note ?? "" }];
+    });
+    await ShoppingListModel.create({
+      householdId,
+      name: l.name,
+      note: l.note ?? "",
+      items,
+      seedRef: l.ref,
+      createdBy: actor,
+      updatedBy: actor,
+    });
+    created++;
+  }
+  return created;
+}

scripts/seed/stock.ts

@@ -33,6 +33,8 @@ type SeedProduct = {
   waste?: { every: number; pct: number; reason: "spoiled" | "expired" | "damaged" };
   /** Bu günden (gün önce) sonra yeniden alınmaz: bugün azalmış görünür. */
   stopRefillDaysAgo?: number;
+  /** Ağır/hacimli (akıllı öneride taşıma cezası). */
+  bulky?: boolean;
   /** Her n. sayımda küçük eksik (−%, hedefin yüzdesi). */
   countDrift?: { everyCounts: number; pct: number };
 };
@@ -184,6 +186,7 @@ export const PRODUCTS: SeedProduct[] = [
   },
   {
     ref: "toz-deterjan",
+    bulky: true,
     category: "genel-temizlik.camasir",
     name: "Toz Deterjan",
     unit: "yıkama",
@@ -195,6 +198,7 @@ export const PRODUCTS: SeedProduct[] = [
   },
   {
     ref: "yumusatici",
+    bulky: true,
     category: "genel-temizlik.camasir",
     name: "Yumuşatıcı",
     unit: "lt",
@@ -206,6 +210,7 @@ export const PRODUCTS: SeedProduct[] = [
   },
   {
     ref: "camasir-suyu",
+    bulky: true,
     category: "genel-temizlik.genel",
     name: "Çamaşır Suyu",
     unit: "lt",
@@ -217,6 +222,7 @@ export const PRODUCTS: SeedProduct[] = [
   },
   {
     ref: "tuvalet-kagidi",
+    bulky: true,
     category: "genel-temizlik.genel",
     name: "Tuvalet Kağıdı",
     unit: "rulo",
@@ -359,7 +365,15 @@ export async function seedStock(
   const today = todayIstanbul();
   let created = 0;
   for (const p of PRODUCTS) {
-    if (await ProductTypeModel.exists({ householdId, seedRef: p.ref })) continue;
+    if (await ProductTypeModel.exists({ householdId, seedRef: p.ref })) {
+      // Faz 13 öncesi seed'lenmiş veritabanında hacimli işaretini tamamla.
+      if (p.bulky)
+        await ProductTypeModel.updateOne(
+          { householdId, seedRef: p.ref, bulky: { $exists: false } },
+          { $set: { bulky: true } },
+        );
+      continue;
+    }
     const doc = await ProductTypeModel.create({
       householdId,
       categoryId: catByKey.get(p.category)!,
@@ -370,6 +384,7 @@ export async function seedStock(
       thresholdPct: p.threshold ?? 20,
       location: p.location,
       step: p.step ?? K,
+      bulky: p.bulky ?? false,
       seedRef: p.ref,
       createdBy: actor,
       updatedBy: actor,

src/app/(app)/alisveris/[id]/mod/page.tsx

@@ -0,0 +1,22 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { ShoppingModeView } from "@/features/shopping/components/shopping-mode";
+import { getShoppingList } from "@/features/shopping/service";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+
+export const metadata: Metadata = { title: tr.shopping.mode.title };
+
+/** /alisveris/:id/mod — alışverişe çıkış: mağazaya göre gruplu kontrol listesi. */
+export default async function ShoppingModePage({
+  params,
+  searchParams,
+}: PageProps<"/alisveris/[id]/mod">) {
+  const { user, household } = await requireActiveHousehold("viewer");
+  const [{ id }, query] = await Promise.all([params, searchParams]);
+  const data = await getShoppingList(user.id, household.id, id);
+  if (!data) notFound();
+  return (
+    <ShoppingModeView data={data} choice={query.plan === "single" ? "single" : "recommended"} />
+  );
+}

src/app/(app)/alisveris/[id]/page.tsx

@@ -0,0 +1,17 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { ShoppingListDetailView } from "@/features/shopping/components/list-detail";
+import { getShoppingList } from "@/features/shopping/service";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+
+export const metadata: Metadata = { title: tr.shopping.title };
+
+/** /alisveris/:id — liste kalemleri, stok önerileri ve akıllı mağaza önerisi. */
+export default async function ShoppingListPage({ params }: PageProps<"/alisveris/[id]">) {
+  const { user, household } = await requireActiveHousehold("viewer");
+  const { id } = await params;
+  const data = await getShoppingList(user.id, household.id, id);
+  if (!data) notFound();
+  return <ShoppingListDetailView data={data} />;
+}

src/app/(app)/alisveris/[id]/tamamla/page.tsx

@@ -0,0 +1,19 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { CompletionForm } from "@/features/shopping/components/completion-form";
+import { getCompletionSheet } from "@/features/shopping/completion";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+
+export const metadata: Metadata = { title: tr.shopping.complete.title };
+
+/** /alisveris/:id/tamamla — alışveriş sonrası giriş: alınanlar, ödeme, fiş, alınmayanlar. */
+export default async function CompleteShoppingPage({
+  params,
+}: PageProps<"/alisveris/[id]/tamamla">) {
+  const { user, household } = await requireActiveHousehold("member");
+  const { id } = await params;
+  const sheet = await getCompletionSheet(user.id, household.id, id);
+  if (!sheet) notFound();
+  return <CompletionForm sheet={sheet} />;
+}

src/app/(app)/alisveris/page.tsx

@@ -0,0 +1,30 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { PageHeader } from "@/components/page-header";
+import { ShoppingListsView } from "@/features/shopping/components/lists-view";
+import { listShoppingLists } from "@/features/shopping/service";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+
+export const metadata: Metadata = { title: tr.shopping.title };
+
+/** /alisveris — aktif ve tamamlanan alışveriş listeleri. */
+export default async function ShoppingPage() {
+  const { user, household } = await requireActiveHousehold("viewer");
+  const data = await listShoppingLists(user.id, household.id);
+  if (!data) notFound();
+  return (
+    <>
+      <PageHeader title={tr.shopping.title} description={tr.shopping.description} />
+      {!data.canWrite ? (
+        <p className="text-sm text-muted-foreground">{tr.shopping.readOnly}</p>
+      ) : null}
+      <ShoppingListsView
+        active={data.active}
+        completed={data.completed}
+        suggestions={data.suggestions}
+        canWrite={data.canWrite}
+      />
+    </>
+  );
+}

src/app/(app)/dashboard/page.tsx

@@ -3,6 +3,8 @@ import Link from "next/link";
 import { Suspense } from "react";
 import { PageHeader } from "@/components/page-header";
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
+import { Skeleton } from "@/components/ui/skeleton";
+import { OverviewCard } from "@/features/dashboard/components/overview-card";
 import { SummaryCardsSkeleton } from "@/features/dashboard/components/summary-cards-skeleton";
 import { DailyPlanCard } from "@/features/budgets/components/daily-plan-card";
 import { BudgetWarningBanner } from "@/features/budgets/components/warning-banner";
@@ -11,6 +13,7 @@ import { getBudget } from "@/features/budgets/service";
 import { ContactsDueBanner } from "@/features/contacts/components/due-banner";
 import { getNetWorth } from "@/features/net-worth/service";
 import { OverdueBanner } from "@/features/recurring/components/overdue-banner";
+import { ShoppingCard } from "@/features/shopping/components/shopping-card";
 import { LowStockCard } from "@/features/stock/components/low-stock-card";
 import { tr } from "@/i18n/tr";
 import { requireActiveHousehold } from "@/lib/dal";
@@ -83,7 +86,7 @@ async function SummaryCards({ userId, householdId }: { userId: string; household
   );
 }
 
-export default async function DashboardPage() {
+export default async function DashboardPage({ searchParams }: PageProps<"/dashboard">) {
   const { user, household } = await requireActiveHousehold("viewer");
   return (
     <>
@@ -103,12 +106,20 @@ export default async function DashboardPage() {
       <Suspense fallback={<SummaryCardsSkeleton />}>
         <SummaryCards userId={user.id} householdId={household.id} />
       </Suspense>
+      <Suspense fallback={<Skeleton className="h-96 rounded-xl" />}>
+        <OverviewCard userId={user.id} householdId={household.id} searchParams={searchParams} />
+      </Suspense>
       <Suspense fallback={null}>
         <DailyPlanCard userId={user.id} householdId={household.id} />
       </Suspense>
-      <Suspense fallback={null}>
-        <LowStockCard userId={user.id} householdId={household.id} />
-      </Suspense>
+      <div className="grid gap-4 lg:grid-cols-2 lg:items-start">
+        <Suspense fallback={null}>
+          <LowStockCard userId={user.id} householdId={household.id} />
+        </Suspense>
+        <Suspense fallback={null}>
+          <ShoppingCard userId={user.id} householdId={household.id} />
+        </Suspense>
+      </div>
     </>
   );
 }

src/app/(app)/raporlar/alisveris/csv/route.ts

@@ -0,0 +1,47 @@
+import { csvContext, csvPct, csvResponse, forbidden, unauthorized } from "@/features/reports/csv";
+import { getShoppingReport } from "@/features/reports/extra";
+import { tr } from "@/i18n/tr";
+import { csvMoney, toCsv } from "@/shared/csv";
+import { todayIstanbul } from "@/shared/dates";
+import { parsePeriod } from "@/shared/reports";
+
+/** GET /raporlar/alisveris/csv?donem=3|6|12&tablo=listeler|magazalar */
+export async function GET(request: Request) {
+  const c = await csvContext(request);
+  if (!c) return unauthorized();
+  const r = await getShoppingReport(c.userId, c.householdId, parsePeriod(c.params.get("donem")));
+  if (!r) return forbidden();
+  const h = tr.reports.csvHeaders;
+  const today = todayIstanbul();
+  if (c.params.get("tablo") === "magazalar")
+    return csvResponse(
+      toCsv(
+        h.stores,
+        r.stores.map((s) => [
+          s.name,
+          csvMoney(s.amountMinor),
+          s.count,
+          csvPct(s.sharePct),
+          csvMoney(s.fromListsMinor),
+        ]),
+      ),
+      tr.reports.csvFiles.stores(today),
+    );
+  return csvResponse(
+    toCsv(
+      h.lists,
+      r.lists.map((l) => [
+        l.date,
+        l.name,
+        csvMoney(l.summary.plannedMinor),
+        csvMoney(l.summary.actualMinor),
+        csvMoney(l.summary.diffMinor),
+        l.summary.counts.same,
+        l.summary.counts.substitute,
+        l.summary.counts.skipped,
+        l.summary.counts.extra,
+      ]),
+    ),
+    tr.reports.csvFiles.lists(today),
+  );
+}

src/app/(app)/raporlar/alisveris/page.tsx

@@ -0,0 +1,57 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import {
+  CsvButton,
+  RangeNav,
+  ReportFrame,
+  ToolsEnd,
+} from "@/features/reports/components/report-frame";
+import { ShoppingReportView } from "@/features/reports/components/shopping-waste-view";
+import { getShoppingReport } from "@/features/reports/extra";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+import { parsePeriod, REPORT_PERIODS } from "@/shared/reports";
+
+const t = tr.reports.shopping;
+export const metadata: Metadata = { title: t.title };
+
+/** /raporlar/alisveris?donem=3|6|12 — liste vs. gerçekleşen, mağaza bazlı harcama. */
+export default async function ShoppingReportPage({
+  searchParams,
+}: PageProps<"/raporlar/alisveris">) {
+  const { user, household } = await requireActiveHousehold("viewer");
+  const period = parsePeriod((await searchParams).donem);
+  const data = await getShoppingReport(user.id, household.id, period);
+  if (!data) notFound();
+  return (
+    <ReportFrame
+      title={t.title}
+      description={t.description}
+      tools={
+        <>
+          <RangeNav
+            path="/raporlar/alisveris"
+            label={tr.reports.periodLabel}
+            value={String(period)}
+            options={REPORT_PERIODS.map((p) => ({
+              value: String(p),
+              label: tr.reports.periods[p]!,
+            }))}
+          />
+          <ToolsEnd>
+            <CsvButton
+              href={`/raporlar/alisveris/csv?donem=${period}&tablo=listeler`}
+              label={t.csvLists}
+            />
+            <CsvButton
+              href={`/raporlar/alisveris/csv?donem=${period}&tablo=magazalar`}
+              label={t.csvStores}
+            />
+          </ToolsEnd>
+        </>
+      }
+    >
+      <ShoppingReportView data={data} />
+    </ReportFrame>
+  );
+}

src/app/(app)/raporlar/birikim/csv/route.ts

@@ -0,0 +1,31 @@
+import { REPORT_RANGES, type ReportRange } from "@/features/assets/service";
+import { csvContext, csvResponse, forbidden, unauthorized } from "@/features/reports/csv";
+import { getAssetsReport } from "@/features/reports/extra";
+import { tr } from "@/i18n/tr";
+import { formatAssetQuantity } from "@/shared/assets";
+import { csvMoney, toCsv } from "@/shared/csv";
+import { todayIstanbul } from "@/shared/dates";
+
+/** GET /raporlar/birikim/csv — varlık başına maliyet, değer ve kâr/zarar. */
+export async function GET(request: Request) {
+  const c = await csvContext(request);
+  if (!c) return unauthorized();
+  const q = c.params.get("donem");
+  const range: ReportRange = REPORT_RANGES.includes(q as ReportRange) ? (q as ReportRange) : "6";
+  const r = await getAssetsReport(c.userId, c.householdId, range);
+  if (!r) return forbidden();
+  return csvResponse(
+    toCsv(
+      tr.reports.csvHeaders.assets,
+      r.items.map((a) => [
+        a.name || a.label,
+        formatAssetQuantity(a.assetKey, a.summary.quantity),
+        csvMoney(a.summary.costMinor),
+        a.summary.currentValueMinor === null ? "" : csvMoney(a.summary.currentValueMinor),
+        a.summary.unrealizedMinor === null ? "" : csvMoney(a.summary.unrealizedMinor),
+        csvMoney(a.summary.realizedMinor),
+      ]),
+    ),
+    tr.reports.csvFiles.assets(todayIstanbul()),
+  );
+}

src/app/(app)/raporlar/birikim/page.tsx

@@ -0,0 +1,46 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { AssetsReportView } from "@/features/reports/components/contacts-assets-view";
+import {
+  CsvButton,
+  RangeNav,
+  ReportFrame,
+  ToolsEnd,
+} from "@/features/reports/components/report-frame";
+import { getAssetsReport } from "@/features/reports/extra";
+import { REPORT_RANGES, type ReportRange } from "@/features/assets/service";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+
+const t = tr.reports.assets;
+export const metadata: Metadata = { title: t.title };
+
+/** /raporlar/birikim?donem=3|6|12|tum — varlık kâr/zarar ve dönem özeti. */
+export default async function AssetsReportPage({ searchParams }: PageProps<"/raporlar/birikim">) {
+  const { user, household } = await requireActiveHousehold("viewer");
+  const q = (await searchParams).donem;
+  const range: ReportRange = REPORT_RANGES.includes(q as ReportRange) ? (q as ReportRange) : "6";
+  const data = await getAssetsReport(user.id, household.id, range);
+  if (!data) notFound();
+  return (
+    <ReportFrame
+      title={t.title}
+      description={t.description}
+      tools={
+        <>
+          <RangeNav
+            path="/raporlar/birikim"
+            label={tr.reports.periodLabel}
+            value={range}
+            options={REPORT_RANGES.map((r) => ({ value: r, label: t.ranges[r]! }))}
+          />
+          <ToolsEnd>
+            <CsvButton href="/raporlar/birikim/csv" />
+          </ToolsEnd>
+        </>
+      }
+    >
+      <AssetsReportView data={data} />
+    </ReportFrame>
+  );
+}

src/app/(app)/raporlar/birim-fiyat/csv/route.ts

@@ -0,0 +1,30 @@
+import { csvContext, csvResponse, forbidden, unauthorized } from "@/features/reports/csv";
+import { getUnitPriceReport } from "@/features/reports/extra";
+import { tr } from "@/i18n/tr";
+import { csvMoney, toCsv } from "@/shared/csv";
+import { todayIstanbul } from "@/shared/dates";
+import { unitPriceBase } from "@/shared/prices";
+
+/** GET /raporlar/birim-fiyat/csv?tip=<ürün tipi> — ay başına en düşük ve ortalama (gösterim biriminde). */
+export async function GET(request: Request) {
+  const c = await csvContext(request);
+  if (!c) return unauthorized();
+  const r = await getUnitPriceReport(c.userId, c.householdId, c.params.get("tip") ?? undefined);
+  if (!r?.selected) return forbidden();
+  const sel = r.selected;
+  const base = unitPriceBase(sel.unit);
+  const money = (x: number | null) => (x === null ? "" : csvMoney(Math.round(x * base.factor)));
+  const header = tr.reports.csvHeaders.unitPrice.map((h, i) =>
+    i === 1 || i === 2 ? `${h} (TL/${base.unit})` : h,
+  );
+  return csvResponse(
+    toCsv(
+      header,
+      sel.points.map((p) => [p.month, money(p.minMinor), money(p.avgMinor), p.count]),
+    ),
+    tr.reports.csvFiles.unitPrice(
+      sel.name.toLocaleLowerCase("tr-TR").replace(/\s+/g, "-"),
+      todayIstanbul(),
+    ),
+  );
+}

src/app/(app)/raporlar/birim-fiyat/page.tsx

@@ -0,0 +1,39 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { CsvButton, ReportFrame, ToolsEnd } from "@/features/reports/components/report-frame";
+import { UnitPriceView } from "@/features/reports/components/unit-price-view";
+import { getUnitPriceReport } from "@/features/reports/extra";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+
+const t = tr.reports.unitPrice;
+export const metadata: Metadata = { title: t.title };
+
+/** /raporlar/birim-fiyat?tip=<ürün tipi> — aylık en düşük ve ortalama birim fiyat. */
+export default async function UnitPriceReportPage({
+  searchParams,
+}: PageProps<"/raporlar/birim-fiyat">) {
+  const { user, household } = await requireActiveHousehold("viewer");
+  const tip = (await searchParams).tip;
+  const data = await getUnitPriceReport(
+    user.id,
+    household.id,
+    typeof tip === "string" ? tip : undefined,
+  );
+  if (!data) notFound();
+  return (
+    <ReportFrame
+      title={t.title}
+      description={t.description}
+      tools={
+        data.selected ? (
+          <ToolsEnd>
+            <CsvButton href={`/raporlar/birim-fiyat/csv?tip=${data.selected.id}`} />
+          </ToolsEnd>
+        ) : undefined
+      }
+    >
+      <UnitPriceView data={data} />
+    </ReportFrame>
+  );
+}

src/app/(app)/raporlar/butce/csv/route.ts

@@ -0,0 +1,23 @@
+import { csvContext, csvPct, csvResponse, forbidden, unauthorized } from "@/features/reports/csv";
+import { getBudgetReport } from "@/features/reports/service";
+import { tr } from "@/i18n/tr";
+import { csvMoney, toCsv } from "@/shared/csv";
+
+/** GET /raporlar/butce/csv?ay=YYYY-MM — kategori bazında limit ve gerçekleşen. */
+export async function GET(request: Request) {
+  const c = await csvContext(request);
+  if (!c) return unauthorized();
+  const r = await getBudgetReport(c.userId, c.householdId, c.month);
+  if (!r) return forbidden();
+  const csv = toCsv(
+    tr.reports.csvHeaders.budget,
+    r.lines.map((l) => [
+      l.path,
+      l.limitMinor === null ? "" : csvMoney(l.limitMinor),
+      csvMoney(l.actualMinor),
+      l.remainingMinor === null ? "" : csvMoney(l.remainingMinor),
+      csvPct(l.ratioBp === null ? null : Math.round(l.ratioBp / 10) / 10),
+    ]),
+  );
+  return csvResponse(csv, tr.reports.csvFiles.budget(r.month));
+}

src/app/(app)/raporlar/butce/page.tsx

@@ -0,0 +1,41 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { BudgetReportView } from "@/features/reports/components/budget-report-view";
+import {
+  CsvButton,
+  ToolsEnd,
+  MonthNav,
+  ReportFrame,
+  monthLabel,
+} from "@/features/reports/components/report-frame";
+import { getBudgetReport } from "@/features/reports/service";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+import { budgetMonthSchema } from "@/shared/schemas/budget";
+
+const t = tr.reports.budget;
+export const metadata: Metadata = { title: t.title };
+
+/** /raporlar/butce?ay=YYYY-MM — bütçe ve gerçekleşen. */
+export default async function BudgetReportPage({ searchParams }: PageProps<"/raporlar/butce">) {
+  const { user, household } = await requireActiveHousehold("viewer");
+  const ay = budgetMonthSchema.safeParse((await searchParams).ay);
+  const data = await getBudgetReport(user.id, household.id, ay.success ? ay.data : undefined);
+  if (!data) notFound();
+  return (
+    <ReportFrame
+      title={t.title}
+      description={t.description(monthLabel(data.month))}
+      tools={
+        <>
+          <MonthNav month={data.month} currentMonth={data.currentMonth} path="/raporlar/butce" />
+          <ToolsEnd>
+            <CsvButton href={`/raporlar/butce/csv?ay=${data.month}`} />
+          </ToolsEnd>
+        </>
+      }
+    >
+      <BudgetReportView data={data} />
+    </ReportFrame>
+  );
+}

src/app/(app)/raporlar/cari/csv/route.ts

@@ -0,0 +1,36 @@
+import { csvContext, csvResponse, forbidden, unauthorized } from "@/features/reports/csv";
+import { getContactsReport } from "@/features/reports/extra";
+import { tr } from "@/i18n/tr";
+import { csvMoney, toCsv } from "@/shared/csv";
+import { todayIstanbul } from "@/shared/dates";
+
+/** GET /raporlar/cari/csv?tablo=cari|ayni */
+export async function GET(request: Request) {
+  const c = await csvContext(request);
+  if (!c) return unauthorized();
+  const r = await getContactsReport(c.userId, c.householdId);
+  if (!r) return forbidden();
+  const h = tr.reports.csvHeaders;
+  const today = todayIstanbul();
+  if (c.params.get("tablo") === "ayni")
+    return csvResponse(
+      toCsv(
+        h.inKind,
+        r.inKind.map((d) => [
+          d.contactName,
+          d.direction === "receivable" ? tr.reports.contacts.receivable : tr.reports.contacts.debt,
+          d.remainingLabel,
+          d.valueMinor === null ? "" : csvMoney(d.valueMinor),
+          d.date,
+        ]),
+      ),
+      tr.reports.csvFiles.inKind(today),
+    );
+  return csvResponse(
+    toCsv(
+      h.contacts,
+      r.contacts.map((x) => [x.name, csvMoney(x.balanceMinor), x.dueDate ?? ""]),
+    ),
+    tr.reports.csvFiles.contacts(today),
+  );
+}

src/app/(app)/raporlar/cari/page.tsx

@@ -0,0 +1,31 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { ContactsReportView } from "@/features/reports/components/contacts-assets-view";
+import { CsvButton, ReportFrame, ToolsEnd } from "@/features/reports/components/report-frame";
+import { getContactsReport } from "@/features/reports/extra";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+
+const t = tr.reports.contacts;
+export const metadata: Metadata = { title: t.title };
+
+/** /raporlar/cari — cari bakiyeler ve açık aynî borç/alacaklar. */
+export default async function ContactsReportPage() {
+  const { user, household } = await requireActiveHousehold("viewer");
+  const data = await getContactsReport(user.id, household.id);
+  if (!data) notFound();
+  return (
+    <ReportFrame
+      title={t.title}
+      description={t.description}
+      tools={
+        <ToolsEnd>
+          <CsvButton href="/raporlar/cari/csv?tablo=cari" label={t.csvContacts} />
+          <CsvButton href="/raporlar/cari/csv?tablo=ayni" label={t.csvInKind} />
+        </ToolsEnd>
+      }
+    >
+      <ContactsReportView data={data} />
+    </ReportFrame>
+  );
+}

src/app/(app)/raporlar/fire/csv/route.ts

@@ -0,0 +1,29 @@
+import { csvContext, csvPct, csvResponse, forbidden, unauthorized } from "@/features/reports/csv";
+import { getWasteReport } from "@/features/reports/extra";
+import { tr } from "@/i18n/tr";
+import { csvMoney, toCsv } from "@/shared/csv";
+import { todayIstanbul } from "@/shared/dates";
+import { quantityInput } from "@/shared/stock";
+import { parsePeriod } from "@/shared/reports";
+
+/** GET /raporlar/fire/csv?donem=3|6|12 */
+export async function GET(request: Request) {
+  const c = await csvContext(request);
+  if (!c) return unauthorized();
+  const r = await getWasteReport(c.userId, c.householdId, parsePeriod(c.params.get("donem")));
+  if (!r) return forbidden();
+  return csvResponse(
+    toCsv(
+      tr.reports.csvHeaders.waste,
+      r.rows.map((x) => [
+        x.name,
+        x.unit,
+        quantityInput(x.wasted),
+        quantityInput(x.purchased),
+        csvPct(x.wastePct),
+        x.costMinor === null ? "" : csvMoney(x.costMinor),
+      ]),
+    ),
+    tr.reports.csvFiles.waste(todayIstanbul()),
+  );
+}

src/app/(app)/raporlar/fire/page.tsx

@@ -0,0 +1,48 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import {
+  CsvButton,
+  RangeNav,
+  ReportFrame,
+  ToolsEnd,
+} from "@/features/reports/components/report-frame";
+import { WasteReportView } from "@/features/reports/components/shopping-waste-view";
+import { getWasteReport } from "@/features/reports/extra";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+import { parsePeriod, REPORT_PERIODS } from "@/shared/reports";
+
+const t = tr.reports.waste;
+export const metadata: Metadata = { title: t.title };
+
+/** /raporlar/fire?donem=3|6|12 — fire/zarar raporu. */
+export default async function WasteReportPage({ searchParams }: PageProps<"/raporlar/fire">) {
+  const { user, household } = await requireActiveHousehold("viewer");
+  const period = parsePeriod((await searchParams).donem);
+  const data = await getWasteReport(user.id, household.id, period);
+  if (!data) notFound();
+  return (
+    <ReportFrame
+      title={t.title}
+      description={t.description}
+      tools={
+        <>
+          <RangeNav
+            path="/raporlar/fire"
+            label={tr.reports.periodLabel}
+            value={String(period)}
+            options={REPORT_PERIODS.map((p) => ({
+              value: String(p),
+              label: tr.reports.periods[p]!,
+            }))}
+          />
+          <ToolsEnd>
+            <CsvButton href={`/raporlar/fire/csv?donem=${period}`} />
+          </ToolsEnd>
+        </>
+      }
+    >
+      <WasteReportView data={data} />
+    </ReportFrame>
+  );
+}

src/app/(app)/raporlar/kategoriler/csv/route.ts

@@ -0,0 +1,29 @@
+import { csvContext, csvPct, csvResponse, forbidden, unauthorized } from "@/features/reports/csv";
+import { getCategoryReport } from "@/features/reports/service";
+import { tr } from "@/i18n/tr";
+import { csvMoney, toCsv } from "@/shared/csv";
+
+/** GET /raporlar/kategoriler/csv?ay=YYYY-MM — üst kategori ve alt kategori satırları. */
+export async function GET(request: Request) {
+  const c = await csvContext(request);
+  if (!c) return unauthorized();
+  const r = await getCategoryReport(c.userId, c.householdId, c.month);
+  if (!r) return forbidden();
+  const rows = r.breakdown.rows.flatMap((top) => [
+    top,
+    ...top.children.map((k) => ({ ...k, parent: top.name })),
+  ]);
+  const csv = toCsv(
+    tr.reports.csvHeaders.categories,
+    rows.map((x) => [
+      "parent" in x ? x.parent : x.name,
+      "parent" in x ? x.name : "",
+      csvMoney(x.amountMinor),
+      csvPct(x.sharePct),
+      csvMoney(x.prevMinor),
+      csvMoney(x.changeMinor),
+      csvPct(x.changePct),
+    ]),
+  );
+  return csvResponse(csv, tr.reports.csvFiles.categories(r.month));
+}

src/app/(app)/raporlar/kategoriler/page.tsx

@@ -0,0 +1,51 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { CategoriesView } from "@/features/reports/components/categories-view";
+import {
+  CsvButton,
+  ToolsEnd,
+  MonthNav,
+  ReportFrame,
+  monthLabel,
+} from "@/features/reports/components/report-frame";
+import { getCategoryReport } from "@/features/reports/service";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+import { budgetMonthSchema } from "@/shared/schemas/budget";
+
+const t = tr.reports.categories;
+export const metadata: Metadata = { title: t.title };
+
+/** /raporlar/kategoriler?ay=YYYY-MM — kategori dağılımı. */
+export default async function CategoryReportPage({
+  searchParams,
+}: PageProps<"/raporlar/kategoriler">) {
+  const { user, household } = await requireActiveHousehold("viewer");
+  const ay = budgetMonthSchema.safeParse((await searchParams).ay);
+  const data = await getCategoryReport(user.id, household.id, ay.success ? ay.data : undefined);
+  if (!data) notFound();
+  return (
+    <ReportFrame
+      title={t.title}
+      description={t.description(monthLabel(data.month))}
+      tools={
+        <>
+          <MonthNav
+            month={data.month}
+            currentMonth={data.currentMonth}
+            path="/raporlar/kategoriler"
+          />
+          <ToolsEnd>
+            <CsvButton href={`/raporlar/kategoriler/csv?ay=${data.month}`} />
+          </ToolsEnd>
+        </>
+      }
+    >
+      {data.current ? <p className="text-xs text-muted-foreground">{t.partialMonth}</p> : null}
+      {data.includesHidden ? (
+        <p className="text-xs text-muted-foreground">{tr.reports.includesHidden}</p>
+      ) : null}
+      <CategoriesView data={data} />
+    </ReportFrame>
+  );
+}

src/app/(app)/raporlar/kisi-hesap/csv/route.ts

@@ -0,0 +1,36 @@
+import { csvContext, csvPct, csvResponse, forbidden, unauthorized } from "@/features/reports/csv";
+import { getPeopleAccountsReport } from "@/features/reports/service";
+import { tr } from "@/i18n/tr";
+import { csvMoney, toCsv } from "@/shared/csv";
+
+/** GET /raporlar/kisi-hesap/csv?ay=YYYY-MM&tablo=kisi|hesap */
+export async function GET(request: Request) {
+  const c = await csvContext(request);
+  if (!c) return unauthorized();
+  const r = await getPeopleAccountsReport(c.userId, c.householdId, c.month);
+  if (!r) return forbidden();
+  const h = tr.reports.csvHeaders;
+  if (c.params.get("tablo") === "hesap")
+    return csvResponse(
+      toCsv(
+        h.accounts,
+        r.accounts.map((a) => [
+          a.name,
+          csvMoney(a.incomeMinor),
+          csvMoney(a.expenseMinor),
+          csvMoney(a.transferInMinor),
+          csvMoney(a.transferOutMinor),
+          csvMoney(a.netMinor),
+          a.count,
+        ]),
+      ),
+      tr.reports.csvFiles.accounts(r.month),
+    );
+  return csvResponse(
+    toCsv(
+      h.people,
+      r.people.map((p) => [p.name, csvMoney(p.expenseMinor), p.count, csvPct(p.sharePct)]),
+    ),
+    tr.reports.csvFiles.people(r.month),
+  );
+}

src/app/(app)/raporlar/kisi-hesap/page.tsx

@@ -0,0 +1,61 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { PeopleView } from "@/features/reports/components/people-view";
+import {
+  CsvButton,
+  ToolsEnd,
+  MonthNav,
+  ReportFrame,
+  monthLabel,
+} from "@/features/reports/components/report-frame";
+import { getPeopleAccountsReport } from "@/features/reports/service";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+import { budgetMonthSchema } from "@/shared/schemas/budget";
+
+const t = tr.reports.people;
+export const metadata: Metadata = { title: t.title };
+
+/** /raporlar/kisi-hesap?ay=YYYY-MM — kişi bazlı harcama ve hesap bazlı hareket. */
+export default async function PeopleReportPage({
+  searchParams,
+}: PageProps<"/raporlar/kisi-hesap">) {
+  const { user, household } = await requireActiveHousehold("viewer");
+  const ay = budgetMonthSchema.safeParse((await searchParams).ay);
+  const data = await getPeopleAccountsReport(
+    user.id,
+    household.id,
+    ay.success ? ay.data : undefined,
+  );
+  if (!data) notFound();
+  return (
+    <ReportFrame
+      title={t.title}
+      description={t.description(monthLabel(data.month))}
+      tools={
+        <>
+          <MonthNav
+            month={data.month}
+            currentMonth={data.currentMonth}
+            path="/raporlar/kisi-hesap"
+          />
+          <ToolsEnd>
+            <CsvButton
+              href={`/raporlar/kisi-hesap/csv?ay=${data.month}&tablo=kisi`}
+              label={t.csvPeople}
+            />
+            <CsvButton
+              href={`/raporlar/kisi-hesap/csv?ay=${data.month}&tablo=hesap`}
+              label={t.csvAccounts}
+            />
+          </ToolsEnd>
+        </>
+      }
+    >
+      {data.includesHidden ? (
+        <p className="text-xs text-muted-foreground">{tr.reports.includesHidden}</p>
+      ) : null}
+      <PeopleView data={data} />
+    </ReportFrame>
+  );
+}

src/app/(app)/raporlar/page.tsx

@@ -0,0 +1,117 @@
+import {
+  ChartPie,
+  ChevronRight,
+  Coins,
+  HandCoins,
+  ShoppingCart,
+  Tags,
+  Target,
+  Trash2,
+  TrendingUp,
+  Users,
+} from "lucide-react";
+import type { Metadata } from "next";
+import Link from "next/link";
+import { notFound } from "next/navigation";
+import { PageHeader } from "@/components/page-header";
+import { monthLabel, formatPct } from "@/features/reports/components/report-frame";
+import { getCategoryReport, getTrendReport } from "@/features/reports/service";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+import { cn } from "@/lib/utils";
+import { formatMoney } from "@/shared/format";
+
+const t = tr.reports;
+export const metadata: Metadata = { title: t.title };
+
+const REPORTS = [
+  { href: "/raporlar/kategoriler", key: "categories", icon: ChartPie },
+  { href: "/raporlar/trend", key: "trend", icon: TrendingUp },
+  { href: "/raporlar/kisi-hesap", key: "people", icon: Users },
+  { href: "/raporlar/butce", key: "budget", icon: Target },
+  { href: "/raporlar/cari", key: "contacts", icon: HandCoins },
+  { href: "/raporlar/birikim", key: "assets", icon: Coins },
+  { href: "/raporlar/alisveris", key: "shopping", icon: ShoppingCart },
+  { href: "/raporlar/birim-fiyat", key: "unitPrice", icon: Tags },
+  { href: "/raporlar/fire", key: "waste", icon: Trash2 },
+] as const;
+
+/** /raporlar — bu bütçe ayının özeti ve raporlar. */
+export default async function ReportsPage() {
+  const { user, household } = await requireActiveHousehold("viewer");
+  const [trend, cats] = await Promise.all([
+    getTrendReport(user.id, household.id, 1),
+    getCategoryReport(user.id, household.id),
+  ]);
+  if (!trend || !cats) notFound();
+  const m = trend.months[0]!;
+  const top = cats.breakdown.rows.filter((r) => r.amountMinor > 0).slice(0, 3);
+  const stats = [
+    { label: t.hub.income, value: formatMoney(m.incomeMinor), tone: "text-income" },
+    { label: t.hub.expense, value: formatMoney(m.expenseMinor), tone: "text-expense" },
+    {
+      label: t.hub.net,
+      value: `${m.netMinor < 0 ? "−" : ""}${formatMoney(Math.abs(m.netMinor))}`,
+      tone: m.netMinor < 0 ? "text-expense" : undefined,
+    },
+    { label: t.hub.savings, value: formatPct(m.savingsPct) },
+  ];
+  return (
+    <>
+      <PageHeader title={t.title} description={t.description} />
+      <section aria-labelledby="hub-month" className="rounded-xl border bg-card p-4">
+        <h2 id="hub-month" className="text-sm font-medium">
+          {t.hub.thisMonth}: <span className="capitalize">{monthLabel(m.month)}</span>{" "}
+          <span className="font-normal text-muted-foreground">({t.trend.ongoing})</span>
+        </h2>
+        <dl className="mt-3 grid grid-cols-2 gap-3 md:grid-cols-4">
+          {stats.map((s) => (
+            <div key={s.label}>
+              <dt className="text-xs text-muted-foreground">{s.label}</dt>
+              <dd className={cn("text-lg font-semibold tabular-nums", s.tone)}>{s.value}</dd>
+            </div>
+          ))}
+        </dl>
+        {top.length ? (
+          <div className="mt-4">
+            <h3 className="text-xs text-muted-foreground">{t.hub.topCategories}</h3>
+            <ul className="mt-1 flex flex-col gap-1 text-sm">
+              {top.map((r) => (
+                <li key={r.id} className="flex justify-between gap-3">
+                  <span className="truncate">{r.name}</span>
+                  <span className="tabular-nums">
+                    {formatMoney(r.amountMinor)}{" "}
+                    <span className="text-muted-foreground">· {formatPct(r.sharePct)}</span>
+                  </span>
+                </li>
+              ))}
+            </ul>
+          </div>
+        ) : null}
+      </section>
+      <ul className="grid gap-3 md:grid-cols-2">
+        {REPORTS.map((r) => {
+          const c = t.hub.cards[r.key];
+          const Icon = r.icon;
+          return (
+            <li key={r.href}>
+              <Link
+                href={r.href}
+                className="flex h-full items-start gap-3 rounded-xl border bg-card p-4 transition-colors hover:bg-accent/40 focus-visible:ring-2 focus-visible:ring-ring focus-visible:outline-none"
+              >
+                <span className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-muted">
+                  <Icon className="size-4.5 text-muted-foreground" aria-hidden />
+                </span>
+                <span className="min-w-0 flex-1">
+                  <span className="block font-medium">{c.title}</span>
+                  <span className="block text-sm text-muted-foreground">{c.description}</span>
+                </span>
+                <ChevronRight className="mt-2 size-4 text-muted-foreground" aria-hidden />
+              </Link>
+            </li>
+          );
+        })}
+      </ul>
+    </>
+  );
+}

src/app/(app)/raporlar/trend/csv/route.ts

@@ -0,0 +1,24 @@
+import { csvContext, csvPct, csvResponse, forbidden, unauthorized } from "@/features/reports/csv";
+import { getTrendReport } from "@/features/reports/service";
+import { tr } from "@/i18n/tr";
+import { csvMoney, toCsv } from "@/shared/csv";
+import { todayIstanbul } from "@/shared/dates";
+
+/** GET /raporlar/trend/csv — son 12 bütçe ayı. */
+export async function GET(request: Request) {
+  const c = await csvContext(request);
+  if (!c) return unauthorized();
+  const r = await getTrendReport(c.userId, c.householdId);
+  if (!r) return forbidden();
+  const csv = toCsv(
+    tr.reports.csvHeaders.trend,
+    r.months.map((m) => [
+      m.month,
+      csvMoney(m.incomeMinor),
+      csvMoney(m.expenseMinor),
+      csvMoney(m.netMinor),
+      csvPct(m.savingsPct),
+    ]),
+  );
+  return csvResponse(csv, tr.reports.csvFiles.trend(todayIstanbul()));
+}

src/app/(app)/raporlar/trend/page.tsx

@@ -0,0 +1,30 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { CsvButton, ToolsEnd, ReportFrame } from "@/features/reports/components/report-frame";
+import { TrendView } from "@/features/reports/components/trend-view";
+import { getTrendReport } from "@/features/reports/service";
+import { tr } from "@/i18n/tr";
+import { requireActiveHousehold } from "@/lib/dal";
+
+const t = tr.reports.trend;
+export const metadata: Metadata = { title: t.title };
+
+/** /raporlar/trend — son 12 bütçe ayı gelir, gider, net ve tasarruf oranı. */
+export default async function TrendReportPage() {
+  const { user, household } = await requireActiveHousehold("viewer");
+  const data = await getTrendReport(user.id, household.id);
+  if (!data) notFound();
+  return (
+    <ReportFrame
+      title={t.title}
+      description={t.description}
+      tools={
+        <ToolsEnd>
+          <CsvButton href="/raporlar/trend/csv" />
+        </ToolsEnd>
+      }
+    >
+      <TrendView data={data} />
+    </ReportFrame>
+  );
+}

src/components/layout/nav-config.ts

@@ -28,7 +28,7 @@ export type NavItem = {
 
 /** Şu an tamamlanmış en yüksek faz — sayfalar eklendikçe artar. */
 /** Alt fazlar ondalıkla: 6.1 = Faz 6a. */
-export const CURRENT_PHASE = 12.2;
+export const CURRENT_PHASE = 14.2;
 
 export const isAvailable = (item: NavItem) => item.phase <= CURRENT_PHASE;
 
@@ -43,8 +43,8 @@ export const MAIN_NAV: NavItem[] = [
   { href: "/butce", label: tr.nav.budget, icon: Target, phase: 10.1 },
   { href: "/stok", label: tr.nav.stock, icon: Package, phase: 11.1 },
   { href: "/magazalar", label: tr.nav.stores, icon: Store, phase: 12.1 },
-  { href: "/alisveris", label: tr.nav.shopping, icon: ShoppingCart, phase: 13 },
-  { href: "/raporlar", label: tr.nav.reports, icon: ChartColumn, phase: 14 },
+  { href: "/alisveris", label: tr.nav.shopping, icon: ShoppingCart, phase: 13.1 },
+  { href: "/raporlar", label: tr.nav.reports, icon: ChartColumn, phase: 14.1 },
   { href: "/ayarlar", label: tr.nav.settings, icon: Settings, phase: 5 },
 ];
 

src/features/budgets/components/daily-plan-view.tsx

@@ -1,17 +1,8 @@
 "use client";
 
 import Link from "next/link";
-import { CartesianGrid, Line, LineChart, ReferenceLine, XAxis, YAxis } from "recharts";
 import { Button } from "@/components/ui/button";
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
-import {
-  ChartContainer,
-  ChartLegend,
-  ChartLegendContent,
-  ChartTooltip,
-  ChartTooltipContent,
-  type ChartConfig,
-} from "@/components/ui/chart";
 import { tr } from "@/i18n/tr";
 import { cn } from "@/lib/utils";
 import { formatDate, formatMoney } from "@/shared/format";
@@ -19,24 +10,13 @@ import type { DailyPlanView as Data } from "../plan";
 
 const t = tr.budget.daily;
 const d = (ymd: string) => formatDate(`${ymd}T12:00:00+03:00`);
-const dayFmt = new Intl.DateTimeFormat("tr-TR", {
-  day: "numeric",
-  month: "short",
-  timeZone: "Europe/Istanbul",
-});
 const monthFmt = new Intl.DateTimeFormat("tr-TR", {
   month: "long",
   year: "numeric",
   timeZone: "Europe/Istanbul",
 });
-const compact = new Intl.NumberFormat("tr-TR", { notation: "compact", maximumFractionDigits: 1 });
 const signed = (minor: number) => `${minor < 0 ? "−" : ""}${formatMoney(Math.abs(minor))}`;
 
-const config = {
-  planned: { label: t.cumPlanned, color: "var(--budget)" },
-  actual: { label: t.cumActual, color: "var(--expense)" },
-} satisfies ChartConfig;
-
 function Stat({
   label,
   value,
@@ -57,7 +37,7 @@ function Stat({
   );
 }
 
-/** Dashboard: ayın günlük planı, kümülatif grafik ve gelirle karşılaştırma. */
+/** Dashboard: ayın günlük planı ve gelirle karşılaştırma (grafik ana grafikte: Aylık). */
 export function DailyPlanView({ data }: { data: Data }) {
   const p = data.plan;
   if (!data.hasBudget) {
@@ -75,14 +55,6 @@ export function DailyPlanView({ data }: { data: Data }) {
       </Card>
     );
   }
-  const chart = p.days.map((day, i) => ({
-    date: day.date,
-    label: dayFmt.format(new Date(`${day.date}T12:00:00+03:00`)),
-    planned: day.cumPlannedMinor / 100,
-    // Gerçekleşen yalnızca bugüne kadar çizilir.
-    actual: p.todayIndex === -1 || i <= p.todayIndex ? day.cumActualMinor / 100 : null,
-  }));
-  const income = data.income.expectedMinor / 100;
   const nextDiff =
     data.next.budgetMinor === null ? null : data.next.expectedIncomeMinor - data.next.budgetMinor;
 
@@ -116,82 +88,6 @@ export function DailyPlanView({ data }: { data: Data }) {
           />
         </div>
 
-        <ChartContainer
-          config={config}
-          className="aspect-auto h-56 w-full"
-          aria-label={t.chartLabel}
-          role="img"
-        >
-          <LineChart data={chart} margin={{ left: 4, right: 12, top: 8 }}>
-            <CartesianGrid vertical={false} />
-            <XAxis
-              dataKey="label"
-              tickLine={false}
-              axisLine={false}
-              tickMargin={8}
-              minTickGap={24}
-            />
-            <YAxis
-              tickLine={false}
-              axisLine={false}
-              width={48}
-              tickFormatter={(v: number) => compact.format(v)}
-            />
-            {income > 0 ? (
-              <ReferenceLine
-                y={income}
-                stroke="var(--income)"
-                strokeDasharray="4 4"
-                label={{
-                  value: `${t.income} ${compact.format(income)}`,
-                  position: "insideTopLeft",
-                  fill: "var(--muted-foreground)",
-                  fontSize: 11,
-                }}
-              />
-            ) : null}
-            <ChartTooltip
-              content={
-                <ChartTooltipContent
-                  labelFormatter={(_, payload) => {
-                    const date = payload?.[0]?.payload?.date as string | undefined;
-                    return date ? d(date) : "";
-                  }}
-                  formatter={(value, name) => (
-                    <div className="flex w-full items-center justify-between gap-3">
-                      <span className="text-muted-foreground">
-                        {config[name as keyof typeof config]?.label}
-                      </span>
-                      <span className="font-medium text-foreground tabular-nums">
-                        {formatMoney(Math.round(Number(value) * 100))}
-                      </span>
-                    </div>
-                  )}
-                />
-              }
-            />
-            <ChartLegend content={<ChartLegendContent />} />
-            <Line
-              dataKey="planned"
-              type="linear"
-              stroke="var(--color-planned)"
-              strokeWidth={2}
-              dot={false}
-              isAnimationActive={false}
-            />
-            <Line
-              dataKey="actual"
-              type="linear"
-              stroke="var(--color-actual)"
-              strokeWidth={2}
-              dot={false}
-              activeDot={{ r: 4 }}
-              connectNulls={false}
-              isAnimationActive={false}
-            />
-          </LineChart>
-        </ChartContainer>
-
         <p className="text-xs text-muted-foreground">
           {t.modes[data.mode]} {p.fixedMinor ? t.fixedNote(formatMoney(p.fixedMinor)) : ""}
         </p>

src/features/budgets/plan.ts

@@ -60,7 +60,7 @@ export type IncomePlan = {
   manual: { id: string; name: string; amountMinor: number }[];
 };
 
-async function incomePlan(ctx: Ctx, s: Settings, month: string): Promise<IncomePlan> {
+export async function incomePlan(ctx: Ctx, s: Settings, month: string): Promise<IncomePlan> {
   const { from, to } = budgetPeriod(month, s.startDay);
   const [docs, budget] = await Promise.all([
     TransactionModel.find(baseMatch(ctx, s, "income", from, to))
@@ -145,7 +145,7 @@ export async function saveIncomeItems(
 // --- Günlük plan ---
 
 /** Güne göre gider: sabit (düzenli/taksit; gerçekleşmiş + planlı) ve gerçekleşen (tümü). */
-async function expensesByDay(ctx: Ctx, s: Settings, from: string, to: string) {
+export async function expensesByDay(ctx: Ctx, s: Settings, from: string, to: string) {
   const pipeline: PipelineStage[] = [
     { $match: baseMatch(ctx, s, "expense", from, to) },
     {
@@ -182,6 +182,20 @@ async function expensesByDay(ctx: Ctx, s: Settings, from: string, to: string) {
   return { fixed, actual, variable };
 }
 
+/** Güne göre beklenen gelir (gerçekleşmiş + planlı gelir işlemleri). */
+export async function incomeByDay(ctx: Ctx, s: Settings, from: string, to: string) {
+  const rows = await TransactionModel.aggregate<{ _id: string; sum: number }>([
+    { $match: baseMatch(ctx, s, "income", from, to) },
+    {
+      $group: {
+        _id: { $dateToString: { date: "$date", format: "%Y-%m-%d", timezone: "Europe/Istanbul" } },
+        sum: { $sum: "$amountMinor" },
+      },
+    },
+  ]);
+  return new Map(rows.map((r) => [r._id, r.sum]));
+}
+
 export type DailyPlanView = {
   month: string;
   period: { from: string; to: string };
@@ -199,6 +213,40 @@ export type DailyPlanView = {
   canWrite: boolean;
 };
 
+/**
+ * Bir bütçe ayının günlük planı: sabit giderler kendi günlerine, değişken bütçe hane ayarına göre
+ * (eşit ya da önceki ayın örüntüsü) dağıtılır.
+ */
+export async function monthDailyPlan(
+  ctx: Ctx,
+  s: Settings,
+  month: string,
+  budgetMinor: number,
+  today = todayIstanbul(),
+): Promise<DailyPlan> {
+  const period = budgetPeriod(month, s.startDay);
+  const byDay = await expensesByDay(ctx, s, period.from, period.to);
+  let weights: number[] | undefined;
+  if (s.dailyMode === "previous_month_pattern") {
+    const prev = budgetPeriod(shiftMonth(month, -1), s.startDay);
+    const prevDays = await expensesByDay(ctx, s, prev.from, prev.to);
+    const len = daysBetween(prev.from, prev.to);
+    weights = patternWeights(
+      Array.from({ length: len }, (_, i) => prevDays.variable.get(addDays(prev.from, i)) ?? 0),
+      daysBetween(period.from, period.to),
+    );
+  }
+  return dailyPlan({
+    from: period.from,
+    to: period.to,
+    today,
+    budgetMinor,
+    fixedByDay: byDay.fixed,
+    actualByDay: byDay.actual,
+    weights,
+  });
+}
+
 /** Dashboard günlük planı: içinde bulunulan bütçe ayı. */
 export async function getDailyPlan(
   userId: string,
@@ -212,34 +260,14 @@ export async function getDailyPlan(
   const period = budgetPeriod(month, s.startDay);
   const nextMonth = shiftMonth(month, 1);
   const mode = s.dailyMode;
-  const [budget, byDay, income, nextIncome, nextBudget] = await Promise.all([
+  const [budget, income, nextIncome, nextBudget] = await Promise.all([
     getBudget(userId, householdId, month),
-    expensesByDay(ctx, s, period.from, period.to),
     incomePlan(ctx, s, month),
     incomePlan(ctx, s, nextMonth),
     getBudget(userId, householdId, nextMonth),
   ]);
   if (!budget) return null;
-
-  let weights: number[] | undefined;
-  if (mode === "previous_month_pattern") {
-    const prev = budgetPeriod(shiftMonth(month, -1), s.startDay);
-    const prevDays = await expensesByDay(ctx, s, prev.from, prev.to);
-    const len = daysBetween(prev.from, prev.to);
-    weights = patternWeights(
-      Array.from({ length: len }, (_, i) => prevDays.variable.get(addDays(prev.from, i)) ?? 0),
-      daysBetween(period.from, period.to),
-    );
-  }
-  const plan = dailyPlan({
-    from: period.from,
-    to: period.to,
-    today,
-    budgetMinor: budget.totals.limitMinor,
-    fixedByDay: byDay.fixed,
-    actualByDay: byDay.actual,
-    weights,
-  });
+  const plan = await monthDailyPlan(ctx, s, month, budget.totals.limitMinor, today);
   const forecastExpense = budget.totals.forecastMinor;
   return {
     month,

src/features/budgets/service.ts

@@ -191,7 +191,11 @@ export async function getBudget(
 ): Promise<BudgetView | null> {
   const ctx = await loadContext(userId, householdId, "viewer");
   if (!ctx) return null;
-  const s = await settingsOf(ctx.m.householdId);
+  return budgetFor(ctx, await settingsOf(ctx.m.householdId), month);
+}
+
+/** Bağlam ve ayarlar hazırken bütçe (raporlarda birden çok ay için yeniden yüklemeden). */
+export async function budgetFor(ctx: Ctx, s: Settings, month?: string): Promise<BudgetView> {
   const today = todayIstanbul();
   const currentMonth = periodOfDate(today, s.startDay);
   const m = month ?? currentMonth;

src/features/dashboard/components/overview-card.tsx

@@ -0,0 +1,24 @@
+import { OVERVIEW_PERIODS, type OverviewPeriod } from "@/shared/overview";
+import { getOverview } from "../service";
+import { OverviewChart } from "./overview-chart";
+
+type Search = Record<string, string | string[] | undefined>;
+
+const periodOf = (x: unknown): OverviewPeriod =>
+  OVERVIEW_PERIODS.includes(x as OverviewPeriod) ? (x as OverviewPeriod) : "month";
+
+/** Dashboard ana grafiği (sunucu): ?periyot=week|month|half|year&gorunum=kumulatif|donemsel. */
+export async function OverviewCard({
+  userId,
+  householdId,
+  searchParams,
+}: {
+  userId: string;
+  householdId: string;
+  searchParams: Promise<Search>;
+}) {
+  const q = await searchParams;
+  const data = await getOverview(userId, householdId, periodOf(q.periyot));
+  if (!data) return null;
+  return <OverviewChart data={data} view={q.gorunum === "donemsel" ? "periodic" : "cumulative"} />;
+}

src/features/dashboard/components/overview-chart.tsx

@@ -0,0 +1,209 @@
+"use client";
+
+import Link from "next/link";
+import { CartesianGrid, Line, LineChart, XAxis, YAxis } from "recharts";
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
+import {
+  ChartContainer,
+  ChartLegend,
+  ChartLegendContent,
+  ChartTooltip,
+  ChartTooltipContent,
+  type ChartConfig,
+} from "@/components/ui/chart";
+import { tr } from "@/i18n/tr";
+import { cn } from "@/lib/utils";
+import { formatDate, formatMoney } from "@/shared/format";
+import { cumulative, OVERVIEW_PERIODS, type OverviewPeriod } from "@/shared/overview";
+import type { OverviewData } from "../service";
+
+const t = tr.dashboard.overview;
+export type OverviewView = "cumulative" | "periodic";
+
+const compact = new Intl.NumberFormat("tr-TR", { notation: "compact", maximumFractionDigits: 1 });
+const dayShort = new Intl.DateTimeFormat("tr-TR", { day: "numeric", month: "short" });
+const weekdayShort = new Intl.DateTimeFormat("tr-TR", { weekday: "short", day: "numeric" });
+const monthShort = new Intl.DateTimeFormat("tr-TR", { month: "short", year: "2-digit" });
+const monthLong = new Intl.DateTimeFormat("tr-TR", { month: "long", year: "numeric" });
+
+const config = {
+  plannedIncome: { label: t.series.plannedIncome, color: "var(--income)" },
+  budget: { label: t.series.budget, color: "var(--budget)" },
+  actual: { label: t.series.actual, color: "var(--expense)" },
+} satisfies ChartConfig;
+const SERIES = ["plannedIncome", "budget", "actual"] as const;
+
+const asDate = (key: string) =>
+  new Date(key.length === 7 ? `${key}-15T12:00:00+03:00` : `${key}T12:00:00+03:00`);
+
+function bucketLabel(key: string, period: OverviewPeriod) {
+  const d = asDate(key);
+  if (key.length === 7) return monthShort.format(d);
+  return period === "week" ? weekdayShort.format(d) : dayShort.format(d);
+}
+
+/** Bölüm 6.13 ana çizgi grafik: periyot seçici ve kümülatif / dönemsel görünüm (URL'de). */
+export function OverviewChart({ data, view }: { data: OverviewData; view: OverviewView }) {
+  const points = view === "cumulative" ? cumulative(data.points) : data.points;
+  const chart = points.map((p) => ({
+    key: p.key,
+    label: bucketLabel(p.key, data.period),
+    plannedIncome: p.plannedIncome === null ? null : p.plannedIncome / 100,
+    budget: p.budget === null ? null : p.budget / 100,
+    actual: p.actual === null ? null : p.actual / 100,
+  }));
+  const hasGap = data.points.some((p) => p.budget === null);
+  const href = (period: OverviewPeriod, v: OverviewView) =>
+    `?periyot=${period}&gorunum=${v === "cumulative" ? "kumulatif" : "donemsel"}`;
+  const rangeText =
+    data.range.granularity === "month"
+      ? `${monthLong.format(asDate(data.range.buckets[0]!))} – ${monthLong.format(asDate(data.range.buckets.at(-1)!))}`
+      : `${formatDate(asDate(data.range.from))} – ${formatDate(asDate(data.range.to))}`;
+  const pill = (active: boolean) =>
+    cn(
+      "rounded-md px-2.5 py-1 text-sm transition-colors focus-visible:ring-2 focus-visible:ring-ring focus-visible:outline-none",
+      active
+        ? "bg-background font-medium shadow-sm"
+        : "text-muted-foreground hover:text-foreground",
+    );
+
+  return (
+    <Card size="sm">
+      <CardHeader className="flex flex-wrap items-start gap-3">
+        <div className="min-w-0 flex-1">
+          <CardTitle className="text-base">{t.title}</CardTitle>
+          <CardDescription>{t.description(rangeText)}</CardDescription>
+        </div>
+        <div className="flex flex-wrap gap-2">
+          <nav aria-label={t.periodLabel} className="flex rounded-lg bg-muted p-0.5">
+            {OVERVIEW_PERIODS.map((p) => (
+              <Link
+                key={p}
+                href={href(p, view)}
+                scroll={false}
+                replace
+                aria-current={p === data.period ? "page" : undefined}
+                className={pill(p === data.period)}
+              >
+                {t.periods[p]}
+              </Link>
+            ))}
+          </nav>
+          <nav aria-label={t.viewLabel} className="flex rounded-lg bg-muted p-0.5">
+            {(["cumulative", "periodic"] as const).map((v) => (
+              <Link
+                key={v}
+                href={href(data.period, v)}
+                scroll={false}
+                replace
+                aria-current={v === view ? "page" : undefined}
+                className={pill(v === view)}
+              >
+                {t.views[v]}
+              </Link>
+            ))}
+          </nav>
+        </div>
+      </CardHeader>
+      <CardContent className="flex flex-col gap-3">
+        <ChartContainer
+          config={config}
+          className="aspect-auto h-64 w-full"
+          aria-label={t.chartLabel}
+          role="img"
+        >
+          <LineChart data={chart} margin={{ left: 4, right: 12, top: 8 }}>
+            <CartesianGrid vertical={false} />
+            <XAxis
+              dataKey="label"
+              tickLine={false}
+              axisLine={false}
+              tickMargin={8}
+              minTickGap={16}
+            />
+            <YAxis
+              tickLine={false}
+              axisLine={false}
+              width={48}
+              tickFormatter={(v: number) => compact.format(v)}
+            />
+            <ChartTooltip
+              content={
+                <ChartTooltipContent
+                  labelFormatter={(_, payload) => {
+                    const key = payload?.[0]?.payload?.key as string | undefined;
+                    if (!key) return "";
+                    return key.length === 7
+                      ? monthLong.format(asDate(key))
+                      : formatDate(asDate(key));
+                  }}
+                  formatter={(value, name) => (
+                    <div className="flex w-full items-center justify-between gap-3">
+                      <span className="text-muted-foreground">
+                        {config[name as keyof typeof config]?.label}
+                      </span>
+                      <span className="font-medium text-foreground tabular-nums">
+                        {formatMoney(Math.round(Number(value) * 100))}
+                      </span>
+                    </div>
+                  )}
+                />
+              }
+            />
+            <ChartLegend content={<ChartLegendContent />} />
+            {SERIES.map((k) => (
+              <Line
+                key={k}
+                dataKey={k}
+                type="linear"
+                stroke={`var(--color-${k})`}
+                strokeWidth={2}
+                strokeDasharray={k === "budget" ? "6 3" : undefined}
+                dot={
+                  data.range.granularity === "month" || data.period === "week" ? { r: 3 } : false
+                }
+                activeDot={{ r: 5 }}
+                connectNulls={false}
+                isAnimationActive={false}
+              />
+            ))}
+          </LineChart>
+        </ChartContainer>
+        {hasGap ? <p className="text-xs text-muted-foreground">{t.noBudget}</p> : null}
+        <details className="text-sm">
+          <summary className="cursor-pointer text-xs text-muted-foreground">{t.table}</summary>
+          <div className="mt-2 max-h-80 overflow-y-auto">
+            <table className="w-full text-right tabular-nums">
+              <thead className="sticky top-0 bg-card text-xs text-muted-foreground">
+                <tr>
+                  <th className="py-1 text-left font-normal">{t.bucket[data.range.granularity]}</th>
+                  {SERIES.map((k) => (
+                    <th key={k} className="py-1 font-normal">
+                      {t.series[k]}
+                    </th>
+                  ))}
+                </tr>
+              </thead>
+              <tbody className="divide-y">
+                {points.map((p) => (
+                  <tr key={p.key}>
+                    <td className="py-1 text-left">
+                      {p.key.length === 7
+                        ? monthLong.format(asDate(p.key))
+                        : formatDate(asDate(p.key))}
+                    </td>
+                    {SERIES.map((k) => (
+                      <td key={k} className="py-1">
+                        {p[k] === null ? "—" : formatMoney(p[k])}
+                      </td>
+                    ))}
+                  </tr>
+                ))}
+              </tbody>
+            </table>
+          </div>
+        </details>
+      </CardContent>
+    </Card>
+  );
+}

src/features/dashboard/service.ts

@@ -0,0 +1,83 @@
+import "server-only";
+import { budgetFor, settingsOf } from "@/features/budgets/service";
+import { incomeByDay, incomePlan, monthDailyPlan } from "@/features/budgets/plan";
+import { loadContext } from "@/features/transactions/service";
+import { budgetPeriod, periodOfDate } from "@/shared/budget";
+import { todayIstanbul } from "@/shared/dates";
+import {
+  overviewRange,
+  type OverviewPeriod,
+  type OverviewPoint,
+  type OverviewRange,
+} from "@/shared/overview";
+
+/**
+ * Dashboard ana grafiği (Bölüm 6.13). Bütçe ve gelir planı motorlarıyla aynı kurallar: bütçe ayı,
+ * taksit modu ve gizli hesap ayarı.
+ *
+ * Aylık noktalar: beklenen gelir (gerçekleşen + planlı + elle), bütçe toplamı (bütçe yoksa boş),
+ * gerçekleşen gider. Günlük noktalar: o günün gelirleri (elle eklenen beklenen gelir dönemin ilk
+ * gününe), günlük plan payı, o günün gerçekleşen gideri; gelecek günlerde gerçekleşen boş.
+ */
+export type OverviewData = {
+  period: OverviewPeriod;
+  range: OverviewRange;
+  points: OverviewPoint[];
+  today: string;
+};
+
+export async function getOverview(
+  userId: string,
+  householdId: string,
+  period: OverviewPeriod,
+): Promise<OverviewData | null> {
+  const ctx = await loadContext(userId, householdId, "viewer");
+  if (!ctx) return null;
+  const s = await settingsOf(ctx.m.householdId);
+  const today = todayIstanbul();
+  const range = overviewRange(period, today, s.startDay);
+
+  if (range.granularity === "month") {
+    const points = await Promise.all(
+      range.buckets.map(async (month) => {
+        const [budget, income] = await Promise.all([
+          budgetFor(ctx, s, month),
+          incomePlan(ctx, s, month),
+        ]);
+        return {
+          key: month,
+          plannedIncome: income.expectedMinor,
+          budget: budget.hasBudget ? budget.totals.limitMinor : null,
+          actual: budget.totals.actualMinor,
+        };
+      }),
+    );
+    return { period, range, points, today };
+  }
+
+  // Günlük: aralığın dokunduğu bütçe ayları (hafta iki aya yayılabilir).
+  const months = [...new Set([range.from, range.to].map((d) => periodOfDate(d, s.startDay)))];
+  const planned = new Map<string, number | null>();
+  const actual = new Map<string, number>();
+  const income = new Map<string, number>();
+  for (const month of months) {
+    const [budget, plan] = await Promise.all([budgetFor(ctx, s, month), incomePlan(ctx, s, month)]);
+    const dp = await monthDailyPlan(ctx, s, month, budget.totals.limitMinor, today);
+    for (const d of dp.days) {
+      planned.set(d.date, budget.hasBudget ? d.plannedMinor : null);
+      actual.set(d.date, d.actualMinor);
+    }
+    const first = budgetPeriod(month, s.startDay).from;
+    if (plan.manualMinor) income.set(first, (income.get(first) ?? 0) + plan.manualMinor);
+  }
+  for (const [d, v] of await incomeByDay(ctx, s, range.from, range.to))
+    income.set(d, (income.get(d) ?? 0) + v);
+
+  const points = range.buckets.map((d) => ({
+    key: d,
+    plannedIncome: income.get(d) ?? 0,
+    budget: planned.get(d) ?? null,
+    actual: d <= today ? (actual.get(d) ?? 0) : null,
+  }));
+  return { period, range, points, today };
+}

src/features/prices/service.ts

@@ -293,17 +293,35 @@ export async function getTypePriceComparison(
   };
 }
 
+/** Ürün tipi birimine çevrilebilen ürünlerin mağaza başına geçerli fiyatı (planlayıcı girdisi). */
+export type TypeOffer = {
+  productId: string;
+  productTypeId: string;
+  storeId: string;
+  priceMinor: number;
+  inTypeUnit: number;
+  unitPriceMinor: number;
+  date: string;
+  stale: boolean;
+  isPromo: boolean;
+};
+
 /**
- * Ürün tipi başına son bilinen birim fiyat (en yeni geçerli fiyat kaydı; tüm marka/mağazalar).
- * Tüketim analizinde aylık maliyet tahmini için. Dönüşümü eksik ürünler atlanır.
+ * Ürün tiplerinin tüm (arşivsiz) ürünlerinin mağaza başına geçerli fiyatları. Dönüşümü eksik
+ * ürünler atlanır. `activeOnly`: arşivli ürün ve mağazaları dışarıda bırak.
  */
-export async function latestTypeUnitPrices(
+export async function loadTypeOffers(
   householdId: Types.ObjectId,
   productTypeIds: Types.ObjectId[],
-  today = todayIstanbul(),
-): Promise<Map<string, { unitPriceMinor: number; date: string }>> {
-  const [products, types] = await Promise.all([
-    ProductModel.find({ householdId, productTypeId: { $in: productTypeIds } })
+  { today = todayIstanbul(), activeOnly = false } = {},
+): Promise<TypeOffer[]> {
+  if (!productTypeIds.length) return [];
+  const [products, types, archivedStores] = await Promise.all([
+    ProductModel.find({
+      householdId,
+      productTypeId: { $in: productTypeIds },
+      ...(activeOnly ? { archivedAt: null } : {}),
+    })
       .select({ productTypeId: 1, packageQuantity: 1, packageUnit: 1, typeQuantity: 1 })
       .lean<
         {
@@ -317,7 +335,13 @@ export async function latestTypeUnitPrices(
     ProductTypeModel.find({ householdId, _id: { $in: productTypeIds } })
       .select({ unit: 1 })
       .lean<{ _id: Types.ObjectId; unit: string }[]>(),
+    activeOnly
+      ? StoreModel.find({ householdId, archivedAt: { $ne: null } })
+          .select({ _id: 1 })
+          .lean<{ _id: Types.ObjectId }[]>()
+      : Promise.resolve([]),
   ]);
+  const skipStore = new Set(archivedStores.map((x) => String(x._id)));
   const unitOf = new Map(types.map((x) => [String(x._id), x.unit]));
   const prices = await loadPrices(
     householdId,
@@ -325,11 +349,12 @@ export async function latestTypeUnitPrices(
   );
   const groups = new Map<string, PriceLean[]>();
   for (const r of prices) {
+    if (skipStore.has(String(r.storeId))) continue;
     const key = `${r.productId}:${r.storeId}`;
     groups.set(key, [...(groups.get(key) ?? []), r]);
   }
   const productById = new Map(products.map((p) => [String(p._id), p]));
-  const out = new Map<string, { unitPriceMinor: number; date: string }>();
+  const out: TypeOffer[] = [];
   for (const records of groups.values()) {
     const p = productById.get(String(records[0]!.productId))!;
     const typeId = String(p.productTypeId);
@@ -341,12 +366,86 @@ export async function latestTypeUnitPrices(
     });
     if (!inType) continue;
     const eff = effectivePrice(records, today)!;
-    const prev = out.get(typeId);
-    if (!prev || eff.record.date > prev.date)
-      out.set(typeId, {
-        unitPriceMinor: unitPrice(eff.record.priceMinor, inType),
-        date: eff.record.date,
-      });
+    out.push({
+      productId: String(p._id),
+      productTypeId: typeId,
+      storeId: String(records[0]!.storeId),
+      priceMinor: eff.record.priceMinor,
+      inTypeUnit: inType,
+      unitPriceMinor: unitPrice(eff.record.priceMinor, inType),
+      date: eff.record.date,
+      stale: eff.stale,
+      isPromo: eff.record.isPromo && !eff.promoEnded,
+    });
+  }
+  return out;
+}
+
+/** Bir ürün tipinin tüm fiyat kayıtları, ürün tipi biriminde birim fiyatla (dönüşümsüzler hariç). */
+export async function loadTypePriceHistory(
+  householdId: Types.ObjectId,
+  productTypeId: Types.ObjectId,
+): Promise<{ date: string; productId: string; storeId: string; unitPriceMinor: number }[]> {
+  const [products, type] = await Promise.all([
+    ProductModel.find({ householdId, productTypeId })
+      .select({ packageQuantity: 1, packageUnit: 1, typeQuantity: 1 })
+      .lean<
+        {
+          _id: Types.ObjectId;
+          packageQuantity: number;
+          packageUnit: string;
+          typeQuantity: number | null;
+        }[]
+      >(),
+    ProductTypeModel.findOne({ householdId, _id: productTypeId })
+      .select({ unit: 1 })
+      .lean<{ unit: string }>(),
+  ]);
+  if (!type) return [];
+  const inType = new Map(
+    products.map((p) => [
+      String(p._id),
+      packageInTypeUnit({
+        packageQuantity: p.packageQuantity,
+        packageUnit: p.packageUnit,
+        typeUnit: type.unit,
+        typeQuantity: p.typeQuantity,
+      }),
+    ]),
+  );
+  const prices = await loadPrices(
+    householdId,
+    products.map((p) => p._id),
+  );
+  return prices.flatMap((r) => {
+    const q = inType.get(String(r.productId));
+    return q
+      ? [
+          {
+            date: r.date,
+            productId: String(r.productId),
+            storeId: String(r.storeId),
+            unitPriceMinor: unitPrice(r.priceMinor, q),
+          },
+        ]
+      : [];
+  });
+}
+
+/**
+ * Ürün tipi başına son bilinen birim fiyat (en yeni geçerli fiyat kaydı; tüm marka/mağazalar).
+ * Tüketim analizinde aylık maliyet tahmini için. Dönüşümü eksik ürünler atlanır.
+ */
+export async function latestTypeUnitPrices(
+  householdId: Types.ObjectId,
+  productTypeIds: Types.ObjectId[],
+  today = todayIstanbul(),
+): Promise<Map<string, { unitPriceMinor: number; date: string }>> {
+  const out = new Map<string, { unitPriceMinor: number; date: string }>();
+  for (const o of await loadTypeOffers(householdId, productTypeIds, { today })) {
+    const prev = out.get(o.productTypeId);
+    if (!prev || o.date > prev.date)
+      out.set(o.productTypeId, { unitPriceMinor: o.unitPriceMinor, date: o.date });
   }
   return out;
 }

src/features/reports/components/budget-report-view.tsx

@@ -0,0 +1,202 @@
+"use client";
+
+import { Bar, BarChart, CartesianGrid, XAxis, YAxis } from "recharts";
+import {
+  ChartContainer,
+  ChartLegend,
+  ChartLegendContent,
+  ChartTooltip,
+  ChartTooltipContent,
+  type ChartConfig,
+} from "@/components/ui/chart";
+import { tr } from "@/i18n/tr";
+import { cn } from "@/lib/utils";
+import { formatMoney } from "@/shared/format";
+import type { BudgetReport } from "../service";
+import { monthLabel, monthShort } from "./report-frame";
+
+const t = tr.reports.budget;
+const compact = new Intl.NumberFormat("tr-TR", { notation: "compact", maximumFractionDigits: 1 });
+const ratio = (bp: number | null) => (bp === null ? "—" : `%${Math.round(bp / 100)}`);
+const STATUS_TONE: Record<string, string> = {
+  ok: "bg-income",
+  warning: "bg-amber-500",
+  over: "bg-expense",
+  none: "bg-muted-foreground",
+};
+
+const config = {
+  limit: { label: t.limit, color: "var(--budget)" },
+  actual: { label: t.actual, color: "var(--expense)" },
+} satisfies ChartConfig;
+
+export function BudgetReportView({ data }: { data: BudgetReport }) {
+  const chart = data.history.map((h) => ({
+    month: h.month,
+    label: monthShort(h.month),
+    limit: h.limitMinor === null ? null : h.limitMinor / 100,
+    actual: h.actualMinor / 100,
+  }));
+  const { totals, hasBudget } = data.budget;
+
+  return (
+    <div className="flex flex-col gap-4">
+      {!hasBudget ? <p className="text-sm text-muted-foreground">{t.noBudget}</p> : null}
+      <div className="overflow-x-auto rounded-xl border bg-card">
+        <table className="w-full min-w-[34rem] text-sm tabular-nums">
+          <thead className="border-b text-xs text-muted-foreground">
+            <tr>
+              <th className="px-3 py-2 text-left font-normal">{t.category}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.limit}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.actual}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.remaining}</th>
+              <th className="w-40 px-3 py-2 text-left font-normal">{t.ratio}</th>
+            </tr>
+          </thead>
+          <tbody className="divide-y">
+            {data.lines.map((l) => (
+              <tr key={l.categoryId} className={cn(l.depth === 0 && "font-medium")}>
+                <td className="py-1.5 pr-3" style={{ paddingLeft: `${0.75 + l.depth * 1.25}rem` }}>
+                  {l.name}
+                </td>
+                <td className="px-3 py-1.5 text-right">
+                  {l.limitMinor === null ? (
+                    <span className="text-xs font-normal text-muted-foreground">
+                      {l.covered ? t.covered : "—"}
+                    </span>
+                  ) : (
+                    formatMoney(l.limitMinor)
+                  )}
+                </td>
+                <td className="px-3 py-1.5 text-right">{formatMoney(l.actualMinor)}</td>
+                <td
+                  className={cn(
+                    "px-3 py-1.5 text-right",
+                    (l.remainingMinor ?? 0) < 0 && "text-expense",
+                  )}
+                >
+                  {l.remainingMinor === null
+                    ? "—"
+                    : `${l.remainingMinor < 0 ? "−" : ""}${formatMoney(Math.abs(l.remainingMinor))}`}
+                </td>
+                <td className="px-3 py-1.5">
+                  {l.ratioBp === null ? (
+                    <span className="text-muted-foreground">—</span>
+                  ) : (
+                    <span className="flex items-center gap-2">
+                      <span
+                        className="h-1.5 flex-1 overflow-hidden rounded-full bg-muted"
+                        aria-hidden
+                      >
+                        <span
+                          className={cn("block h-full rounded-full", STATUS_TONE[l.status])}
+                          style={{ width: `${Math.min(100, l.ratioBp / 100)}%` }}
+                        />
+                      </span>
+                      <span className="w-12 text-right text-xs">{ratio(l.ratioBp)}</span>
+                    </span>
+                  )}
+                </td>
+              </tr>
+            ))}
+          </tbody>
+          <tfoot className="border-t font-medium">
+            <tr>
+              <td className="px-3 py-2">{tr.reports.categories.total}</td>
+              <td className="px-3 py-2 text-right">
+                {hasBudget ? formatMoney(totals.limitMinor) : "—"}
+              </td>
+              <td className="px-3 py-2 text-right">{formatMoney(totals.actualMinor)}</td>
+              <td
+                className={cn("px-3 py-2 text-right", totals.remainingMinor < 0 && "text-expense")}
+              >
+                {hasBudget
+                  ? `${totals.remainingMinor < 0 ? "−" : ""}${formatMoney(Math.abs(totals.remainingMinor))}`
+                  : "—"}
+              </td>
+              <td className="px-3 py-2 text-left text-xs">{ratio(totals.ratioBp)}</td>
+            </tr>
+          </tfoot>
+        </table>
+      </div>
+
+      <section className="rounded-xl border bg-card p-4" aria-labelledby="bh-h">
+        <h2 id="bh-h" className="mb-2 text-sm font-medium">
+          {t.historyTitle}
+        </h2>
+        <ChartContainer
+          config={config}
+          className="aspect-auto h-56 w-full"
+          role="img"
+          aria-label={t.historyChartLabel}
+        >
+          <BarChart data={chart} margin={{ left: 4, right: 8, top: 8 }} barGap={2}>
+            <CartesianGrid vertical={false} />
+            <XAxis dataKey="label" tickLine={false} axisLine={false} tickMargin={8} />
+            <YAxis
+              tickLine={false}
+              axisLine={false}
+              width={48}
+              tickFormatter={(v: number) => compact.format(v)}
+            />
+            <ChartTooltip
+              content={
+                <ChartTooltipContent
+                  labelFormatter={(_, payload) => {
+                    const m = payload?.[0]?.payload?.month as string | undefined;
+                    return m ? monthLabel(m) : "";
+                  }}
+                  formatter={(value, name) => (
+                    <div className="flex w-full items-center justify-between gap-3">
+                      <span className="text-muted-foreground">
+                        {config[name as keyof typeof config]?.label}
+                      </span>
+                      <span className="font-medium text-foreground tabular-nums">
+                        {formatMoney(Math.round(Number(value) * 100))}
+                      </span>
+                    </div>
+                  )}
+                />
+              }
+            />
+            <ChartLegend content={<ChartLegendContent />} />
+            <Bar
+              dataKey="limit"
+              fill="var(--color-limit)"
+              radius={[4, 4, 0, 0]}
+              isAnimationActive={false}
+            />
+            <Bar
+              dataKey="actual"
+              fill="var(--color-actual)"
+              radius={[4, 4, 0, 0]}
+              isAnimationActive={false}
+            />
+          </BarChart>
+        </ChartContainer>
+        <table className="mt-3 w-full text-sm tabular-nums">
+          <thead className="text-xs text-muted-foreground">
+            <tr>
+              <th className="py-1 text-left font-normal">{t.month}</th>
+              <th className="py-1 text-right font-normal">{t.limit}</th>
+              <th className="py-1 text-right font-normal">{t.actual}</th>
+              <th className="py-1 text-right font-normal">{t.ratio}</th>
+            </tr>
+          </thead>
+          <tbody className="divide-y">
+            {data.history.map((h) => (
+              <tr key={h.month}>
+                <td className="py-1 capitalize">{monthLabel(h.month)}</td>
+                <td className="py-1 text-right">
+                  {h.limitMinor === null ? t.noLimit : formatMoney(h.limitMinor)}
+                </td>
+                <td className="py-1 text-right">{formatMoney(h.actualMinor)}</td>
+                <td className="py-1 text-right">{ratio(h.ratioBp)}</td>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+      </section>
+    </div>
+  );
+}

src/features/reports/components/categories-view.tsx

@@ -0,0 +1,217 @@
+"use client";
+
+import { Cell, Pie, PieChart } from "recharts";
+import {
+  ChartContainer,
+  ChartTooltip,
+  ChartTooltipContent,
+  type ChartConfig,
+} from "@/components/ui/chart";
+import { IconBadge } from "@/components/appearance/swatch";
+import { tr } from "@/i18n/tr";
+import { cn } from "@/lib/utils";
+import { formatMoney } from "@/shared/format";
+import type { CategoryReport } from "../service";
+import { Change, formatPct } from "./report-frame";
+
+const t = tr.reports.categories;
+/** Halkada en fazla bu kadar dilim; kalanlar "Diğer". */
+const MAX_SLICES = 7;
+
+export function CategoriesView({ data }: { data: CategoryReport }) {
+  const { breakdown, appearance } = data;
+  const positive = breakdown.rows.filter((r) => r.amountMinor > 0);
+  const head = positive.slice(0, MAX_SLICES);
+  const rest = positive.slice(MAX_SLICES);
+  const slices = [
+    ...head.map((r) => ({
+      key: r.id,
+      name: r.name,
+      value: r.amountMinor / 100,
+      share: r.sharePct,
+      color: `var(--swatch-${appearance[r.id]?.color ?? "slate"})`,
+    })),
+    ...(rest.length
+      ? [
+          {
+            key: "__other__",
+            name: t.other(rest.length),
+            value: rest.reduce((a, r) => a + r.amountMinor, 0) / 100,
+            share: Math.round(rest.reduce((a, r) => a + r.sharePct, 0) * 10) / 10,
+            color: "var(--muted-foreground)",
+          },
+        ]
+      : []),
+  ];
+  const config = Object.fromEntries(
+    slices.map((s) => [s.key, { label: s.name, color: s.color }]),
+  ) satisfies ChartConfig;
+
+  if (breakdown.totalMinor === 0 && breakdown.rows.length === 0)
+    return (
+      <p className="rounded-lg border border-dashed p-6 text-center text-sm text-muted-foreground">
+        {tr.reports.noData}
+      </p>
+    );
+
+  return (
+    <div className="grid gap-4 lg:grid-cols-[minmax(0,20rem)_minmax(0,1fr)] lg:items-start">
+      <div className="rounded-xl border bg-card p-4">
+        <div className="relative">
+          <ChartContainer
+            config={config}
+            className="mx-auto aspect-square w-full max-w-64"
+            role="img"
+            aria-label={t.chartLabel}
+          >
+            <PieChart>
+              <ChartTooltip
+                content={
+                  <ChartTooltipContent
+                    hideLabel
+                    nameKey="key"
+                    formatter={(value, _name, item) => (
+                      <div className="flex w-full items-center justify-between gap-3">
+                        <span className="text-muted-foreground">{item.payload.name}</span>
+                        <span className="font-medium text-foreground tabular-nums">
+                          {formatMoney(Math.round(Number(value) * 100))} ·{" "}
+                          {formatPct(item.payload.share)}
+                        </span>
+                      </div>
+                    )}
+                  />
+                }
+              />
+              <Pie
+                data={slices}
+                dataKey="value"
+                nameKey="key"
+                innerRadius="62%"
+                outerRadius="100%"
+                stroke="var(--card)"
+                strokeWidth={2}
+                isAnimationActive={false}
+              >
+                {slices.map((s) => (
+                  <Cell key={s.key} fill={s.color} />
+                ))}
+              </Pie>
+            </PieChart>
+          </ChartContainer>
+          <div className="pointer-events-none absolute inset-0 flex flex-col items-center justify-center">
+            <span className="text-xs text-muted-foreground">{t.total}</span>
+            <span className="text-lg font-semibold tabular-nums">
+              {formatMoney(breakdown.totalMinor)}
+            </span>
+          </div>
+        </div>
+        <ul className="mt-4 flex flex-col gap-1.5 text-sm">
+          {slices.map((s) => (
+            <li key={s.key} className="flex items-center gap-2">
+              <span
+                aria-hidden
+                className="size-2.5 shrink-0 rounded-sm"
+                style={{ background: s.color }}
+              />
+              <span className="min-w-0 flex-1 truncate">{s.name}</span>
+              <span className="text-muted-foreground tabular-nums">{formatPct(s.share)}</span>
+            </li>
+          ))}
+        </ul>
+      </div>
+
+      <div className="overflow-x-auto rounded-xl border bg-card">
+        <table className="w-full min-w-[34rem] text-sm">
+          <thead className="border-b text-xs text-muted-foreground">
+            <tr>
+              <th className="px-3 py-2 text-left font-normal">{t.category}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.amount}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.share}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.previous}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.change}</th>
+            </tr>
+          </thead>
+          <tbody>
+            {breakdown.rows.map((r) => {
+              const a = appearance[r.id];
+              return [
+                <tr key={r.id} className="border-t bg-muted/20 font-medium">
+                  <td className="px-3 py-2">
+                    <span className="flex items-center gap-2">
+                      {a ? <IconBadge icon={a.icon} color={a.color} size="sm" /> : null}
+                      {r.name}
+                    </span>
+                  </td>
+                  <td className="px-3 py-2 text-right tabular-nums">
+                    {formatMoney(r.amountMinor)}
+                  </td>
+                  <td className="px-3 py-2 text-right tabular-nums">{formatPct(r.sharePct)}</td>
+                  <td className="px-3 py-2 text-right text-muted-foreground tabular-nums">
+                    {formatMoney(r.prevMinor)}
+                  </td>
+                  <td className="px-3 py-2 text-right">
+                    <Change minor={r.changeMinor} pct={r.changePct} format={formatMoney} />
+                  </td>
+                </tr>,
+                ...(r.children.length && r.ownMinor
+                  ? [
+                      <tr key={`${r.id}-own`} className="text-muted-foreground">
+                        <td className="py-1.5 pr-3 pl-10 italic">{t.own}</td>
+                        <td className="px-3 py-1.5 text-right tabular-nums">
+                          {formatMoney(r.ownMinor)}
+                        </td>
+                        <td colSpan={3} />
+                      </tr>,
+                    ]
+                  : []),
+                ...r.children.map((c) => (
+                  <tr key={c.id}>
+                    <td className={cn("py-1.5 pr-3", c.depth > 1 ? "pl-14" : "pl-10")}>{c.name}</td>
+                    <td className="px-3 py-1.5 text-right tabular-nums">
+                      {formatMoney(c.amountMinor)}
+                    </td>
+                    <td className="px-3 py-1.5 text-right text-muted-foreground tabular-nums">
+                      {formatPct(c.sharePct)}
+                    </td>
+                    <td className="px-3 py-1.5 text-right text-muted-foreground tabular-nums">
+                      {formatMoney(c.prevMinor)}
+                    </td>
+                    <td className="px-3 py-1.5 text-right">
+                      <Change minor={c.changeMinor} pct={c.changePct} format={formatMoney} />
+                    </td>
+                  </tr>
+                )),
+              ];
+            })}
+          </tbody>
+          <tfoot className="border-t font-medium">
+            <tr>
+              <td className="px-3 py-2">{t.total}</td>
+              <td className="px-3 py-2 text-right tabular-nums">
+                {formatMoney(breakdown.totalMinor)}
+              </td>
+              <td className="px-3 py-2 text-right tabular-nums">%100</td>
+              <td className="px-3 py-2 text-right text-muted-foreground tabular-nums">
+                {formatMoney(breakdown.prevTotalMinor)}
+              </td>
+              <td className="px-3 py-2 text-right">
+                <Change
+                  minor={breakdown.totalMinor - breakdown.prevTotalMinor}
+                  pct={
+                    breakdown.prevTotalMinor
+                      ? Math.round(
+                          ((breakdown.totalMinor - breakdown.prevTotalMinor) * 1000) /
+                            breakdown.prevTotalMinor,
+                        ) / 10
+                      : null
+                  }
+                  format={formatMoney}
+                />
+              </td>
+            </tr>
+          </tfoot>
+        </table>
+      </div>
+    </div>
+  );
+}

src/features/reports/components/contacts-assets-view.tsx

@@ -0,0 +1,250 @@
+import Link from "next/link";
+import { Badge } from "@/components/ui/badge";
+import { tr } from "@/i18n/tr";
+import { cn } from "@/lib/utils";
+import { formatMoney } from "@/shared/format";
+import { formatAssetQuantity } from "@/shared/assets";
+import type { AssetsReport, ContactsReport } from "../extra";
+import { dayLabel } from "./report-frame";
+
+const signed = (n: number) => `${n > 0 ? "+" : n < 0 ? "−" : ""}${formatMoney(Math.abs(n))}`;
+const bp = (n: number | null) =>
+  n === null
+    ? ""
+    : ` (${n < 0 ? "−" : "+"}%${(Math.abs(n) / 100).toLocaleString("tr-TR", { maximumFractionDigits: 1 })})`;
+
+function Stat({ label, value, tone }: { label: string; value: string; tone?: string }) {
+  return (
+    <div className="rounded-xl border bg-card p-3">
+      <p className="text-xs text-muted-foreground">{label}</p>
+      <p className={cn("text-lg font-semibold tabular-nums", tone)}>{value}</p>
+    </div>
+  );
+}
+
+export function ContactsReportView({ data }: { data: ContactsReport }) {
+  const t = tr.reports.contacts;
+  return (
+    <div className="flex flex-col gap-6">
+      <div className="grid grid-cols-2 gap-3 md:grid-cols-4">
+        <Stat label={t.owesMe} value={formatMoney(data.totals.owesMeMinor)} tone="text-income" />
+        <Stat label={t.iOwe} value={formatMoney(data.totals.iOweMinor)} tone="text-expense" />
+        <Stat
+          label={`${t.receivable} (${t.value.toLocaleLowerCase("tr-TR")})`}
+          value={formatMoney(data.inKindTotals.receivableMinor)}
+        />
+        <Stat
+          label={`${t.debt} (${t.value.toLocaleLowerCase("tr-TR")})`}
+          value={formatMoney(data.inKindTotals.debtMinor)}
+        />
+      </div>
+
+      <section aria-labelledby="cari-h" className="flex flex-col gap-2">
+        <h2 id="cari-h" className="font-medium">
+          {t.contact}
+        </h2>
+        {data.contacts.length ? (
+          <div className="overflow-x-auto rounded-xl border bg-card">
+            <table className="w-full min-w-[28rem] text-sm tabular-nums">
+              <thead className="border-b text-xs text-muted-foreground">
+                <tr>
+                  <th className="px-3 py-2 text-left font-normal">{t.contact}</th>
+                  <th className="px-3 py-2 text-left font-normal">{t.direction}</th>
+                  <th className="px-3 py-2 text-right font-normal">{t.balance}</th>
+                  <th className="px-3 py-2 text-right font-normal">{t.due}</th>
+                </tr>
+              </thead>
+              <tbody className="divide-y">
+                {data.contacts.map((c) => (
+                  <tr key={c.id}>
+                    <td className="px-3 py-1.5">
+                      <Link href={`/cari/${c.id}`} className="hover:underline">
+                        {c.name}
+                      </Link>
+                    </td>
+                    <td className="px-3 py-1.5">{c.balanceMinor > 0 ? t.owesMe : t.iOwe}</td>
+                    <td
+                      className={cn(
+                        "px-3 py-1.5 text-right font-medium",
+                        c.balanceMinor > 0 ? "text-income" : "text-expense",
+                      )}
+                    >
+                      {formatMoney(Math.abs(c.balanceMinor))}
+                    </td>
+                    <td className="px-3 py-1.5 text-right">
+                      {c.dueDate ? dayLabel(c.dueDate) : "—"}
+                      {t.dueStates[c.due] ? (
+                        <Badge
+                          variant="outline"
+                          className={cn(
+                            "ml-2",
+                            c.due === "overdue" && "border-expense/50 text-expense",
+                          )}
+                        >
+                          {t.dueStates[c.due]}
+                        </Badge>
+                      ) : null}
+                    </td>
+                  </tr>
+                ))}
+              </tbody>
+            </table>
+          </div>
+        ) : (
+          <p className="rounded-lg border border-dashed p-6 text-center text-sm text-muted-foreground">
+            {t.noContacts}
+          </p>
+        )}
+      </section>
+
+      <section aria-labelledby="ayni-h" className="flex flex-col gap-2">
+        <div>
+          <h2 id="ayni-h" className="font-medium">
+            {t.inKindTitle}
+          </h2>
+          <p className="text-xs text-muted-foreground">{t.inKindHint}</p>
+        </div>
+        {data.inKind.length ? (
+          <div className="overflow-x-auto rounded-xl border bg-card">
+            <table className="w-full min-w-[32rem] text-sm tabular-nums">
+              <thead className="border-b text-xs text-muted-foreground">
+                <tr>
+                  <th className="px-3 py-2 text-left font-normal">{t.contact}</th>
+                  <th className="px-3 py-2 text-left font-normal">{t.direction}</th>
+                  <th className="px-3 py-2 text-right font-normal">{t.remaining}</th>
+                  <th className="px-3 py-2 text-right font-normal">{t.value}</th>
+                  <th className="px-3 py-2 text-right font-normal">{t.since}</th>
+                </tr>
+              </thead>
+              <tbody className="divide-y">
+                {data.inKind.map((d) => (
+                  <tr key={d.id}>
+                    <td className="px-3 py-1.5">
+                      <Link href={`/cari/${d.contactId}`} className="hover:underline">
+                        {d.contactName}
+                      </Link>
+                    </td>
+                    <td className="px-3 py-1.5">
+                      {d.direction === "receivable" ? t.receivable : t.debt}
+                    </td>
+                    <td className="px-3 py-1.5 text-right">{d.remainingLabel}</td>
+                    <td className="px-3 py-1.5 text-right">
+                      {d.valueMinor === null ? "—" : formatMoney(d.valueMinor)}
+                    </td>
+                    <td className="px-3 py-1.5 text-right">{dayLabel(d.date)}</td>
+                  </tr>
+                ))}
+              </tbody>
+            </table>
+          </div>
+        ) : (
+          <p className="rounded-lg border border-dashed p-6 text-center text-sm text-muted-foreground">
+            {t.noInKind}
+          </p>
+        )}
+        {data.inKindTotals.unpriced ? (
+          <p className="text-xs text-muted-foreground">{t.unpriced(data.inKindTotals.unpriced)}</p>
+        ) : null}
+      </section>
+    </div>
+  );
+}
+
+export function AssetsReportView({ data }: { data: AssetsReport }) {
+  const t = tr.reports.assets;
+  const p = data.period;
+  const tone = (n: number | null) =>
+    n === null ? "" : n < 0 ? "text-expense" : n > 0 ? "text-income" : "";
+  return (
+    <div className="flex flex-col gap-6">
+      <section aria-labelledby="period-h" className="flex flex-col gap-2">
+        <h2 id="period-h" className="font-medium">
+          {t.periodTitle}: {dayLabel(p.from)} – {dayLabel(p.to)}
+        </h2>
+        <div className="grid grid-cols-2 gap-3 md:grid-cols-5">
+          <Stat
+            label={t.startValue}
+            value={p.startValueMinor === null ? "—" : formatMoney(p.startValueMinor)}
+          />
+          <Stat label={t.invested} value={formatMoney(p.investedMinor)} />
+          <Stat label={t.proceeds} value={formatMoney(p.proceedsMinor)} />
+          <Stat
+            label={t.endValue}
+            value={p.endValueMinor === null ? "—" : formatMoney(p.endValueMinor)}
+          />
+          <Stat
+            label={t.profit}
+            value={p.profitMinor === null ? "—" : `${signed(p.profitMinor)}${bp(p.profitBp)}`}
+            tone={tone(p.profitMinor)}
+          />
+        </div>
+        {p.excluded ? (
+          <p className="text-xs text-muted-foreground">{t.excluded(p.excluded)}</p>
+        ) : null}
+      </section>
+
+      {data.items.length ? (
+        <div className="overflow-x-auto rounded-xl border bg-card">
+          <table className="w-full min-w-[40rem] text-sm tabular-nums">
+            <thead className="border-b text-xs text-muted-foreground">
+              <tr>
+                <th className="px-3 py-2 text-left font-normal">{t.asset}</th>
+                <th className="px-3 py-2 text-right font-normal">{t.quantity}</th>
+                <th className="px-3 py-2 text-right font-normal">{t.cost}</th>
+                <th className="px-3 py-2 text-right font-normal">{t.value}</th>
+                <th className="px-3 py-2 text-right font-normal">{t.unrealized}</th>
+                <th className="px-3 py-2 text-right font-normal">{t.realized}</th>
+              </tr>
+            </thead>
+            <tbody className="divide-y">
+              {data.items.map((a) => (
+                <tr key={a.id}>
+                  <td className="px-3 py-1.5">
+                    <Link href={`/birikim/${a.id}`} className="hover:underline">
+                      {a.name || a.label}
+                    </Link>
+                  </td>
+                  <td className="px-3 py-1.5 text-right">
+                    {formatAssetQuantity(a.assetKey, a.summary.quantity)}
+                  </td>
+                  <td className="px-3 py-1.5 text-right">{formatMoney(a.summary.costMinor)}</td>
+                  <td className="px-3 py-1.5 text-right">
+                    {a.summary.currentValueMinor === null
+                      ? t.noPrice
+                      : formatMoney(a.summary.currentValueMinor)}
+                  </td>
+                  <td className={cn("px-3 py-1.5 text-right", tone(a.summary.unrealizedMinor))}>
+                    {a.summary.unrealizedMinor === null
+                      ? "—"
+                      : `${signed(a.summary.unrealizedMinor)}${bp(a.summary.unrealizedBp)}`}
+                  </td>
+                  <td className={cn("px-3 py-1.5 text-right", tone(a.summary.realizedMinor))}>
+                    {signed(a.summary.realizedMinor)}
+                  </td>
+                </tr>
+              ))}
+            </tbody>
+            <tfoot className="border-t font-medium">
+              <tr>
+                <td className="px-3 py-2">{t.total}</td>
+                <td />
+                <td className="px-3 py-2 text-right">{formatMoney(data.totals.costMinor)}</td>
+                <td className="px-3 py-2 text-right">{formatMoney(data.totals.valueMinor)}</td>
+                <td className={cn("px-3 py-2 text-right", tone(data.totals.unrealizedMinor))}>
+                  {signed(data.totals.unrealizedMinor)}
+                </td>
+                <td className={cn("px-3 py-2 text-right", tone(data.totals.realizedMinor))}>
+                  {signed(data.totals.realizedMinor)}
+                </td>
+              </tr>
+            </tfoot>
+          </table>
+        </div>
+      ) : (
+        <p className="rounded-lg border border-dashed p-6 text-center text-sm text-muted-foreground">
+          {t.empty}
+        </p>
+      )}
+    </div>
+  );
+}

src/features/reports/components/people-view.tsx

@@ -0,0 +1,108 @@
+import { Badge } from "@/components/ui/badge";
+import { tr } from "@/i18n/tr";
+import { cn } from "@/lib/utils";
+import { formatMoney } from "@/shared/format";
+import type { PeopleAccountsReport } from "../service";
+import { formatPct } from "./report-frame";
+
+const t = tr.reports.people;
+const signed = (n: number) => `${n > 0 ? "+" : n < 0 ? "−" : ""}${formatMoney(Math.abs(n))}`;
+
+/** Kişi bazlı harcama (pay çubuğu + tablo) ve hesap bazlı hareket tablosu. */
+export function PeopleView({ data }: { data: PeopleAccountsReport }) {
+  return (
+    <div className="flex flex-col gap-6">
+      <section aria-labelledby="people-h" className="flex flex-col gap-2">
+        <div>
+          <h2 id="people-h" className="font-medium">
+            {t.peopleTitle}
+          </h2>
+          <p className="text-xs text-muted-foreground">{t.peopleHint}</p>
+        </div>
+        {data.people.length ? (
+          <ul className="divide-y rounded-xl border bg-card">
+            {data.people.map((p) => (
+              <li key={p.userId} className="flex flex-col gap-1.5 p-3 text-sm">
+                <div className="flex items-baseline gap-3">
+                  <span className="min-w-0 flex-1 truncate font-medium">{p.name}</span>
+                  <span className="text-xs text-muted-foreground tabular-nums">
+                    {p.count} {t.count.toLocaleLowerCase("tr-TR")}
+                  </span>
+                  <span className="w-24 text-right tabular-nums">
+                    {formatMoney(p.expenseMinor)}
+                  </span>
+                  <span className="w-14 text-right text-muted-foreground tabular-nums">
+                    {formatPct(p.sharePct)}
+                  </span>
+                </div>
+                <div className="h-1.5 overflow-hidden rounded-full bg-muted" aria-hidden>
+                  <div
+                    className="h-full rounded-full bg-expense"
+                    style={{ width: `${p.sharePct}%` }}
+                  />
+                </div>
+              </li>
+            ))}
+            <li className="flex justify-between p-3 text-sm font-medium">
+              <span>{tr.reports.categories.total}</span>
+              <span className="tabular-nums">{formatMoney(data.peopleTotalMinor)}</span>
+            </li>
+          </ul>
+        ) : (
+          <p className="rounded-lg border border-dashed p-6 text-center text-sm text-muted-foreground">
+            {tr.reports.noData}
+          </p>
+        )}
+      </section>
+
+      <section aria-labelledby="acc-h" className="flex flex-col gap-2">
+        <div>
+          <h2 id="acc-h" className="font-medium">
+            {t.accountsTitle}
+          </h2>
+          <p className="text-xs text-muted-foreground">{t.accountsHint}</p>
+        </div>
+        <div className="overflow-x-auto rounded-xl border bg-card">
+          <table className="w-full min-w-[40rem] text-sm tabular-nums">
+            <thead className="border-b text-xs text-muted-foreground">
+              <tr>
+                <th className="px-3 py-2 text-left font-normal">{t.account}</th>
+                <th className="px-3 py-2 text-right font-normal">{t.income}</th>
+                <th className="px-3 py-2 text-right font-normal">{t.expense}</th>
+                <th className="px-3 py-2 text-right font-normal">{t.transferIn}</th>
+                <th className="px-3 py-2 text-right font-normal">{t.transferOut}</th>
+                <th className="px-3 py-2 text-right font-normal">{t.net}</th>
+                <th className="px-3 py-2 text-right font-normal">{t.count}</th>
+              </tr>
+            </thead>
+            <tbody className="divide-y">
+              {data.accounts.map((a) => (
+                <tr key={a.id} className={cn(a.count === 0 && "text-muted-foreground")}>
+                  <td className="px-3 py-1.5">
+                    <span className="flex items-center gap-2">
+                      {a.name}
+                      {a.archived ? <Badge variant="secondary">{t.archived}</Badge> : null}
+                    </span>
+                  </td>
+                  <td className="px-3 py-1.5 text-right">{formatMoney(a.incomeMinor)}</td>
+                  <td className="px-3 py-1.5 text-right">{formatMoney(a.expenseMinor)}</td>
+                  <td className="px-3 py-1.5 text-right">{formatMoney(a.transferInMinor)}</td>
+                  <td className="px-3 py-1.5 text-right">{formatMoney(a.transferOutMinor)}</td>
+                  <td
+                    className={cn(
+                      "px-3 py-1.5 text-right font-medium",
+                      a.netMinor < 0 ? "text-expense" : a.netMinor > 0 ? "text-income" : "",
+                    )}
+                  >
+                    {signed(a.netMinor)}
+                  </td>
+                  <td className="px-3 py-1.5 text-right">{a.count}</td>
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </div>
+      </section>
+    </div>
+  );
+}

src/features/reports/components/report-frame.tsx

@@ -0,0 +1,168 @@
+import { ArrowLeft, ChevronLeft, ChevronRight, Download } from "lucide-react";
+import Link from "next/link";
+import { PageHeader } from "@/components/page-header";
+import { Button } from "@/components/ui/button";
+import { tr } from "@/i18n/tr";
+import { shiftMonth } from "@/shared/budget";
+
+const t = tr.reports;
+
+const monthFmt = new Intl.DateTimeFormat("tr-TR", { month: "long", year: "numeric" });
+export const monthLabel = (month: string) =>
+  monthFmt.format(new Date(`${month}-15T12:00:00+03:00`));
+const monthShortFmt = new Intl.DateTimeFormat("tr-TR", { month: "short", year: "2-digit" });
+export const monthShort = (month: string) =>
+  monthShortFmt.format(new Date(`${month}-15T12:00:00+03:00`));
+
+/** 14,3 → "%14,3"; −20 → "−%20"; null → "—". */
+export function formatPct(n: number | null): string {
+  if (n === null) return "—";
+  const abs = Math.abs(n).toLocaleString("tr-TR", { maximumFractionDigits: 1 });
+  return n < 0 ? `−%${abs}` : `%${abs}`;
+}
+
+/** Önceki / sonraki bütçe ayı (?ay=). Gelecek aya gidilmez. */
+export function MonthNav({
+  month,
+  currentMonth,
+  path,
+}: {
+  month: string;
+  currentMonth: string;
+  path: string;
+}) {
+  const next = shiftMonth(month, 1);
+  return (
+    <nav aria-label={t.currentMonth} className="flex items-center gap-1">
+      <Button variant="outline" size="icon-sm" asChild>
+        <Link href={`${path}?ay=${shiftMonth(month, -1)}`} aria-label={t.prevMonth}>
+          <ChevronLeft />
+        </Link>
+      </Button>
+      <span className="min-w-36 text-center text-sm font-medium capitalize">
+        {monthLabel(month)}
+      </span>
+      {next <= currentMonth ? (
+        <Button variant="outline" size="icon-sm" asChild>
+          <Link href={`${path}?ay=${next}`} aria-label={t.nextMonth}>
+            <ChevronRight />
+          </Link>
+        </Button>
+      ) : (
+        <Button variant="outline" size="icon-sm" disabled aria-label={t.nextMonth}>
+          <ChevronRight />
+        </Button>
+      )}
+      {month !== currentMonth ? (
+        <Button variant="ghost" size="sm" asChild>
+          <Link href={path}>{t.currentMonth}</Link>
+        </Button>
+      ) : null}
+    </nav>
+  );
+}
+
+/** Rapor sayfası çerçevesi: geri bağlantısı, başlık, araçlar (ay seçici, CSV). */
+export function ReportFrame({
+  title,
+  description,
+  tools,
+  children,
+}: {
+  title: string;
+  description: React.ReactNode;
+  tools?: React.ReactNode;
+  children: React.ReactNode;
+}) {
+  return (
+    <div className="flex flex-col gap-4">
+      <Button variant="ghost" size="sm" asChild className="-ml-2 w-fit">
+        <Link href="/raporlar">
+          <ArrowLeft />
+          {t.back}
+        </Link>
+      </Button>
+      <PageHeader title={title} description={description} />
+      {tools ? <div className="flex flex-wrap items-center gap-2">{tools}</div> : null}
+      {children}
+    </div>
+  );
+}
+
+export function CsvButton({ href, label }: { href: string; label?: string }) {
+  return (
+    <Button variant="outline" size="sm" asChild>
+      <a href={href} download>
+        <Download />
+        {label ?? t.csv}
+      </a>
+    </Button>
+  );
+}
+
+/** Araç çubuğunun sağ tarafı (CSV düğmeleri). */
+export function ToolsEnd({ children }: { children: React.ReactNode }) {
+  return <div className="ml-auto flex flex-wrap gap-2">{children}</div>;
+}
+
+/** İşaretli tutar ve yüzde değişim; renk tek başına anlam taşımaz (işaret metinde). */
+export function Change({
+  minor,
+  pct,
+  format,
+}: {
+  minor: number;
+  pct: number | null;
+  format: (n: number) => string;
+}) {
+  if (minor === 0) return <span className="text-muted-foreground tabular-nums">0</span>;
+  const up = minor > 0;
+  return (
+    <span className={`tabular-nums ${up ? "text-expense" : "text-income"}`}>
+      {up ? "+" : "−"}
+      {format(Math.abs(minor))}
+      {pct !== null ? ` (${up ? "+" : "−"}%${Math.abs(pct).toLocaleString("tr-TR")})` : ""}
+    </span>
+  );
+}
+
+/** Dönem seçici (?donem=…): seçenekler bağlantı, seçili olan vurgulu. */
+export function RangeNav({
+  path,
+  param = "donem",
+  options,
+  value,
+  label,
+}: {
+  path: string;
+  param?: string;
+  options: { value: string; label: string }[];
+  value: string;
+  label: string;
+}) {
+  return (
+    <nav aria-label={label} className="flex rounded-lg bg-muted p-0.5">
+      {options.map((o) => (
+        <Link
+          key={o.value}
+          href={`${path}?${param}=${o.value}`}
+          aria-current={o.value === value ? "page" : undefined}
+          className={
+            o.value === value
+              ? "rounded-md bg-background px-2.5 py-1 text-sm font-medium shadow-sm"
+              : "rounded-md px-2.5 py-1 text-sm text-muted-foreground hover:text-foreground"
+          }
+        >
+          {o.label}
+        </Link>
+      ))}
+    </nav>
+  );
+}
+
+const dayFmt = new Intl.DateTimeFormat("tr-TR", {
+  day: "numeric",
+  month: "short",
+  year: "numeric",
+});
+export const dayLabel = (ymd: string) => dayFmt.format(new Date(`${ymd}T12:00:00+03:00`));

src/features/reports/components/shopping-waste-view.tsx

@@ -0,0 +1,234 @@
+import Link from "next/link";
+import { tr } from "@/i18n/tr";
+import { cn } from "@/lib/utils";
+import { formatMoney } from "@/shared/format";
+import { WASTE_REASONS } from "@/shared/stock";
+import { formatStock } from "@/shared/stock";
+import type { ShoppingReport, WasteReport } from "../extra";
+import { dayLabel, formatPct } from "./report-frame";
+
+const signed = (n: number) => `${n > 0 ? "+" : n < 0 ? "−" : ""}${formatMoney(Math.abs(n))}`;
+const empty = (text: string) => (
+  <p className="rounded-lg border border-dashed p-6 text-center text-sm text-muted-foreground">
+    {text}
+  </p>
+);
+
+export function ShoppingReportView({ data }: { data: ShoppingReport }) {
+  const t = tr.reports.shopping;
+  const reasons = tr.shopping.report.reasons;
+  const reasonRows = (
+    ["price", "quantity", "substitute", "skipped", "extra", "unplanned"] as const
+  ).filter((k) => data.listTotals[k] !== 0);
+  return (
+    <div className="flex flex-col gap-6">
+      <section aria-labelledby="lists-h" className="flex flex-col gap-2">
+        <h2 id="lists-h" className="font-medium">
+          {t.listsTitle}
+        </h2>
+        {data.lists.length ? (
+          <>
+            <div className="overflow-x-auto rounded-xl border bg-card">
+              <table className="w-full min-w-[36rem] text-sm tabular-nums">
+                <thead className="border-b text-xs text-muted-foreground">
+                  <tr>
+                    <th className="px-3 py-2 text-left font-normal">{t.date}</th>
+                    <th className="px-3 py-2 text-left font-normal">{t.list}</th>
+                    <th className="px-3 py-2 text-right font-normal">{t.planned}</th>
+                    <th className="px-3 py-2 text-right font-normal">{t.actual}</th>
+                    <th className="px-3 py-2 text-right font-normal">{t.diff}</th>
+                  </tr>
+                </thead>
+                <tbody className="divide-y">
+                  {data.lists.map((l) => (
+                    <tr key={l.id}>
+                      <td className="px-3 py-1.5 whitespace-nowrap">{dayLabel(l.date)}</td>
+                      <td className="px-3 py-1.5">
+                        <Link href={`/alisveris/${l.id}`} className="font-medium hover:underline">
+                          {l.name}
+                        </Link>
+                        <span className="block text-xs text-muted-foreground">
+                          {t.counts(
+                            l.summary.counts.same,
+                            l.summary.counts.substitute,
+                            l.summary.counts.skipped,
+                            l.summary.counts.extra,
+                          )}
+                          {l.stores.length ? ` · ${l.stores.join(", ")}` : ""}
+                        </span>
+                      </td>
+                      <td className="px-3 py-1.5 text-right">
+                        {formatMoney(l.summary.plannedMinor)}
+                      </td>
+                      <td className="px-3 py-1.5 text-right">
+                        {formatMoney(l.summary.actualMinor)}
+                      </td>
+                      <td
+                        className={cn(
+                          "px-3 py-1.5 text-right",
+                          l.summary.diffMinor > 0
+                            ? "text-expense"
+                            : l.summary.diffMinor < 0
+                              ? "text-income"
+                              : "",
+                        )}
+                      >
+                        {signed(l.summary.diffMinor)}
+                      </td>
+                    </tr>
+                  ))}
+                </tbody>
+                <tfoot className="border-t font-medium">
+                  <tr>
+                    <td className="px-3 py-2" colSpan={2}>
+                      {t.total}
+                    </td>
+                    <td className="px-3 py-2 text-right">
+                      {formatMoney(data.listTotals.plannedMinor)}
+                    </td>
+                    <td className="px-3 py-2 text-right">
+                      {formatMoney(data.listTotals.actualMinor)}
+                    </td>
+                    <td className="px-3 py-2 text-right">{signed(data.listTotals.diffMinor)}</td>
+                  </tr>
+                </tfoot>
+              </table>
+            </div>
+            {reasonRows.length ? (
+              <ul className="flex flex-col gap-1 rounded-xl border bg-card p-3 text-sm">
+                {reasonRows.map((k) => (
+                  <li key={k} className="flex justify-between gap-3">
+                    <span>{reasons[k]}</span>
+                    <span className="tabular-nums">{signed(data.listTotals[k])}</span>
+                  </li>
+                ))}
+              </ul>
+            ) : null}
+          </>
+        ) : (
+          empty(t.listsEmpty)
+        )}
+      </section>
+
+      <section aria-labelledby="stores-h" className="flex flex-col gap-2">
+        <div>
+          <h2 id="stores-h" className="font-medium">
+            {t.storesTitle}
+          </h2>
+          <p className="text-xs text-muted-foreground">{t.storesHint}</p>
+        </div>
+        {data.stores.length ? (
+          <ul className="divide-y rounded-xl border bg-card">
+            {data.stores.map((s) => (
+              <li key={s.name} className="flex flex-col gap-1.5 p-3 text-sm">
+                <div className="flex items-baseline gap-3">
+                  <span className="min-w-0 flex-1 truncate font-medium">{s.name}</span>
+                  <span className="text-xs text-muted-foreground tabular-nums">
+                    {s.count} {t.count.toLocaleLowerCase("tr-TR")}
+                    {s.fromListsMinor ? ` · ${t.fromLists} ${formatMoney(s.fromListsMinor)}` : ""}
+                  </span>
+                  <span className="w-28 text-right tabular-nums">{formatMoney(s.amountMinor)}</span>
+                  <span className="w-14 text-right text-muted-foreground tabular-nums">
+                    {formatPct(s.sharePct)}
+                  </span>
+                </div>
+                <div className="h-1.5 overflow-hidden rounded-full bg-muted" aria-hidden>
+                  <div
+                    className="h-full rounded-full bg-budget"
+                    style={{ width: `${s.sharePct}%` }}
+                  />
+                </div>
+              </li>
+            ))}
+            <li className="flex justify-between p-3 text-sm font-medium">
+              <span>{t.total}</span>
+              <span className="tabular-nums">{formatMoney(data.storesTotalMinor)}</span>
+            </li>
+          </ul>
+        ) : (
+          empty(t.storesEmpty)
+        )}
+      </section>
+    </div>
+  );
+}
+
+export function WasteReportView({ data }: { data: WasteReport }) {
+  const t = tr.reports.waste;
+  const reasonText = tr.stock.wasteReasons;
+  if (!data.rows.length) return empty(t.empty);
+  return (
+    <div className="flex flex-col gap-4">
+      <div className="grid gap-3 md:grid-cols-[minmax(0,14rem)_minmax(0,1fr)]">
+        <div className="rounded-xl border bg-card p-3">
+          <p className="text-xs text-muted-foreground">{t.total}</p>
+          <p className="text-lg font-semibold text-expense tabular-nums">
+            {formatMoney(data.totalCostMinor)}
+          </p>
+          <p className="text-[11px] text-muted-foreground">{t.costHint}</p>
+        </div>
+        <div className="rounded-xl border bg-card p-3">
+          <h2 className="mb-1 text-xs text-muted-foreground">{t.reasonsTitle}</h2>
+          <ul className="flex flex-col gap-1 text-sm">
+            {WASTE_REASONS.filter((r) => data.reasons[r].count).map((r) => (
+              <li key={r} className="flex justify-between gap-3">
+                <span>
+                  {reasonText[r]}{" "}
+                  <span className="text-xs text-muted-foreground">
+                    ({t.count(data.reasons[r].count)})
+                  </span>
+                </span>
+                <span className="tabular-nums">{formatMoney(data.reasons[r].costMinor)}</span>
+              </li>
+            ))}
+          </ul>
+        </div>
+      </div>
+      <div className="overflow-x-auto rounded-xl border bg-card">
+        <table className="w-full min-w-[36rem] text-sm tabular-nums">
+          <thead className="border-b text-xs text-muted-foreground">
+            <tr>
+              <th className="px-3 py-2 text-left font-normal">{t.product}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.wasted}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.purchased}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.ratio}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.cost}</th>
+            </tr>
+          </thead>
+          <tbody className="divide-y">
+            {data.rows.map((r) => (
+              <tr key={r.productTypeId}>
+                <td className="px-3 py-1.5">
+                  <Link href={`/stok/${r.productTypeId}`} className="hover:underline">
+                    {r.name}
+                  </Link>
+                  <span className="block text-xs text-muted-foreground">
+                    {WASTE_REASONS.filter((x) => r.byReason[x])
+                      .map((x) => `${reasonText[x]}: ${formatStock(r.byReason[x], r.unit)}`)
+                      .join(" · ")}
+                  </span>
+                </td>
+                <td className="px-3 py-1.5 text-right">{formatStock(r.wasted, r.unit)}</td>
+                <td className="px-3 py-1.5 text-right">{formatStock(r.purchased, r.unit)}</td>
+                <td
+                  className={cn(
+                    "px-3 py-1.5 text-right",
+                    (r.wastePct ?? 0) >= 15 && "font-medium text-expense",
+                  )}
+                >
+                  {formatPct(r.wastePct)}
+                </td>
+                <td className="px-3 py-1.5 text-right">
+                  {r.costMinor === null ? "—" : formatMoney(r.costMinor)}
+                </td>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+      </div>
+      {data.unpriced ? (
+        <p className="text-xs text-muted-foreground">{t.unpriced(data.unpriced)}</p>
+      ) : null}
+    </div>
+  );
+}

src/features/reports/components/trend-view.tsx

@@ -0,0 +1,196 @@
+"use client";
+
+import {
+  Bar,
+  BarChart,
+  CartesianGrid,
+  Line,
+  LineChart,
+  ReferenceLine,
+  XAxis,
+  YAxis,
+} from "recharts";
+import {
+  ChartContainer,
+  ChartLegend,
+  ChartLegendContent,
+  ChartTooltip,
+  ChartTooltipContent,
+  type ChartConfig,
+} from "@/components/ui/chart";
+import { tr } from "@/i18n/tr";
+import { cn } from "@/lib/utils";
+import { formatMoney } from "@/shared/format";
+import type { TrendReport } from "../service";
+import { monthLabel, monthShort, formatPct } from "./report-frame";
+
+const t = tr.reports.trend;
+const compact = new Intl.NumberFormat("tr-TR", { notation: "compact", maximumFractionDigits: 1 });
+
+const barConfig = {
+  income: { label: t.income, color: "var(--income)" },
+  expense: { label: t.expense, color: "var(--expense)" },
+} satisfies ChartConfig;
+const rateConfig = { rate: { label: t.savings, color: "var(--budget)" } } satisfies ChartConfig;
+
+export function TrendView({ data }: { data: TrendReport }) {
+  const chart = data.months.map((m) => ({
+    month: m.month,
+    label: monthShort(m.month),
+    income: m.incomeMinor / 100,
+    expense: m.expenseMinor / 100,
+    // Devam eden ayın oranı (maaş henüz yatmamış olabilir) ölçeği bozmasın: grafikte yok.
+    rate: m.month === data.currentMonth ? null : m.savingsPct,
+  }));
+  const moneyTip = (
+    <ChartTooltipContent
+      labelFormatter={(_, payload) => {
+        const m = payload?.[0]?.payload?.month as string | undefined;
+        return m ? monthLabel(m) : "";
+      }}
+      formatter={(value, name) => (
+        <div className="flex w-full items-center justify-between gap-3">
+          <span className="text-muted-foreground">
+            {barConfig[name as keyof typeof barConfig]?.label}
+          </span>
+          <span className="font-medium text-foreground tabular-nums">
+            {formatMoney(Math.round(Number(value) * 100))}
+          </span>
+        </div>
+      )}
+    />
+  );
+
+  return (
+    <div className="flex flex-col gap-4">
+      <div className="rounded-xl border bg-card p-4">
+        <ChartContainer
+          config={barConfig}
+          className="aspect-auto h-64 w-full"
+          role="img"
+          aria-label={t.chartLabel}
+        >
+          <BarChart data={chart} margin={{ left: 4, right: 8, top: 8 }} barGap={2}>
+            <CartesianGrid vertical={false} />
+            <XAxis dataKey="label" tickLine={false} axisLine={false} tickMargin={8} />
+            <YAxis
+              tickLine={false}
+              axisLine={false}
+              width={48}
+              tickFormatter={(v: number) => compact.format(v)}
+            />
+            <ChartTooltip content={moneyTip} />
+            <ChartLegend content={<ChartLegendContent />} />
+            <Bar
+              dataKey="income"
+              fill="var(--color-income)"
+              radius={[4, 4, 0, 0]}
+              isAnimationActive={false}
+            />
+            <Bar
+              dataKey="expense"
+              fill="var(--color-expense)"
+              radius={[4, 4, 0, 0]}
+              isAnimationActive={false}
+            />
+          </BarChart>
+        </ChartContainer>
+      </div>
+
+      <div className="rounded-xl border bg-card p-4">
+        <h2 className="text-sm font-medium">{t.rateTitle}</h2>
+        <p className="mb-2 text-xs text-muted-foreground">
+          {t.rateHint} {t.partialHint}
+        </p>
+        <ChartContainer
+          config={rateConfig}
+          className="aspect-auto h-40 w-full"
+          role="img"
+          aria-label={t.rateChartLabel}
+        >
+          <LineChart data={chart} margin={{ left: 4, right: 8, top: 8 }}>
+            <CartesianGrid vertical={false} />
+            <XAxis dataKey="label" tickLine={false} axisLine={false} tickMargin={8} />
+            <YAxis
+              tickLine={false}
+              axisLine={false}
+              width={40}
+              tickFormatter={(v: number) => `%${v}`}
+            />
+            <ReferenceLine y={0} stroke="var(--border)" />
+            <ChartTooltip
+              content={
+                <ChartTooltipContent
+                  labelFormatter={(_, payload) => {
+                    const m = payload?.[0]?.payload?.month as string | undefined;
+                    return m ? monthLabel(m) : "";
+                  }}
+                  formatter={(value) => (
+                    <span className="font-medium text-foreground tabular-nums">
+                      {formatPct(Number(value))}
+                    </span>
+                  )}
+                />
+              }
+            />
+            <Line
+              dataKey="rate"
+              stroke="var(--color-rate)"
+              strokeWidth={2}
+              dot={{ r: 3 }}
+              connectNulls={false}
+              isAnimationActive={false}
+            />
+          </LineChart>
+        </ChartContainer>
+      </div>
+
+      <div className="overflow-x-auto rounded-xl border bg-card">
+        <table className="w-full min-w-[32rem] text-sm tabular-nums">
+          <thead className="border-b text-xs text-muted-foreground">
+            <tr>
+              <th className="px-3 py-2 text-left font-normal">{t.month}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.income}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.expense}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.net}</th>
+              <th className="px-3 py-2 text-right font-normal">{t.savings}</th>
+            </tr>
+          </thead>
+          <tbody className="divide-y">
+            {[...data.months].reverse().map((m) => (
+              <tr key={m.month} className={cn(m.month === data.currentMonth && "bg-muted/40")}>
+                <td className="px-3 py-1.5">
+                  <span className="capitalize">{monthLabel(m.month)}</span>
+                  {m.month === data.currentMonth ? (
+                    <span className="ml-1 text-xs text-muted-foreground">({t.ongoing})</span>
+                  ) : null}
+                </td>
+                <td className="px-3 py-1.5 text-right">{formatMoney(m.incomeMinor)}</td>
+                <td className="px-3 py-1.5 text-right">{formatMoney(m.expenseMinor)}</td>
+                <td className={cn("px-3 py-1.5 text-right", m.netMinor < 0 && "text-expense")}>
+                  {m.netMinor < 0 ? "−" : ""}
+                  {formatMoney(Math.abs(m.netMinor))}
+                </td>
+                <td className="px-3 py-1.5 text-right">{formatPct(m.savingsPct)}</td>
+              </tr>
+            ))}
+          </tbody>
+          <tfoot className="border-t font-medium">
+            <tr>
+              <td className="px-3 py-2">{t.total}</td>
+              <td className="px-3 py-2 text-right">{formatMoney(data.totals.incomeMinor)}</td>
+              <td className="px-3 py-2 text-right">{formatMoney(data.totals.expenseMinor)}</td>
+              <td
+                className={cn("px-3 py-2 text-right", data.totals.netMinor < 0 && "text-expense")}
+              >
+                {data.totals.netMinor < 0 ? "−" : ""}
+                {formatMoney(Math.abs(data.totals.netMinor))}
+              </td>
+              <td className="px-3 py-2 text-right">{formatPct(data.totals.savingsPct)}</td>
+            </tr>
+          </tfoot>
+        </table>
+      </div>
+    </div>
+  );
+}

src/features/reports/components/unit-price-view.tsx

@@ -0,0 +1,178 @@
+"use client";
+
+import { useRouter } from "next/navigation";
+import { CartesianGrid, Line, LineChart, XAxis, YAxis } from "recharts";
+import {
+  ChartContainer,
+  ChartLegend,
+  ChartLegendContent,
+  ChartTooltip,
+  ChartTooltipContent,
+  type ChartConfig,
+} from "@/components/ui/chart";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import { tr } from "@/i18n/tr";
+import { formatUnitPrice, unitPriceBase } from "@/shared/prices";
+import type { UnitPriceReport } from "../extra";
+import { dayLabel, monthLabel, monthShort } from "./report-frame";
+
+const t = tr.reports.unitPrice;
+const config = {
+  min: { label: t.min, color: "var(--income)" },
+  avg: { label: t.avg, color: "var(--budget)" },
+} satisfies ChartConfig;
+
+/** Ürün tipi seçimi (URL'de) ve aylık en düşük / ortalama birim fiyat. */
+export function UnitPriceView({ data }: { data: UnitPriceReport }) {
+  const router = useRouter();
+  const sel = data.selected;
+  if (!sel)
+    return (
+      <p className="rounded-lg border border-dashed p-6 text-center text-sm text-muted-foreground">
+        {t.noTypes}
+      </p>
+    );
+  const base = unitPriceBase(sel.unit);
+  // Gösterim biriminde TL (g → kg, ml → lt).
+  const tl = (minor: number | null) => (minor === null ? null : (minor * base.factor) / 100);
+  const chart = sel.points.map((p) => ({
+    month: p.month,
+    label: monthShort(p.month),
+    min: tl(p.minMinor),
+    avg: tl(p.avgMinor),
+  }));
+  const fmt = (minor: number | null) => (minor === null ? "—" : formatUnitPrice(minor, sel.unit));
+
+  return (
+    <div className="flex flex-col gap-4">
+      <div className="flex items-center gap-2">
+        <label htmlFor="up-type" className="text-sm text-muted-foreground">
+          {t.type}
+        </label>
+        <Select
+          value={sel.id}
+          onValueChange={(id) => router.replace(`/raporlar/birim-fiyat?tip=${id}`)}
+        >
+          <SelectTrigger id="up-type" className="w-64">
+            <SelectValue />
+          </SelectTrigger>
+          <SelectContent className="max-h-72">
+            {data.types.map((x) => (
+              <SelectItem key={x.id} value={x.id}>
+                {x.name}{" "}
+                <span className="text-xs text-muted-foreground">({t.records(x.records)})</span>
+              </SelectItem>
+            ))}
+          </SelectContent>
+        </Select>
+      </div>
+
+      <div className="rounded-xl border bg-card p-4">
+        <ChartContainer
+          config={config}
+          className="aspect-auto h-60 w-full"
+          role="img"
+          aria-label={t.chartLabel(sel.name)}
+        >
+          <LineChart data={chart} margin={{ left: 4, right: 8, top: 8 }}>
+            <CartesianGrid vertical={false} />
+            <XAxis dataKey="label" tickLine={false} axisLine={false} tickMargin={8} />
+            <YAxis
+              tickLine={false}
+              axisLine={false}
+              width={56}
+              tickFormatter={(v: number) =>
+                `₺${v.toLocaleString("tr-TR", { maximumFractionDigits: 2 })}`
+              }
+            />
+            <ChartTooltip
+              content={
+                <ChartTooltipContent
+                  labelFormatter={(_, payload) => {
+                    const m = payload?.[0]?.payload?.month as string | undefined;
+                    return m ? monthLabel(m) : "";
+                  }}
+                  formatter={(value, name) => (
+                    <div className="flex w-full items-center justify-between gap-3">
+                      <span className="text-muted-foreground">
+                        {config[name as keyof typeof config]?.label}
+                      </span>
+                      <span className="font-medium text-foreground tabular-nums">
+                        {formatUnitPrice((Number(value) * 100) / base.factor, sel.unit)}
+                      </span>
+                    </div>
+                  )}
+                />
+              }
+            />
+            <ChartLegend content={<ChartLegendContent />} />
+            {(["min", "avg"] as const).map((k) => (
+              <Line
+                key={k}
+                dataKey={k}
+                stroke={`var(--color-${k})`}
+                strokeWidth={2}
+                strokeDasharray={k === "avg" ? "6 3" : undefined}
+                dot={{ r: 3 }}
+                connectNulls
+                isAnimationActive={false}
+              />
+            ))}
+          </LineChart>
+        </ChartContainer>
+        <table className="mt-3 w-full text-sm tabular-nums">
+          <thead className="text-xs text-muted-foreground">
+            <tr>
+              <th className="py-1 text-left font-normal">{t.month}</th>
+              <th className="py-1 text-right font-normal">{t.min}</th>
+              <th className="py-1 text-right font-normal">{t.avg}</th>
+              <th className="py-1 text-right font-normal">{t.count}</th>
+            </tr>
+          </thead>
+          <tbody className="divide-y">
+            {[...sel.points].reverse().map((p) => (
+              <tr key={p.month}>
+                <td className="py-1 capitalize">{monthLabel(p.month)}</td>
+                <td className="py-1 text-right">{fmt(p.minMinor)}</td>
+                <td className="py-1 text-right">{fmt(p.avgMinor)}</td>
+                <td className="py-1 text-right">{p.count}</td>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+      </div>
+
+      {sel.stores.length ? (
+        <section className="rounded-xl border bg-card p-4" aria-labelledby="up-stores">
+          <h2 id="up-stores" className="mb-2 text-sm font-medium">
+            {t.storesTitle}
+          </h2>
+          <table className="w-full text-sm tabular-nums">
+            <thead className="text-xs text-muted-foreground">
+              <tr>
+                <th className="py-1 text-left font-normal">{t.store}</th>
+                <th className="py-1 text-right font-normal">{t.min}</th>
+                <th className="py-1 text-right font-normal">{t.last}</th>
+              </tr>
+            </thead>
+            <tbody className="divide-y">
+              {sel.stores.map((s) => (
+                <tr key={s.id}>
+                  <td className="py-1">{s.label}</td>
+                  <td className="py-1 text-right">{fmt(s.minMinor)}</td>
+                  <td className="py-1 text-right">{dayLabel(s.lastDate)}</td>
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </section>
+      ) : null}
+    </div>
+  );
+}

src/features/reports/csv.ts

@@ -0,0 +1,34 @@
+import "server-only";
+import { tr } from "@/i18n/tr";
+import { getHouseholdContext } from "@/lib/dal";
+import { budgetMonthSchema } from "@/shared/schemas/budget";
+
+/** CSV rotaları için ortak: oturum + aktif hane, ?ay= doğrulaması ve yanıt üretimi. */
+export async function csvContext(request: Request) {
+  const ctx = await getHouseholdContext();
+  if (!ctx?.household) return null;
+  const params = new URL(request.url).searchParams;
+  const ay = budgetMonthSchema.safeParse(params.get("ay"));
+  return {
+    userId: ctx.user.id,
+    householdId: ctx.household.id,
+    month: ay.success ? ay.data : undefined,
+    params,
+  };
+}
+
+export const unauthorized = () => new Response(tr.common.unauthorized, { status: 401 });
+export const forbidden = () => new Response(tr.common.unauthorized, { status: 403 });
+
+export function csvResponse(csv: string, filename: string) {
+  return new Response(csv, {
+    headers: {
+      "Content-Type": "text/csv; charset=utf-8",
+      "Content-Disposition": `attachment; filename="${filename}"`,
+      "Cache-Control": "no-store",
+    },
+  });
+}
+
+/** 14,3 → "14,3" (CSV ondalık virgül). */
+export const csvPct = (n: number | null) => (n === null ? "" : String(n).replace(".", ","));

src/features/reports/extra.int.test.ts

@@ -0,0 +1,130 @@
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { completeShopping, getCompletionSheet } from "@/features/shopping/completion";
+import { AccountModel } from "@/models/account";
+import { ProductTypeModel } from "@/models/product-type";
+import { ShoppingListModel } from "@/models/shopping-list";
+import { todayIstanbul } from "@/shared/dates";
+import { formatMoneyInput } from "@/shared/money";
+import { shoppingCompletionSchema } from "@/shared/schemas/shopping";
+import { setupSeededDb, teardownDb } from "@/test/seeded-db";
+import {
+  getAssetsReport,
+  getContactsReport,
+  getShoppingReport,
+  getUnitPriceReport,
+  getWasteReport,
+} from "./extra";
+
+let ids: Awaited<ReturnType<typeof setupSeededDb>>;
+let cakir = "";
+let ayse = "";
+let zeynep = "";
+let fatma = "";
+
+beforeAll(async () => {
+  ids = await setupSeededDb();
+  cakir = ids.household("Çakır Ailesi");
+  ayse = ids.user("ayse");
+  zeynep = ids.user("zeynep");
+  fatma = ids.user("fatma");
+});
+afterAll(teardownDb);
+
+describe("cari ve aynî", () => {
+  it("bakiyeli cariler büyükten küçüğe; toplamlar; açık aynî borçlar; başka hane göremez", async () => {
+    const r = (await getContactsReport(ayse, cakir))!;
+    expect(r.contacts.length).toBeGreaterThan(0);
+    expect(r.contacts.every((c) => c.balanceMinor !== 0 && !c.archived)).toBe(true);
+    const abs = r.contacts.map((c) => Math.abs(c.balanceMinor));
+    expect(abs).toEqual([...abs].sort((a, b) => b - a));
+    expect(r.inKind.length).toBeGreaterThan(0);
+    expect(r.inKind.every((d) => d.remainingQuantity > 0)).toBe(true);
+    expect(await getContactsReport(fatma, cakir)).toBeNull();
+  });
+});
+
+describe("birikim", () => {
+  it("varlık kâr/zarar ve dönem raporu", async () => {
+    const r = (await getAssetsReport(ayse, cakir, "6"))!;
+    expect(r.items.length).toBeGreaterThan(0);
+    expect(r.period.from < r.period.to).toBe(true);
+    expect(r.range).toBe("6");
+  });
+});
+
+describe("alışveriş", () => {
+  it("mağaza bazlı harcama alıcı adıyla eşleşir; tamamlanan liste plan/gerçek satırı verir", async () => {
+    const before = (await getShoppingReport(ayse, cakir, 6))!;
+    expect(before.lists).toEqual([]);
+    expect(before.stores.map((s) => s.name)).toEqual(expect.arrayContaining(["Migros", "BİM"]));
+    expect(before.stores.reduce((a, s) => a + s.amountMinor, 0)).toBe(before.storesTotalMinor);
+
+    // Haftalık marketten yalnızca süt alınır, kalanlar bırakılır.
+    const weekly = String((await ShoppingListModel.findOne({ seedRef: "haftalik" }).lean())!._id);
+    const sheet = (await getCompletionSheet(ayse, cakir, weekly))!;
+    const milk = sheet.items.find((i) => i.label === "Süt")!;
+    const plan = sheet.planned[milk.id]!;
+    const account = String((await AccountModel.findOne({ name: "Ziraat Maaş" }).lean())!._id);
+    const done = await completeShopping(
+      ayse,
+      cakir,
+      weekly,
+      shoppingCompletionSchema.parse({
+        date: todayIstanbul(),
+        lines: [
+          {
+            itemId: milk.id,
+            productId: plan.productId,
+            storeId: plan.storeId,
+            packages: String(plan.packages),
+            amount: formatMoneyInput(plan.priceMinor * plan.packages),
+          },
+        ],
+        stores: [{ storeId: plan.storeId, accountId: account, attachmentIds: [] }],
+        leftover: { action: "drop" },
+      }),
+    );
+    expect(done.ok).toBe(true);
+
+    const after = (await getShoppingReport(ayse, cakir, 3))!;
+    expect(after.lists).toHaveLength(1);
+    const row = after.lists[0]!;
+    expect(row.summary.counts.same).toBe(1);
+    expect(row.summary.actualMinor).toBe(plan.priceMinor * plan.packages);
+    expect(after.listTotals.diffMinor).toBe(row.summary.diffMinor);
+    const store = after.stores.find((s) => s.fromListsMinor > 0)!;
+    expect(store.fromListsMinor).toBe(plan.priceMinor * plan.packages);
+  });
+});
+
+describe("birim fiyat geçmişi", () => {
+  it("fiyatı olan tipler; seçilen tipte 12 ay noktası ve mağaza en düşükleri", async () => {
+    const r = (await getUnitPriceReport(ayse, cakir))!;
+    expect(r.types.length).toBeGreaterThan(5);
+    expect(r.months).toHaveLength(12);
+    const toz = String((await ProductTypeModel.findOne({ seedRef: "toz-deterjan" }).lean())!._id);
+    const d = (await getUnitPriceReport(ayse, cakir, toz))!;
+    expect(d.selected!.id).toBe(toz);
+    expect(d.selected!.points).toHaveLength(12);
+    const priced = d.selected!.points.filter((p) => p.count > 0);
+    expect(priced.length).toBeGreaterThan(3);
+    for (const p of priced) expect(p.minMinor!).toBeLessThanOrEqual(p.avgMinor!);
+    const mins = d.selected!.stores.map((s) => s.minMinor);
+    expect(mins).toEqual([...mins].sort((a, b) => a - b));
+  });
+});
+
+describe("fire / zarar", () => {
+  it("fire satırları, oran ve nedenler; izleyici de okuyabilir", async () => {
+    const r = (await getWasteReport(zeynep, cakir, 12))!;
+    expect(r.rows.length).toBeGreaterThan(0);
+    for (const row of r.rows) {
+      const sum = Object.values(row.byReason).reduce((a, b) => a + b, 0);
+      expect(sum).toBe(row.wasted);
+      if (row.purchased > 0) expect(row.wastePct).not.toBeNull();
+    }
+    const priced = r.rows.reduce((a, x) => a + (x.costMinor ?? 0), 0);
+    expect(priced).toBe(r.totalCostMinor);
+    expect(await getWasteReport(fatma, cakir, 12)).toBeNull();
+  });
+});

src/features/reports/extra.ts

@@ -0,0 +1,482 @@
+import "server-only";
+import { Types } from "mongoose";
+import {
+  getPeriodReport,
+  listAssets,
+  type AssetView,
+  type ReportRange,
+} from "@/features/assets/service";
+import { listContacts, type ContactView } from "@/features/contacts/service";
+import { listInKind } from "@/features/in-kind/service";
+import { latestTypeUnitPrices, loadTypePriceHistory } from "@/features/prices/service";
+import { storeLabel } from "@/features/stores/service";
+import { TransactionModel } from "@/models/transaction";
+import { ProductPriceModel } from "@/models/product-price";
+import { ProductTypeModel } from "@/models/product-type";
+import { ShoppingListModel } from "@/models/shopping-list";
+import { StockMovementModel } from "@/models/stock-movement";
+import { StoreModel } from "@/models/store";
+import { formatAssetQuantity, type AssetKey, type InKindDirection } from "@/shared/assets";
+import { budgetPeriod, periodOfDate, shiftMonth } from "@/shared/budget";
+import { istanbulDayStart } from "@/shared/dates";
+import type { PeriodReport } from "@/shared/portfolio";
+import {
+  matchStoreName,
+  monthlyUnitPrices,
+  sharePct,
+  type ReportPeriod,
+  type UnitPricePoint,
+} from "@/shared/reports";
+import { foldTr, compareTr } from "@/shared/search";
+import type { ShoppingCompletion } from "@/shared/shopping";
+import { compareShopping, type ComparisonSummary } from "@/shared/shopping-compare";
+import { WASTE_REASONS, type WasteReason } from "@/shared/stock";
+import { base, type Base } from "./service";
+
+/**
+ * Faz 14b raporları: cari ve aynî borçlar, birikim kâr/zarar, alışveriş (liste vs. gerçekleşen,
+ * mağaza bazlı harcama), birim fiyat geçmişi, fire/zarar. Okuma: viewer; gizlilik kuralları
+ * kaynak servislerle aynı (gizli cari/varlık/hesap görünmez).
+ */
+
+const DAY_MS = 86_400_000;
+
+/** İçinde bulunulan dahil son N bütçe ayı ve tarih aralığı. */
+function periodRange(b: Base, months: number) {
+  const list = Array.from({ length: months }, (_, i) => shiftMonth(b.currentMonth, i - months + 1));
+  return {
+    months: list,
+    from: budgetPeriod(list[0]!, b.s.startDay).from,
+    to: budgetPeriod(list.at(-1)!, b.s.startDay).to,
+  };
+}
+
+// --- Cari özet ve aynî borçlar ---
+
+export type InKindRow = {
+  id: string;
+  contactId: string;
+  contactName: string;
+  direction: InKindDirection;
+  assetKey: AssetKey;
+  /** Kalan miktar ("12,5 gr 22 ayar"). */
+  remainingLabel: string;
+  remainingQuantity: number;
+  valueMinor: number | null;
+  date: string;
+};
+
+export type ContactsReport = {
+  contacts: ContactView[];
+  totals: { owesMeMinor: number; iOweMinor: number };
+  inKind: InKindRow[];
+  inKindTotals: { receivableMinor: number; debtMinor: number; unpriced: number };
+};
+
+export async function getContactsReport(
+  userId: string,
+  householdId: string,
+): Promise<ContactsReport | null> {
+  const [list, inKind] = await Promise.all([
+    listContacts(userId, householdId),
+    listInKind(userId, householdId),
+  ]);
+  if (!list || !inKind) return null;
+  const open = inKind.filter((d) => !d.closedAt && d.progress.remainingQuantity > 0);
+  const totals = { receivableMinor: 0, debtMinor: 0, unpriced: 0 };
+  for (const d of open) {
+    const v = d.progress.currentValueMinor;
+    if (v === null) totals.unpriced++;
+    else if (d.direction === "receivable") totals.receivableMinor += v;
+    else totals.debtMinor += v;
+  }
+  return {
+    contacts: list.contacts
+      .filter((c) => !c.archived && c.balanceMinor !== 0)
+      .sort((a, b) => Math.abs(b.balanceMinor) - Math.abs(a.balanceMinor)),
+    totals: list.totals,
+    inKind: open.map((d) => ({
+      id: d.id,
+      contactId: d.contactId,
+      contactName: d.contactName,
+      direction: d.direction,
+      assetKey: d.assetKey,
+      remainingLabel: formatAssetQuantity(d.assetKey, d.progress.remainingQuantity),
+      remainingQuantity: d.progress.remainingQuantity,
+      valueMinor: d.progress.currentValueMinor,
+      date: d.date,
+    })),
+    inKindTotals: totals,
+  };
+}
+
+// --- Birikim kâr/zarar ---
+
+export type AssetsReport = {
+  items: AssetView[];
+  totals: {
+    valueMinor: number;
+    costMinor: number;
+    unrealizedMinor: number;
+    realizedMinor: number;
+    missingPrice: number;
+  };
+  period: PeriodReport & { excluded: number };
+  range: ReportRange;
+};
+
+export async function getAssetsReport(
+  userId: string,
+  householdId: string,
+  range: ReportRange,
+): Promise<AssetsReport | null> {
+  const [assets, period] = await Promise.all([
+    listAssets(userId, householdId),
+    getPeriodReport(userId, householdId, range),
+  ]);
+  if (!assets || !period) return null;
+  return {
+    items: assets.items.filter((a) => a.summary.quantity > 0 || a.summary.realizedMinor !== 0),
+    totals: assets.totals,
+    period,
+    range,
+  };
+}
+
+// --- Alışveriş: liste vs. gerçekleşen, mağaza bazlı harcama ---
+
+export type CompletedListRow = {
+  id: string;
+  name: string;
+  date: string;
+  summary: ComparisonSummary;
+  stores: string[];
+};
+
+export type StoreSpendRow = {
+  name: string;
+  amountMinor: number;
+  count: number;
+  /** Alışverişi tamamla ile gelen kısım. */
+  fromListsMinor: number;
+  sharePct: number;
+};
+
+export type ShoppingReport = {
+  period: ReportPeriod;
+  from: string;
+  to: string;
+  lists: CompletedListRow[];
+  listTotals: ComparisonSummary["reasons"] & {
+    plannedMinor: number;
+    actualMinor: number;
+    diffMinor: number;
+  };
+  stores: StoreSpendRow[];
+  storesTotalMinor: number;
+};
+
+export async function getShoppingReport(
+  userId: string,
+  householdId: string,
+  period: ReportPeriod,
+): Promise<ShoppingReport | null> {
+  const b = await base(userId, householdId);
+  if (!b) return null;
+  const range = periodRange(b, period);
+  const hid = b.ctx.m.householdId;
+  const [lists, storeDocs, txs] = await Promise.all([
+    ShoppingListModel.find({
+      householdId: hid,
+      deletedAt: null,
+      status: "completed",
+      "completion.date": { $gte: range.from, $lte: range.to },
+    })
+      .select({ name: 1, completion: 1 })
+      .lean<{ _id: Types.ObjectId; name: string; completion: ShoppingCompletion }[]>(),
+    StoreModel.find({ householdId: hid })
+      .select({ name: 1, branch: 1 })
+      .lean<{ name: string; branch: string }[]>(),
+    TransactionModel.find({
+      householdId: hid,
+      type: "expense",
+      status: "posted",
+      deletedAt: null,
+      date: {
+        $gte: istanbulDayStart(range.from)!,
+        $lt: new Date(istanbulDayStart(range.to)!.getTime() + DAY_MS),
+      },
+      ...(!b.s.includePrivate && b.ctx.hiddenAccountIds.length
+        ? { accountId: { $nin: b.ctx.hiddenAccountIds } }
+        : {}),
+    })
+      .select({ payeeName: 1, amountMinor: 1, shoppingListId: 1 })
+      .lean<{ payeeName: string; amountMinor: number; shoppingListId: Types.ObjectId | null }[]>(),
+  ]);
+
+  const rows: CompletedListRow[] = lists
+    .map((l) => ({
+      id: String(l._id),
+      name: l.name,
+      date: l.completion.date,
+      stores: l.completion.stores.map((s) => s.label),
+      summary: compareShopping(
+        l.completion.rows.map((r) => ({
+          match: r.match,
+          plan: r.plan,
+          actual:
+            r.amountMinor === null
+              ? null
+              : { productId: r.productId, packages: r.packages, amountMinor: r.amountMinor },
+        })),
+      ),
+    }))
+    .sort((a, c) => (a.date < c.date ? 1 : -1));
+  const listTotals = {
+    plannedMinor: 0,
+    actualMinor: 0,
+    diffMinor: 0,
+    price: 0,
+    quantity: 0,
+    substitute: 0,
+    skipped: 0,
+    extra: 0,
+    unplanned: 0,
+  };
+  for (const r of rows) {
+    listTotals.plannedMinor += r.summary.plannedMinor;
+    listTotals.actualMinor += r.summary.actualMinor;
+    listTotals.diffMinor += r.summary.diffMinor;
+    for (const k of ["price", "quantity", "substitute", "skipped", "extra", "unplanned"] as const)
+      listTotals[k] += r.summary.reasons[k];
+  }
+
+  // Mağaza adı bazında (şubeler birlikte): gider alıcısı mağaza adıyla başlıyorsa.
+  const names = [...new Set(storeDocs.map((s) => s.name))];
+  const byStore = new Map<string, StoreSpendRow>();
+  for (const t of txs) {
+    const name = matchStoreName(t.payeeName, names, foldTr);
+    if (!name) continue;
+    const row = byStore.get(name) ?? {
+      name,
+      amountMinor: 0,
+      count: 0,
+      fromListsMinor: 0,
+      sharePct: 0,
+    };
+    row.amountMinor += t.amountMinor;
+    row.count++;
+    if (t.shoppingListId) row.fromListsMinor += t.amountMinor;
+    byStore.set(name, row);
+  }
+  const storesTotal = [...byStore.values()].reduce((a, r) => a + r.amountMinor, 0);
+  const stores = [...byStore.values()]
+    .map((r) => ({ ...r, sharePct: sharePct(r.amountMinor, storesTotal) }))
+    .sort((a, c) => c.amountMinor - a.amountMinor);
+  return {
+    period,
+    from: range.from,
+    to: range.to,
+    lists: rows,
+    listTotals,
+    stores,
+    storesTotalMinor: storesTotal,
+  };
+}
+
+// --- Birim fiyat geçmişi ---
+
+export type UnitPriceReport = {
+  types: { id: string; name: string; unit: string; records: number }[];
+  selected: {
+    id: string;
+    name: string;
+    unit: string;
+    points: UnitPricePoint[];
+    /** Mağaza başına dönemdeki en düşük birim fiyat. */
+    stores: { id: string; label: string; minMinor: number; lastDate: string }[];
+  } | null;
+  months: string[];
+};
+
+export async function getUnitPriceReport(
+  userId: string,
+  householdId: string,
+  typeId?: string,
+): Promise<UnitPriceReport | null> {
+  const b = await base(userId, householdId);
+  if (!b) return null;
+  const hid = b.ctx.m.householdId;
+  const range = periodRange(b, 12);
+  const [types, counts] = await Promise.all([
+    ProductTypeModel.find({ householdId: hid, archivedAt: null })
+      .select({ name: 1, unit: 1 })
+      .lean<{ _id: Types.ObjectId; name: string; unit: string }[]>(),
+    ProductPriceModel.aggregate<{ _id: Types.ObjectId; n: number }>([
+      { $match: { householdId: hid, deletedAt: null } },
+      { $lookup: { from: "products", localField: "productId", foreignField: "_id", as: "p" } },
+      { $unwind: "$p" },
+      { $group: { _id: "$p.productTypeId", n: { $sum: 1 } } },
+    ]),
+  ]);
+  const count = new Map(counts.map((c) => [String(c._id), c.n]));
+  const options = types
+    .map((x) => ({
+      id: String(x._id),
+      name: x.name,
+      unit: x.unit,
+      records: count.get(String(x._id)) ?? 0,
+    }))
+    .filter((x) => x.records > 0)
+    .sort((a, c) => compareTr(a.name, c.name));
+  const chosen = options.find((x) => x.id === typeId) ?? options[0];
+  if (!chosen) return { types: options, selected: null, months: range.months };
+
+  const [history, storeDocs] = await Promise.all([
+    loadTypePriceHistory(hid, new Types.ObjectId(chosen.id)),
+    StoreModel.find({ householdId: hid })
+      .select({ name: 1, branch: 1 })
+      .lean<{ _id: Types.ObjectId; name: string; branch: string }[]>(),
+  ]);
+  const inRange = history.filter((h) => h.date >= range.from && h.date <= range.to);
+  const points = monthlyUnitPrices(
+    inRange.map((h) => ({
+      month: periodOfDate(h.date, b.s.startDay),
+      unitPriceMinor: h.unitPriceMinor,
+    })),
+    range.months,
+  );
+  const labelOf = new Map(storeDocs.map((s) => [String(s._id), storeLabel(s)]));
+  const perStore = new Map<string, { minMinor: number; lastDate: string }>();
+  for (const h of inRange) {
+    const cur = perStore.get(h.storeId);
+    perStore.set(h.storeId, {
+      minMinor: cur ? Math.min(cur.minMinor, h.unitPriceMinor) : h.unitPriceMinor,
+      lastDate: cur && cur.lastDate > h.date ? cur.lastDate : h.date,
+    });
+  }
+  return {
+    types: options,
+    months: range.months,
+    selected: {
+      id: chosen.id,
+      name: chosen.name,
+      unit: chosen.unit,
+      points,
+      stores: [...perStore.entries()]
+        .map(([id, v]) => ({ id, label: labelOf.get(id) ?? "—", ...v }))
+        .sort((a, c) => a.minMinor - c.minMinor),
+    },
+  };
+}
+
+// --- Fire / zarar ---
+
+export type WasteRow = {
+  productTypeId: string;
+  name: string;
+  unit: string;
+  wasted: number;
+  purchased: number;
+  /** Fire / alım (yüzde); alım yoksa null. */
+  wastePct: number | null;
+  byReason: Record<WasteReason, number>;
+  /** Tahmini maliyet: fire × son bilinen birim fiyat (fiyat yoksa null). */
+  costMinor: number | null;
+};
+
+export type WasteReport = {
+  period: ReportPeriod;
+  from: string;
+  to: string;
+  rows: WasteRow[];
+  /** Neden başına fire satırı sayısı ve tahmini maliyet. */
+  reasons: Record<WasteReason, { count: number; costMinor: number }>;
+  totalCostMinor: number;
+  unpriced: number;
+};
+
+export async function getWasteReport(
+  userId: string,
+  householdId: string,
+  period: ReportPeriod,
+): Promise<WasteReport | null> {
+  const b = await base(userId, householdId);
+  if (!b) return null;
+  const range = periodRange(b, period);
+  const hid = b.ctx.m.householdId;
+  const moves = await StockMovementModel.find({
+    householdId: hid,
+    deletedAt: null,
+    kind: { $in: ["waste", "purchase"] },
+    date: { $gte: range.from, $lte: range.to },
+  })
+    .select({ productTypeId: 1, kind: 1, quantity: 1, wasteReason: 1 })
+    .lean<
+      {
+        productTypeId: Types.ObjectId;
+        kind: "waste" | "purchase";
+        quantity: number;
+        wasteReason: WasteReason | null;
+      }[]
+    >();
+  const wasteTypeIds = [
+    ...new Set(moves.filter((m) => m.kind === "waste").map((m) => String(m.productTypeId))),
+  ].map((id) => new Types.ObjectId(id));
+  const [types, prices] = await Promise.all([
+    ProductTypeModel.find({ householdId: hid, _id: { $in: wasteTypeIds } })
+      .select({ name: 1, unit: 1 })
+      .lean<{ _id: Types.ObjectId; name: string; unit: string }[]>(),
+    latestTypeUnitPrices(hid, wasteTypeIds),
+  ]);
+  const emptyReasons = () =>
+    Object.fromEntries(WASTE_REASONS.map((r) => [r, 0])) as Record<WasteReason, number>;
+  const rows = new Map<string, WasteRow>();
+  for (const t of types)
+    rows.set(String(t._id), {
+      productTypeId: String(t._id),
+      name: t.name,
+      unit: t.unit,
+      wasted: 0,
+      purchased: 0,
+      wastePct: null,
+      byReason: emptyReasons(),
+      costMinor: null,
+    });
+  const reasons = Object.fromEntries(
+    WASTE_REASONS.map((r) => [r, { count: 0, costMinor: 0 }]),
+  ) as WasteReport["reasons"];
+  for (const m of moves) {
+    const row = rows.get(String(m.productTypeId));
+    if (!row) continue;
+    if (m.kind === "purchase") {
+      row.purchased += m.quantity;
+      continue;
+    }
+    const reason = m.wasteReason ?? "other";
+    row.wasted += m.quantity;
+    row.byReason[reason] += m.quantity;
+    reasons[reason].count++;
+    const price = prices.get(row.productTypeId);
+    if (price) reasons[reason].costMinor += Math.round((m.quantity * price.unitPriceMinor) / 1000);
+  }
+  let total = 0;
+  let unpriced = 0;
+  const list = [...rows.values()].map((r) => {
+    const price = prices.get(r.productTypeId);
+    const costMinor = price ? Math.round((r.wasted * price.unitPriceMinor) / 1000) : null;
+    if (costMinor === null) unpriced++;
+    else total += costMinor;
+    return { ...r, costMinor, wastePct: r.purchased > 0 ? sharePct(r.wasted, r.purchased) : null };
+  });
+  list.sort((a, c) => (c.costMinor ?? -1) - (a.costMinor ?? -1) || compareTr(a.name, c.name));
+  return {
+    period,
+    from: range.from,
+    to: range.to,
+    rows: list,
+    reasons,
+    totalCostMinor: total,
+    unpriced,
+  };
+}

src/features/reports/service.int.test.ts

@@ -0,0 +1,114 @@
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { getBudget } from "@/features/budgets/service";
+import { getOverview } from "@/features/dashboard/service";
+import { setupSeededDb, teardownDb } from "@/test/seeded-db";
+import {
+  getBudgetReport,
+  getCategoryReport,
+  getPeopleAccountsReport,
+  getTrendReport,
+} from "./service";
+
+let ids: Awaited<ReturnType<typeof setupSeededDb>>;
+let cakir = "";
+let ayse = "";
+let zeynep = "";
+let fatma = "";
+
+beforeAll(async () => {
+  ids = await setupSeededDb();
+  cakir = ids.household("Çakır Ailesi");
+  ayse = ids.user("ayse");
+  zeynep = ids.user("zeynep");
+  fatma = ids.user("fatma");
+});
+afterAll(teardownDb);
+
+describe("kategori dağılımı", () => {
+  it("toplam bütçenin gerçekleşeniyle aynı; oranlar ~%100; başka hane göremez", async () => {
+    const r = (await getCategoryReport(ayse, cakir))!;
+    const budget = (await getBudget(ayse, cakir))!;
+    expect(r.breakdown.totalMinor).toBe(budget.totals.actualMinor);
+    expect(r.breakdown.totalMinor).toBeGreaterThan(0);
+    const sum = r.breakdown.rows.reduce((a, x) => a + x.amountMinor, 0);
+    expect(sum).toBe(r.breakdown.totalMinor);
+    const pct = r.breakdown.rows.reduce((a, x) => a + x.sharePct, 0);
+    expect(Math.abs(pct - 100)).toBeLessThan(1);
+    // Alt kategori kırılımı: çocukların ve doğrudan tutarın toplamı üst satıra eşit.
+    for (const row of r.breakdown.rows) {
+      const kids = row.children.reduce((a, c) => a + c.amountMinor, 0);
+      expect(kids + row.ownMinor).toBe(row.amountMinor);
+    }
+    expect(r.appearance[r.breakdown.rows[0]!.id]).toBeDefined();
+    expect(await getCategoryReport(fatma, cakir)).toBeNull();
+  });
+
+  it("önceki ay seçilebilir", async () => {
+    const cur = (await getCategoryReport(ayse, cakir))!;
+    const prev = (await getCategoryReport(ayse, cakir, cur.previous))!;
+    expect(prev.current).toBe(false);
+    expect(prev.breakdown.totalMinor).toBe(cur.breakdown.prevTotalMinor);
+  });
+});
+
+describe("aylık trend", () => {
+  it("12 ay; içinde bulunulan ayın gideri bütçeyle aynı; tasarruf oranı tutarlı", async () => {
+    const r = (await getTrendReport(ayse, cakir))!;
+    expect(r.months).toHaveLength(12);
+    const last = r.months.at(-1)!;
+    expect(last.month).toBe(r.currentMonth);
+    expect(last.expenseMinor).toBe((await getBudget(ayse, cakir))!.totals.actualMinor);
+    for (const m of r.months) {
+      expect(m.netMinor).toBe(m.incomeMinor - m.expenseMinor);
+      if (m.incomeMinor === 0) expect(m.savingsPct).toBeNull();
+    }
+    expect(r.months.filter((m) => m.incomeMinor > 0).length).toBeGreaterThan(3);
+  });
+});
+
+describe("kişi ve hesap bazlı", () => {
+  it("kişi toplamları ve oranları; gizli hesap yalnızca sahibine görünür", async () => {
+    const own = (await getPeopleAccountsReport(ayse, cakir))!;
+    expect(own.people.reduce((a, p) => a + p.expenseMinor, 0)).toBe(own.peopleTotalMinor);
+    expect(own.people.every((p) => p.name !== "—")).toBe(true);
+    expect(own.accounts.map((a) => a.name)).toContain("Ayşe — Pluxee");
+    for (const a of own.accounts)
+      expect(a.netMinor).toBe(
+        a.incomeMinor + a.transferInMinor - a.expenseMinor - a.transferOutMinor,
+      );
+    const other = (await getPeopleAccountsReport(zeynep, cakir))!;
+    expect(other.accounts.map((a) => a.name)).not.toContain("Ayşe — Pluxee");
+  });
+});
+
+describe("bütçe ve gerçekleşen", () => {
+  it("son 6 ay; son satır seçilen ay", async () => {
+    const r = (await getBudgetReport(ayse, cakir))!;
+    expect(r.history).toHaveLength(6);
+    expect(r.history.at(-1)!.month).toBe(r.month);
+    expect(r.history.at(-1)!.actualMinor).toBe(r.budget.totals.actualMinor);
+  });
+});
+
+describe("dashboard ana grafik", () => {
+  it("periyotlar: hafta 7 gün, ay günleri, 6 ve 12 ay; gelecek günlerde gerçekleşen boş", async () => {
+    const week = (await getOverview(ayse, cakir, "week"))!;
+    expect(week.points).toHaveLength(7);
+    expect(week.points.filter((p) => p.key > week.today).every((p) => p.actual === null)).toBe(
+      true,
+    );
+    const month = (await getOverview(ayse, cakir, "month"))!;
+    const budget = (await getBudget(ayse, cakir))!;
+    const actual = month.points.reduce((a, p) => a + (p.actual ?? 0), 0);
+    expect(actual).toBe(budget.totals.actualMinor);
+    if (budget.hasBudget) {
+      const planned = month.points.reduce((a, p) => a + (p.budget ?? 0), 0);
+      expect(planned).toBe(budget.totals.limitMinor);
+    }
+    const half = (await getOverview(ayse, cakir, "half"))!;
+    expect(half.points).toHaveLength(6);
+    expect(half.points.at(-1)!.actual).toBe(budget.totals.actualMinor);
+    expect((await getOverview(ayse, cakir, "year"))!.points).toHaveLength(12);
+    expect(await getOverview(fatma, cakir, "month")).toBeNull();
+  });
+});

src/features/reports/service.ts

@@ -0,0 +1,353 @@
+import "server-only";
+import { Types } from "mongoose";
+import { incomePlan } from "@/features/budgets/plan";
+import {
+  budgetFor,
+  expenseAmounts,
+  settingsOf,
+  type BudgetLineView,
+  type BudgetView,
+  type Settings,
+} from "@/features/budgets/service";
+import { loadContext, userNames, type Ctx } from "@/features/transactions/service";
+import { tr } from "@/i18n/tr";
+import { TransactionModel } from "@/models/transaction";
+import type { AccountType } from "@/shared/accounts";
+import type { IconKey, Swatch } from "@/shared/appearance";
+import { budgetPeriod, periodOfDate, shiftMonth } from "@/shared/budget";
+import { istanbulDayStart, todayIstanbul } from "@/shared/dates";
+import { categoryBreakdown, savingsRate, sharePct, type CategoryBreakdown } from "@/shared/reports";
+
+/**
+ * Raporlar (Bölüm 6.14). Okuma: viewer. "Ay" bütçe ayıdır (hane ayarı); gider kuralları bütçeyle
+ * aynı: gerçekleşmiş işlemler, bölünmüş işlemler kalem bazında, taksit modu ve başkasının
+ * "yalnızca ben" hesabındaki giderler hane ayarına göre (yalnızca tutar). Başkasının gizli
+ * hesabı hesap raporunda hiç görünmez.
+ */
+
+const DAY_MS = 86_400_000;
+const ORPHAN = "__none__";
+
+export type Base = { ctx: Ctx; s: Settings; today: string; currentMonth: string };
+
+export async function base(userId: string, householdId: string): Promise<Base | null> {
+  const ctx = await loadContext(userId, householdId, "viewer");
+  if (!ctx) return null;
+  const s = await settingsOf(ctx.m.householdId);
+  const today = todayIstanbul();
+  return { ctx, s, today, currentMonth: periodOfDate(today, s.startDay) };
+}
+
+/** Kategori bazında gerçekleşen gider (kendi tutarı); kategorisiz/bilinmeyen tek satırda. */
+async function actualByCategory(b: Base, month: string) {
+  const { from, to } = budgetPeriod(month, b.s.startDay);
+  const amounts = await expenseAmounts(b.ctx, b.s, from, to);
+  const out = new Map<string, number>();
+  for (const [id, a] of amounts) {
+    const v = a.fixedMinor + a.variableMinor;
+    if (!v) continue;
+    const known = id && b.ctx.categoryMap.get(id)?.kind === "expense";
+    const key = known ? id : ORPHAN;
+    out.set(key, (out.get(key) ?? 0) + v);
+  }
+  return out;
+}
+
+export type MonthInfo = {
+  month: string;
+  from: string;
+  to: string;
+  current: boolean;
+  currentMonth: string;
+};
+
+export const monthInfo = (b: Base, month: string): MonthInfo => ({
+  month,
+  ...budgetPeriod(month, b.s.startDay),
+  current: month === b.currentMonth,
+  currentMonth: b.currentMonth,
+});
+
+// --- Kategori dağılımı ---
+
+export type CategoryReport = MonthInfo & {
+  previous: string;
+  breakdown: CategoryBreakdown;
+  appearance: Record<string, { icon: IconKey; color: Swatch; path: string }>;
+  includesHidden: boolean;
+};
+
+export async function getCategoryReport(
+  userId: string,
+  householdId: string,
+  month?: string,
+): Promise<CategoryReport | null> {
+  const b = await base(userId, householdId);
+  if (!b) return null;
+  const m = month ?? b.currentMonth;
+  const prev = shiftMonth(m, -1);
+  const [current, previous] = await Promise.all([
+    actualByCategory(b, m),
+    actualByCategory(b, prev),
+  ]);
+  const cats = b.ctx.flatCategories
+    .filter((c) => c.kind === "expense")
+    .map((c) => ({ id: c.id, parentId: c.parentId, name: c.name, order: c.order }));
+  cats.push({ id: ORPHAN, parentId: null, name: tr.reports.uncategorized, order: 1e9 });
+  const appearance: CategoryReport["appearance"] = {
+    [ORPHAN]: { icon: "tag", color: "slate", path: tr.reports.uncategorized },
+  };
+  for (const c of b.ctx.categoryMap.values())
+    if (c.kind === "expense")
+      appearance[String(c.id)] = { icon: c.icon, color: c.color, path: c.path };
+  return {
+    ...monthInfo(b, m),
+    previous: prev,
+    breakdown: categoryBreakdown(cats, current, previous),
+    appearance,
+    includesHidden: b.s.includePrivate && b.ctx.hiddenAccountIds.length > 0,
+  };
+}
+
+// --- Aylık trend ---
+
+export type TrendRow = {
+  month: string;
+  incomeMinor: number;
+  expenseMinor: number;
+  netMinor: number;
+  savingsPct: number | null;
+};
+
+export type TrendReport = {
+  months: TrendRow[];
+  totals: {
+    incomeMinor: number;
+    expenseMinor: number;
+    netMinor: number;
+    savingsPct: number | null;
+  };
+  currentMonth: string;
+};
+
+/** Son `count` bütçe ayı (içinde bulunulan dahil): gerçekleşen gelir, gider, net, tasarruf oranı. */
+export async function getTrendReport(
+  userId: string,
+  householdId: string,
+  count = 12,
+): Promise<TrendReport | null> {
+  const b = await base(userId, householdId);
+  if (!b) return null;
+  const months = Array.from({ length: count }, (_, i) => shiftMonth(b.currentMonth, i - count + 1));
+  const rows = await Promise.all(
+    months.map(async (month) => {
+      const [income, expense] = await Promise.all([
+        incomePlan(b.ctx, b.s, month),
+        actualByCategory(b, month),
+      ]);
+      const incomeMinor = income.actualMinor;
+      const expenseMinor = [...expense.values()].reduce((a, v) => a + v, 0);
+      return {
+        month,
+        incomeMinor,
+        expenseMinor,
+        netMinor: incomeMinor - expenseMinor,
+        savingsPct: savingsRate(incomeMinor, expenseMinor),
+      };
+    }),
+  );
+  const incomeMinor = rows.reduce((a, r) => a + r.incomeMinor, 0);
+  const expenseMinor = rows.reduce((a, r) => a + r.expenseMinor, 0);
+  return {
+    months: rows,
+    totals: {
+      incomeMinor,
+      expenseMinor,
+      netMinor: incomeMinor - expenseMinor,
+      savingsPct: savingsRate(incomeMinor, expenseMinor),
+    },
+    currentMonth: b.currentMonth,
+  };
+}
+
+// --- Kişi ve hesap bazlı ---
+
+export type PersonRow = {
+  userId: string;
+  name: string;
+  expenseMinor: number;
+  count: number;
+  sharePct: number;
+};
+
+export type AccountRow = {
+  id: string;
+  name: string;
+  type: AccountType;
+  archived: boolean;
+  incomeMinor: number;
+  expenseMinor: number;
+  transferInMinor: number;
+  transferOutMinor: number;
+  netMinor: number;
+  count: number;
+};
+
+export type PeopleAccountsReport = MonthInfo & {
+  people: PersonRow[];
+  peopleTotalMinor: number;
+  accounts: AccountRow[];
+  includesHidden: boolean;
+};
+
+type TxLean = {
+  type: "income" | "expense" | "transfer";
+  amountMinor: number;
+  accountId: Types.ObjectId | null;
+  toAccountId: Types.ObjectId | null;
+  createdBy: Types.ObjectId;
+};
+
+export async function getPeopleAccountsReport(
+  userId: string,
+  householdId: string,
+  month?: string,
+): Promise<PeopleAccountsReport | null> {
+  const b = await base(userId, householdId);
+  if (!b) return null;
+  const m = month ?? b.currentMonth;
+  const info = monthInfo(b, m);
+  const docs = await TransactionModel.find({
+    householdId: b.ctx.m.householdId,
+    deletedAt: null,
+    status: "posted",
+    date: {
+      $gte: istanbulDayStart(info.from)!,
+      $lt: new Date(istanbulDayStart(info.to)!.getTime() + DAY_MS),
+    },
+  })
+    .select({ type: 1, amountMinor: 1, accountId: 1, toAccountId: 1, createdBy: 1 })
+    .lean<TxLean[]>();
+  const hidden = new Set(b.ctx.hiddenAccountIds.map(String));
+
+  // Kişi: kaydı giren üye; gizli hesap giderleri hane ayarına göre (yalnızca tutar).
+  const people = new Map<string, { expense: number; count: number }>();
+  for (const d of docs) {
+    if (d.type !== "expense") continue;
+    if (d.accountId && hidden.has(String(d.accountId)) && !b.s.includePrivate) continue;
+    const key = String(d.createdBy);
+    const p = people.get(key) ?? { expense: 0, count: 0 };
+    p.expense += d.amountMinor;
+    p.count++;
+    people.set(key, p);
+  }
+  const names = await userNames([...people.keys()].map((id) => new Types.ObjectId(id)));
+  const peopleTotal = [...people.values()].reduce((a, p) => a + p.expense, 0);
+
+  // Hesap: başkasının gizli hesabı hiç görünmez.
+  const acc = new Map<string, Omit<AccountRow, "id" | "name" | "type" | "archived" | "netMinor">>();
+  const bump = (
+    id: Types.ObjectId | null,
+    k: "incomeMinor" | "expenseMinor" | "transferInMinor" | "transferOutMinor",
+    v: number,
+  ) => {
+    if (!id || hidden.has(String(id))) return;
+    const key = String(id);
+    const row = acc.get(key) ?? {
+      incomeMinor: 0,
+      expenseMinor: 0,
+      transferInMinor: 0,
+      transferOutMinor: 0,
+      count: 0,
+    };
+    row[k] += v;
+    row.count++;
+    acc.set(key, row);
+  };
+  for (const d of docs) {
+    if (d.type === "income") bump(d.accountId, "incomeMinor", d.amountMinor);
+    else if (d.type === "expense") bump(d.accountId, "expenseMinor", d.amountMinor);
+    else {
+      bump(d.accountId, "transferOutMinor", d.amountMinor);
+      bump(d.toAccountId, "transferInMinor", d.amountMinor);
+    }
+  }
+  const accounts: AccountRow[] = [];
+  for (const a of b.ctx.accountMap.values()) {
+    if (a.hidden) continue;
+    const row = acc.get(String(a.id));
+    if (!row && a.archived) continue;
+    const r = row ?? {
+      incomeMinor: 0,
+      expenseMinor: 0,
+      transferInMinor: 0,
+      transferOutMinor: 0,
+      count: 0,
+    };
+    accounts.push({
+      id: String(a.id),
+      name: a.name,
+      type: a.type,
+      archived: a.archived,
+      ...r,
+      netMinor: r.incomeMinor + r.transferInMinor - r.expenseMinor - r.transferOutMinor,
+    });
+  }
+  accounts.sort((x, y) => y.count - x.count || x.name.localeCompare(y.name, "tr"));
+
+  return {
+    ...info,
+    people: [...people.entries()]
+      .map(([id, p]) => ({
+        userId: id,
+        name: names.get(id) ?? "—",
+        expenseMinor: p.expense,
+        count: p.count,
+        sharePct: sharePct(p.expense, peopleTotal),
+      }))
+      .sort((x, y) => y.expenseMinor - x.expenseMinor),
+    peopleTotalMinor: peopleTotal,
+    accounts,
+    includesHidden: b.s.includePrivate && b.ctx.hiddenAccountIds.length > 0,
+  };
+}
+
+// --- Bütçe vs. gerçekleşen ---
+
+export type BudgetHistoryRow = {
+  month: string;
+  limitMinor: number | null;
+  actualMinor: number;
+  ratioBp: number | null;
+};
+
+export type BudgetReport = MonthInfo & {
+  budget: BudgetView;
+  lines: BudgetLineView[];
+  history: BudgetHistoryRow[];
+};
+
+/** Seçilen ayın kategori bazında bütçe/gerçekleşen tablosu ve son 6 ayın toplamları. */
+export async function getBudgetReport(
+  userId: string,
+  householdId: string,
+  month?: string,
+): Promise<BudgetReport | null> {
+  const b = await base(userId, householdId);
+  if (!b) return null;
+  const m = month ?? b.currentMonth;
+  const months = Array.from({ length: 6 }, (_, i) => shiftMonth(m, i - 5));
+  const budgets = await Promise.all(months.map((x) => budgetFor(b.ctx, b.s, x)));
+  const budget = budgets.at(-1)!;
+  return {
+    ...monthInfo(b, m),
+    budget,
+    lines: budget.lines,
+    history: budgets.map((x) => ({
+      month: x.month,
+      limitMinor: x.hasBudget ? x.totals.limitMinor : null,
+      actualMinor: x.totals.actualMinor,
+      ratioBp: x.hasBudget ? x.totals.ratioBp : null,
+    })),
+  };
+}

src/features/shopping/actions.ts

@@ -0,0 +1,128 @@
+"use server";
+
+import { revalidatePath } from "next/cache";
+import { z } from "zod";
+import { tr } from "@/i18n/tr";
+import { fail, type ActionResult } from "@/lib/action-result";
+import { getHouseholdActionContext } from "@/lib/dal";
+import {
+  shoppingCompletionSchema,
+  shoppingItemFormSchema,
+  shoppingItemUpdateSchema,
+  shoppingListFormSchema,
+} from "@/shared/schemas/shopping";
+import { completeShopping } from "./completion";
+import {
+  addShoppingItem,
+  approveSuggestions,
+  createShoppingList,
+  deleteShoppingList,
+  dismissSuggestion,
+  moveShoppingItem,
+  removeShoppingItem,
+  setShoppingItemChecked,
+  updateShoppingItem,
+  updateShoppingList,
+} from "./service";
+
+const idSchema = z.string().regex(/^[a-f0-9]{24}$/i);
+
+function fieldErrors(error: z.ZodError) {
+  const out: Record<string, string> = {};
+  for (const issue of error.issues) {
+    const key = issue.path.join(".");
+    if (key && !out[key]) out[key] = issue.message;
+  }
+  return out;
+}
+
+async function run<T, R>(
+  schema: z.ZodType<T>,
+  input: unknown,
+  fn: (userId: string, householdId: string, data: T) => Promise<ActionResult<R>>,
+): Promise<ActionResult<R>> {
+  const ctx = await getHouseholdActionContext("member");
+  if (!ctx) return fail(tr.common.unauthorized);
+  const parsed = schema.safeParse(input);
+  if (!parsed.success) return fail(tr.adminUsers.errors.checkFields, fieldErrors(parsed.error));
+  const result = await fn(ctx.user.id, ctx.household.id, parsed.data);
+  if (result.ok) revalidatePath("/", "layout");
+  return result;
+}
+
+const ids = (...keys: string[]) => z.object(Object.fromEntries(keys.map((k) => [k, idSchema])));
+
+export async function saveShoppingListAction(listId: string | null, input: unknown) {
+  if (listId === null)
+    return run(shoppingListFormSchema, input, (u, h, d) => createShoppingList(u, h, d));
+  const id = idSchema.safeParse(listId);
+  if (!id.success) return fail(tr.common.notFound);
+  return run(shoppingListFormSchema, input, (u, h, d) => updateShoppingList(u, h, id.data, d));
+}
+
+export async function deleteShoppingListAction(listId: unknown) {
+  const id = idSchema.safeParse(listId);
+  if (!id.success) return fail(tr.common.notFound);
+  return run(z.unknown(), null, (u, h) => deleteShoppingList(u, h, id.data));
+}
+
+export async function addShoppingItemAction(listId: unknown, input: unknown) {
+  const id = idSchema.safeParse(listId);
+  if (!id.success) return fail(tr.common.notFound);
+  return run(shoppingItemFormSchema, input, (u, h, d) => addShoppingItem(u, h, id.data, d));
+}
+
+export async function updateShoppingItemAction(listId: unknown, itemId: unknown, input: unknown) {
+  const ref = ids("listId", "itemId").safeParse({ listId, itemId });
+  if (!ref.success) return fail(tr.common.notFound);
+  return run(shoppingItemUpdateSchema, input, (u, h, d) =>
+    updateShoppingItem(u, h, ref.data.listId!, ref.data.itemId!, d),
+  );
+}
+
+export async function removeShoppingItemAction(listId: unknown, itemId: unknown) {
+  const ref = ids("listId", "itemId").safeParse({ listId, itemId });
+  if (!ref.success) return fail(tr.common.notFound);
+  return run(z.unknown(), null, (u, h) =>
+    removeShoppingItem(u, h, ref.data.listId!, ref.data.itemId!),
+  );
+}
+
+export async function setShoppingItemCheckedAction(
+  listId: unknown,
+  itemId: unknown,
+  checked: unknown,
+) {
+  const ref = ids("listId", "itemId").safeParse({ listId, itemId });
+  if (!ref.success || typeof checked !== "boolean") return fail(tr.common.notFound);
+  return run(z.unknown(), null, (u, h) =>
+    setShoppingItemChecked(u, h, ref.data.listId!, ref.data.itemId!, checked),
+  );
+}
+
+export async function moveShoppingItemAction(listId: unknown, itemId: unknown, target: unknown) {
+  const ref = ids("listId", "itemId", "target").safeParse({ listId, itemId, target });
+  if (!ref.success) return fail(tr.common.notFound);
+  return run(z.unknown(), null, (u, h) =>
+    moveShoppingItem(u, h, ref.data.listId!, ref.data.itemId!, ref.data.target!),
+  );
+}
+
+export async function approveSuggestionsAction(listId: unknown, productTypeIds: unknown) {
+  const id = idSchema.safeParse(listId);
+  const types = z.array(idSchema).min(1).max(200).safeParse(productTypeIds);
+  if (!id.success || !types.success) return fail(tr.common.notFound);
+  return run(z.unknown(), null, (u, h) => approveSuggestions(u, h, id.data, types.data));
+}
+
+export async function dismissSuggestionAction(productTypeId: unknown) {
+  const id = idSchema.safeParse(productTypeId);
+  if (!id.success) return fail(tr.common.notFound);
+  return run(z.unknown(), null, (u, h) => dismissSuggestion(u, h, id.data));
+}
+
+export async function completeShoppingAction(listId: unknown, input: unknown) {
+  const id = idSchema.safeParse(listId);
+  if (!id.success) return fail(tr.common.notFound);
+  return run(shoppingCompletionSchema, input, (u, h, d) => completeShopping(u, h, id.data, d));
+}

src/features/shopping/completion.int.test.ts

@@ -0,0 +1,250 @@
+import { Types } from "mongoose";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { AccountModel } from "@/models/account";
+import { CategoryModel } from "@/models/category";
+import { ProductModel } from "@/models/product";
+import { ProductPriceModel } from "@/models/product-price";
+import { ShoppingListModel } from "@/models/shopping-list";
+import { StockMovementModel } from "@/models/stock-movement";
+import { StoreModel } from "@/models/store";
+import { TransactionModel } from "@/models/transaction";
+import { todayIstanbul } from "@/shared/dates";
+import { formatMoneyInput } from "@/shared/money";
+import { addDays } from "@/shared/recurrence";
+import { shoppingCompletionSchema } from "@/shared/schemas/shopping";
+import { setupSeededDb, teardownDb } from "@/test/seeded-db";
+import { completeShopping, getCompletionSheet } from "./completion";
+import { getShoppingList } from "./service";
+
+let ids: Awaited<ReturnType<typeof setupSeededDb>>;
+let cakir = "";
+let ayse = "";
+let zeynep = "";
+let weekly = "";
+let monthEnd = "";
+const today = todayIstanbul();
+
+const bySeed = (model: typeof ProductModel | typeof StoreModel, seedRef: string) =>
+  (model as typeof ProductModel)
+    .findOne({ seedRef })
+    .lean()
+    .then((x) => String(x!._id));
+const accountId = (name: string) =>
+  AccountModel.findOne({ name })
+    .lean()
+    .then((x) => String(x!._id));
+
+beforeAll(async () => {
+  ids = await setupSeededDb();
+  cakir = ids.household("Çakır Ailesi");
+  ayse = ids.user("ayse");
+  zeynep = ids.user("zeynep");
+  weekly = String((await ShoppingListModel.findOne({ seedRef: "haftalik" }).lean())!._id);
+  monthEnd = String((await ShoppingListModel.findOne({ seedRef: "ay-sonu" }).lean())!._id);
+});
+afterAll(teardownDb);
+
+async function scenario() {
+  const sheet = (await getCompletionSheet(ayse, cakir, weekly))!;
+  const item = (label: string) => sheet.items.find((i) => i.label === label)!;
+  const milk = item("Süt");
+  const eggs = item("Yumurta");
+  const detergent = item("Toz Deterjan");
+  const candle = item("Doğum günü mumu");
+  const tomato = item("Domates");
+  const sok = await bySeed(StoreModel, "sok");
+  const migros = await bySeed(StoreModel, "migros");
+  const a101 = await bySeed(StoreModel, "a101");
+  const milkPlan = sheet.planned[milk.id]!;
+  const detPlan = sheet.planned[detergent.id]!;
+  const market = (await CategoryModel.findOne({
+    defaultKey: "market",
+    householdId: cakir,
+  }).lean())!;
+  const accounts = {
+    bank: await accountId("Ziraat Maaş"),
+    meal: await accountId("Ayşe — Pluxee"),
+    card: await accountId("Garanti Bonus"),
+  };
+  return {
+    sheet,
+    milk,
+    eggs,
+    detergent,
+    candle,
+    tomato,
+    stores: { sok, migros, a101 },
+    form: (over: Record<string, unknown> = {}) =>
+      shoppingCompletionSchema.parse({
+        date: today,
+        lines: [
+          // Planlanan ürün, planlanan mağaza; paket fiyatı plandan 1 TL fazla.
+          {
+            itemId: milk.id,
+            productId: milkPlan.productId,
+            storeId: milkPlan.storeId,
+            packages: String(milkPlan.packages),
+            amount: formatMoneyInput((milkPlan.priceMinor + 100) * milkPlan.packages),
+          },
+          // Muadil: 15'li köy yumurtası, A101.
+          {
+            itemId: eggs.id,
+            productId: sheet.products.find((p) => p.label.includes("Köy"))!.id,
+            storeId: a101,
+            packages: "2",
+            amount: "189,80",
+          },
+          // Planlanan ürün başka mağazada (Migros, yemek kartı).
+          {
+            itemId: detergent.id,
+            productId: detPlan.productId,
+            storeId: migros,
+            packages: "1",
+            amount: "549,00",
+          },
+          // Markasız ürün tipi (pazardan domates): 2,5 kg, fiyat kaydı yok.
+          { itemId: tomato.id, productId: "", storeId: sok, packages: "2,5", amount: "60" },
+          // Serbest metin kalemi: yedek gider kategorisi.
+          { itemId: candle.id, productId: "", storeId: sok, packages: "1", amount: "25" },
+          // Plansız ekstra.
+          {
+            itemId: "",
+            productId: sheet.products.find((p) => p.label.startsWith("Fairy"))!.id,
+            storeId: sok,
+            packages: "1",
+            amount: "84,50",
+          },
+        ],
+        stores: [
+          { storeId: sok, accountId: accounts.bank, attachmentIds: [] },
+          { storeId: migros, accountId: accounts.meal, attachmentIds: [] },
+          { storeId: a101, accountId: accounts.card, attachmentIds: [] },
+        ],
+        fallbackCategoryId: String(market._id),
+        leftover: { action: "move", targetListId: monthEnd, newListName: "" },
+        ...over,
+      }),
+  };
+}
+
+describe("tamamlama ekranı", () => {
+  it("plan, fiyatlar, hesaplar ve eşleme bilgisi; izleyici açamaz", async () => {
+    const s = await scenario();
+    expect(s.sheet.items).toHaveLength(9);
+    expect(Object.keys(s.sheet.planned).length).toBe(7);
+    expect(Object.keys(s.sheet.prices).length).toBeGreaterThan(20);
+    expect(s.sheet.accounts.map((a) => a.name)).toContain("Ayşe — Pluxee");
+    expect(s.sheet.defaultFallbackCategoryId).not.toBeNull();
+    expect(s.sheet.otherLists.map((l) => l.name)).toEqual(["Ay sonu toptan"]);
+    expect(await getCompletionSheet(zeynep, cakir, weekly)).toBeNull();
+  });
+});
+
+describe("alışverişi tamamla", () => {
+  it("doğrulama: muadil aynı tipten, gelecek tarih, izleyici, şema kuralları", async () => {
+    const s = await scenario();
+    const wrongType = s.form();
+    wrongType.lines[0]!.productId = await bySeed(ProductModel, "ariel-5kg");
+    expect((await completeShopping(ayse, cakir, weekly, wrongType)).ok).toBe(false);
+    expect(
+      (await completeShopping(ayse, cakir, weekly, s.form({ date: addDays(today, 1) }))).ok,
+    ).toBe(false);
+    expect((await completeShopping(zeynep, cakir, weekly, s.form())).ok).toBe(false);
+    // Mağazası için ödeme hesabı girilmemiş satır.
+    expect(
+      shoppingCompletionSchema.safeParse({
+        date: today,
+        lines: [
+          {
+            itemId: "",
+            productId: s.milk.productTypeId,
+            storeId: s.stores.sok,
+            packages: "1",
+            amount: "1",
+          },
+        ],
+        stores: [],
+        leftover: { action: "drop" },
+      }).success,
+    ).toBe(false);
+  });
+
+  it("ek dosya hatasında hiçbir şey yazılmaz (transaction geri alınır)", async () => {
+    const s = await scenario();
+    const form = s.form();
+    form.stores[0]!.attachmentIds = [String(new Types.ObjectId())];
+    expect((await completeShopping(ayse, cakir, weekly, form)).ok).toBe(false);
+    expect(await TransactionModel.countDocuments({ shoppingListId: { $ne: null } })).toBe(0);
+    expect(await StockMovementModel.countDocuments({ shoppingListId: { $ne: null } })).toBe(0);
+    expect(await ProductPriceModel.countDocuments({ source: "receipt" })).toBe(0);
+    expect((await ShoppingListModel.findById(weekly).lean())!.status).toBe("active");
+  });
+
+  it("stok, fiyat, mağaza başına bölünmüş gider, kalanların taşınması ve rapor", async () => {
+    const s = await scenario();
+    const monthEndBefore = (await ShoppingListModel.findById(monthEnd).lean())!.items.length;
+
+    const r = await completeShopping(ayse, cakir, weekly, s.form());
+    expect(r).toMatchObject({ ok: true, data: { transactions: 3 } });
+
+    // Mağaza başına gider; Şok: gıda + temizlik + yedek (mum) bölünmüş.
+    const txs = await TransactionModel.find({ shoppingListId: new Types.ObjectId(weekly) }).lean();
+    expect(txs).toHaveLength(3);
+    const sokTx = txs.find((t) => t.payeeName.startsWith("Şok"))!;
+    expect(sokTx.splits).toHaveLength(3);
+    expect(sokTx.splits.reduce((a, x) => a + x.amountMinor, 0)).toBe(sokTx.amountMinor);
+    const migrosTx = txs.find((t) => t.payeeName.startsWith("Migros"))!;
+    expect(migrosTx).toMatchObject({ amountMinor: 549_00, splits: [] });
+    expect(String(migrosTx.accountId)).toBe(await accountId("Ayşe — Pluxee"));
+
+    // Stok alımları (serbest metin hariç 5 kalem) ve fiş kaynaklı fiyatlar (markasız domates hariç 4).
+    expect(
+      await StockMovementModel.countDocuments({
+        shoppingListId: new Types.ObjectId(weekly),
+        kind: "purchase",
+      }),
+    ).toBe(5);
+    expect(await ProductPriceModel.countDocuments({ source: "receipt" })).toBe(4);
+    const eggPrice = await ProductPriceModel.findOne({ source: "receipt", priceMinor: 94_90 });
+    expect(eggPrice).not.toBeNull();
+
+    // Liste kapandı; alınmayan 5 kalem "Ay sonu toptan"a taşındı.
+    const after = (await getShoppingList(ayse, cakir, weekly))!;
+    expect(after.list.status).toBe("completed");
+    expect(after.canWrite).toBe(false);
+    expect(after.report!.completion.movedTo?.name).toBe("Ay sonu toptan");
+    expect((await ShoppingListModel.findById(monthEnd).lean())!.items.length).toBe(
+      monthEndBefore + 4,
+    );
+    // Süt alımı: paket × 1 lt.
+    const milkMove = await StockMovementModel.findOne({
+      shoppingListId: new Types.ObjectId(weekly),
+      productTypeId: new Types.ObjectId(s.milk.productTypeId!),
+    }).lean();
+    expect(milkMove!.quantity).toBe(s.sheet.planned[s.milk.id]!.packages * 1000);
+    // Markasız domates: tipin biriminde 2,5 kg.
+    const tomatoMove = await StockMovementModel.findOne({
+      shoppingListId: new Types.ObjectId(weekly),
+      productTypeId: new Types.ObjectId(s.tomato.productTypeId!),
+    }).lean();
+    expect(tomatoMove!.quantity).toBe(2500);
+
+    // Rapor: aynı/muadil/alınmadı/ekstra; nedenlerin toplamı farka eşit.
+    const { summary, completion } = after.report!;
+    expect(summary.counts).toEqual({ same: 4, substitute: 1, skipped: 4, extra: 1 });
+    const sum = Object.values(summary.reasons).reduce((a, b) => a + b, 0);
+    expect(sum).toBe(summary.diffMinor);
+    // Süt: paket başına +1 TL; deterjan: aynı ürün başka mağazada (Migros) farklı fiyat.
+    expect(summary.reasons.price).toBe(
+      100 * s.sheet.planned[s.milk.id]!.packages +
+        (549_00 - s.sheet.planned[s.detergent.id]!.priceMinor),
+    );
+    expect(summary.reasons.extra).toBe(84_50);
+    expect(summary.reasons.unplanned).toBe(25_00 + 60_00);
+    expect(summary.reasons.skipped).toBeLessThan(0);
+    expect(completion.stores).toHaveLength(3);
+
+    // Tamamlanan liste değiştirilemez, ikinci kez tamamlanamaz.
+    expect((await completeShopping(ayse, cakir, weekly, s.form())).ok).toBe(false);
+  });
+});

src/features/shopping/completion.ts

@@ -0,0 +1,586 @@
+import "server-only";
+import { Types } from "mongoose";
+import { syncOwnerAttachments } from "@/features/attachments/service";
+import type { CategoryOption } from "@/features/categories/tree";
+import { buildTree, toOptions } from "@/features/categories/tree";
+import { loadTypeOffers } from "@/features/prices/service";
+import { listProducts, type ProductView } from "@/features/products/service";
+import { getStock } from "@/features/stock/service";
+import { buildDoc, loadContext } from "@/features/transactions/service";
+import { tr } from "@/i18n/tr";
+import { fail, ok, type ActionResult } from "@/lib/action-result";
+import { connectMongoose } from "@/lib/db/mongoose";
+import { AccountModel } from "@/models/account";
+import { CategoryModel } from "@/models/category";
+import { ProductPriceModel } from "@/models/product-price";
+import { ShoppingListModel } from "@/models/shopping-list";
+import { StoreModel } from "@/models/store";
+import { StockMovementModel } from "@/models/stock-movement";
+import { TransactionModel } from "@/models/transaction";
+import { allowedAttachmentKinds } from "@/shared/attachments";
+import type { MealCardProvider } from "@/shared/accounts";
+import { todayIstanbul } from "@/shared/dates";
+import { formatQuantity, QUANTITY_SCALE } from "@/shared/quantity";
+import { formatStock } from "@/shared/stock";
+import type { ShoppingCompletionForm } from "@/shared/schemas/shopping";
+import type { CompletionRow, CompletionStore, ShoppingCompletion } from "@/shared/shopping";
+import { matchKind, type PlannedPurchase } from "@/shared/shopping-compare";
+import { MAX_SPLITS } from "@/shared/transactions";
+import type { TransactionForm } from "@/shared/schemas/transaction";
+import {
+  getShoppingList,
+  writableList,
+  type ItemLean,
+  type ShoppingItemView,
+  type ShoppingListSummary,
+} from "./service";
+
+/**
+ * "Alışverişi tamamla" (Bölüm 6.12). Tek MongoDB transaction içinde: stok alım hareketleri, fiyat
+ * kayıtları (kaynak: fiş), mağaza başına bölünmüş gider (stok → gider kategorisi eşlemesi), fiş
+ * görselleri ve alınmayan kalemlerin taşınması; liste kapanır ve karşılaştırma görüntüsü saklanır.
+ */
+
+const t = tr.shopping;
+const v = t.validation;
+
+export type CompletionSheet = {
+  list: ShoppingListSummary;
+  items: ShoppingItemView[];
+  /** Kalem başına akıllı önerinin planı (önerilen dağılım). */
+  planned: Record<
+    string,
+    { productId: string; storeId: string; packages: number; priceMinor: number }
+  >;
+  products: {
+    id: string;
+    label: string;
+    packageLabel: string;
+    productTypeId: string;
+    typeName: string;
+  }[];
+  stores: { id: string; label: string; slot: number; mealCard: boolean; providers: string[] }[];
+  /** Geçerli paket fiyatları: `${productId}:${storeId}` → kuruş (tutar ön doldurması için). */
+  prices: Record<string, number>;
+  accounts: { id: string; name: string; type: string; mealCardProvider: MealCardProvider | null }[];
+  expenseCategories: CategoryOption[];
+  /** Gider kategorisine eşlenmemiş ürün tipleri (yedek kategori gerekir). */
+  unmappedTypeIds: string[];
+  defaultFallbackCategoryId: string | null;
+  otherLists: { id: string; name: string }[];
+  today: string;
+};
+
+async function expenseCategoryOptions(householdId: Types.ObjectId) {
+  const rows = await CategoryModel.find({ householdId, kind: "expense" }).lean<
+    {
+      _id: Types.ObjectId;
+      name: string;
+      parentId: Types.ObjectId | null;
+      order: number;
+      archivedAt: Date | null;
+      defaultKey: string | null;
+    }[]
+  >();
+  const options = toOptions(
+    buildTree(
+      rows.map((c) => ({
+        id: String(c._id),
+        kind: "expense" as const,
+        name: c.name,
+        parentId: c.parentId ? String(c.parentId) : null,
+        order: c.order,
+        archived: Boolean(c.archivedAt),
+      })),
+    ),
+  );
+  const market = rows.find((c) => c.defaultKey === "market" && !c.archivedAt);
+  return { options, marketId: market ? String(market._id) : null };
+}
+
+/** Ürün tipi → etkin gider kategorisi (stok kategorisinden, üstten devralınarak). */
+async function typeExpenseMap(userId: string, householdId: string) {
+  const stock = await getStock(userId, householdId);
+  if (!stock) return null;
+  const catExpense = new Map(stock.categories.map((c) => [c.id, c.expense?.id ?? null]));
+  return new Map(stock.items.map((i) => [i.id, catExpense.get(i.categoryId) ?? null]));
+}
+
+/** /alisveris/:id/tamamla — alınanları girme ekranının verisi. */
+export async function getCompletionSheet(
+  userId: string,
+  householdId: string,
+  listId: string,
+): Promise<CompletionSheet | null> {
+  const detail = await getShoppingList(userId, householdId, listId);
+  if (!detail || !detail.canWrite) return null;
+  const ctx = await loadContext(userId, householdId, "member");
+  if (!ctx) return null;
+  const [productList, expense, categories, accounts] = await Promise.all([
+    listProducts(userId, householdId),
+    typeExpenseMap(userId, householdId),
+    expenseCategoryOptions(ctx.m.householdId),
+    AccountModel.find({ householdId: ctx.m.householdId, archivedAt: null })
+      .select({ name: 1, type: 1, order: 1, isPrivate: 1, ownerUserId: 1, mealCardProvider: 1 })
+      .sort({ order: 1 })
+      .lean<
+        {
+          _id: Types.ObjectId;
+          name: string;
+          type: string;
+          isPrivate: boolean;
+          ownerUserId: Types.ObjectId | null;
+          mealCardProvider: MealCardProvider | null;
+        }[]
+      >(),
+  ]);
+  if (!productList || !expense) return null;
+  const products = productList.products.filter((p) => p.inTypeUnit !== null);
+  const offers = await loadTypeOffers(
+    ctx.m.householdId,
+    [...new Set(products.map((p) => p.productTypeId))].map((x) => new Types.ObjectId(x)),
+    { activeOnly: true },
+  );
+  const planned: CompletionSheet["planned"] = {};
+  for (const g of detail.plan.recommended?.stores ?? [])
+    for (const l of g.lines)
+      planned[l.itemId] = {
+        productId: l.productId,
+        storeId: l.storeId,
+        packages: l.packages,
+        priceMinor: l.priceMinor,
+      };
+  const { stores: storeRefs } = detail.plan;
+  const storeRows = await StoreModel.find({ householdId: ctx.m.householdId, archivedAt: null })
+    .select({ mealCardProviders: 1, mealCardAccepted: 1 })
+    .lean<{ _id: Types.ObjectId; mealCardAccepted: boolean; mealCardProviders: string[] }[]>();
+  return {
+    list: detail.list,
+    items: detail.items,
+    planned,
+    products: products.map((p) => ({
+      id: p.id,
+      label: p.label,
+      packageLabel: p.packageLabel,
+      productTypeId: p.productTypeId,
+      typeName: p.productTypeName,
+    })),
+    stores: storeRows
+      .map((s) => {
+        const ref = storeRefs[String(s._id)]!;
+        return {
+          id: ref.id,
+          label: ref.label,
+          slot: ref.slot,
+          mealCard: s.mealCardAccepted,
+          providers: s.mealCardAccepted ? s.mealCardProviders : [],
+        };
+      })
+      .sort((a, b) => a.label.localeCompare(b.label, "tr")),
+    prices: Object.fromEntries(offers.map((o) => [`${o.productId}:${o.storeId}`, o.priceMinor])),
+    accounts: accounts
+      .filter((a) => !a.isPrivate || String(a.ownerUserId) === userId)
+      .map((a) => ({
+        id: String(a._id),
+        name: a.name,
+        type: a.type,
+        mealCardProvider: a.mealCardProvider ?? null,
+      })),
+    expenseCategories: categories.options,
+    unmappedTypeIds: [...expense.entries()].filter(([, e]) => !e).map(([id]) => id),
+    defaultFallbackCategoryId: categories.marketId,
+    otherLists: detail.otherLists,
+    today: todayIstanbul(),
+  };
+}
+
+/** Transaction içindeki doğrulama hatası: geri alıp kullanıcıya döndürmek için. */
+class CompletionError extends Error {
+  constructor(readonly result: ActionResult<never>) {
+    super(result.ok ? "" : result.error);
+  }
+}
+
+type ResolvedLine = {
+  item: ItemLean | null;
+  product: ProductView | null;
+  storeId: string;
+  /** Üründe paket adedi; markasız ürün tipi kaleminde tipin birimindeki miktar (binde bir). */
+  packages: number;
+  amountMinor: number;
+  categoryId: string;
+  /** Stoğa işlenecek ürün tipi ve miktar (serbest metinde null). */
+  stock: { productTypeId: string; quantity: number } | null;
+};
+
+export async function completeShopping(
+  actorId: string,
+  householdId: string,
+  listId: string,
+  input: ShoppingCompletionForm,
+): Promise<ActionResult<{ transactions: number }>> {
+  const r = await writableList(actorId, householdId, listId);
+  if (r.error) return r.error;
+  const { m, list, actor } = r;
+  if (input.date > todayIstanbul()) return fail(v.futureDate, { date: v.futureDate });
+  const ctx = await loadContext(actorId, householdId, "member");
+  if (!ctx) return fail(tr.common.unauthorized);
+
+  const [productList, expense, stockData, activeStores] = await Promise.all([
+    listProducts(actorId, householdId, { includeArchived: true }),
+    typeExpenseMap(actorId, householdId),
+    getShoppingList(actorId, householdId, listId),
+    StoreModel.find({ householdId: m.householdId, archivedAt: null })
+      .select({ _id: 1 })
+      .lean<{ _id: Types.ObjectId }[]>(),
+  ]);
+  const activeStoreIds = new Set(activeStores.map((x) => String(x._id)));
+  if (!productList || !expense || !stockData) return fail(tr.common.notFound);
+  const products = new Map(productList.products.map((p) => [p.id, p]));
+  const views = new Map(stockData.items.map((i) => [i.id, i]));
+  const storeRefs = stockData.plan.stores;
+  const itemById = new Map(list.items.map((i) => [String(i._id), i]));
+
+  // Yedek gider kategorisi (eşlenmemiş ve serbest metin kalemleri için).
+  const fallback = input.fallbackCategoryId;
+  const fallbackOk =
+    fallback &&
+    ctx.categoryMap.get(fallback)?.kind === "expense" &&
+    !ctx.categoryMap.get(fallback)?.archived;
+
+  // --- Satırları doğrula ---
+  const lines: ResolvedLine[] = [];
+  for (const [i, l] of input.lines.entries()) {
+    const at = (field: string) => `lines.${i}.${field}`;
+    const item = l.itemId ? (itemById.get(l.itemId) ?? null) : null;
+    if (l.itemId && !item) return fail(v.itemGone);
+    if (!activeStoreIds.has(l.storeId))
+      return fail(tr.productPrices.validation.store, {
+        [at("storeId")]: tr.productPrices.validation.store,
+      });
+
+    let product: ProductView | null = null;
+    let typeId: string | null = null;
+    if (item?.kind === "text") {
+      if (l.productId) return fail(v.textNoProduct, { [at("productId")]: v.textNoProduct });
+    } else if (item?.kind === "type" && !l.productId) {
+      // Markasız (ör. pazardan domates): miktar tipin biriminde, fiyat kaydı yok.
+      typeId = String(item.productTypeId);
+    } else {
+      product = l.productId ? (products.get(l.productId) ?? null) : null;
+      if (!product || product.archived) return fail(v.product, { [at("productId")]: v.product });
+      if (product.inTypeUnit === null)
+        return fail(v.conversion(product.label), {
+          [at("productId")]: v.conversion(product.label),
+        });
+      const expectedType =
+        item?.kind === "type"
+          ? String(item.productTypeId)
+          : item?.kind === "product"
+            ? (products.get(String(item.productId))?.productTypeId ?? null)
+            : null;
+      if (expectedType && product.productTypeId !== expectedType)
+        return fail(v.substituteType, { [at("productId")]: v.substituteType });
+      typeId = product.productTypeId;
+    }
+    const mapped = typeId ? (expense.get(typeId) ?? null) : null;
+    const categoryId = mapped ?? (fallbackOk ? fallback : null);
+    if (!categoryId) return fail(v.fallbackCategory, { fallbackCategoryId: v.fallbackCategory });
+    lines.push({
+      item,
+      product,
+      storeId: l.storeId,
+      packages: l.packages,
+      amountMinor: l.amount,
+      categoryId,
+      stock: typeId
+        ? {
+            productTypeId: typeId,
+            quantity: product
+              ? Math.max(1, Math.round((l.packages * product.inTypeUnit!) / QUANTITY_SCALE))
+              : l.packages,
+          }
+        : null,
+    });
+  }
+
+  // --- Mağaza başına gider işlemleri (doğrulama buildDoc ile) ---
+  const accountOf = new Map(input.stores.map((s) => [s.storeId, s]));
+  const byStore = new Map<string, ResolvedLine[]>();
+  for (const l of lines) byStore.set(l.storeId, [...(byStore.get(l.storeId) ?? []), l]);
+  const txDocs: { storeId: string; doc: Record<string, unknown>; attachmentIds: string[] }[] = [];
+  for (const [storeId, group] of byStore) {
+    const entry = accountOf.get(storeId)!;
+    const amount = group.reduce((a, l) => a + l.amountMinor, 0);
+    const perCategory = new Map<string, { amount: number; count: number }>();
+    for (const l of group) {
+      const c = perCategory.get(l.categoryId) ?? { amount: 0, count: 0 };
+      c.amount += l.amountMinor;
+      c.count++;
+      perCategory.set(l.categoryId, c);
+    }
+    if (perCategory.size > MAX_SPLITS) return fail(v.tooManySplits);
+    const split = perCategory.size >= 2;
+    const form: TransactionForm = {
+      type: "expense",
+      amount,
+      date: input.date,
+      accountId: entry.accountId,
+      toAccountId: null,
+      categoryId: split ? null : [...perCategory.keys()][0]!,
+      splits: split
+        ? [...perCategory.entries()].map(([categoryId, c]) => ({
+            categoryId,
+            amount: c.amount,
+            note: t.complete.splitNote(c.count),
+          }))
+        : [],
+      payee: storeRefs[storeId]!.label,
+      description: t.complete.txDescription(list.name),
+      tags: [],
+      installments: 1,
+      attachmentIds: entry.attachmentIds,
+    };
+    const built = buildDoc(ctx, form);
+    if (!built.ok) {
+      const msg = built.error;
+      return fail(msg, { [`stores.${input.stores.indexOf(entry)}.accountId`]: msg });
+    }
+    txDocs.push({ storeId, doc: built.data, attachmentIds: entry.attachmentIds });
+  }
+
+  // --- Alınmayanlar ---
+  const boughtIds = new Set(lines.flatMap((l) => (l.item ? [String(l.item._id)] : [])));
+  const leftover = list.items.filter((i) => !boughtIds.has(String(i._id)));
+  let target: { _id: Types.ObjectId; name: string; items: ItemLean[] } | null = null;
+  if (leftover.length && input.leftover.action === "move") {
+    const tl = await writableList(actorId, householdId, input.leftover.targetListId!);
+    if (tl.error || tl.list._id.equals(list._id))
+      return fail(v.targetList, { "leftover.targetListId": v.targetList });
+    target = tl.list;
+  }
+
+  // --- Plan ve karşılaştırma görüntüsü ---
+  // Kullanıcının gördüğü akıllı öneri (önerilen dağılım).
+  const plan = stockData.plan;
+  const planned = new Map<string, PlannedPurchase & { storeId: string }>();
+  for (const g of plan.recommended?.stores ?? [])
+    for (const l of g.lines)
+      planned.set(l.itemId, {
+        productId: l.productId,
+        storeId: l.storeId,
+        packages: l.packages * QUANTITY_SCALE,
+        priceMinor: l.priceMinor,
+        costMinor: l.costMinor,
+      });
+  const label = (id: string) => products.get(id)?.label ?? "—";
+  const pkgLabel = (id: string) => {
+    const p = products.get(id);
+    return p ? `${p.label} · ${p.packageLabel}` : "—";
+  };
+  const planOf = (itemId: string): CompletionRow["plan"] => {
+    const p = planned.get(itemId);
+    return p
+      ? {
+          ...p,
+          productLabel: pkgLabel(p.productId),
+          storeLabel: storeRefs[p.storeId]?.label ?? "—",
+        }
+      : null;
+  };
+  const rows: CompletionRow[] = [];
+  const lineByItem = new Map(lines.flatMap((l) => (l.item ? [[String(l.item._id), l]] : [])));
+  for (const item of list.items) {
+    const id = String(item._id);
+    const l = lineByItem.get(id) ?? null;
+    const p = planned.get(id) ?? null;
+    rows.push({
+      itemId: id,
+      match: matchKind(
+        { kind: item.kind, productId: item.productId ? String(item.productId) : null },
+        p,
+        l
+          ? { productId: l.product?.id ?? null, packages: l.packages, amountMinor: l.amountMinor }
+          : null,
+      ),
+      label: views.get(id)?.label ?? item.text,
+      productId: l?.product?.id ?? null,
+      productLabel: l?.product ? pkgLabel(l.product.id) : "",
+      storeId: l?.storeId ?? null,
+      storeLabel: l ? (storeRefs[l.storeId]?.label ?? "—") : "",
+      packages: l?.packages ?? 0,
+      quantityLabel: !l
+        ? ""
+        : l.product
+          ? `${formatQuantity(l.packages)} ${t.packageUnit}`
+          : l.stock
+            ? formatStock(l.packages, views.get(id)?.unit ?? "")
+            : "",
+      amountMinor: l?.amountMinor ?? null,
+      plan: planOf(id),
+    });
+  }
+  for (const l of lines.filter((x) => !x.item))
+    rows.push({
+      itemId: null,
+      match: "extra",
+      label: label(l.product!.id),
+      productId: l.product!.id,
+      productLabel: pkgLabel(l.product!.id),
+      storeId: l.storeId,
+      storeLabel: storeRefs[l.storeId]?.label ?? "—",
+      packages: l.packages,
+      quantityLabel: `${formatQuantity(l.packages)} ${t.packageUnit}`,
+      amountMinor: l.amountMinor,
+      plan: null,
+    });
+
+  // --- Yaz (tek transaction) ---
+  const mongoose = await connectMongoose();
+  const accountNames = new Map([...ctx.accountMap.values()].map((a) => [String(a.id), a.name]));
+  try {
+    const stores: CompletionStore[] = [];
+    await mongoose.connection.transaction(async (session) => {
+      stores.length = 0;
+      for (const { storeId, doc, attachmentIds } of txDocs) {
+        const [tx] = await TransactionModel.create(
+          [
+            {
+              ...doc,
+              householdId: m.householdId,
+              status: "posted",
+              shoppingListId: list._id,
+              createdBy: actor,
+              updatedBy: actor,
+            },
+          ],
+          { session },
+        );
+        const synced = await syncOwnerAttachments({
+          householdId: m.householdId,
+          actorId,
+          ownerType: "transaction",
+          ownerId: tx!._id,
+          ids: attachmentIds,
+          allowedKinds: allowedAttachmentKinds("expense"),
+          session,
+        });
+        if (!synced.ok) throw new CompletionError(synced);
+        await TransactionModel.updateOne(
+          { _id: tx!._id },
+          { $set: { attachmentCount: synced.data } },
+          { session },
+        );
+        const accountId = String(doc.accountId);
+        stores.push({
+          storeId,
+          label: storeRefs[storeId]!.label,
+          accountId,
+          accountName: accountNames.get(accountId) ?? "—",
+          transactionId: String(tx!._id),
+          amountMinor: doc.amountMinor as number,
+          attachmentCount: synced.data,
+        });
+      }
+
+      const stockLines = lines.filter((l) => l.stock);
+      if (stockLines.length)
+        await StockMovementModel.insertMany(
+          stockLines.map((l) => ({
+            householdId: m.householdId,
+            productTypeId: new Types.ObjectId(l.stock!.productTypeId),
+            kind: "purchase",
+            date: input.date,
+            quantity: l.stock!.quantity,
+            note: t.complete.txDescription(list.name),
+            shoppingListId: list._id,
+            createdBy: actor,
+          })),
+          { session },
+        );
+      const productLines = lines.filter((l) => l.product);
+      if (productLines.length) {
+        // Fiyat kaydı: ürün × mağaza başına tek kayıt; paket fiyatı = tutar / paket adedi.
+        const prices = new Map<string, ResolvedLine[]>();
+        for (const l of productLines) {
+          const key = `${l.product!.id}:${l.storeId}`;
+          prices.set(key, [...(prices.get(key) ?? []), l]);
+        }
+        await ProductPriceModel.insertMany(
+          [...prices.values()].map((group) => {
+            const packages = group.reduce((a, l) => a + l.packages, 0);
+            const amount = group.reduce((a, l) => a + l.amountMinor, 0);
+            return {
+              householdId: m.householdId,
+              productId: new Types.ObjectId(group[0]!.product!.id),
+              storeId: new Types.ObjectId(group[0]!.storeId),
+              date: input.date,
+              priceMinor: Math.max(1, Math.round((amount * QUANTITY_SCALE) / packages)),
+              isPromo: false,
+              promoUntil: null,
+              source: "receipt",
+              note: "",
+              createdBy: actor,
+            };
+          }),
+          { session },
+        );
+      }
+
+      let movedTo: ShoppingCompletion["movedTo"] = null;
+      const carry = leftover.map((i) => ({
+        ...i,
+        checked: false,
+        checkedBy: null,
+        checkedAt: null,
+      }));
+      if (leftover.length && input.leftover.action === "move" && target) {
+        await ShoppingListModel.updateOne(
+          { _id: target._id },
+          { $push: { items: { $each: carry } }, $set: { updatedBy: actor } },
+          { session },
+        );
+        movedTo = { listId: String(target._id), name: target.name };
+      } else if (leftover.length && input.leftover.action === "new") {
+        const [created] = await ShoppingListModel.create(
+          [
+            {
+              householdId: m.householdId,
+              name: input.leftover.newListName,
+              items: carry,
+              createdBy: actor,
+              updatedBy: actor,
+            },
+          ],
+          { session },
+        );
+        movedTo = { listId: String(created!._id), name: input.leftover.newListName };
+      }
+
+      const completion: ShoppingCompletion = {
+        date: input.date,
+        completedBy: actorId,
+        rows,
+        stores,
+        movedTo,
+      };
+      const res = await ShoppingListModel.updateOne(
+        { _id: list._id, status: "active", deletedAt: null },
+        {
+          $set: {
+            status: "completed",
+            completedAt: new Date(),
+            completion,
+            updatedBy: actor,
+          },
+        },
+        { session },
+      );
+      if (!res.modifiedCount) throw new CompletionError(fail(v.notActive));
+    });
+    return ok({ transactions: txDocs.length });
+  } catch (error) {
+    if (error instanceof CompletionError) return error.result;
+    throw error;
+  }
+}

src/features/shopping/components/completion-form.tsx

@@ -0,0 +1,660 @@
+"use client";
+
+import { ArrowLeft, Plus, Trash2 } from "lucide-react";
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { useMemo, useState } from "react";
+import { toast } from "sonner";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { Checkbox } from "@/components/ui/checkbox";
+import { Field, FieldDescription, FieldError, FieldLabel } from "@/components/ui/field";
+import { Input } from "@/components/ui/input";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import { AttachmentPicker } from "@/features/attachments/components/attachment-picker";
+import type { AttachmentInfo } from "@/features/attachments/service";
+import { StoreDot } from "@/features/prices/components/offers-list";
+import { tr } from "@/i18n/tr";
+import { cn } from "@/lib/utils";
+import { formatMoney } from "@/shared/format";
+import { formatMoneyInput, parseMoney } from "@/shared/money";
+import { parseQuantity } from "@/shared/quantity";
+import type { LeftoverAction } from "@/shared/shopping";
+import { quantityInput } from "@/shared/stock";
+import { completeShoppingAction } from "../actions";
+import type { CompletionSheet } from "../completion";
+import type { ShoppingItemView } from "../service";
+
+const t = tr.shopping.complete;
+/** Ürün tipi kaleminde marka belirtmeden alım (Radix Select boş değer kabul etmez). */
+const GENERIC = "__generic__";
+
+type Line = {
+  productId: string;
+  storeId: string;
+  packages: string;
+  amount: string;
+  /** Kullanıcı tutarı elle değiştirdi: fiyattan yeniden hesaplanmaz. */
+  touched: boolean;
+};
+type ItemLine = Line & { bought: boolean };
+type Extra = Line & { key: number };
+
+/** Paket fiyatı biliniyorsa tutar = fiyat × paket. */
+function priceAmount(sheet: CompletionSheet, l: Pick<Line, "productId" | "storeId" | "packages">) {
+  const price = sheet.prices[`${l.productId}:${l.storeId}`];
+  const q = parseQuantity(l.packages);
+  return price && q ? formatMoneyInput(Math.round((price * q) / 1000)) : "";
+}
+
+function withPrice(sheet: CompletionSheet, l: Line, patch: Partial<Line>): Line {
+  const next = { ...l, ...patch };
+  if ("amount" in patch) return { ...next, touched: true };
+  if (next.touched) return next;
+  return { ...next, amount: priceAmount(sheet, next) || next.amount };
+}
+
+function initialLine(sheet: CompletionSheet, item: ShoppingItemView): Line {
+  const plan = sheet.planned[item.id];
+  const typeOf = (id: string | null) => sheet.products.find((p) => p.id === id)?.productTypeId;
+  const typeId = item.kind === "product" ? typeOf(item.productId) : item.productTypeId;
+  const productId =
+    item.kind === "text"
+      ? ""
+      : (plan?.productId ??
+        item.productId ??
+        sheet.products.find((p) => p.productTypeId === typeId)?.id ??
+        GENERIC);
+  const packages = plan
+    ? String(plan.packages)
+    : item.quantity && (item.kind === "product" || productId === GENERIC)
+      ? quantityInput(item.quantity)
+      : "1";
+  const base = {
+    productId,
+    storeId: plan?.storeId ?? defaultStore(sheet),
+    packages,
+    amount: "",
+    touched: false,
+  };
+  return { ...base, amount: priceAmount(sheet, base) };
+}
+
+/** Planda en çok kalemin gittiği mağaza; plan yoksa ilk mağaza. */
+function defaultStore(sheet: CompletionSheet) {
+  const count = new Map<string, number>();
+  for (const p of Object.values(sheet.planned))
+    count.set(p.storeId, (count.get(p.storeId) ?? 0) + 1);
+  return [...count.entries()].sort((a, b) => b[1] - a[1])[0]?.[0] ?? sheet.stores[0]?.id ?? "";
+}
+
+/** Mağazaya uygun varsayılan hesap: geçerli yemek kartı, yoksa banka/nakit, yoksa ilk hesap. */
+function defaultAccount(sheet: CompletionSheet, storeId: string) {
+  const store = sheet.stores.find((s) => s.id === storeId);
+  const meal = sheet.accounts.find(
+    (a) =>
+      a.type === "meal_card" && a.mealCardProvider && store?.providers.includes(a.mealCardProvider),
+  );
+  return (
+    meal?.id ??
+    sheet.accounts.find((a) => a.type === "bank" || a.type === "cash")?.id ??
+    sheet.accounts[0]?.id ??
+    ""
+  );
+}
+
+function LineFields({
+  sheet,
+  line,
+  products,
+  text,
+  onChange,
+  errors,
+  idPrefix,
+  genericUnit,
+}: {
+  sheet: CompletionSheet;
+  line: Line;
+  products: CompletionSheet["products"];
+  text: boolean;
+  onChange: (patch: Partial<Line>) => void;
+  errors: Record<string, string | undefined>;
+  idPrefix: string;
+  /** Ürün tipi kalemi: markasız seçeneği ve tipin birimi. */
+  genericUnit?: string;
+}) {
+  const generic = line.productId === GENERIC;
+  return (
+    <div className="grid grid-cols-2 gap-3 sm:grid-cols-[minmax(0,2fr)_minmax(0,1.4fr)_5rem_7rem]">
+      {text ? (
+        <p className="col-span-2 self-center text-xs text-muted-foreground sm:col-span-1">
+          {tr.shopping.complete.textItem}
+        </p>
+      ) : (
+        <Field data-invalid={Boolean(errors.productId)} className="col-span-2 sm:col-span-1">
+          <FieldLabel htmlFor={`${idPrefix}-p`} className="text-xs">
+            {t.product}
+          </FieldLabel>
+          <Select value={line.productId} onValueChange={(x) => onChange({ productId: x })}>
+            <SelectTrigger id={`${idPrefix}-p`} className="w-full">
+              <SelectValue placeholder={tr.shopping.validation.product} />
+            </SelectTrigger>
+            <SelectContent className="max-h-72">
+              {genericUnit ? (
+                <SelectItem value={GENERIC}>{t.generic(genericUnit)}</SelectItem>
+              ) : null}
+              {products.map((p) => (
+                <SelectItem key={p.id} value={p.id}>
+                  {p.label}{" "}
+                  <span className="text-xs text-muted-foreground">({p.packageLabel})</span>
+                </SelectItem>
+              ))}
+            </SelectContent>
+          </Select>
+          {errors.productId ? <FieldError>{errors.productId}</FieldError> : null}
+        </Field>
+      )}
+      <Field data-invalid={Boolean(errors.storeId)} className="col-span-2 sm:col-span-1">
+        <FieldLabel htmlFor={`${idPrefix}-s`} className="text-xs">
+          {t.store}
+        </FieldLabel>
+        <Select value={line.storeId} onValueChange={(x) => onChange({ storeId: x })}>
+          <SelectTrigger id={`${idPrefix}-s`} className="w-full">
+            <SelectValue />
+          </SelectTrigger>
+          <SelectContent className="max-h-72">
+            {sheet.stores.map((s) => (
+              <SelectItem key={s.id} value={s.id}>
+                <StoreDot slot={s.slot} />
+                {s.label}
+              </SelectItem>
+            ))}
+          </SelectContent>
+        </Select>
+      </Field>
+      {text ? (
+        <span className="hidden sm:block" />
+      ) : (
+        <Field data-invalid={Boolean(errors.packages)}>
+          <FieldLabel htmlFor={`${idPrefix}-q`} className="text-xs">
+            {generic && genericUnit ? `${t.quantity} (${genericUnit})` : t.packages}
+          </FieldLabel>
+          <Input
+            id={`${idPrefix}-q`}
+            inputMode="decimal"
+            value={line.packages}
+            onChange={(e) => onChange({ packages: e.target.value })}
+            className="text-right tabular-nums"
+            aria-invalid={Boolean(errors.packages)}
+          />
+        </Field>
+      )}
+      <Field
+        data-invalid={Boolean(errors.amount)}
+        className={text ? "col-span-2 sm:col-span-1" : ""}
+      >
+        <FieldLabel htmlFor={`${idPrefix}-a`} className="text-xs">
+          {t.amount}
+        </FieldLabel>
+        <Input
+          id={`${idPrefix}-a`}
+          inputMode="decimal"
+          value={line.amount}
+          onChange={(e) => onChange({ amount: e.target.value })}
+          className="text-right tabular-nums"
+          aria-invalid={Boolean(errors.amount)}
+        />
+        {errors.amount ? <FieldError>{errors.amount}</FieldError> : null}
+      </Field>
+    </div>
+  );
+}
+
+/** /alisveris/:id/tamamla — alınanları gir, mağaza başına hesap ve fiş, alınmayanlar. */
+export function CompletionForm({ sheet }: { sheet: CompletionSheet }) {
+  const router = useRouter();
+  const anyChecked = sheet.items.some((i) => i.checked);
+  const [date, setDate] = useState(sheet.today);
+  const [rows, setRows] = useState<Record<string, ItemLine>>(() =>
+    Object.fromEntries(
+      sheet.items.map((i) => [
+        i.id,
+        { ...initialLine(sheet, i), bought: anyChecked ? i.checked : !i.archived },
+      ]),
+    ),
+  );
+  const [extras, setExtras] = useState<Extra[]>([]);
+  const [accounts, setAccounts] = useState<Record<string, string>>({});
+  const [receipts, setReceipts] = useState<Record<string, AttachmentInfo[]>>({});
+  const [uploading, setUploading] = useState(0);
+  const [fallback, setFallback] = useState(sheet.defaultFallbackCategoryId ?? "");
+  const [leftover, setLeftover] = useState<{
+    action: LeftoverAction;
+    target: string;
+    name: string;
+  }>({
+    action: sheet.otherLists.length ? "move" : "new",
+    target: sheet.otherLists[0]?.id ?? "",
+    name: t.newListDefault(sheet.list.name),
+  });
+  const [errors, setErrors] = useState<Record<string, string | undefined>>({});
+  const [busy, setBusy] = useState(false);
+
+  const typeProducts = (item: ShoppingItemView) => {
+    const typeId =
+      item.kind === "product"
+        ? sheet.products.find((p) => p.id === item.productId)?.productTypeId
+        : item.productTypeId;
+    return sheet.products.filter((p) => p.productTypeId === typeId);
+  };
+
+  const bought = sheet.items.filter((i) => rows[i.id]!.bought);
+  const unbought = sheet.items.filter((i) => !rows[i.id]!.bought);
+  const allLines: (Line & { itemId: string; text: boolean })[] = [
+    ...bought.map((i) => ({ ...rows[i.id]!, itemId: i.id, text: i.kind === "text" })),
+    ...extras.map((e) => ({ ...e, itemId: "", text: false })),
+  ];
+  const storeIds = [...new Set(allLines.map((l) => l.storeId).filter(Boolean))];
+  const unmapped = new Set(sheet.unmappedTypeIds);
+  const needsFallback = allLines.some(
+    (l) =>
+      l.text || unmapped.has(sheet.products.find((p) => p.id === l.productId)?.productTypeId ?? ""),
+  );
+  const total = allLines.reduce((a, l) => a + (parseMoney(l.amount) ?? 0), 0);
+  const plannedTotal = useMemo(
+    () => Object.values(sheet.planned).reduce((a, p) => a + p.priceMinor * p.packages, 0),
+    [sheet.planned],
+  );
+
+  function setRow(id: string, patch: Partial<ItemLine>) {
+    setRows((s) => {
+      const cur = s[id]!;
+      const { bought: b, ...rest } = patch;
+      const next = Object.keys(rest).length ? { ...cur, ...withPrice(sheet, cur, rest) } : cur;
+      return { ...s, [id]: { ...next, bought: b ?? cur.bought } };
+    });
+  }
+
+  async function submit() {
+    setBusy(true);
+    const lineKeys = allLines.map((l, i) =>
+      l.itemId ? `item:${l.itemId}` : `extra:${extras[i - bought.length]?.key}`,
+    );
+    const r = await completeShoppingAction(sheet.list.id, {
+      date,
+      lines: allLines.map((l) => ({
+        itemId: l.itemId,
+        productId: l.text || l.productId === GENERIC ? "" : l.productId,
+        storeId: l.storeId,
+        packages: l.text ? "1" : l.packages,
+        amount: l.amount,
+      })),
+      stores: storeIds.map((id) => ({
+        storeId: id,
+        accountId: accounts[id] ?? defaultAccount(sheet, id),
+        attachmentIds: (receipts[id] ?? []).map((a) => a.id),
+      })),
+      fallbackCategoryId: needsFallback ? fallback : "",
+      leftover: unbought.length
+        ? { action: leftover.action, targetListId: leftover.target, newListName: leftover.name }
+        : { action: "drop" },
+    });
+    setBusy(false);
+    if (r.ok) {
+      toast.success(t.saved);
+      router.push(`/alisveris/${sheet.list.id}`);
+      return;
+    }
+    // Satır hatalarını satır anahtarına çevir.
+    const mapped: Record<string, string | undefined> = {};
+    for (const [k, msg] of Object.entries(r.fieldErrors ?? {})) {
+      const m = /^lines\.(\d+)\.(\w+)$/.exec(k);
+      if (m) mapped[`${lineKeys[Number(m[1])]}.${m[2]}`] = msg;
+      else {
+        const s = /^stores\.(\d+)\.(\w+)$/.exec(k);
+        mapped[s ? `store:${storeIds[Number(s[1])]}` : k] = msg;
+      }
+    }
+    setErrors({ ...mapped, root: r.error });
+    toast.error(r.error);
+  }
+
+  const errs = (key: string) => ({
+    productId: errors[`${key}.productId`],
+    storeId: errors[`${key}.storeId`],
+    packages: errors[`${key}.packages`],
+    amount: errors[`${key}.amount`],
+  });
+
+  return (
+    <div className="mx-auto flex w-full max-w-4xl flex-col gap-5">
+      <Button variant="ghost" size="sm" asChild className="-ml-2 w-fit">
+        <Link href={`/alisveris/${sheet.list.id}`}>
+          <ArrowLeft />
+          {tr.shopping.actions.backToList}
+        </Link>
+      </Button>
+      <div>
+        <h1 className="text-xl font-semibold">
+          {t.title}: {sheet.list.name}
+        </h1>
+        <p className="text-sm text-muted-foreground">{t.description}</p>
+      </div>
+      {sheet.stores.length === 0 ? (
+        <p className="rounded-lg border border-dashed p-6 text-center text-sm">{t.noStores}</p>
+      ) : null}
+      <Field className="max-w-48" data-invalid={Boolean(errors.date)}>
+        <FieldLabel htmlFor="sc-date">{t.date}</FieldLabel>
+        <Input
+          id="sc-date"
+          type="date"
+          value={date}
+          max={sheet.today}
+          onChange={(e) => setDate(e.target.value)}
+        />
+        {errors.date ? <FieldError>{errors.date}</FieldError> : null}
+      </Field>
+
+      <section aria-labelledby="sc-items" className="flex flex-col gap-2">
+        <h2 id="sc-items" className="font-medium">
+          {t.itemsTitle}
+        </h2>
+        <ul className="divide-y rounded-xl border bg-card">
+          {sheet.items.map((item) => {
+            const row = rows[item.id]!;
+            const plan = sheet.planned[item.id];
+            const planProduct = plan ? sheet.products.find((p) => p.id === plan.productId) : null;
+            const planStore = plan ? sheet.stores.find((s) => s.id === plan.storeId) : null;
+            const substitute =
+              row.bought &&
+              item.kind !== "text" &&
+              (item.kind === "product"
+                ? row.productId !== item.productId
+                : plan && row.productId !== plan.productId);
+            const key = `item:${item.id}`;
+            return (
+              <li
+                key={item.id}
+                className={cn("flex flex-col gap-3 p-3", !row.bought && "bg-muted/30")}
+              >
+                <div className="flex items-start gap-3">
+                  <Checkbox
+                    id={`b-${item.id}`}
+                    checked={row.bought}
+                    onCheckedChange={(x) => setRow(item.id, { bought: x === true })}
+                    className="mt-0.5 size-5"
+                  />
+                  <label htmlFor={`b-${item.id}`} className="min-w-0 flex-1 cursor-pointer">
+                    <span
+                      className={cn("block font-medium", !row.bought && "text-muted-foreground")}
+                    >
+                      {item.label}{" "}
+                      {item.quantityLabel ? (
+                        <span className="text-sm font-normal text-muted-foreground tabular-nums">
+                          · {item.quantityLabel}
+                        </span>
+                      ) : null}
+                    </span>
+                    <span className="block text-xs text-muted-foreground">
+                      {plan && planProduct && planStore
+                        ? t.planned(
+                            `${planProduct.label} · ${planStore.label} · ${formatMoney(plan.priceMinor * plan.packages)}`,
+                          )
+                        : item.kind === "text"
+                          ? null
+                          : t.noPlan}
+                    </span>
+                  </label>
+                  {substitute ? <Badge variant="outline">{t.substitute}</Badge> : null}
+                </div>
+                {row.bought ? (
+                  <LineFields
+                    sheet={sheet}
+                    line={row}
+                    products={typeProducts(item)}
+                    text={item.kind === "text"}
+                    genericUnit={item.kind === "type" ? item.unit : undefined}
+                    onChange={(patch) => setRow(item.id, patch)}
+                    errors={errs(key)}
+                    idPrefix={`l-${item.id}`}
+                  />
+                ) : null}
+              </li>
+            );
+          })}
+        </ul>
+      </section>
+
+      <section aria-labelledby="sc-extras" className="flex flex-col gap-2">
+        <h2 id="sc-extras" className="font-medium">
+          {t.extrasTitle}
+        </h2>
+        {extras.length ? (
+          <ul className="divide-y rounded-xl border bg-card">
+            {extras.map((e) => (
+              <li key={e.key} className="flex items-start gap-2 p-3">
+                <div className="min-w-0 flex-1">
+                  <LineFields
+                    sheet={sheet}
+                    line={e}
+                    products={sheet.products}
+                    text={false}
+                    onChange={(patch) =>
+                      setExtras((s) =>
+                        s.map((x) =>
+                          x.key === e.key ? { ...x, ...withPrice(sheet, x, patch) } : x,
+                        ),
+                      )
+                    }
+                    errors={errs(`extra:${e.key}`)}
+                    idPrefix={`e-${e.key}`}
+                  />
+                </div>
+                <Button
+                  size="icon-sm"
+                  variant="ghost"
+                  className="mt-6"
+                  aria-label={t.removeExtra}
+                  onClick={() => setExtras((s) => s.filter((x) => x.key !== e.key))}
+                >
+                  <Trash2 />
+                </Button>
+              </li>
+            ))}
+          </ul>
+        ) : null}
+        <Button
+          variant="outline"
+          size="sm"
+          className="w-fit"
+          onClick={() =>
+            setExtras((s) => [
+              ...s,
+              {
+                key: Date.now(),
+                productId: "",
+                storeId: storeIds[0] ?? defaultStore(sheet),
+                packages: "1",
+                amount: "",
+                touched: false,
+              },
+            ])
+          }
+        >
+          <Plus />
+          {t.addExtra}
+        </Button>
+      </section>
+
+      {storeIds.length ? (
+        <section aria-labelledby="sc-stores" className="flex flex-col gap-2">
+          <div>
+            <h2 id="sc-stores" className="font-medium">
+              {t.storesTitle}
+            </h2>
+            <p className="text-sm text-muted-foreground">{t.storesDescription}</p>
+          </div>
+          <ul className="grid gap-3 md:grid-cols-2">
+            {storeIds.map((id) => {
+              const store = sheet.stores.find((s) => s.id === id);
+              const lines = allLines.filter((l) => l.storeId === id);
+              const sum = lines.reduce((a, l) => a + (parseMoney(l.amount) ?? 0), 0);
+              return (
+                <li key={id} className="flex flex-col gap-3 rounded-xl border bg-card p-3">
+                  <div className="flex items-center gap-2">
+                    <span className="flex min-w-0 items-center font-medium">
+                      <StoreDot slot={store?.slot ?? 1} />
+                      <span className="truncate">{store?.label}</span>
+                    </span>
+                    <span className="ml-auto text-sm tabular-nums">
+                      {t.subtotal(lines.length)} · {formatMoney(sum)}
+                    </span>
+                  </div>
+                  <Field data-invalid={Boolean(errors[`store:${id}`])}>
+                    <FieldLabel htmlFor={`acc-${id}`}>{t.account}</FieldLabel>
+                    <Select
+                      value={accounts[id] ?? defaultAccount(sheet, id)}
+                      onValueChange={(x) => setAccounts((s) => ({ ...s, [id]: x }))}
+                    >
+                      <SelectTrigger id={`acc-${id}`} className="w-full">
+                        <SelectValue />
+                      </SelectTrigger>
+                      <SelectContent>
+                        {sheet.accounts.map((a) => (
+                          <SelectItem key={a.id} value={a.id}>
+                            {a.name}
+                          </SelectItem>
+                        ))}
+                      </SelectContent>
+                    </Select>
+                    {errors[`store:${id}`] ? (
+                      <FieldError>{errors[`store:${id}`]}</FieldError>
+                    ) : null}
+                  </Field>
+                  <Field>
+                    <FieldLabel>{t.receipts}</FieldLabel>
+                    <AttachmentPicker
+                      value={receipts[id] ?? []}
+                      onChange={(items) => setReceipts((s) => ({ ...s, [id]: items }))}
+                      allowedKinds={["image"]}
+                      onBusyChange={(b) => setUploading((n) => n + (b ? 1 : -1))}
+                      addLabel={t.addReceipt}
+                      hint={t.receiptHint}
+                    />
+                  </Field>
+                </li>
+              );
+            })}
+          </ul>
+        </section>
+      ) : null}
+
+      {needsFallback ? (
+        <Field data-invalid={Boolean(errors.fallbackCategoryId)} className="max-w-md">
+          <FieldLabel htmlFor="sc-fallback">{t.fallbackCategory}</FieldLabel>
+          <Select value={fallback} onValueChange={setFallback}>
+            <SelectTrigger id="sc-fallback" className="w-full">
+              <SelectValue placeholder={t.fallbackCategory} />
+            </SelectTrigger>
+            <SelectContent className="max-h-72">
+              {sheet.expenseCategories.map((c) => (
+                <SelectItem key={c.id} value={c.id}>
+                  {c.path}
+                </SelectItem>
+              ))}
+            </SelectContent>
+          </Select>
+          <FieldDescription>{t.fallbackHint}</FieldDescription>
+          {errors.fallbackCategoryId ? <FieldError>{errors.fallbackCategoryId}</FieldError> : null}
+        </Field>
+      ) : null}
+
+      {unbought.length ? (
+        <section aria-labelledby="sc-left" className="flex flex-col gap-2">
+          <div>
+            <h2 id="sc-left" className="font-medium">
+              {t.leftoverTitle}
+            </h2>
+            <p className="text-sm text-muted-foreground">
+              {t.leftoverDescription(unbought.length)} {unbought.map((i) => i.label).join(", ")}
+            </p>
+          </div>
+          <div role="radiogroup" aria-labelledby="sc-left" className="flex flex-col gap-2">
+            {(["move", "new", "drop"] as const)
+              .filter((a) => a !== "move" || sheet.otherLists.length)
+              .map((a) => (
+                <label key={a} className="flex items-center gap-2 text-sm">
+                  <input
+                    type="radio"
+                    name="leftover"
+                    value={a}
+                    checked={leftover.action === a}
+                    onChange={() => setLeftover((s) => ({ ...s, action: a }))}
+                    className="size-4 accent-primary"
+                  />
+                  {t.leftoverActions[a]}
+                </label>
+              ))}
+          </div>
+          {leftover.action === "move" ? (
+            <Select
+              value={leftover.target}
+              onValueChange={(x) => setLeftover((s) => ({ ...s, target: x }))}
+            >
+              <SelectTrigger className="w-full max-w-md" aria-label={tr.shopping.moveTarget}>
+                <SelectValue />
+              </SelectTrigger>
+              <SelectContent>
+                {sheet.otherLists.map((l) => (
+                  <SelectItem key={l.id} value={l.id}>
+                    {l.name}
+                  </SelectItem>
+                ))}
+              </SelectContent>
+            </Select>
+          ) : leftover.action === "new" ? (
+            <Input
+              aria-label={t.newListName}
+              value={leftover.name}
+              onChange={(e) => setLeftover((s) => ({ ...s, name: e.target.value }))}
+              className="max-w-md"
+            />
+          ) : null}
+          {errors["leftover.targetListId"] || errors["leftover.newListName"] ? (
+            <FieldError>
+              {errors["leftover.targetListId"] ?? errors["leftover.newListName"]}
+            </FieldError>
+          ) : null}
+        </section>
+      ) : null}
+
+      <div className="sticky bottom-[calc(4rem+env(safe-area-inset-bottom))] z-10 -mx-4 border-t bg-background/95 backdrop-blur md:bottom-0 md:mx-0 md:rounded-xl md:border">
+        <div className="flex items-center gap-3 px-4 py-3">
+          <div className="min-w-0 flex-1 text-sm">
+            <span className="font-medium tabular-nums">
+              {t.total}: {formatMoney(total)}
+            </span>
+            {plannedTotal ? (
+              <span className="text-muted-foreground tabular-nums">
+                {" · "}
+                {t.plannedTotal}: {formatMoney(plannedTotal)}
+              </span>
+            ) : null}
+            {errors.root ? (
+              <span className="block text-xs text-destructive">{errors.root}</span>
+            ) : null}
+          </div>
+          <Button onClick={submit} disabled={busy || uploading > 0 || allLines.length === 0}>
+            {t.submit}
+          </Button>
+        </div>
+      </div>
+    </div>
+  );
+}

src/features/shopping/components/item-dialog.tsx

@@ -0,0 +1,222 @@
+"use client";
+
+import { useState } from "react";
+import { toast } from "sonner";
+import { ResponsiveDialog } from "@/components/responsive-dialog";
+import { Button } from "@/components/ui/button";
+import { Field, FieldDescription, FieldError, FieldGroup, FieldLabel } from "@/components/ui/field";
+import { Input } from "@/components/ui/input";
+import {
+  Select,
+  SelectContent,
+  SelectGroup,
+  SelectItem,
+  SelectLabel,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs";
+import { tr } from "@/i18n/tr";
+import { SHOPPING_ITEM_KINDS, type ShoppingItemKind } from "@/shared/shopping";
+import { quantityInput } from "@/shared/stock";
+import { addShoppingItemAction, updateShoppingItemAction } from "../actions";
+import type { ItemOptions, ShoppingItemView } from "../service";
+
+const t = tr.shopping;
+const f = t.fields;
+type Errors = Record<string, string | undefined>;
+
+/** Kalem ekle (ürün tipi / belirli marka / serbest metin) ya da düzenle (miktar, not). */
+export function ShoppingItemDialog({
+  listId,
+  item,
+  options,
+  onClose,
+}: {
+  listId: string;
+  item: ShoppingItemView | null;
+  options: ItemOptions;
+  onClose: () => void;
+}) {
+  const [v, setV] = useState({
+    kind: (item?.kind ?? "type") as ShoppingItemKind,
+    productTypeId: item?.productTypeId ?? "",
+    productId: item?.productId ?? "",
+    text: item?.text ?? "",
+    quantity: item?.quantity != null ? quantityInput(item.quantity) : "",
+    unit: item?.kind === "text" ? item.unit : "",
+    note: item?.note ?? "",
+  });
+  const [errors, setErrors] = useState<Errors>({});
+  const [busy, setBusy] = useState(false);
+  const set = <K extends keyof typeof v>(k: K, x: (typeof v)[K]) => setV((s) => ({ ...s, [k]: x }));
+
+  const typeUnit = options.types.find((x) => x.id === v.productTypeId)?.unit ?? "";
+  const unitSuffix =
+    v.kind === "type" ? (item?.unit ?? typeUnit) : v.kind === "product" ? t.packageUnit : "";
+  const productGroups = new Map<string, ItemOptions["products"]>();
+  for (const p of options.products)
+    productGroups.set(p.typeName, [...(productGroups.get(p.typeName) ?? []), p]);
+
+  async function submit(e: React.FormEvent) {
+    e.preventDefault();
+    setBusy(true);
+    const r = item
+      ? await updateShoppingItemAction(listId, item.id, {
+          quantity: v.quantity,
+          text: v.text,
+          unit: v.unit,
+          note: v.note,
+        })
+      : await addShoppingItemAction(listId, v);
+    setBusy(false);
+    if (r.ok) {
+      toast.success(item ? t.toast.itemSaved : t.toast.itemAdded);
+      onClose();
+    } else setErrors({ ...r.fieldErrors, root: r.fieldErrors ? undefined : r.error });
+  }
+
+  return (
+    <ResponsiveDialog
+      open
+      onOpenChange={(o) => !o && onClose()}
+      title={item ? t.editItemTitle : t.addItemTitle}
+      description={item && item.kind !== "text" ? item.label : undefined}
+      footer={
+        <>
+          <Button variant="outline" type="button" onClick={onClose}>
+            {tr.common.cancel}
+          </Button>
+          <Button type="submit" form="shopping-item-form" disabled={busy}>
+            {tr.common.save}
+          </Button>
+        </>
+      }
+    >
+      <form id="shopping-item-form" onSubmit={submit} noValidate>
+        <FieldGroup>
+          {item ? null : (
+            <Field>
+              <FieldLabel>{f.kind}</FieldLabel>
+              <Tabs value={v.kind} onValueChange={(x) => set("kind", x as ShoppingItemKind)}>
+                <TabsList className="w-full">
+                  {SHOPPING_ITEM_KINDS.map((k) => (
+                    <TabsTrigger key={k} value={k}>
+                      {t.kinds[k]}
+                    </TabsTrigger>
+                  ))}
+                </TabsList>
+              </Tabs>
+              <FieldDescription>{t.kindHints[v.kind]}</FieldDescription>
+            </Field>
+          )}
+          {!item && v.kind === "type" ? (
+            <Field data-invalid={Boolean(errors.productTypeId)}>
+              <FieldLabel htmlFor="si-type">{f.productType}</FieldLabel>
+              <Select value={v.productTypeId} onValueChange={(x) => set("productTypeId", x)}>
+                <SelectTrigger
+                  id="si-type"
+                  className="w-full"
+                  aria-invalid={Boolean(errors.productTypeId)}
+                >
+                  <SelectValue placeholder={t.validation.productType} />
+                </SelectTrigger>
+                <SelectContent className="max-h-72">
+                  {options.types.map((x) => (
+                    <SelectItem key={x.id} value={x.id}>
+                      {x.name} <span className="text-xs text-muted-foreground">({x.unit})</span>
+                    </SelectItem>
+                  ))}
+                </SelectContent>
+              </Select>
+              {errors.productTypeId ? <FieldError>{errors.productTypeId}</FieldError> : null}
+            </Field>
+          ) : null}
+          {!item && v.kind === "product" ? (
+            <Field data-invalid={Boolean(errors.productId)}>
+              <FieldLabel htmlFor="si-product">{f.product}</FieldLabel>
+              <Select value={v.productId} onValueChange={(x) => set("productId", x)}>
+                <SelectTrigger
+                  id="si-product"
+                  className="w-full"
+                  aria-invalid={Boolean(errors.productId)}
+                >
+                  <SelectValue placeholder={t.validation.product} />
+                </SelectTrigger>
+                <SelectContent className="max-h-72">
+                  {[...productGroups.entries()].map(([group, rows]) => (
+                    <SelectGroup key={group}>
+                      <SelectLabel>{group}</SelectLabel>
+                      {rows.map((p) => (
+                        <SelectItem key={p.id} value={p.id}>
+                          {p.label}{" "}
+                          <span className="text-xs text-muted-foreground">({p.packageLabel})</span>
+                        </SelectItem>
+                      ))}
+                    </SelectGroup>
+                  ))}
+                </SelectContent>
+              </Select>
+              {errors.productId ? <FieldError>{errors.productId}</FieldError> : null}
+            </Field>
+          ) : null}
+          {v.kind === "text" ? (
+            <Field data-invalid={Boolean(errors.text)}>
+              <FieldLabel htmlFor="si-text">{f.text}</FieldLabel>
+              <Input
+                id="si-text"
+                value={v.text}
+                placeholder={f.textPlaceholder}
+                onChange={(e) => set("text", e.target.value)}
+                aria-invalid={Boolean(errors.text)}
+                autoFocus={!item}
+              />
+              {errors.text ? <FieldError>{errors.text}</FieldError> : null}
+            </Field>
+          ) : null}
+          <div className="grid grid-cols-2 gap-3">
+            <Field data-invalid={Boolean(errors.quantity)}>
+              <FieldLabel htmlFor="si-qty">
+                {v.kind === "product" ? f.packages : f.quantity}
+                {unitSuffix ? ` (${unitSuffix})` : ""}
+              </FieldLabel>
+              <Input
+                id="si-qty"
+                inputMode="decimal"
+                value={v.quantity}
+                onChange={(e) => set("quantity", e.target.value)}
+                className="text-right tabular-nums"
+                aria-invalid={Boolean(errors.quantity)}
+              />
+              {errors.quantity ? <FieldError>{errors.quantity}</FieldError> : null}
+            </Field>
+            {v.kind === "text" ? (
+              <Field>
+                <FieldLabel htmlFor="si-unit">{f.unit}</FieldLabel>
+                <Input
+                  id="si-unit"
+                  value={v.unit}
+                  placeholder={f.unitPlaceholder}
+                  onChange={(e) => set("unit", e.target.value)}
+                />
+              </Field>
+            ) : null}
+          </div>
+          {v.kind !== "text" ? (
+            <FieldDescription className="-mt-2">{f.quantityHint}</FieldDescription>
+          ) : null}
+          <Field>
+            <FieldLabel htmlFor="si-note">{f.itemNote}</FieldLabel>
+            <Input
+              id="si-note"
+              value={v.note}
+              placeholder={f.itemNotePlaceholder}
+              onChange={(e) => set("note", e.target.value)}
+            />
+          </Field>
+          {errors.root ? <FieldError>{errors.root}</FieldError> : null}
+        </FieldGroup>
+      </form>
+    </ResponsiveDialog>
+  );
+}

src/features/shopping/components/list-detail.tsx

@@ -0,0 +1,509 @@
+"use client";
+
+import {
+  ArrowLeft,
+  ArrowRightLeft,
+  Check,
+  ClipboardCheck,
+  EllipsisVertical,
+  Package,
+  Pencil,
+  Plus,
+  ShoppingCart,
+  Sparkles,
+  Tag,
+  Trash2,
+  X,
+} from "lucide-react";
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { useState } from "react";
+import { toast } from "sonner";
+import {
+  AlertDialog,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from "@/components/ui/alert-dialog";
+import { PageHeader } from "@/components/page-header";
+import { ResponsiveDialog } from "@/components/responsive-dialog";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
+import { Field, FieldLabel } from "@/components/ui/field";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import { useAutoRefresh } from "@/hooks/use-auto-refresh";
+import { tr } from "@/i18n/tr";
+import { cn } from "@/lib/utils";
+import { SHOPPING_REFRESH_MS } from "@/shared/shopping";
+import { formatStock } from "@/shared/stock";
+import {
+  approveSuggestionsAction,
+  deleteShoppingListAction,
+  dismissSuggestionAction,
+  moveShoppingItemAction,
+  removeShoppingItemAction,
+} from "../actions";
+import type { ShoppingItemView, ShoppingListDetail, SuggestionView } from "../service";
+import { ShoppingItemDialog } from "./item-dialog";
+import { ShoppingListDialog } from "./list-dialog";
+import { PlanPanel } from "./plan-panel";
+import { ShoppingReport } from "./report-view";
+
+const t = tr.shopping;
+
+function SuggestionsPanel({
+  listId,
+  suggestions,
+  canWrite,
+}: {
+  listId: string;
+  suggestions: SuggestionView[];
+  canWrite: boolean;
+}) {
+  const [busy, setBusy] = useState<string | null>(null);
+  const s = t.suggestions;
+
+  async function approve(ids: string[]) {
+    setBusy(ids.length > 1 ? "all" : ids[0]!);
+    const r = await approveSuggestionsAction(listId, ids);
+    setBusy(null);
+    if (r.ok) toast.success(t.toast.suggestionsAdded(r.data.added));
+    else toast.error(r.error);
+  }
+  async function dismiss(id: string) {
+    setBusy(id);
+    const r = await dismissSuggestionAction(id);
+    setBusy(null);
+    if (r.ok) toast.success(t.toast.dismissed);
+    else toast.error(r.error);
+  }
+
+  return (
+    <section
+      aria-labelledby="sugg-h"
+      className="flex flex-col gap-3 rounded-xl border border-amber-500/40 bg-amber-500/5 p-4"
+    >
+      <div className="flex flex-wrap items-start gap-3">
+        <div className="min-w-0 flex-1">
+          <h2 id="sugg-h" className="flex items-center gap-1.5 font-medium">
+            <Sparkles className="size-4 text-amber-600" aria-hidden />
+            {s.title}
+          </h2>
+          <p className="text-sm text-muted-foreground">{s.description}</p>
+        </div>
+        {canWrite && suggestions.length > 1 ? (
+          <Button
+            size="sm"
+            variant="outline"
+            disabled={busy !== null}
+            onClick={() => approve(suggestions.map((x) => x.productTypeId))}
+          >
+            <Plus />
+            {s.addAll}
+          </Button>
+        ) : null}
+      </div>
+      <ul className="divide-y rounded-lg border bg-card">
+        {suggestions.map((x) => {
+          const reasons = [
+            x.suggestion.waste
+              ? tr.stock.suggestions.wasteReduced(
+                  x.suggestion.waste.purchases,
+                  x.suggestion.waste.pct,
+                )
+              : null,
+          ].filter(Boolean);
+          return (
+            <li key={x.productTypeId} className="flex flex-wrap items-center gap-x-3 gap-y-2 p-3">
+              <div className="min-w-0 flex-1">
+                <p className="truncate font-medium">
+                  <Link href={`/stok/${x.productTypeId}`} className="hover:underline">
+                    {x.name}
+                  </Link>
+                </p>
+                <p className="text-xs text-muted-foreground tabular-nums">
+                  {s.line(
+                    formatStock(Math.max(0, x.current), x.unit),
+                    formatStock(x.target, x.unit),
+                    x.pct,
+                  )}
+                </p>
+                <p className="text-sm tabular-nums">
+                  {s.suggested(formatStock(x.suggestedQuantity, x.unit))}
+                  {reasons.length ? (
+                    <span className="text-xs text-muted-foreground"> · {reasons.join(" · ")}</span>
+                  ) : null}
+                </p>
+              </div>
+              {canWrite ? (
+                <div className="flex gap-2">
+                  <Button
+                    size="sm"
+                    variant="ghost"
+                    disabled={busy !== null}
+                    title={s.dismissHint}
+                    onClick={() => dismiss(x.productTypeId)}
+                  >
+                    <X />
+                    {s.dismiss}
+                  </Button>
+                  <Button
+                    size="sm"
+                    disabled={busy !== null}
+                    onClick={() => approve([x.productTypeId])}
+                  >
+                    <Check />
+                    {s.add}
+                  </Button>
+                </div>
+              ) : null}
+            </li>
+          );
+        })}
+      </ul>
+    </section>
+  );
+}
+
+const KIND_ICON = { type: Package, product: Tag, text: null } as const;
+
+function ItemRow({
+  item,
+  canWrite,
+  onEdit,
+  onMove,
+  onRemove,
+}: {
+  item: ShoppingItemView;
+  canWrite: boolean;
+  onEdit: () => void;
+  onMove: () => void;
+  onRemove: () => void;
+}) {
+  const Icon = KIND_ICON[item.kind];
+  return (
+    <li className={cn("flex items-center gap-3 p-3", item.checked && "bg-muted/30")}>
+      <span
+        aria-hidden
+        className="flex size-8 shrink-0 items-center justify-center rounded-md bg-muted text-muted-foreground"
+      >
+        {item.checked ? (
+          <Check className="size-4 text-income" />
+        ) : Icon ? (
+          <Icon className="size-4" />
+        ) : (
+          <span className="text-xs">Aa</span>
+        )}
+      </span>
+      <div className="min-w-0 flex-1">
+        <p
+          className={cn(
+            "truncate font-medium",
+            item.checked && "text-muted-foreground line-through",
+          )}
+        >
+          {item.kind === "type" && item.productTypeId ? (
+            <Link href={`/stok/${item.productTypeId}`} className="hover:underline">
+              {item.label}
+            </Link>
+          ) : item.kind === "product" && item.productId ? (
+            <Link href={`/stok/urunler/${item.productId}`} className="hover:underline">
+              {item.label}
+            </Link>
+          ) : (
+            item.label
+          )}
+        </p>
+        {item.detail || item.stock ? (
+          <p className="truncate text-xs text-muted-foreground">
+            {item.stock ? t.stockLine(item.stock.current, item.stock.target) : item.detail}
+          </p>
+        ) : null}
+        <div className="mt-1 flex flex-wrap items-center gap-1.5">
+          {item.checked ? <Badge variant="secondary">{tr.shopping.mode.inCart}</Badge> : null}
+          {item.source === "suggestion" ? (
+            <Badge variant="outline" className="gap-1">
+              <Sparkles className="size-3" aria-hidden />
+              {t.fromSuggestion}
+            </Badge>
+          ) : null}
+          {item.archived ? <Badge variant="secondary">{t.archivedRef}</Badge> : null}
+          {item.note ? <span className="text-xs text-muted-foreground">{item.note}</span> : null}
+        </div>
+      </div>
+      <span className="shrink-0 text-sm tabular-nums">{item.quantityLabel}</span>
+      {canWrite ? (
+        <DropdownMenu modal={false}>
+          <DropdownMenuTrigger asChild>
+            <Button size="icon-sm" variant="ghost" aria-label={`${item.label}: ${t.actions.more}`}>
+              <EllipsisVertical />
+            </Button>
+          </DropdownMenuTrigger>
+          <DropdownMenuContent align="end">
+            <DropdownMenuItem onSelect={onEdit}>
+              <Pencil />
+              {t.actions.edit}
+            </DropdownMenuItem>
+            <DropdownMenuItem onSelect={onMove}>
+              <ArrowRightLeft />
+              {t.actions.moveTo}
+            </DropdownMenuItem>
+            <DropdownMenuSeparator />
+            <DropdownMenuItem variant="destructive" onSelect={onRemove}>
+              <Trash2 />
+              {t.actions.remove}
+            </DropdownMenuItem>
+          </DropdownMenuContent>
+        </DropdownMenu>
+      ) : null}
+    </li>
+  );
+}
+
+function MoveDialog({
+  listId,
+  item,
+  lists,
+  onClose,
+}: {
+  listId: string;
+  item: ShoppingItemView;
+  lists: { id: string; name: string }[];
+  onClose: () => void;
+}) {
+  const [target, setTarget] = useState(lists[0]?.id ?? "");
+  const [busy, setBusy] = useState(false);
+  async function submit() {
+    setBusy(true);
+    const r = await moveShoppingItemAction(listId, item.id, target);
+    setBusy(false);
+    if (r.ok) {
+      toast.success(t.toast.moved);
+      onClose();
+    } else toast.error(r.error);
+  }
+  return (
+    <ResponsiveDialog
+      open
+      onOpenChange={(o) => !o && onClose()}
+      title={t.moveTitle}
+      description={t.moveDescription(item.label)}
+      footer={
+        <>
+          <Button variant="outline" onClick={onClose}>
+            {tr.common.cancel}
+          </Button>
+          <Button onClick={submit} disabled={busy || !target}>
+            {t.actions.moveTo}
+          </Button>
+        </>
+      }
+    >
+      {lists.length ? (
+        <Field>
+          <FieldLabel htmlFor="sm-target">{t.moveTarget}</FieldLabel>
+          <Select value={target} onValueChange={setTarget}>
+            <SelectTrigger id="sm-target" className="w-full">
+              <SelectValue />
+            </SelectTrigger>
+            <SelectContent>
+              {lists.map((l) => (
+                <SelectItem key={l.id} value={l.id}>
+                  {l.name}
+                </SelectItem>
+              ))}
+            </SelectContent>
+          </Select>
+        </Field>
+      ) : (
+        <p className="text-sm text-muted-foreground">{t.noOtherLists}</p>
+      )}
+    </ResponsiveDialog>
+  );
+}
+
+/** /alisveris/:id — kalemler, stok önerileri (onayla/reddet), akıllı mağaza önerisi. */
+export function ShoppingListDetailView({ data }: { data: ShoppingListDetail }) {
+  const router = useRouter();
+  const { list, items, canWrite } = data;
+  const [adding, setAdding] = useState(false);
+  const [editing, setEditing] = useState<ShoppingItemView | null>(null);
+  const [moving, setMoving] = useState<ShoppingItemView | null>(null);
+  const [editingList, setEditingList] = useState(false);
+  const [deleting, setDeleting] = useState(false);
+  useAutoRefresh(SHOPPING_REFRESH_MS);
+
+  async function remove(item: ShoppingItemView) {
+    const r = await removeShoppingItemAction(list.id, item.id);
+    if (r.ok) toast.success(t.toast.itemRemoved);
+    else toast.error(r.error);
+  }
+
+  return (
+    <div className="flex flex-col gap-4">
+      <Button variant="ghost" size="sm" asChild className="-ml-2 w-fit">
+        <Link href="/alisveris">
+          <ArrowLeft />
+          {t.actions.back}
+        </Link>
+      </Button>
+      <div className="flex items-start gap-3">
+        <div className="min-w-0 flex-1">
+          <PageHeader
+            title={list.name}
+            description={
+              <>
+                {t.itemCount(list.itemCount)}
+                {list.checkedCount ? ` · ${t.checkedCount(list.checkedCount, list.itemCount)}` : ""}
+                {list.note ? ` · ${list.note}` : ""}
+              </>
+            }
+          />
+        </div>
+        {canWrite ? (
+          <DropdownMenu modal={false}>
+            <DropdownMenuTrigger asChild>
+              <Button size="icon-sm" variant="ghost" aria-label={t.actions.more}>
+                <EllipsisVertical />
+              </Button>
+            </DropdownMenuTrigger>
+            <DropdownMenuContent align="end">
+              <DropdownMenuItem onSelect={() => setEditingList(true)}>
+                <Pencil />
+                {t.actions.editList}
+              </DropdownMenuItem>
+              <DropdownMenuSeparator />
+              <DropdownMenuItem variant="destructive" onSelect={() => setDeleting(true)}>
+                <Trash2 />
+                {t.actions.deleteList}
+              </DropdownMenuItem>
+            </DropdownMenuContent>
+          </DropdownMenu>
+        ) : null}
+      </div>
+
+      <div className="flex flex-wrap gap-2">
+        {canWrite ? (
+          <Button size="sm" onClick={() => setAdding(true)}>
+            <Plus />
+            {t.actions.addItem}
+          </Button>
+        ) : null}
+        {items.length && list.status === "active" ? (
+          <Button size="sm" variant="outline" asChild>
+            <Link href={`/alisveris/${list.id}/mod`}>
+              <ShoppingCart />
+              {t.actions.goShopping}
+            </Link>
+          </Button>
+        ) : null}
+        {items.length && canWrite ? (
+          <Button size="sm" variant="outline" asChild>
+            <Link href={`/alisveris/${list.id}/tamamla`}>
+              <ClipboardCheck />
+              {tr.shopping.complete.action}
+            </Link>
+          </Button>
+        ) : null}
+      </div>
+
+      {data.report ? (
+        <ShoppingReport completion={data.report.completion} summary={data.report.summary} />
+      ) : (
+        <div className="grid gap-4 xl:grid-cols-[minmax(0,1fr)_minmax(0,26rem)] xl:items-start">
+          <div className="flex flex-col gap-4">
+            {data.suggestions.length ? (
+              <SuggestionsPanel
+                listId={list.id}
+                suggestions={data.suggestions}
+                canWrite={canWrite}
+              />
+            ) : null}
+            {items.length ? (
+              <ul className="divide-y rounded-xl border bg-card">
+                {items.map((i) => (
+                  <ItemRow
+                    key={i.id}
+                    item={i}
+                    canWrite={canWrite}
+                    onEdit={() => setEditing(i)}
+                    onMove={() => setMoving(i)}
+                    onRemove={() => remove(i)}
+                  />
+                ))}
+              </ul>
+            ) : (
+              <p className="rounded-lg border border-dashed p-6 text-center text-sm text-muted-foreground">
+                {t.emptyList}
+              </p>
+            )}
+          </div>
+          <PlanPanel plan={data.plan} items={items} />
+        </div>
+      )}
+
+      {adding || editing ? (
+        <ShoppingItemDialog
+          listId={list.id}
+          item={editing}
+          options={data.options}
+          onClose={() => {
+            setAdding(false);
+            setEditing(null);
+          }}
+        />
+      ) : null}
+      {moving ? (
+        <MoveDialog
+          listId={list.id}
+          item={moving}
+          lists={data.otherLists}
+          onClose={() => setMoving(null)}
+        />
+      ) : null}
+      {editingList ? (
+        <ShoppingListDialog list={list} onClose={() => setEditingList(false)} />
+      ) : null}
+      <AlertDialog open={deleting} onOpenChange={setDeleting}>
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>{t.deleteTitle}</AlertDialogTitle>
+            <AlertDialogDescription>{t.deleteDescription(list.name)}</AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel>{tr.common.cancel}</AlertDialogCancel>
+            <Button
+              variant="destructive"
+              onClick={async () => {
+                setDeleting(false);
+                const r = await deleteShoppingListAction(list.id);
+                if (r.ok) {
+                  toast.success(t.toast.deleted);
+                  router.push("/alisveris");
+                } else toast.error(r.error);
+              }}
+            >
+              {t.actions.deleteList}
+            </Button>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
+    </div>
+  );
+}

src/features/shopping/components/list-dialog.tsx

@@ -0,0 +1,86 @@
+"use client";
+
+import { useRouter } from "next/navigation";
+import { useState } from "react";
+import { toast } from "sonner";
+import { ResponsiveDialog } from "@/components/responsive-dialog";
+import { Button } from "@/components/ui/button";
+import { Field, FieldError, FieldGroup, FieldLabel } from "@/components/ui/field";
+import { Input } from "@/components/ui/input";
+import { tr } from "@/i18n/tr";
+import { saveShoppingListAction } from "../actions";
+
+const t = tr.shopping;
+
+/** Yeni liste / listeyi düzenle. Yeni liste açılınca detayına gider. */
+export function ShoppingListDialog({
+  list,
+  onClose,
+}: {
+  list: { id: string; name: string; note: string } | null;
+  onClose: () => void;
+}) {
+  const router = useRouter();
+  const [v, setV] = useState({ name: list?.name ?? "", note: list?.note ?? "" });
+  const [errors, setErrors] = useState<Record<string, string | undefined>>({});
+  const [busy, setBusy] = useState(false);
+
+  async function submit(e: React.FormEvent) {
+    e.preventDefault();
+    setBusy(true);
+    const r = await saveShoppingListAction(list?.id ?? null, v);
+    setBusy(false);
+    if (!r.ok) {
+      setErrors({ ...r.fieldErrors, root: r.fieldErrors ? undefined : r.error });
+      return;
+    }
+    toast.success(t.toast.saved);
+    onClose();
+    if (!list && r.data && typeof r.data === "object" && "id" in r.data)
+      router.push(`/alisveris/${r.data.id}`);
+  }
+
+  return (
+    <ResponsiveDialog
+      open
+      onOpenChange={(o) => !o && onClose()}
+      title={list ? t.editTitle : t.createTitle}
+      footer={
+        <>
+          <Button variant="outline" type="button" onClick={onClose}>
+            {tr.common.cancel}
+          </Button>
+          <Button type="submit" form="shopping-list-form" disabled={busy}>
+            {tr.common.save}
+          </Button>
+        </>
+      }
+    >
+      <form id="shopping-list-form" onSubmit={submit} noValidate>
+        <FieldGroup>
+          <Field data-invalid={Boolean(errors.name)}>
+            <FieldLabel htmlFor="sl-name">{t.fields.name}</FieldLabel>
+            <Input
+              id="sl-name"
+              value={v.name}
+              placeholder={t.fields.namePlaceholder}
+              onChange={(e) => setV((s) => ({ ...s, name: e.target.value }))}
+              aria-invalid={Boolean(errors.name)}
+              autoFocus
+            />
+            {errors.name ? <FieldError>{errors.name}</FieldError> : null}
+          </Field>
+          <Field>
+            <FieldLabel htmlFor="sl-note">{t.fields.note}</FieldLabel>
+            <Input
+              id="sl-note"
+              value={v.note}
+              onChange={(e) => setV((s) => ({ ...s, note: e.target.value }))}
+            />
+          </Field>
+          {errors.root ? <FieldError>{errors.root}</FieldError> : null}
+        </FieldGroup>
+      </form>
+    </ResponsiveDialog>
+  );
+}

src/features/shopping/components/lists-view.tsx

@@ -0,0 +1,115 @@
+"use client";
+
+import { CheckCircle2, ListChecks, Plus, Sparkles } from "lucide-react";
+import Link from "next/link";
+import { useState } from "react";
+import { Button } from "@/components/ui/button";
+import { useAutoRefresh } from "@/hooks/use-auto-refresh";
+import { tr } from "@/i18n/tr";
+import { formatDate } from "@/shared/format";
+import { SHOPPING_REFRESH_MS } from "@/shared/shopping";
+import type { ShoppingListSummary } from "../service";
+import { ShoppingListDialog } from "./list-dialog";
+
+const t = tr.shopping;
+
+function ListCard({ list }: { list: ShoppingListSummary }) {
+  const done = list.status === "completed";
+  const Icon = done ? CheckCircle2 : ListChecks;
+  return (
+    <li>
+      <Link
+        href={`/alisveris/${list.id}`}
+        className="flex h-full flex-col gap-2 rounded-xl border bg-card p-4 transition-colors hover:bg-accent/40 focus-visible:ring-2 focus-visible:ring-ring focus-visible:outline-none"
+      >
+        <div className="flex items-start gap-3">
+          <span className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-muted">
+            <Icon className="size-4.5 text-muted-foreground" aria-hidden />
+          </span>
+          <div className="min-w-0 flex-1">
+            <p className="truncate font-medium">{list.name}</p>
+            <p className="text-xs text-muted-foreground tabular-nums">
+              {t.itemCount(list.itemCount)}
+              {list.checkedCount && !done
+                ? ` · ${t.checkedCount(list.checkedCount, list.itemCount)}`
+                : ""}
+            </p>
+          </div>
+        </div>
+        {list.preview.length ? (
+          <p className="line-clamp-2 text-sm text-muted-foreground">
+            {list.preview.join(", ")}
+            {list.itemCount > list.preview.length ? "…" : ""}
+          </p>
+        ) : (
+          <p className="text-sm text-muted-foreground">{t.emptyList}</p>
+        )}
+        <p className="mt-auto text-xs text-muted-foreground">
+          {done && list.completedAt
+            ? t.completedAt(formatDate(list.completedAt))
+            : t.updated(formatDate(list.updatedAt))}
+        </p>
+      </Link>
+    </li>
+  );
+}
+
+/** /alisveris: aktif ve tamamlanan listeler, yeni liste, bekleyen stok önerileri. */
+export function ShoppingListsView({
+  active,
+  completed,
+  suggestions,
+  canWrite,
+}: {
+  active: ShoppingListSummary[];
+  completed: ShoppingListSummary[];
+  suggestions: number;
+  canWrite: boolean;
+}) {
+  const [creating, setCreating] = useState(false);
+  useAutoRefresh(SHOPPING_REFRESH_MS);
+
+  return (
+    <div className="flex flex-col gap-6">
+      {suggestions > 0 ? (
+        <p className="flex items-start gap-2 rounded-lg border border-amber-500/40 bg-amber-500/5 p-3 text-sm">
+          <Sparkles className="mt-0.5 size-4 shrink-0 text-amber-600" aria-hidden />
+          {t.suggestionsBanner(suggestions)}
+        </p>
+      ) : null}
+      <section className="flex flex-col gap-3">
+        <div className="flex items-center gap-3">
+          <h2 className="text-sm font-medium text-muted-foreground">{t.active}</h2>
+          {canWrite ? (
+            <Button size="sm" className="ml-auto" onClick={() => setCreating(true)}>
+              <Plus />
+              {t.newList}
+            </Button>
+          ) : null}
+        </div>
+        {active.length ? (
+          <ul className="grid gap-3 md:grid-cols-2 xl:grid-cols-3">
+            {active.map((l) => (
+              <ListCard key={l.id} list={l} />
+            ))}
+          </ul>
+        ) : (
+          <p className="rounded-lg border border-dashed p-6 text-center text-sm text-muted-foreground">
+            {t.emptyActive}
+          </p>
+        )}
+      </section>
+      {completed.length ? (
+        <section className="flex flex-col gap-3">
+          <h2 className="text-sm font-medium text-muted-foreground">{t.completed}</h2>
+          <ul className="grid gap-3 md:grid-cols-2 xl:grid-cols-3">
+            {completed.map((l) => (
+              <ListCard key={l.id} list={l} />
+            ))}
+          </ul>
+        </section>
+      ) : null}
+      {creating ? <ShoppingListDialog list={null} onClose={() => setCreating(false)} /> : null}
+    </div>
+  );
+}

src/features/shopping/components/plan-panel.tsx

@@ -0,0 +1,194 @@
+"use client";
+
+import { Globe, Info, Utensils } from "lucide-react";
+import { useState } from "react";
+import { Badge } from "@/components/ui/badge";
+import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs";
+import { StoreDot } from "@/features/prices/components/offers-list";
+import { tr } from "@/i18n/tr";
+import { formatMoney } from "@/shared/format";
+import { formatUnitPrice } from "@/shared/prices";
+import { formatQuantity } from "@/shared/quantity";
+import type { PlanOption } from "@/shared/shopping-plan";
+import type { ShoppingItemView, ShoppingPlanView } from "../service";
+
+const t = tr.shopping.plan;
+
+export type PlanChoice = "recommended" | "single";
+
+const sameStores = (a: PlanOption | null, b: PlanOption | null) =>
+  (a?.stores.map((s) => s.storeId).join() ?? "") === (b?.stores.map((s) => s.storeId).join() ?? "");
+
+/** "Tek mağaza en iyi seçenek: X" ya da "Önerilen dağılım: A (7 ürün), B (3 ürün): Y (Z tasarruf)". */
+export function planHeadline(plan: ShoppingPlanView): string | null {
+  const rec = plan.recommended;
+  if (!rec) return null;
+  const label = (id: string) => plan.stores[id]?.label ?? "—";
+  if (rec.stores.length === 1 && rec.missing.length === 0)
+    return t.singleBest(label(rec.stores[0]!.storeId), formatMoney(rec.totalMinor));
+  const parts = rec.stores.map((g) => t.part(label(g.storeId), g.lines.length)).join(", ");
+  const saving =
+    plan.savingMinor && plan.savingMinor > 0 ? ` (${t.saving(formatMoney(plan.savingMinor))})` : "";
+  return `${t.split(parts, formatMoney(rec.totalMinor))}${saving}`;
+}
+
+function PlanGroups({
+  option,
+  plan,
+  itemLabel,
+}: {
+  option: PlanOption;
+  plan: ShoppingPlanView;
+  itemLabel: Map<string, string>;
+}) {
+  return (
+    <div className="flex flex-col gap-3">
+      {option.stores.map((g) => {
+        const store = plan.stores[g.storeId];
+        return (
+          <section key={g.storeId} className="overflow-hidden rounded-lg border">
+            <header className="flex flex-wrap items-center gap-x-3 gap-y-1 border-b bg-muted/40 px-3 py-2">
+              <h3 className="flex min-w-0 items-center text-sm font-medium">
+                <StoreDot slot={store?.slot ?? 1} />
+                <span className="truncate">{store?.label ?? "—"}</span>
+                {store?.kind === "online" ? (
+                  <Globe className="ml-1.5 size-3.5 text-muted-foreground" aria-hidden />
+                ) : null}
+              </h3>
+              {g.mealCardMinor > 0 ? (
+                <Badge variant="outline" className="gap-1">
+                  <Utensils className="size-3" aria-hidden />
+                  {t.mealCard(formatMoney(g.mealCardMinor))}
+                </Badge>
+              ) : null}
+              <span className="ml-auto text-sm font-medium tabular-nums">
+                {formatMoney(g.subtotalMinor + g.deliveryFeeMinor)}
+              </span>
+            </header>
+            <ul className="divide-y">
+              {g.lines.map((l) => {
+                const p = plan.products[l.productId];
+                return (
+                  <li
+                    key={l.itemId}
+                    className="grid grid-cols-[minmax(0,1fr)_auto] gap-x-3 px-3 py-2 text-sm"
+                  >
+                    <span className="min-w-0">
+                      <span className="block truncate">{itemLabel.get(l.itemId) ?? "—"}</span>
+                      <span className="block truncate text-xs text-muted-foreground">
+                        {p
+                          ? p.label === itemLabel.get(l.itemId)
+                            ? p.packageLabel
+                            : `${p.label} · ${p.packageLabel}`
+                          : "—"}
+                        {p ? ` · ${formatUnitPrice(l.unitPriceMinor, p.typeUnit)}` : ""}
+                      </span>
+                    </span>
+                    <span className="text-right tabular-nums">
+                      <span className="block">{formatMoney(l.costMinor)}</span>
+                      {l.packages > 1 ? (
+                        <span className="block text-xs text-muted-foreground">
+                          {t.line(formatQuantity(l.packages * 1000), formatMoney(l.priceMinor))}
+                        </span>
+                      ) : null}
+                    </span>
+                  </li>
+                );
+              })}
+              {store?.kind === "online" ? (
+                <li className="flex justify-between px-3 py-2 text-xs text-muted-foreground">
+                  <span>
+                    {g.deliveryFeeMinor
+                      ? t.delivery(formatMoney(g.deliveryFeeMinor))
+                      : t.freeDelivery}
+                  </span>
+                  <span className="tabular-nums">
+                    {g.deliveryFeeMinor ? formatMoney(g.deliveryFeeMinor) : ""}
+                  </span>
+                </li>
+              ) : null}
+            </ul>
+          </section>
+        );
+      })}
+      {option.missing.length ? (
+        <p className="text-sm text-muted-foreground">
+          {t.missing}: {option.missing.map((id) => itemLabel.get(id) ?? "—").join(", ")}
+        </p>
+      ) : null}
+      <p className="flex justify-between border-t pt-2 text-sm font-medium">
+        <span>{t.total}</span>
+        <span className="tabular-nums">{formatMoney(option.totalMinor)}</span>
+      </p>
+    </div>
+  );
+}
+
+/** Liste detayında akıllı mağaza önerisi: özet cümle, önerilen / tek mağaza dağılımı. */
+export function PlanPanel({ plan, items }: { plan: ShoppingPlanView; items: ShoppingItemView[] }) {
+  const [choice, setChoice] = useState<PlanChoice>("recommended");
+  const itemLabel = new Map(items.map((i) => [i.id, i.label]));
+  const headline = planHeadline(plan);
+  const differs = plan.single && !sameStores(plan.single, plan.recommended);
+  const option = choice === "single" && differs ? plan.single! : plan.recommended;
+  const hasText = items.some((i) => i.kind === "text");
+
+  return (
+    <section className="flex flex-col gap-3 rounded-xl border bg-card p-4" aria-labelledby="plan-h">
+      <div>
+        <h2 id="plan-h" className="font-medium">
+          {t.title}
+        </h2>
+        <p className="text-sm text-muted-foreground">{t.description}</p>
+      </div>
+      {!option ? (
+        <p className="text-sm text-muted-foreground">{t.empty}</p>
+      ) : (
+        <>
+          {headline ? <p className="text-sm font-medium">{headline}</p> : null}
+          {plan.single && plan.single.missing.length && differs ? (
+            <p className="text-xs text-muted-foreground">
+              {t.singleMissing(plan.single.missing.length)}
+            </p>
+          ) : null}
+          {differs ? (
+            <Tabs value={choice} onValueChange={(x) => setChoice(x as PlanChoice)}>
+              <TabsList>
+                <TabsTrigger value="recommended">{t.recommended}</TabsTrigger>
+                <TabsTrigger value="single">{t.single}</TabsTrigger>
+              </TabsList>
+            </Tabs>
+          ) : null}
+          <PlanGroups option={option} plan={plan} itemLabel={itemLabel} />
+        </>
+      )}
+      {plan.unpriced.length ? (
+        <p className="text-sm">
+          <span className="font-medium">{t.unpriced}:</span>{" "}
+          <span className="text-muted-foreground">
+            {plan.unpriced.map((id) => itemLabel.get(id) ?? "—").join(", ")}
+          </span>
+          <span className="block text-xs text-muted-foreground">{t.unpricedHint}</span>
+        </p>
+      ) : null}
+      <ul className="flex flex-col gap-1 text-xs text-muted-foreground">
+        <li className="flex gap-1.5">
+          <Info className="mt-0.5 size-3 shrink-0" aria-hidden />
+          {t.threshold(formatMoney(plan.thresholdMinor))}
+        </li>
+        {plan.mealCardBalanceMinor > 0 ? (
+          <li className="flex gap-1.5">
+            <Utensils className="mt-0.5 size-3 shrink-0" aria-hidden />
+            {t.mealCardBalance(formatMoney(plan.mealCardBalanceMinor))}
+          </li>
+        ) : null}
+        {hasText ? (
+          <li className="flex gap-1.5">
+            <Info className="mt-0.5 size-3 shrink-0" aria-hidden />
+            {t.textItems}
+          </li>
+        ) : null}
+      </ul>
+    </section>
+  );
+}

src/features/shopping/components/report-view.tsx

@@ -0,0 +1,184 @@
+import { ArrowRight, Receipt } from "lucide-react";
+import Link from "next/link";
+import { Badge } from "@/components/ui/badge";
+import { tr } from "@/i18n/tr";
+import { cn } from "@/lib/utils";
+import { formatDate, formatMoney } from "@/shared/format";
+import { formatQuantity } from "@/shared/quantity";
+import type { CompletionRow, ShoppingCompletion } from "@/shared/shopping";
+import type { ComparisonReasons, ComparisonSummary, MatchKind } from "@/shared/shopping-compare";
+
+const t = tr.shopping.report;
+
+const MATCH_STYLE: Record<MatchKind, string> = {
+  same: "border-income/40 text-income",
+  substitute: "border-amber-500/50 text-amber-700 dark:text-amber-400",
+  skipped: "text-muted-foreground",
+  extra: "border-budget/40 text-budget",
+};
+
+/** İşaretli tutar: "+₺12,00" / "−₺5,00". Renk tek başına anlam taşımaz. */
+function Signed({ value, className }: { value: number; className?: string }) {
+  return (
+    <span
+      className={cn(
+        "tabular-nums",
+        value > 0 ? "text-expense" : value < 0 ? "text-income" : "text-muted-foreground",
+        className,
+      )}
+    >
+      {value > 0 ? "+" : value < 0 ? "−" : ""}
+      {formatMoney(Math.abs(value))}
+    </span>
+  );
+}
+
+function Cell({ label, sub, amount }: { label: string; sub: string; amount: number | null }) {
+  return (
+    <span className="flex min-w-0 flex-col">
+      <span className="truncate">{label || "—"}</span>
+      {sub ? <span className="truncate text-xs text-muted-foreground">{sub}</span> : null}
+      {amount !== null ? <span className="text-xs tabular-nums">{formatMoney(amount)}</span> : null}
+    </span>
+  );
+}
+
+const pkgs = (packages: number) => `${formatQuantity(packages)} ${tr.shopping.packageUnit}`;
+
+function Row({ row }: { row: CompletionRow }) {
+  return (
+    <li className="grid grid-cols-2 gap-x-3 gap-y-2 p-3 text-sm md:grid-cols-[minmax(0,1.2fr)_7rem_minmax(0,1.5fr)_minmax(0,1.5fr)] md:items-start">
+      <span className="font-medium">{row.label}</span>
+      <span className="justify-self-end md:justify-self-start">
+        <Badge variant="outline" className={MATCH_STYLE[row.match]}>
+          {t.matches[row.match]}
+        </Badge>
+      </span>
+      <span className="flex gap-1.5 md:block">
+        <span className="text-xs text-muted-foreground md:hidden">{t.plan}:</span>
+        {row.plan ? (
+          <Cell
+            label={row.plan.productLabel}
+            sub={`${row.plan.storeLabel} · ${pkgs(row.plan.packages)}`}
+            amount={row.plan.costMinor}
+          />
+        ) : (
+          <span className="text-muted-foreground">{t.noPlanCell}</span>
+        )}
+      </span>
+      <span className="flex gap-1.5 md:block">
+        <span className="text-xs text-muted-foreground md:hidden">{t.bought}:</span>
+        {row.amountMinor !== null ? (
+          <Cell
+            label={row.productLabel || row.label}
+            sub={[row.storeLabel, row.quantityLabel ?? (row.productId ? pkgs(row.packages) : "")]
+              .filter(Boolean)
+              .join(" · ")}
+            amount={row.amountMinor}
+          />
+        ) : (
+          <span className="text-muted-foreground">{t.noPlanCell}</span>
+        )}
+      </span>
+    </li>
+  );
+}
+
+/** Tamamlanan liste: planlanan vs. gerçek, farkın nedenleri, kalem bazında eşleşme, giderler. */
+export function ShoppingReport({
+  completion,
+  summary,
+}: {
+  completion: ShoppingCompletion;
+  summary: ComparisonSummary;
+}) {
+  const reasons = (Object.entries(summary.reasons) as [keyof ComparisonReasons, number][]).filter(
+    ([, v]) => v !== 0,
+  );
+  return (
+    <section aria-labelledby="report-h" className="flex flex-col gap-4">
+      <div>
+        <h2 id="report-h" className="font-medium">
+          {t.title}
+        </h2>
+        <p className="text-sm text-muted-foreground">
+          {t.description(formatDate(`${completion.date}T12:00:00+03:00`))}
+        </p>
+      </div>
+      <dl className="grid grid-cols-3 gap-3">
+        {[
+          { label: t.planned, node: formatMoney(summary.plannedMinor) },
+          { label: t.actual, node: formatMoney(summary.actualMinor) },
+          { label: t.diff, node: <Signed value={summary.diffMinor} /> },
+        ].map((x) => (
+          <div key={x.label} className="rounded-xl border bg-card p-3">
+            <dt className="text-xs text-muted-foreground">{x.label}</dt>
+            <dd className="text-lg font-semibold tabular-nums">{x.node}</dd>
+          </div>
+        ))}
+      </dl>
+      {reasons.length ? (
+        <div className="rounded-xl border bg-card p-3">
+          <h3 className="mb-2 text-sm font-medium">{t.reasonsTitle}</h3>
+          <ul className="flex flex-col gap-1 text-sm">
+            {reasons.map(([k, v]) => (
+              <li key={k} className="flex justify-between gap-3">
+                <span>{t.reasons[k]}</span>
+                <Signed value={v} />
+              </li>
+            ))}
+          </ul>
+        </div>
+      ) : null}
+
+      <div className="overflow-hidden rounded-xl border bg-card">
+        <div className="hidden grid-cols-[minmax(0,1.2fr)_7rem_minmax(0,1.5fr)_minmax(0,1.5fr)] gap-3 border-b px-3 py-2 text-xs text-muted-foreground md:grid">
+          <span>{t.item}</span>
+          <span />
+          <span>{t.plan}</span>
+          <span>{t.bought}</span>
+        </div>
+        <ul className="divide-y">
+          {completion.rows.map((r, i) => (
+            <Row key={r.itemId ?? `extra-${i}`} row={r} />
+          ))}
+        </ul>
+      </div>
+
+      <div className="flex flex-col gap-2">
+        <h3 className="text-sm font-medium">{t.expenses}</h3>
+        <ul className="grid gap-2 md:grid-cols-2">
+          {completion.stores.map((s) => (
+            <li
+              key={s.transactionId}
+              className="flex items-center gap-3 rounded-lg border bg-card p-3 text-sm"
+            >
+              <Receipt className="size-4 shrink-0 text-muted-foreground" aria-hidden />
+              <span className="min-w-0 flex-1">
+                <span className="block truncate font-medium">{s.label}</span>
+                <span className="block truncate text-xs text-muted-foreground">
+                  {t.expenseLine(s.accountName, s.attachmentCount)}
+                </span>
+              </span>
+              <Link
+                href={`/islemler?hesap=${s.accountId}`}
+                className="shrink-0 font-medium tabular-nums hover:underline"
+              >
+                {formatMoney(s.amountMinor)}
+              </Link>
+            </li>
+          ))}
+        </ul>
+      </div>
+      {completion.movedTo ? (
+        <Link
+          href={`/alisveris/${completion.movedTo.listId}`}
+          className="flex w-fit items-center gap-1 text-sm text-primary hover:underline"
+        >
+          {t.movedTo(completion.movedTo.name)}
+          <ArrowRight className="size-3.5" aria-hidden />
+        </Link>
+      ) : null}
+    </section>
+  );
+}

src/features/shopping/components/shopping-card.tsx

@@ -0,0 +1,59 @@
+import { ShoppingCart, Sparkles } from "lucide-react";
+import Link from "next/link";
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
+import { tr } from "@/i18n/tr";
+import { getActiveListsSummary } from "../service";
+
+const t = tr.shopping;
+const LIMIT = 3;
+
+/** Dashboard: aktif alışveriş listeleri ve bekleyen stok önerileri. Liste ve öneri yoksa gizli. */
+export async function ShoppingCard({
+  userId,
+  householdId,
+}: {
+  userId: string;
+  householdId: string;
+}) {
+  const data = await getActiveListsSummary(userId, householdId);
+  if (!data || (!data.lists.length && !data.suggestions)) return null;
+  return (
+    <Card size="sm">
+      <CardHeader>
+        <CardTitle className="flex items-center gap-2 text-base">
+          <ShoppingCart className="size-4 text-muted-foreground" aria-hidden />
+          {t.dashboard.title}
+        </CardTitle>
+        {data.suggestions ? (
+          <CardDescription className="flex items-center gap-1.5">
+            <Sparkles className="size-3.5 text-amber-600" aria-hidden />
+            {t.dashboard.suggestions(data.suggestions)}
+          </CardDescription>
+        ) : null}
+      </CardHeader>
+      <CardContent className="flex flex-col gap-3">
+        {data.lists.length ? (
+          <ul className="divide-y text-sm">
+            {data.lists.slice(0, LIMIT).map((l) => (
+              <li key={l.id} className="flex items-center justify-between gap-3 py-1.5">
+                <Link href={`/alisveris/${l.id}`} className="min-w-0 truncate hover:underline">
+                  {l.name}
+                </Link>
+                <span className="shrink-0 text-xs text-muted-foreground tabular-nums">
+                  {l.checkedCount
+                    ? t.checkedCount(l.checkedCount, l.itemCount)
+                    : t.itemCount(l.itemCount)}
+                </span>
+              </li>
+            ))}
+          </ul>
+        ) : (
+          <p className="text-sm text-muted-foreground">{t.dashboard.empty}</p>
+        )}
+        <Link href="/alisveris" className="text-sm text-primary hover:underline">
+          {t.dashboard.open}
+        </Link>
+      </CardContent>
+    </Card>
+  );
+}

src/features/shopping/components/shopping-mode.tsx

@@ -0,0 +1,257 @@
+"use client";
+
+import { ArrowLeft, Check, ClipboardCheck, Globe } from "lucide-react";
+import Link from "next/link";
+import { startTransition, useOptimistic } from "react";
+import { toast } from "sonner";
+import { Button } from "@/components/ui/button";
+import { StoreDot } from "@/features/prices/components/offers-list";
+import { useAutoRefresh } from "@/hooks/use-auto-refresh";
+import { tr } from "@/i18n/tr";
+import { cn } from "@/lib/utils";
+import { formatMoney } from "@/shared/format";
+import { formatQuantity } from "@/shared/quantity";
+import { SHOPPING_REFRESH_MS } from "@/shared/shopping";
+import type { PlanLine } from "@/shared/shopping-plan";
+import { setShoppingItemCheckedAction } from "../actions";
+import type { ShoppingItemView, ShoppingListDetail } from "../service";
+import { planHeadline, type PlanChoice } from "./plan-panel";
+
+const t = tr.shopping;
+const m = t.mode;
+
+type Group = {
+  key: string;
+  title: string;
+  slot: number | null;
+  online: boolean;
+  hint?: string;
+  rows: { item: ShoppingItemView; line: PlanLine | null }[];
+};
+
+function Row({
+  item,
+  line,
+  product,
+  canWrite,
+  onToggle,
+}: {
+  item: ShoppingItemView;
+  line: PlanLine | null;
+  product: { label: string; packageLabel: string } | undefined;
+  canWrite: boolean;
+  onToggle: () => void;
+}) {
+  const sub = [
+    line
+      ? line.packages > 1
+        ? t.plan.line(formatQuantity(line.packages * 1000), formatMoney(line.priceMinor))
+        : formatMoney(line.priceMinor)
+      : null,
+    line && product && item.kind === "type" ? `${product.label} · ${product.packageLabel}` : null,
+    item.note || null,
+  ].filter(Boolean);
+  return (
+    <li>
+      <button
+        type="button"
+        role="checkbox"
+        aria-checked={item.checked}
+        aria-label={m.check(item.label)}
+        disabled={!canWrite}
+        onClick={onToggle}
+        className={cn(
+          "flex min-h-16 w-full items-center gap-4 px-4 py-3 text-left transition-colors hover:bg-accent/40 focus-visible:bg-accent/40 focus-visible:outline-none disabled:cursor-default",
+          item.checked && "bg-muted/40",
+        )}
+      >
+        <span
+          aria-hidden
+          className={cn(
+            "flex size-7 shrink-0 items-center justify-center rounded-md border-2",
+            item.checked ? "border-income bg-income text-white" : "border-muted-foreground/40",
+          )}
+        >
+          {item.checked ? <Check className="size-4.5" strokeWidth={3} /> : null}
+        </span>
+        <span className="min-w-0 flex-1">
+          <span
+            className={cn(
+              "block text-base font-medium",
+              item.checked && "text-muted-foreground line-through",
+            )}
+          >
+            {item.label}
+          </span>
+          {sub.length ? (
+            <span className="line-clamp-2 text-sm text-muted-foreground">{sub.join(" · ")}</span>
+          ) : null}
+        </span>
+        <span className="shrink-0 text-base tabular-nums">{item.quantityLabel}</span>
+      </button>
+    </li>
+  );
+}
+
+/** /alisveris/:id/mod — mağazaya göre gruplanmış, büyük dokunma alanlı kontrol listesi. */
+export function ShoppingModeView({
+  data,
+  choice,
+}: {
+  data: ShoppingListDetail;
+  choice: PlanChoice;
+}) {
+  useAutoRefresh(SHOPPING_REFRESH_MS);
+  const { list, plan, canWrite } = data;
+  const [items, setOptimistic] = useOptimistic(
+    data.items,
+    (state, change: { id: string; checked: boolean }) =>
+      state.map((i) => (i.id === change.id ? { ...i, checked: change.checked } : i)),
+  );
+  const option = (choice === "single" ? plan.single : null) ?? plan.recommended;
+  const byId = new Map(items.map((i) => [i.id, i]));
+
+  const groups: Group[] = [];
+  const placed = new Set<string>();
+  for (const g of option?.stores ?? []) {
+    const store = plan.stores[g.storeId];
+    const rows = g.lines.flatMap((line) => {
+      const item = byId.get(line.itemId);
+      if (!item) return [];
+      placed.add(item.id);
+      return [{ item, line }];
+    });
+    groups.push({
+      key: g.storeId,
+      title: store?.label ?? "—",
+      slot: store?.slot ?? null,
+      online: store?.kind === "online",
+      rows,
+    });
+  }
+  const rest = items.filter((i) => !placed.has(i.id));
+  if (rest.length)
+    groups.push({
+      key: "other",
+      title: m.other,
+      slot: null,
+      online: false,
+      hint: m.otherHint,
+      rows: rest.map((item) => ({ item, line: null })),
+    });
+
+  const done = items.filter((i) => i.checked).length;
+  const pct = items.length ? Math.round((done / items.length) * 100) : 0;
+
+  function toggle(item: ShoppingItemView) {
+    const checked = !item.checked;
+    startTransition(async () => {
+      setOptimistic({ id: item.id, checked });
+      const r = await setShoppingItemCheckedAction(list.id, item.id, checked);
+      if (!r.ok) toast.error(r.error);
+    });
+  }
+
+  const headline = planHeadline(plan);
+  const differs =
+    plan.single &&
+    plan.single.stores.map((s) => s.storeId).join() !==
+      plan.recommended?.stores.map((s) => s.storeId).join();
+
+  return (
+    <div className="mx-auto flex w-full max-w-2xl flex-col gap-4">
+      <Button variant="ghost" size="sm" asChild className="-ml-2 w-fit">
+        <Link href={`/alisveris/${list.id}`}>
+          <ArrowLeft />
+          {t.actions.backToList}
+        </Link>
+      </Button>
+      <div className="flex flex-col gap-2">
+        <h1 className="text-xl font-semibold">
+          {m.title}: {list.name}
+        </h1>
+        {headline ? <p className="text-sm text-muted-foreground">{headline}</p> : null}
+        {differs ? (
+          <nav aria-label={m.planChoice} className="flex gap-2">
+            {(["recommended", "single"] as const).map((c) => (
+              <Button
+                key={c}
+                size="sm"
+                variant={c === choice ? "secondary" : "ghost"}
+                asChild
+                aria-current={c === choice ? "page" : undefined}
+              >
+                <Link href={c === "single" ? "?plan=single" : "?"} replace scroll={false}>
+                  {c === "single" ? t.plan.single : t.plan.recommended}
+                </Link>
+              </Button>
+            ))}
+          </nav>
+        ) : null}
+      </div>
+
+      <div className="sticky top-14 z-10 -mx-4 bg-background/95 px-4 py-2 backdrop-blur">
+        <div className="flex items-center justify-between text-sm">
+          <span className="font-medium tabular-nums">{m.progress(done, items.length)}</span>
+          {done === items.length && items.length ? (
+            <span className="text-income">{m.allDone}</span>
+          ) : null}
+        </div>
+        <div
+          className="mt-1.5 h-2 overflow-hidden rounded-full bg-muted"
+          role="progressbar"
+          aria-valuemin={0}
+          aria-valuemax={items.length}
+          aria-valuenow={done}
+          aria-label={m.progress(done, items.length)}
+        >
+          <div
+            className="h-full rounded-full bg-income transition-all"
+            style={{ width: `${pct}%` }}
+          />
+        </div>
+      </div>
+
+      {groups.map((g) => {
+        const groupDone = g.rows.filter((r) => r.item.checked).length;
+        return (
+          <section key={g.key} className="overflow-hidden rounded-xl border bg-card">
+            <header className="flex items-center gap-2 border-b bg-muted/40 px-4 py-2.5">
+              <h2 className="flex min-w-0 items-center font-medium">
+                {g.slot ? <StoreDot slot={g.slot} /> : null}
+                <span className="truncate">{g.title}</span>
+                {g.online ? (
+                  <Globe className="ml-1.5 size-3.5 text-muted-foreground" aria-hidden />
+                ) : null}
+              </h2>
+              <span className="ml-auto text-sm text-muted-foreground tabular-nums">
+                {groupDone}/{g.rows.length}
+              </span>
+            </header>
+            {g.hint ? <p className="px-4 pt-2 text-xs text-muted-foreground">{g.hint}</p> : null}
+            <ul className="divide-y">
+              {g.rows.map(({ item, line }) => (
+                <Row
+                  key={item.id}
+                  item={item}
+                  line={line}
+                  product={line ? plan.products[line.productId] : undefined}
+                  canWrite={canWrite}
+                  onToggle={() => toggle(item)}
+                />
+              ))}
+            </ul>
+          </section>
+        );
+      })}
+      {canWrite && done > 0 ? (
+        <Button asChild size="lg" className="w-full">
+          <Link href={`/alisveris/${list.id}/tamamla`}>
+            <ClipboardCheck />
+            {t.complete.action}
+          </Link>
+        </Button>
+      ) : null}
+    </div>
+  );
+}

src/features/shopping/service.int.test.ts

@@ -0,0 +1,202 @@
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { AuditLogModel } from "@/models/audit-log";
+import { ProductModel } from "@/models/product";
+import { ProductTypeModel } from "@/models/product-type";
+import { ShoppingListModel } from "@/models/shopping-list";
+import { shoppingItemFormSchema, shoppingItemUpdateSchema } from "@/shared/schemas/shopping";
+import { setupSeededDb, teardownDb } from "@/test/seeded-db";
+import {
+  addShoppingItem,
+  approveSuggestions,
+  createShoppingList,
+  deleteShoppingList,
+  dismissSuggestion,
+  getShoppingList,
+  listShoppingLists,
+  moveShoppingItem,
+  removeShoppingItem,
+  setShoppingItemChecked,
+  updateShoppingItem,
+} from "./service";
+
+let ids: Awaited<ReturnType<typeof setupSeededDb>>;
+let cakir = "";
+let ayse = "";
+let zeynep = "";
+let fatma = "";
+let weekly = "";
+let monthEnd = "";
+
+const typeId = (seedRef: string) =>
+  ProductTypeModel.findOne({ seedRef })
+    .lean()
+    .then((x) => String(x!._id));
+const productId = (seedRef: string) =>
+  ProductModel.findOne({ seedRef })
+    .lean()
+    .then((x) => String(x!._id));
+const item = (input: Record<string, unknown>) => shoppingItemFormSchema.parse(input);
+
+beforeAll(async () => {
+  ids = await setupSeededDb();
+  cakir = ids.household("Çakır Ailesi");
+  ayse = ids.user("ayse");
+  zeynep = ids.user("zeynep");
+  fatma = ids.user("fatma");
+  weekly = String((await ShoppingListModel.findOne({ seedRef: "haftalik" }).lean())!._id);
+  monthEnd = String((await ShoppingListModel.findOne({ seedRef: "ay-sonu" }).lean())!._id);
+});
+afterAll(teardownDb);
+
+describe("liste okuma ve akıllı öneri", () => {
+  it("aktif listeler, bekleyen öneri sayısı; başka hane göremez", async () => {
+    const data = (await listShoppingLists(ayse, cakir))!;
+    expect(data.active.map((l) => l.name).sort()).toEqual(["Ay sonu toptan", "Haftalık market"]);
+    expect(data.suggestions).toBeGreaterThanOrEqual(3);
+    expect(data.canWrite).toBe(true);
+    expect(await listShoppingLists(fatma, cakir)).toBeNull();
+    expect(await getShoppingList(fatma, cakir, weekly)).toBeNull();
+  });
+
+  it("kalem görünümleri, eşik önerileri ve plan", async () => {
+    const d = (await getShoppingList(ayse, cakir, weekly))!;
+    expect(d.items).toHaveLength(9);
+    const milk = d.items.find((i) => i.label === "Süt")!;
+    expect(milk).toMatchObject({ kind: "type", unit: "lt", quantityLabel: "4 lt" });
+    expect(milk.stock).not.toBeNull();
+    const yumos = d.items.find((i) => i.kind === "product")!;
+    expect(yumos.quantityLabel).toBe("1 paket");
+    const candle = d.items.find((i) => i.kind === "text")!;
+    expect(candle).toMatchObject({ label: "Doğum günü mumu", note: "Rakam mum: 7" });
+
+    // Eşiğin altındaki mercimek listede yok: öneri olarak gelir.
+    expect(d.suggestions.map((s) => s.name)).toContain("Kırmızı Mercimek");
+    expect(d.suggestions.every((s) => s.suggestedQuantity >= 0)).toBe(true);
+
+    // Plan: domatesin fiyatı yok; serbest metin plana katılmaz; diğerleri karşılanır.
+    const tomato = d.items.find((i) => i.label === "Domates")!;
+    expect(d.plan.unpriced).toEqual([tomato.id]);
+    const rec = d.plan.recommended!;
+    expect(rec.missing).toEqual([]);
+    const planned = rec.stores.flatMap((g) => g.lines.map((l) => l.itemId));
+    expect(planned).toHaveLength(7);
+    expect(planned).not.toContain(candle.id);
+    for (const g of rec.stores) {
+      expect(d.plan.stores[g.storeId]).toBeDefined();
+      for (const l of g.lines) expect(d.plan.products[l.productId]).toBeDefined();
+    }
+    // Belirli marka kalemi yalnızca o ürünle planlanır.
+    const yumosLine = rec.stores.flatMap((g) => g.lines).find((l) => l.itemId === yumos.id)!;
+    expect(yumosLine.productId).toBe(yumos.productId);
+    expect(d.plan.single).not.toBeNull();
+    expect(d.plan.thresholdMinor).toBe(10_000);
+    // Ayşe'nin yemek kartı bakiyesi plana girer (seed: Multinet).
+    expect(d.plan.mealCardBalanceMinor).toBeGreaterThan(0);
+    expect(d.options.types.length).toBeGreaterThan(10);
+    expect(d.otherLists.map((o) => o.name)).toEqual(["Ay sonu toptan"]);
+  });
+});
+
+describe("kalem işlemleri", () => {
+  it("ekle (çift kayıt reddi, izleyici yazamaz), düzenle, işaretle, taşı, çıkar", async () => {
+    const milk = await typeId("sut");
+    expect(shoppingItemFormSchema.safeParse({ kind: "type", productTypeId: "" }).success).toBe(
+      false,
+    );
+    expect(shoppingItemFormSchema.safeParse({ kind: "text", text: "" }).success).toBe(false);
+    expect(
+      (await addShoppingItem(ayse, cakir, weekly, item({ kind: "type", productTypeId: milk }))).ok,
+    ).toBe(false);
+    const text = item({ kind: "text", text: "Pil", quantity: "4", unit: "adet" });
+    expect((await addShoppingItem(zeynep, cakir, weekly, text)).ok).toBe(false);
+
+    const added = await addShoppingItem(ayse, cakir, weekly, text);
+    expect(added.ok).toBe(true);
+    const id = added.ok ? added.data.id : "";
+    const brand = await addShoppingItem(
+      ayse,
+      cakir,
+      weekly,
+      item({ kind: "product", productId: await productId("ariel-5kg"), quantity: "2" }),
+    );
+    expect(brand.ok).toBe(true);
+
+    expect(
+      (
+        await updateShoppingItem(
+          ayse,
+          cakir,
+          weekly,
+          id,
+          shoppingItemUpdateSchema.parse({ quantity: "6", text: "AA pil", unit: "adet" }),
+        )
+      ).ok,
+    ).toBe(true);
+    let d = (await getShoppingList(ayse, cakir, weekly))!;
+    expect(d.items.find((i) => i.id === id)).toMatchObject({
+      label: "AA pil",
+      quantityLabel: "6 adet",
+    });
+    const ariel = d.items.find((i) => i.label.startsWith("Ariel"))!;
+    expect(ariel.quantityLabel).toBe("2 paket");
+
+    expect((await setShoppingItemChecked(ayse, cakir, weekly, id, true)).ok).toBe(true);
+    d = (await getShoppingList(ayse, cakir, weekly))!;
+    // Sepete alınanlar sona.
+    expect(d.items.at(-1)).toMatchObject({ id, checked: true });
+    expect(d.list.checkedCount).toBe(1);
+
+    expect((await moveShoppingItem(ayse, cakir, weekly, id, weekly)).ok).toBe(false);
+    expect((await moveShoppingItem(ayse, cakir, weekly, id, monthEnd)).ok).toBe(true);
+    const target = (await getShoppingList(ayse, cakir, monthEnd))!;
+    expect(target.items.find((i) => i.id === id)).toMatchObject({ checked: false });
+
+    expect((await removeShoppingItem(ayse, cakir, monthEnd, id)).ok).toBe(true);
+    expect((await removeShoppingItem(ayse, cakir, monthEnd, id)).ok).toBe(false);
+    expect((await removeShoppingItem(ayse, cakir, weekly, ariel.id)).ok).toBe(true);
+  });
+});
+
+describe("eşik önerileri", () => {
+  it("onayla: önerilen miktarla eklenir, öneriden düşer; tekrar onay reddedilir", async () => {
+    const lentil = await typeId("kirmizi-mercimek");
+    const r = await approveSuggestions(ayse, cakir, weekly, [lentil]);
+    expect(r).toMatchObject({ ok: true, data: { added: 1 } });
+    const d = (await getShoppingList(ayse, cakir, weekly))!;
+    const row = d.items.find((i) => i.productTypeId === lentil)!;
+    expect(row.source).toBe("suggestion");
+    expect(row.quantity).toBeGreaterThan(0);
+    expect(d.suggestions.some((s) => s.productTypeId === lentil)).toBe(false);
+    expect((await approveSuggestions(ayse, cakir, weekly, [lentil])).ok).toBe(false);
+    // Başka aktif listede de öneri olarak görünmez.
+    const other = (await getShoppingList(ayse, cakir, monthEnd))!;
+    expect(other.suggestions.some((s) => s.productTypeId === lentil)).toBe(false);
+    await removeShoppingItem(ayse, cakir, weekly, row.id);
+  });
+
+  it("reddet: stok yenilenene kadar gizli; izleyici reddedemez", async () => {
+    const tablet = await typeId("tablet-deterjan");
+    expect((await dismissSuggestion(zeynep, cakir, tablet)).ok).toBe(false);
+    expect((await dismissSuggestion(ayse, cakir, tablet)).ok).toBe(true);
+    const d = (await getShoppingList(ayse, cakir, weekly))!;
+    expect(d.suggestions.some((s) => s.productTypeId === tablet)).toBe(false);
+    await ProductTypeModel.updateOne(
+      { seedRef: "tablet-deterjan" },
+      { $set: { suggestionDismissedAt: null } },
+    );
+  });
+});
+
+describe("liste yönetimi", () => {
+  it("oluştur ve sil (soft delete + denetim)", async () => {
+    const r = await createShoppingList(ayse, cakir, { name: "Deneme", note: "" });
+    expect(r.ok).toBe(true);
+    const id = r.ok ? r.data.id : "";
+    expect((await deleteShoppingList(zeynep, cakir, id)).ok).toBe(false);
+    expect((await deleteShoppingList(ayse, cakir, id)).ok).toBe(true);
+    expect(await getShoppingList(ayse, cakir, id)).toBeNull();
+    expect(
+      await AuditLogModel.exists({ action: "shoppingList.delete", targetId: id }),
+    ).toBeTruthy();
+  });
+});

src/features/shopping/service.ts

@@ -0,0 +1,898 @@
+import "server-only";
+import { Types } from "mongoose";
+import { listAccounts } from "@/features/accounts/service";
+import { hasHouseholdRole } from "@/features/households/roles";
+import { resolveMembership, type Membership } from "@/features/households/service";
+import { loadTypeOffers } from "@/features/prices/service";
+import { listProducts, type ProductView } from "@/features/products/service";
+import { getStock, type ProductTypeView } from "@/features/stock/service";
+import { storeLabel } from "@/features/stores/service";
+import { tr } from "@/i18n/tr";
+import { fail, ok, type ActionResult } from "@/lib/action-result";
+import { writeAudit } from "@/lib/audit";
+import { toObjectId } from "@/lib/object-id";
+import { HouseholdModel } from "@/models/household";
+import { ProductModel } from "@/models/product";
+import { ProductTypeModel } from "@/models/product-type";
+import { ShoppingListModel } from "@/models/shopping-list";
+import { StockMovementModel } from "@/models/stock-movement";
+import { StoreModel } from "@/models/store";
+import { seriesSlot } from "@/shared/prices";
+import { formatQuantity, QUANTITY_SCALE } from "@/shared/quantity";
+import type {
+  ShoppingItemForm,
+  ShoppingItemUpdate,
+  ShoppingListForm,
+} from "@/shared/schemas/shopping";
+import {
+  requiredQuantity,
+  suggestionHidden,
+  type ShoppingItemKind,
+  type ShoppingItemSource,
+  type ShoppingCompletion,
+  type ShoppingListStatus,
+} from "@/shared/shopping";
+import { compareShopping, type ComparisonSummary } from "@/shared/shopping-compare";
+import { planShopping, type PlanResult } from "@/shared/shopping-plan";
+import { compareTr } from "@/shared/search";
+import { formatStock, type PurchaseSuggestion } from "@/shared/stock";
+import type { StoreKind } from "@/shared/stores";
+
+/**
+ * Alışveriş listeleri (Bölüm 6.12). Hane içinde ortak; okuma viewer, yazma member.
+ * Stok eşiğinin altındaki ürün tipleri aktif listelere onayla/reddet önerisi olarak gelir.
+ * Akıllı mağaza önerisi saf motorla (shared/shopping-plan) okuma sırasında hesaplanır.
+ */
+
+const t = tr.shopping;
+
+export type ItemLean = {
+  _id: Types.ObjectId;
+  kind: ShoppingItemKind;
+  productTypeId: Types.ObjectId | null;
+  productId: Types.ObjectId | null;
+  text: string;
+  quantity: number | null;
+  unit: string;
+  note: string;
+  source: ShoppingItemSource;
+  checked: boolean;
+  checkedAt: Date | null;
+  addedAt: Date;
+};
+
+export type ListLean = {
+  _id: Types.ObjectId;
+  name: string;
+  status: ShoppingListStatus;
+  note: string;
+  items: ItemLean[];
+  completedAt: Date | null;
+  completion: ShoppingCompletion | null;
+  createdAt: Date;
+  updatedAt: Date;
+};
+
+export type ShoppingListSummary = {
+  id: string;
+  name: string;
+  status: ShoppingListStatus;
+  note: string;
+  itemCount: number;
+  checkedCount: number;
+  /** İlk birkaç kalemin adı (kart önizlemesi). */
+  preview: string[];
+  updatedAt: string;
+  completedAt: string | null;
+};
+
+export type ShoppingItemView = {
+  id: string;
+  kind: ShoppingItemKind;
+  productTypeId: string | null;
+  productId: string | null;
+  text: string;
+  label: string;
+  /** Ürün: paket ve ürün tipi; ürün tipi: kategori yolu. */
+  detail: string;
+  quantity: number | null;
+  /** Ürün tipinde tipin birimi, üründe "paket", serbest metinde girilen birim. */
+  unit: string;
+  /** "2 kg", "3 paket"; boş miktarda ürün tipinde "" (en az 1 paket). */
+  quantityLabel: string;
+  note: string;
+  source: ShoppingItemSource;
+  checked: boolean;
+  /** Ürün tipi/ürün arşivlendi. */
+  archived: boolean;
+  /** Ürün tipi kaleminde evdeki stok. */
+  stock: { current: string; target: string; low: boolean } | null;
+};
+
+export type SuggestionView = {
+  productTypeId: string;
+  name: string;
+  categoryPath: string;
+  unit: string;
+  current: number;
+  target: number;
+  pct: number | null;
+  suggestedQuantity: number;
+  suggestion: PurchaseSuggestion;
+};
+
+export type PlanStoreRef = {
+  id: string;
+  label: string;
+  kind: StoreKind;
+  slot: number;
+  mealCard: boolean;
+};
+
+export type ShoppingPlanView = PlanResult & {
+  stores: Record<string, PlanStoreRef>;
+  products: Record<string, { label: string; packageLabel: string; typeUnit: string }>;
+  thresholdMinor: number;
+  /** Bu kullanıcının görebildiği yemek kartı bakiyelerinin toplamı. */
+  mealCardBalanceMinor: number;
+};
+
+export type ItemOptions = {
+  types: { id: string; name: string; unit: string; path: string }[];
+  products: {
+    id: string;
+    label: string;
+    packageLabel: string;
+    productTypeId: string;
+    typeName: string;
+  }[];
+};
+
+export type ShoppingListDetail = {
+  list: ShoppingListSummary;
+  items: ShoppingItemView[];
+  suggestions: SuggestionView[];
+  plan: ShoppingPlanView;
+  options: ItemOptions;
+  /** Kalem taşımak için diğer aktif listeler. */
+  otherLists: { id: string; name: string }[];
+  canWrite: boolean;
+  /** Tamamlanmış listede karşılaştırma raporu. */
+  report: { completion: ShoppingCompletion; summary: ComparisonSummary } | null;
+};
+
+// --- Yardımcılar ---
+
+const iso = (d: Date | null) => (d ? d.toISOString() : null);
+
+function summary(l: ListLean, labels: Map<string, string>): ShoppingListSummary {
+  return {
+    id: String(l._id),
+    name: l.name,
+    status: l.status,
+    note: l.note,
+    itemCount: l.items.length,
+    checkedCount: l.items.filter((i) => i.checked).length,
+    preview: l.items.slice(0, 4).map((i) => itemName(i, labels)),
+    updatedAt: l.updatedAt.toISOString(),
+    completedAt: iso(l.completedAt),
+  };
+}
+
+const refKey = (i: Pick<ItemLean, "kind" | "productTypeId" | "productId">) =>
+  i.kind === "type" ? `t:${i.productTypeId}` : i.kind === "product" ? `p:${i.productId}` : null;
+
+function itemName(i: ItemLean, labels: Map<string, string>) {
+  const key = refKey(i);
+  return key ? (labels.get(key) ?? "—") : i.text;
+}
+
+/** Kalemlerin ürün tipi ve ürün adları (arşivliler dahil). */
+async function loadLabels(householdId: Types.ObjectId, lists: ListLean[]) {
+  const typeIds = new Set<string>();
+  const productIds = new Set<string>();
+  for (const l of lists)
+    for (const i of l.items) {
+      if (i.productTypeId) typeIds.add(String(i.productTypeId));
+      if (i.productId) productIds.add(String(i.productId));
+    }
+  const [types, products] = await Promise.all([
+    ProductTypeModel.find({
+      householdId,
+      _id: { $in: [...typeIds].map((x) => new Types.ObjectId(x)) },
+    })
+      .select({ name: 1 })
+      .lean<{ _id: Types.ObjectId; name: string }[]>(),
+    ProductModel.find({
+      householdId,
+      _id: { $in: [...productIds].map((x) => new Types.ObjectId(x)) },
+    })
+      .select({ brand: 1, name: 1 })
+      .lean<{ _id: Types.ObjectId; brand: string; name: string }[]>(),
+  ]);
+  const labels = new Map<string, string>();
+  for (const x of types) labels.set(`t:${x._id}`, x.name);
+  for (const x of products) labels.set(`p:${x._id}`, x.name ? `${x.brand} ${x.name}` : x.brand);
+  return labels;
+}
+
+async function loadList(m: Membership, listId: string) {
+  const id = toObjectId(listId);
+  if (!id) return null;
+  return ShoppingListModel.findOne({
+    _id: id,
+    householdId: m.householdId,
+    deletedAt: null,
+  }).lean<ListLean>();
+}
+
+/** Ürün tipi başına son alım hareketinin giriş zamanı (öneri reddi için). */
+async function lastPurchaseAt(householdId: Types.ObjectId, typeIds: Types.ObjectId[]) {
+  if (!typeIds.length) return new Map<string, Date>();
+  const rows = await StockMovementModel.aggregate<{ _id: Types.ObjectId; at: Date }>([
+    {
+      $match: {
+        householdId,
+        productTypeId: { $in: typeIds },
+        kind: "purchase",
+        deletedAt: null,
+      },
+    },
+    { $group: { _id: "$productTypeId", at: { $max: "$createdAt" } } },
+  ]);
+  return new Map(rows.map((r) => [String(r._id), r.at]));
+}
+
+/**
+ * Bekleyen eşik önerileri: eşiğin altındaki ürün tipleri; hiçbir aktif listede (alınmamış kalem
+ * olarak, tip ya da o tipin ürünü) yoksa ve reddedilmemişse.
+ */
+async function pendingSuggestions(
+  m: Membership,
+  low: ProductTypeView[],
+): Promise<SuggestionView[]> {
+  if (!low.length) return [];
+  const lowIds = low.map((x) => new Types.ObjectId(x.id));
+  const [active, dismissed, purchases] = await Promise.all([
+    ShoppingListModel.find({ householdId: m.householdId, deletedAt: null, status: "active" })
+      .select({ items: 1 })
+      .lean<{ items: ItemLean[] }[]>(),
+    ProductTypeModel.find({ householdId: m.householdId, _id: { $in: lowIds } })
+      .select({ suggestionDismissedAt: 1 })
+      .lean<{ _id: Types.ObjectId; suggestionDismissedAt: Date | null }[]>(),
+    lastPurchaseAt(m.householdId, lowIds),
+  ]);
+  const listed = new Set<string>();
+  const productIds: Types.ObjectId[] = [];
+  for (const l of active)
+    for (const i of l.items) {
+      if (i.checked) continue;
+      if (i.productTypeId) listed.add(String(i.productTypeId));
+      if (i.productId) productIds.push(i.productId);
+    }
+  if (productIds.length) {
+    const rows = await ProductModel.find({ householdId: m.householdId, _id: { $in: productIds } })
+      .select({ productTypeId: 1 })
+      .lean<{ productTypeId: Types.ObjectId }[]>();
+    for (const r of rows) listed.add(String(r.productTypeId));
+  }
+  const dismissedAt = new Map(dismissed.map((d) => [String(d._id), d.suggestionDismissedAt]));
+  return low
+    .filter(
+      (x) =>
+        !listed.has(x.id) &&
+        !suggestionHidden(dismissedAt.get(x.id) ?? null, purchases.get(x.id) ?? null),
+    )
+    .map((x) => ({
+      productTypeId: x.id,
+      name: x.name,
+      categoryPath: x.categoryPath,
+      unit: x.unit,
+      current: x.current,
+      target: x.targetQuantity,
+      pct: x.level.pct,
+      suggestedQuantity: x.suggestedQuantity,
+      suggestion: x.suggestion,
+    }));
+}
+
+/** Eşik önerileri (dashboard ve stok sayfası özetleri için). */
+export async function getPendingSuggestions(
+  userId: string,
+  householdId: string,
+): Promise<SuggestionView[] | null> {
+  const m = await resolveMembership(userId, householdId, "viewer");
+  if (!m) return null;
+  const stock = await getStock(userId, householdId);
+  return stock ? pendingSuggestions(m, stock.suggestions) : null;
+}
+
+// --- Okuma ---
+
+export async function listShoppingLists(
+  userId: string,
+  householdId: string,
+): Promise<{
+  active: ShoppingListSummary[];
+  completed: ShoppingListSummary[];
+  suggestions: number;
+  canWrite: boolean;
+} | null> {
+  const m = await resolveMembership(userId, householdId, "viewer");
+  if (!m) return null;
+  const [lists, suggestions] = await Promise.all([
+    ShoppingListModel.find({ householdId: m.householdId, deletedAt: null })
+      .sort({ updatedAt: -1 })
+      .lean<ListLean[]>(),
+    getPendingSuggestions(userId, householdId),
+  ]);
+  const labels = await loadLabels(m.householdId, lists);
+  return {
+    active: lists.filter((l) => l.status === "active").map((l) => summary(l, labels)),
+    completed: lists
+      .filter((l) => l.status === "completed")
+      .slice(0, 20)
+      .map((l) => summary(l, labels)),
+    suggestions: suggestions?.length ?? 0,
+    canWrite: hasHouseholdRole(m.role, "member"),
+  };
+}
+
+/** Dashboard: aktif listelerin özeti. */
+export async function getActiveListsSummary(userId: string, householdId: string) {
+  const data = await listShoppingLists(userId, householdId);
+  if (!data) return null;
+  return { lists: data.active, suggestions: data.suggestions };
+}
+
+function itemView(
+  i: ItemLean,
+  types: Map<string, ProductTypeView>,
+  products: Map<string, ProductView>,
+  archivedTypes: Map<string, { name: string; unit: string }>,
+): ShoppingItemView {
+  const base = {
+    id: String(i._id),
+    kind: i.kind,
+    productTypeId: i.productTypeId ? String(i.productTypeId) : null,
+    productId: i.productId ? String(i.productId) : null,
+    text: i.text,
+    quantity: i.quantity,
+    note: i.note,
+    source: i.source,
+    checked: i.checked,
+  };
+  if (i.kind === "type") {
+    const ty = types.get(String(i.productTypeId));
+    const fallback = archivedTypes.get(String(i.productTypeId));
+    const unit = ty?.unit ?? fallback?.unit ?? "";
+    return {
+      ...base,
+      label: ty?.name ?? fallback?.name ?? "—",
+      detail: ty?.categoryPath ?? "",
+      unit,
+      quantityLabel: i.quantity === null ? "" : formatStock(i.quantity, unit),
+      archived: !ty,
+      stock: ty
+        ? {
+            current: formatStock(Math.max(0, ty.current), ty.unit),
+            target: formatStock(ty.targetQuantity, ty.unit),
+            low: ty.level.low,
+          }
+        : null,
+    };
+  }
+  if (i.kind === "product") {
+    const p = products.get(String(i.productId));
+    const packages = i.quantity ?? QUANTITY_SCALE;
+    return {
+      ...base,
+      label: p?.label ?? "—",
+      detail: p ? `${p.packageLabel} · ${p.productTypeName}` : "",
+      unit: t.packageUnit,
+      quantityLabel: `${formatQuantity(packages)} ${t.packageUnit}`,
+      archived: !p || p.archived,
+      stock: null,
+    };
+  }
+  return {
+    ...base,
+    label: i.text,
+    detail: "",
+    unit: i.unit,
+    quantityLabel: i.quantity === null ? "" : formatQuantity(i.quantity, i.unit || undefined),
+    archived: false,
+    stock: null,
+  };
+}
+
+export async function buildPlan(
+  userId: string,
+  m: Membership,
+  items: ItemLean[],
+  products: Map<string, ProductView>,
+  types: Map<string, ProductTypeView>,
+): Promise<ShoppingPlanView> {
+  const planItems = items
+    .filter((i) => i.kind !== "text")
+    .map((i) => {
+      const p = i.productId ? products.get(String(i.productId)) : undefined;
+      const typeId = i.kind === "product" ? (p?.productTypeId ?? "") : String(i.productTypeId);
+      return {
+        id: String(i._id),
+        productTypeId: typeId,
+        quantity: requiredQuantity(i, p?.inTypeUnit ?? null),
+        productId: i.kind === "product" ? String(i.productId) : null,
+        bulky: types.get(typeId)?.bulky ?? false,
+      };
+    })
+    .filter((i) => i.productTypeId);
+  const typeIds = [...new Set(planItems.map((i) => i.productTypeId))].map(
+    (x) => new Types.ObjectId(x),
+  );
+  const [offers, stores, household, accounts] = await Promise.all([
+    loadTypeOffers(m.householdId, typeIds, { activeOnly: true }),
+    StoreModel.find({ householdId: m.householdId }).sort({ createdAt: 1, _id: 1 }).lean<
+      {
+        _id: Types.ObjectId;
+        name: string;
+        branch: string;
+        kind: StoreKind;
+        distanceM: number | null;
+        carryDifficulty: number;
+        deliveryFeeMinor: number | null;
+        freeDeliveryMinMinor: number | null;
+        mealCardAccepted: boolean;
+        mealCardProviders: string[];
+        archivedAt: Date | null;
+      }[]
+    >(),
+    HouseholdModel.findById(m.householdId).select({ settings: 1 }).lean(),
+    listAccounts(userId, String(m.householdId)),
+  ]);
+  const mealCards = (accounts?.accounts ?? [])
+    .filter(
+      (a) =>
+        a.type === "meal_card" &&
+        !a.archived &&
+        a.mealCardProvider &&
+        a.balanceMinor !== null &&
+        a.balanceMinor > 0,
+    )
+    .map((a) => ({ provider: a.mealCardProvider!, balanceMinor: a.balanceMinor! }));
+  const active = stores.filter((s) => !s.archivedAt);
+  const threshold = household?.settings?.extraStoreSavingThresholdMinor ?? 10_000;
+  const result = planShopping({
+    items: planItems,
+    offers,
+    stores: active.map((s) => ({
+      id: String(s._id),
+      kind: s.kind,
+      distanceM: s.distanceM,
+      carryDifficulty: s.carryDifficulty,
+      deliveryFeeMinor: s.deliveryFeeMinor,
+      freeDeliveryMinMinor: s.freeDeliveryMinMinor,
+      mealCardProviders: s.mealCardAccepted ? s.mealCardProviders : [],
+    })),
+    mealCards,
+    extraStoreThresholdMinor: threshold,
+  });
+  // Planda geçen ürünlerin etiketleri (listede olmayan muadil markalar dahil).
+  const used = new Set<string>();
+  for (const o of [result.single, result.recommended])
+    for (const g of o?.stores ?? []) for (const l of g.lines) used.add(l.productId);
+  for (const l of Object.values(result.cheapest)) used.add(l.productId);
+  const missing = [...used].filter((id) => !products.has(id));
+  if (missing.length) {
+    const extra = await listProducts(userId, String(m.householdId), { includeArchived: true });
+    for (const p of extra?.products ?? []) products.set(p.id, p);
+  }
+  return {
+    ...result,
+    stores: Object.fromEntries(
+      stores.map((s, i) => [
+        String(s._id),
+        {
+          id: String(s._id),
+          label: storeLabel(s),
+          kind: s.kind,
+          slot: seriesSlot(i),
+          mealCard: s.mealCardAccepted,
+        },
+      ]),
+    ),
+    products: Object.fromEntries(
+      [...used].flatMap((id) => {
+        const p = products.get(id);
+        return p
+          ? [[id, { label: p.label, packageLabel: p.packageLabel, typeUnit: p.typeUnit }]]
+          : [];
+      }),
+    ),
+    thresholdMinor: threshold,
+    mealCardBalanceMinor: mealCards.reduce((a, c) => a + c.balanceMinor, 0),
+  };
+}
+
+export async function getShoppingList(
+  userId: string,
+  householdId: string,
+  listId: string,
+): Promise<ShoppingListDetail | null> {
+  const m = await resolveMembership(userId, householdId, "viewer");
+  if (!m) return null;
+  const list = await loadList(m, listId);
+  if (!list) return null;
+  const [stock, productList, others, labels] = await Promise.all([
+    getStock(userId, householdId),
+    listProducts(userId, householdId, { includeArchived: true }),
+    ShoppingListModel.find({
+      householdId: m.householdId,
+      deletedAt: null,
+      status: "active",
+      _id: { $ne: list._id },
+    })
+      .select({ name: 1 })
+      .sort({ updatedAt: -1 })
+      .lean<{ _id: Types.ObjectId; name: string }[]>(),
+    loadLabels(m.householdId, [list]),
+  ]);
+  if (!stock || !productList) return null;
+  const types = new Map(stock.items.map((x) => [x.id, x]));
+  const products = new Map(productList.products.map((p) => [p.id, p]));
+  // Arşivlenmiş ürün tiplerinin adı/birimi (getStock yalnızca aktifleri döner).
+  const archivedTypeIds = list.items
+    .filter((i) => i.productTypeId && !types.has(String(i.productTypeId)))
+    .map((i) => i.productTypeId!);
+  const archivedTypes = new Map(
+    (
+      await ProductTypeModel.find({ householdId: m.householdId, _id: { $in: archivedTypeIds } })
+        .select({ name: 1, unit: 1 })
+        .lean<{ _id: Types.ObjectId; name: string; unit: string }[]>()
+    ).map((x) => [String(x._id), { name: x.name, unit: x.unit }]),
+  );
+  const items = list.items
+    .map((i) => itemView(i, types, products, archivedTypes))
+    .sort((a, b) => Number(a.checked) - Number(b.checked));
+  const isActive = list.status === "active";
+  const canWrite = hasHouseholdRole(m.role, "member") && isActive;
+  const [suggestions, plan] = await Promise.all([
+    isActive ? pendingSuggestions(m, stock.suggestions) : Promise.resolve([]),
+    buildPlan(userId, m, list.items, products, types),
+  ]);
+  return {
+    list: summary(list, labels),
+    items,
+    suggestions,
+    plan,
+    options: {
+      types: stock.items
+        .map((x) => ({ id: x.id, name: x.name, unit: x.unit, path: x.categoryPath }))
+        .sort((a, b) => compareTr(a.name, b.name)),
+      products: productList.products
+        .filter((p) => !p.archived && !p.conversionMissing && types.has(p.productTypeId))
+        .map((p) => ({
+          id: p.id,
+          label: p.label,
+          packageLabel: p.packageLabel,
+          productTypeId: p.productTypeId,
+          typeName: p.productTypeName,
+        })),
+    },
+    otherLists: others.map((o) => ({ id: String(o._id), name: o.name })),
+    canWrite,
+    report: list.completion
+      ? {
+          completion: list.completion,
+          summary: compareShopping(
+            list.completion.rows.map((r) => ({
+              match: r.match,
+              plan: r.plan,
+              actual:
+                r.amountMinor === null
+                  ? null
+                  : { productId: r.productId, packages: r.packages, amountMinor: r.amountMinor },
+            })),
+          ),
+        }
+      : null,
+  };
+}
+
+// --- Yazma: listeler ---
+
+export async function writableList(actorId: string, householdId: string, listId: string) {
+  const m = await resolveMembership(actorId, householdId, "member");
+  if (!m) return { error: fail(tr.common.unauthorized) } as const;
+  const list = await loadList(m, listId);
+  if (!list) return { error: fail(tr.common.notFound) } as const;
+  if (list.status !== "active") return { error: fail(t.validation.notActive) } as const;
+  return { error: null, m, list, actor: new Types.ObjectId(actorId) } as const;
+}
+
+export async function createShoppingList(
+  actorId: string,
+  householdId: string,
+  input: ShoppingListForm,
+): Promise<ActionResult<{ id: string }>> {
+  const m = await resolveMembership(actorId, householdId, "member");
+  if (!m) return fail(tr.common.unauthorized);
+  const actor = new Types.ObjectId(actorId);
+  const doc = await ShoppingListModel.create({
+    householdId: m.householdId,
+    name: input.name,
+    note: input.note,
+    createdBy: actor,
+    updatedBy: actor,
+  });
+  return ok({ id: String(doc._id) });
+}
+
+export async function updateShoppingList(
+  actorId: string,
+  householdId: string,
+  listId: string,
+  input: ShoppingListForm,
+): Promise<ActionResult> {
+  const r = await writableList(actorId, householdId, listId);
+  if (r.error) return r.error;
+  await ShoppingListModel.updateOne(
+    { _id: r.list._id },
+    { $set: { name: input.name, note: input.note, updatedBy: r.actor } },
+  );
+  return ok(undefined);
+}
+
+/** Liste silme (soft delete, audit). Tamamlanmış liste de silinebilir. */
+export async function deleteShoppingList(
+  actorId: string,
+  householdId: string,
+  listId: string,
+): Promise<ActionResult> {
+  const m = await resolveMembership(actorId, householdId, "member");
+  if (!m) return fail(tr.common.unauthorized);
+  const list = await loadList(m, listId);
+  if (!list) return fail(tr.common.notFound);
+  const actor = new Types.ObjectId(actorId);
+  await ShoppingListModel.updateOne(
+    { _id: list._id },
+    { $set: { deletedAt: new Date(), updatedBy: actor } },
+  );
+  await writeAudit({
+    action: "shoppingList.delete",
+    actorId: actor,
+    householdId: m.householdId,
+    targetType: "shoppingList",
+    targetId: listId,
+    diff: { name: list.name, status: list.status, items: list.items.length },
+  });
+  return ok(undefined);
+}
+
+// --- Yazma: kalemler ---
+
+/** Ürün tipi / ürün aktif mi; aynı kalem listede alınmamış olarak var mı? */
+async function checkItemRef(
+  m: Membership,
+  list: ListLean,
+  input: Pick<ShoppingItemForm, "kind" | "productTypeId" | "productId">,
+): Promise<ActionResult<never> | null> {
+  if (input.kind === "type") {
+    const ok = await ProductTypeModel.exists({
+      _id: new Types.ObjectId(input.productTypeId!),
+      householdId: m.householdId,
+      archivedAt: null,
+    });
+    if (!ok) return fail(t.validation.productType, { productTypeId: t.validation.productType });
+  }
+  if (input.kind === "product") {
+    const ok = await ProductModel.exists({
+      _id: new Types.ObjectId(input.productId!),
+      householdId: m.householdId,
+      archivedAt: null,
+    });
+    if (!ok) return fail(t.validation.product, { productId: t.validation.product });
+  }
+  const key = refKey({
+    kind: input.kind,
+    productTypeId: input.productTypeId ? new Types.ObjectId(input.productTypeId) : null,
+    productId: input.productId ? new Types.ObjectId(input.productId) : null,
+  });
+  if (key && list.items.some((i) => !i.checked && refKey(i) === key))
+    return fail(t.validation.duplicate);
+  return null;
+}
+
+export async function addShoppingItem(
+  actorId: string,
+  householdId: string,
+  listId: string,
+  input: ShoppingItemForm,
+  source: ShoppingItemSource = "manual",
+): Promise<ActionResult<{ id: string }>> {
+  const r = await writableList(actorId, householdId, listId);
+  if (r.error) return r.error;
+  const bad = await checkItemRef(r.m, r.list, input);
+  if (bad) return bad;
+  const _id = new Types.ObjectId();
+  await ShoppingListModel.updateOne(
+    { _id: r.list._id },
+    {
+      $push: {
+        items: {
+          _id,
+          kind: input.kind,
+          productTypeId: input.productTypeId ? new Types.ObjectId(input.productTypeId) : null,
+          productId: input.productId ? new Types.ObjectId(input.productId) : null,
+          text: input.text,
+          quantity: input.quantity,
+          unit: input.unit,
+          note: input.note,
+          source,
+          addedBy: r.actor,
+          addedAt: new Date(),
+        },
+      },
+      $set: { updatedBy: r.actor },
+    },
+  );
+  return ok({ id: String(_id) });
+}
+
+export async function updateShoppingItem(
+  actorId: string,
+  householdId: string,
+  listId: string,
+  itemId: string,
+  input: ShoppingItemUpdate,
+): Promise<ActionResult> {
+  const r = await writableList(actorId, householdId, listId);
+  if (r.error) return r.error;
+  const item = r.list.items.find((i) => String(i._id) === itemId);
+  if (!item) return fail(tr.common.notFound);
+  if (item.kind === "text" && !input.text)
+    return fail(t.validation.text, { text: t.validation.text });
+  const set: Record<string, unknown> = {
+    "items.$.quantity": input.quantity,
+    "items.$.note": input.note,
+    updatedBy: r.actor,
+  };
+  if (item.kind === "text") {
+    set["items.$.text"] = input.text;
+    set["items.$.unit"] = input.unit;
+  }
+  await ShoppingListModel.updateOne({ _id: r.list._id, "items._id": item._id }, { $set: set });
+  return ok(undefined);
+}
+
+export async function removeShoppingItem(
+  actorId: string,
+  householdId: string,
+  listId: string,
+  itemId: string,
+): Promise<ActionResult> {
+  const r = await writableList(actorId, householdId, listId);
+  if (r.error) return r.error;
+  const id = toObjectId(itemId);
+  if (!id || !r.list.items.some((i) => i._id.equals(id))) return fail(tr.common.notFound);
+  await ShoppingListModel.updateOne(
+    { _id: r.list._id },
+    { $pull: { items: { _id: id } }, $set: { updatedBy: r.actor } },
+  );
+  return ok(undefined);
+}
+
+/** Alışveriş modunda sepete alındı / geri alındı. */
+export async function setShoppingItemChecked(
+  actorId: string,
+  householdId: string,
+  listId: string,
+  itemId: string,
+  checked: boolean,
+): Promise<ActionResult> {
+  const r = await writableList(actorId, householdId, listId);
+  if (r.error) return r.error;
+  const id = toObjectId(itemId);
+  if (!id) return fail(tr.common.notFound);
+  const res = await ShoppingListModel.updateOne(
+    { _id: r.list._id, "items._id": id },
+    {
+      $set: {
+        "items.$.checked": checked,
+        "items.$.checkedBy": checked ? r.actor : null,
+        "items.$.checkedAt": checked ? new Date() : null,
+      },
+    },
+  );
+  return res.matchedCount ? ok(undefined) : fail(tr.common.notFound);
+}
+
+/** Kalemi başka bir aktif listeye taşır. */
+export async function moveShoppingItem(
+  actorId: string,
+  householdId: string,
+  listId: string,
+  itemId: string,
+  targetListId: string,
+): Promise<ActionResult> {
+  const r = await writableList(actorId, householdId, listId);
+  if (r.error) return r.error;
+  const target = await writableList(actorId, householdId, targetListId);
+  if (target.error) return target.error;
+  if (target.list._id.equals(r.list._id)) return fail(t.validation.sameList);
+  const item = r.list.items.find((i) => String(i._id) === itemId);
+  if (!item) return fail(tr.common.notFound);
+  const key = refKey(item);
+  if (key && target.list.items.some((i) => !i.checked && refKey(i) === key))
+    return fail(t.validation.duplicateIn(target.list.name));
+  await ShoppingListModel.updateOne(
+    { _id: target.list._id },
+    {
+      $push: { items: { ...item, checked: false, checkedBy: null, checkedAt: null } },
+      $set: { updatedBy: r.actor },
+    },
+  );
+  await ShoppingListModel.updateOne(
+    { _id: r.list._id },
+    { $pull: { items: { _id: item._id } }, $set: { updatedBy: r.actor } },
+  );
+  return ok(undefined);
+}
+
+// --- Eşik önerileri ---
+
+/** Önerileri onayla: önerilen miktarla ürün tipi kalemi olarak eklenir. */
+export async function approveSuggestions(
+  actorId: string,
+  householdId: string,
+  listId: string,
+  productTypeIds: string[],
+): Promise<ActionResult<{ added: number }>> {
+  const r = await writableList(actorId, householdId, listId);
+  if (r.error) return r.error;
+  const stock = await getStock(actorId, householdId);
+  if (!stock) return fail(tr.common.unauthorized);
+  const pending = new Map(
+    (await pendingSuggestions(r.m, stock.suggestions)).map((x) => [x.productTypeId, x]),
+  );
+  const items = productTypeIds
+    .map((id) => pending.get(id))
+    .filter((x): x is SuggestionView => Boolean(x))
+    .map((x) => ({
+      _id: new Types.ObjectId(),
+      kind: "type" as const,
+      productTypeId: new Types.ObjectId(x.productTypeId),
+      productId: null,
+      text: "",
+      quantity: x.suggestedQuantity > 0 ? x.suggestedQuantity : null,
+      unit: "",
+      note: "",
+      source: "suggestion" as const,
+      addedBy: r.actor,
+      addedAt: new Date(),
+    }));
+  if (!items.length) return fail(t.validation.suggestionGone);
+  await ShoppingListModel.updateOne(
+    { _id: r.list._id },
+    { $push: { items: { $each: items } }, $set: { updatedBy: r.actor } },
+  );
+  return ok({ added: items.length });
+}
+
+/** Öneriyi reddet: stok yenilenene (yeni alım) kadar gösterilmez. */
+export async function dismissSuggestion(
+  actorId: string,
+  householdId: string,
+  productTypeId: string,
+): Promise<ActionResult> {
+  const m = await resolveMembership(actorId, householdId, "member");
+  if (!m) return fail(tr.common.unauthorized);
+  const id = toObjectId(productTypeId);
+  const res = id
+    ? await ProductTypeModel.updateOne(
+        { _id: id, householdId: m.householdId, archivedAt: null },
+        { $set: { suggestionDismissedAt: new Date() } },
+      )
+    : null;
+  return res?.matchedCount ? ok(undefined) : fail(tr.common.notFound);
+}

src/features/stock/components/stock-dialogs.tsx

@@ -4,6 +4,7 @@ import { useState } from "react";
 import { toast } from "sonner";
 import { ResponsiveDialog } from "@/components/responsive-dialog";
 import { Button } from "@/components/ui/button";
+import { Checkbox } from "@/components/ui/checkbox";
 import { Field, FieldDescription, FieldError, FieldGroup, FieldLabel } from "@/components/ui/field";
 import { Input } from "@/components/ui/input";
 import {
@@ -73,6 +74,7 @@ export function ProductTypeFormDialog({
     step: item ? quantityInput(item.step) : "1",
     countEveryDays: item?.countEveryDays ? String(item.countEveryDays) : "",
     note: item?.note ?? "",
+    bulky: item?.bulky ?? false,
     initialQuantity: "",
   });
   const [errors, setErrors] = useState<Errors>({});
@@ -93,6 +95,7 @@ export function ProductTypeFormDialog({
       step: v.step,
       countEveryDays: v.countEveryDays,
       note: v.note,
+      bulky: v.bulky,
       initialQuantity: item ? "" : v.initialQuantity,
     });
     setBusy(false);
@@ -285,6 +288,17 @@ export function ProductTypeFormDialog({
           <FieldDescription className="-mt-2">
             {f.stepHint} {f.countEveryDaysHint}
           </FieldDescription>
+          <Field orientation="horizontal">
+            <Checkbox
+              id="pt-bulky"
+              checked={v.bulky}
+              onCheckedChange={(x) => set("bulky", x === true)}
+            />
+            <div className="flex flex-col gap-0.5">
+              <FieldLabel htmlFor="pt-bulky">{f.bulky}</FieldLabel>
+              <FieldDescription>{f.bulkyHint}</FieldDescription>
+            </div>
+          </Field>
           <Field>
             <FieldLabel htmlFor="pt-note">{f.note}</FieldLabel>
             <Input id="pt-note" value={v.note} onChange={(e) => set("note", e.target.value)} />

src/features/stock/components/stock-view.tsx

@@ -216,7 +216,12 @@ export function StockView({ data, options }: { data: Data; options: StockOption[
             <CardTitle className="text-base">{t.suggestions.title}</CardTitle>
             <CardDescription>{t.suggestions.description}</CardDescription>
           </CardHeader>
-          <CardContent>
+          <CardContent className="flex flex-col gap-3">
+            {data.suggestions.length ? (
+              <Link href="/alisveris" className="text-sm text-primary hover:underline">
+                {t.suggestions.toShopping}
+              </Link>
+            ) : null}
             {data.suggestions.length === 0 ? (
               <p className="text-sm text-muted-foreground">{t.suggestions.empty}</p>
             ) : (

src/features/stock/service.ts

@@ -87,6 +87,7 @@ type ProductLean = {
   step: number;
   countEveryDays: number | null;
   note: string;
+  bulky?: boolean;
   archivedAt: Date | null;
   createdAt: Date;
 };
@@ -132,6 +133,7 @@ export type ProductTypeView = {
   step: number;
   countEveryDays: number | null;
   note: string;
+  bulky: boolean;
   archived: boolean;
   current: number;
   level: StockLevel;
@@ -331,6 +333,7 @@ function toView(p: ProductLean, moves: MoveLean[], ctx: ViewContext): ProductTyp
     step: p.step,
     countEveryDays: p.countEveryDays,
     note: p.note,
+    bulky: Boolean(p.bulky),
     archived: Boolean(p.archivedAt),
     current,
     level,
@@ -807,6 +810,7 @@ const productFields = (input: ProductTypeForm) => ({
   step: input.step,
   countEveryDays: input.countEveryDays,
   note: input.note,
+  bulky: input.bulky,
 });
 
 export async function createProductType(

src/hooks/use-auto-refresh.ts

@@ -0,0 +1,25 @@
+"use client";
+
+import { useRouter } from "next/navigation";
+import { useEffect } from "react";
+
+/**
+ * Paylaşılan veriler için hafif senkron: sayfa yeniden odaklanınca ve belirli aralıkla sunucu
+ * bileşenlerini yeniler (aile üyeleri aynı listeyi kullanır). Sekme gizliyken yenilemez.
+ */
+export function useAutoRefresh(intervalMs: number) {
+  const router = useRouter();
+  useEffect(() => {
+    const refresh = () => {
+      if (document.visibilityState === "visible") router.refresh();
+    };
+    const timer = window.setInterval(refresh, intervalMs);
+    window.addEventListener("focus", refresh);
+    document.addEventListener("visibilitychange", refresh);
+    return () => {
+      window.clearInterval(timer);
+      window.removeEventListener("focus", refresh);
+      document.removeEventListener("visibilitychange", refresh);
+    };
+  }, [router, intervalMs]);
+}

src/i18n/tr.ts

@@ -1012,6 +1012,7 @@ export const tr = {
       title: "Alınması önerilenler",
       description: "Kritik eşiğin altına düşen ürünler ve hedefe tamamlamak için gereken miktar.",
       empty: "Eşiğin altına düşen ürün yok.",
+      toShopping: "Alışveriş listelerinde onayla veya reddet",
       suggested: (q: string) => `Öneri: ${q}`,
       wasteReduced: (purchases: number, pct: number) =>
         `Son ${purchases} alımda %${pct} fire, miktar azaltıldı.`,
@@ -1055,6 +1056,9 @@ export const tr = {
       stepHint: "Hızlı azaltma düğmesinin düşeceği miktar.",
       countEveryDays: "Sayım sıklığı (gün)",
       countEveryDaysHint: "Boş bırakılırsa kategoriden devralınır.",
+      bulky: "Ağır / hacimli",
+      bulkyHint:
+        "Su, deterjan gibi taşıması zor ürünler. Akıllı öneri bunları yakın ya da online mağazaya yönlendirir.",
       note: "Not",
       initialQuantity: "Evdeki mevcut miktar",
       initialHint: "Tahmini veya ambalaj üzerinden. Boş bırakılırsa 0 kabul edilir.",
@@ -1352,6 +1356,238 @@ export const tr = {
       archived: "Ürün arşivli.",
     },
   },
+  shopping: {
+    title: "Alışveriş listeleri",
+    description:
+      "Aile üyeleri aynı listeleri kullanır. Stokta azalan ürünler öneri olarak gelir; akıllı öneri en uygun mağaza ve markayı seçer.",
+    readOnly: "Görüntüleme yetkiniz var; listeleri değiştiremezsiniz.",
+    newList: "Yeni liste",
+    createTitle: "Yeni alışveriş listesi",
+    editTitle: "Listeyi düzenle",
+    active: "Aktif listeler",
+    completed: "Tamamlanan alışverişler",
+    emptyActive: "Aktif liste yok. Yeni bir liste açın.",
+    itemCount: (n: number) => `${n} kalem`,
+    checkedCount: (done: number, total: number) => `${done}/${total} alındı`,
+    updated: (when: string) => `Güncellendi: ${when}`,
+    completedAt: (when: string) => `Tamamlandı: ${when}`,
+    emptyList: "Liste boş.",
+    suggestionsBanner: (n: number) =>
+      `Stokta eşiğin altına düşen ${n} ürün var. Bir listeyi açıp öneriyi onaylayın ya da reddedin.`,
+    fields: {
+      name: "Liste adı",
+      namePlaceholder: "ör. Haftalık market, Ay başı toptan",
+      note: "Not",
+      kind: "Kalem türü",
+      productType: "Ürün tipi",
+      product: "Ürün (marka/paket)",
+      text: "Kalem",
+      textPlaceholder: "ör. Doğum günü mumu",
+      quantity: "Miktar",
+      packages: "Paket adedi",
+      quantityHint: "Boş bırakılırsa en az bir paket.",
+      unit: "Birim",
+      unitPlaceholder: "ör. adet",
+      itemNote: "Not",
+      itemNotePlaceholder: "ör. laktozsuz olsun",
+    },
+    kinds: { type: "Ürün tipi", product: "Belirli marka", text: "Serbest metin" },
+    kindHints: {
+      type: "Markayı akıllı öneri seçer.",
+      product: "Yalnızca bu ürün önerilir.",
+      text: "Stokla ve fiyatlarla bağlanmaz.",
+    },
+    packageUnit: "paket",
+    stockLine: (current: string, target: string) => `Evde ${current} / hedef ${target}`,
+    fromSuggestion: "Stok önerisi",
+    archivedRef: "Arşivlendi",
+    actions: {
+      more: "Diğer işlemler",
+      addItem: "Kalem ekle",
+      edit: "Düzenle",
+      editList: "Listeyi düzenle",
+      deleteList: "Listeyi sil",
+      remove: "Listeden çıkar",
+      moveTo: "Başka listeye taşı",
+      goShopping: "Alışverişe çık",
+      back: "Alışveriş listeleri",
+      backToList: "Listeye dön",
+    },
+    editItemTitle: "Kalemi düzenle",
+    addItemTitle: "Kalem ekle",
+    moveTitle: "Başka listeye taşı",
+    moveDescription: (name: string) => `"${name}" seçilen aktif listeye taşınır.`,
+    moveTarget: "Hedef liste",
+    noOtherLists: "Taşınabilecek başka aktif liste yok.",
+    deleteTitle: "Liste silinsin mi?",
+    deleteDescription: (name: string) => `"${name}" listesi ve kalemleri silinir.`,
+    suggestions: {
+      title: "Stok önerileri",
+      description: "Eşiğin altına düşen ürünler. Onaylananlar önerilen miktarla listeye eklenir.",
+      addAll: "Tümünü ekle",
+      add: "Ekle",
+      dismiss: "Reddet",
+      dismissHint: "Stok yenilenene (yeni alım girilene) kadar önerilmez.",
+      line: (current: string, target: string, pct: number | null) =>
+        `Evde ${current} / hedef ${target}${pct === null ? "" : ` (%${pct})`}`,
+      suggested: (q: string) => `Önerilen: ${q}`,
+    },
+    plan: {
+      title: "Akıllı mağaza önerisi",
+      description:
+        "Son bilinen fiyatlarla. Uzaklık ve taşıma güçlüğü, online teslimat ücreti ve yemek kartı bakiyesi hesaba katılır.",
+      recommended: "Önerilen dağılım",
+      single: "Tek mağaza",
+      singleBest: (store: string, total: string) => `Tek mağaza en iyi seçenek: ${store}, ${total}`,
+      split: (parts: string, total: string) => `Önerilen dağılım: ${parts}: ${total}`,
+      part: (store: string, n: number) => `${store} (${n} ürün)`,
+      saving: (amount: string) => `${amount} tasarruf`,
+      singleMissing: (n: number) => `Tek mağazada ${n} kalem bulunmuyor.`,
+      threshold: (amount: string) =>
+        `Ek mağaza ancak ${amount} üstü tasarruf sağlarsa önerilir (hane ayarı).`,
+      mealCard: (amount: string) => `Yemek kartıyla ödenebilir: ${amount}`,
+      mealCardBalance: (amount: string) => `Yemek kartı bakiyeniz: ${amount}`,
+      delivery: (amount: string) => `Teslimat ${amount}`,
+      freeDelivery: "Teslimat ücretsiz",
+      subtotal: "Ara toplam",
+      total: "Tahmini toplam",
+      line: (packages: string, price: string) => `${packages} × ${price}`,
+      unpriced: "Fiyatı bilinmeyenler",
+      unpricedHint: "Bu kalemler için mağaza fiyatı girilmemiş.",
+      cheapestAt: (store: string, unitPrice: string) =>
+        `En ucuz birim fiyat: ${store}, ${unitPrice}`,
+      empty: "Öneri için listede fiyatı bilinen ürün yok.",
+      textItems: "Serbest metin kalemleri öneriye katılmaz.",
+      missing: "Bu planda alınamayan",
+    },
+    mode: {
+      title: "Alışveriş modu",
+      progress: (done: number, total: number) => `${done}/${total} sepette`,
+      other: "Diğer",
+      otherHint: "Fiyatı bilinmeyen ve serbest metin kalemleri",
+      inCart: "Sepette",
+      allDone: "Hepsi sepette.",
+      planChoice: "Plan",
+      check: (label: string) => `${label}: sepete alındı olarak işaretle`,
+      refreshed: "Liste güncellendi",
+    },
+    toast: {
+      saved: "Liste kaydedildi.",
+      deleted: "Liste silindi.",
+      itemAdded: "Kalem eklendi.",
+      itemSaved: "Kalem güncellendi.",
+      itemRemoved: "Kalem listeden çıkarıldı.",
+      moved: "Kalem taşındı.",
+      suggestionsAdded: (n: number) => `${n} öneri listeye eklendi.`,
+      dismissed: "Öneri reddedildi.",
+    },
+    validation: {
+      quantity: "Geçerli bir miktar girin (ör. 2 veya 1,5)",
+      productType: "Aktif bir ürün tipi seçin",
+      product: "Aktif bir ürün seçin",
+      text: "Kalem adını yazın",
+      duplicate: "Bu ürün listede zaten var; miktarını düzenleyin.",
+      duplicateIn: (name: string) => `Bu ürün "${name}" listesinde zaten var.`,
+      notActive: "Bu liste tamamlandı; değiştirilemez.",
+      sameList: "Kalem zaten bu listede.",
+      suggestionGone: "Öneri artık geçerli değil (listede ya da stok yenilenmiş).",
+      amount: "Geçerli bir tutar girin (ör. 89,90)",
+      noLines: "Alınan en az bir ürün seçin",
+      duplicateLine: "Bir liste kalemi yalnızca bir kez girilebilir",
+      duplicateStore: "Mağaza iki kez girilmiş",
+      account: "Her mağaza için ödeme hesabı seçin",
+      targetList: "Alınmayanlar için hedef liste seçin",
+      futureDate: "Gelecek tarihli alışveriş girilemez",
+      itemGone: "Listede olmayan bir kalem seçilmiş; sayfayı yenileyin",
+      substituteType: "Muadil aynı ürün tipinden olmalı",
+      textNoProduct: "Serbest metin kalemine ürün seçilemez",
+      conversion: (name: string) => `"${name}" ürününün tip birimine dönüşümü yok`,
+      fallbackCategory: "Eşlenmemiş kalemler için gider kategorisi seçin",
+      tooManySplits: "Bir mağazada çok fazla gider kategorisi var",
+    },
+    complete: {
+      action: "Alışverişi tamamla",
+      title: "Alışverişi tamamla",
+      description:
+        "Aldıklarınızı seçin: aynı ürün ya da muadili, paket adedi, ödenen tutar ve mağaza. Kaydedince stok, fiyatlar, mağaza başına gider ve fişler tek seferde işlenir.",
+      date: "Alışveriş tarihi",
+      bought: "Alındı",
+      itemsTitle: "Listedekiler",
+      extrasTitle: "Listede olmayanlar",
+      addExtra: "Listede olmayan ürün ekle",
+      removeExtra: "Ekstrayı çıkar",
+      product: "Alınan ürün",
+      store: "Mağaza",
+      packages: "Paket",
+      quantity: "Miktar",
+      generic: (unit: string) => `Marka belirtmeden (${unit})`,
+      amount: "Tutar (₺)",
+      amountHint: "Fişteki satır tutarı.",
+      planned: (text: string) => `Plan: ${text}`,
+      substitute: "Muadil",
+      noPlan: "Planda fiyat yoktu",
+      textItem: "Serbest metin: stok ve fiyata işlenmez.",
+      storesTitle: "Ödeme ve fiş",
+      storesDescription:
+        "Her mağaza ayrı gider işlemi olur; kalemler stok kategorisinin gider kategorisine bölünür.",
+      account: "Ödeme hesabı",
+      receipts: "Fiş görselleri",
+      addReceipt: "Fiş ekle",
+      receiptHint: "Fiş fotoğrafı; işlemin ekine kaydedilir.",
+      subtotal: (n: number) => `${n} kalem`,
+      fallbackCategory: "Eşlenmemiş kalemlerin gider kategorisi",
+      fallbackHint:
+        "Stok kategorisi bir gider kategorisine eşlenmemiş ürünler ve serbest metin kalemleri buraya yazılır.",
+      leftoverTitle: "Alınmayanlar",
+      leftoverDescription: (n: number) => `${n} kalem alınmadı.`,
+      leftoverActions: {
+        move: "Başka aktif listeye taşı",
+        new: "Yeni liste aç",
+        drop: "Bırak (listeyle kapanır)",
+      },
+      newListName: "Yeni liste adı",
+      newListDefault: (name: string) => `${name} – kalanlar`,
+      total: "Toplam",
+      plannedTotal: "Planlanan",
+      submit: "Alışverişi tamamla",
+      saved: "Alışveriş tamamlandı; stok, fiyatlar ve giderler işlendi.",
+      txDescription: (list: string) => `Alışveriş: ${list}`,
+      splitNote: (n: number) => `${n} kalem`,
+      noStores: "Mağaza yok. Önce bir mağaza ekleyin.",
+    },
+    report: {
+      title: "Karşılaştırma raporu",
+      description: (date: string) =>
+        `Alışveriş tarihi ${date}. Plan, tamamlama anındaki akıllı öneridir.`,
+      planned: "Planlanan",
+      actual: "Gerçekleşen",
+      diff: "Fark",
+      reasonsTitle: "Farkın nedenleri",
+      reasons: {
+        price: "Fiyat farkı (aynı ürün)",
+        quantity: "Miktar farkı",
+        substitute: "Muadil ürün",
+        skipped: "Alınmayanlar",
+        extra: "Plansız ekstralar",
+        unplanned: "Planda fiyatı olmayanlar",
+      },
+      matches: { same: "Aynı", substitute: "Muadil", skipped: "Alınmadı", extra: "Plansız ekstra" },
+      item: "Kalem",
+      plan: "Plan",
+      bought: "Alınan",
+      expenses: "Mağaza giderleri",
+      expenseLine: (account: string, receipts: number) =>
+        receipts ? `${account} · ${receipts} fiş` : account,
+      movedTo: (name: string) => `Alınmayanlar "${name}" listesine taşındı.`,
+      noPlanCell: "—",
+    },
+    dashboard: {
+      title: "Alışveriş",
+      empty: "Aktif liste yok.",
+      open: "Listeleri aç",
+      suggestions: (n: number) => `${n} stok önerisi bekliyor`,
+    },
+  },
   productPrices: {
     add: "Fiyat gir",
     addTitle: "Fiyat gir",
@@ -1626,6 +1862,304 @@ export const tr = {
     identifierRequired: "Kullanıcı adı veya e-posta girin",
     passwordRequired: "Şifre girin",
   },
+  reports: {
+    title: "Raporlar",
+    description:
+      "Bütçe ayına göre. Gizli hesap giderleri hane ayarına göre (yalnızca tutar) dahil edilir.",
+    uncategorized: "Kategorisiz",
+    back: "Raporlar",
+    csv: "CSV indir",
+    prevMonth: "Önceki ay",
+    nextMonth: "Sonraki ay",
+    currentMonth: "Bu ay",
+    includesHidden: 'Başka üyelerin "yalnızca ben" hesaplarındaki giderler tutar olarak dahil.',
+    noData: "Bu dönemde kayıt yok.",
+    hub: {
+      thisMonth: "Bu bütçe ayı",
+      income: "Gelir",
+      expense: "Gider",
+      net: "Net",
+      savings: "Tasarruf oranı",
+      topCategories: "En çok harcanan kategoriler",
+      open: "Raporu aç",
+      cards: {
+        categories: {
+          title: "Kategori dağılımı",
+          description:
+            "Kategorilerin toplam gidere oranı, alt kategori kırılımı, önceki aya göre değişim.",
+        },
+        trend: {
+          title: "Aylık trend",
+          description: "Son 12 ay gelir, gider, net ve tasarruf oranı.",
+        },
+        people: {
+          title: "Kişi ve hesap bazlı",
+          description: "Üyelerin harcaması ve hesapların aylık hareketi.",
+        },
+        budget: {
+          title: "Bütçe ve gerçekleşen",
+          description: "Kategori bazında limit ve harcama, son 6 ayın karşılaştırması.",
+        },
+        contacts: {
+          title: "Cari ve aynî borçlar",
+          description: "Kim kime ne kadar borçlu; açık altın/döviz borç ve alacakları.",
+        },
+        assets: {
+          title: "Birikim kâr/zarar",
+          description: "Varlık başına maliyet, değer ve kâr/zarar; dönem özeti.",
+        },
+        shopping: {
+          title: "Alışveriş",
+          description: "Liste ve gerçekleşen karşılaştırması, mağaza bazlı harcama.",
+        },
+        unitPrice: {
+          title: "Birim fiyat geçmişi",
+          description: "Ürün tipi başına aylık en düşük ve ortalama birim fiyat.",
+        },
+        waste: {
+          title: "Fire / zarar",
+          description: "Fire miktarı, alıma oranı, nedenleri ve tahmini maliyet.",
+        },
+      },
+    },
+    categories: {
+      title: "Kategori dağılımı",
+      description: (month: string) =>
+        `${month} bütçe ayı; toplam gidere oran ve önceki aya göre değişim.`,
+      chartLabel: "Kategorilerin toplam gider içindeki payı, halka grafik",
+      total: "Toplam gider",
+      category: "Kategori",
+      amount: "Tutar",
+      share: "Oran",
+      previous: "Önceki ay",
+      change: "Değişim",
+      own: "Doğrudan üst kategoriye",
+      partialMonth: "Ay devam ediyor; değişim önceki ayın tamamıyla karşılaştırılır.",
+      newCategory: "yeni",
+      other: (n: number) => `Diğer (${n} kategori)`,
+    },
+    trend: {
+      title: "Aylık trend",
+      description: "Son 12 bütçe ayı: gerçekleşen gelir ve gider, net ve tasarruf oranı.",
+      chartLabel: "Son 12 ay gelir ve gider sütun grafiği",
+      rateChartLabel: "Son 12 ay tasarruf oranı",
+      month: "Ay",
+      income: "Gelir",
+      expense: "Gider",
+      net: "Net",
+      savings: "Tasarruf oranı",
+      total: "12 ay toplam",
+      rateTitle: "Tasarruf oranı",
+      rateHint: "(gelir − gider) / gelir. Gelir yoksa hesaplanmaz.",
+      partialHint: "Devam eden ay grafikte gösterilmez.",
+      ongoing: "devam ediyor",
+    },
+    people: {
+      title: "Kişi ve hesap bazlı",
+      description: (month: string) => `${month} bütçe ayı; yalnızca gerçekleşmiş işlemler.`,
+      peopleTitle: "Kişi bazlı harcama",
+      peopleHint: "Gideri kaydeden üyeye göre.",
+      person: "Kişi",
+      expense: "Gider",
+      count: "İşlem",
+      share: "Oran",
+      csvPeople: "Kişiler CSV",
+      csvAccounts: "Hesaplar CSV",
+      accountsTitle: "Hesap bazlı hareket",
+      accountsHint: 'Transferler dahil; başka üyelerin "yalnızca ben" hesapları gösterilmez.',
+      account: "Hesap",
+      income: "Gelir",
+      transferIn: "Gelen transfer",
+      transferOut: "Giden transfer",
+      net: "Net değişim",
+      archived: "arşivli",
+    },
+    budget: {
+      title: "Bütçe ve gerçekleşen",
+      description: (month: string) => `${month} bütçe ayı; kategori bazında limit ve gerçekleşen.`,
+      noBudget: "Bu ay için bütçe yok.",
+      category: "Kategori",
+      limit: "Limit",
+      actual: "Gerçekleşen",
+      remaining: "Kalan",
+      ratio: "Kullanım",
+      historyTitle: "Son 6 ay",
+      historyChartLabel: "Son 6 ay bütçe ve gerçekleşen sütun grafiği",
+      month: "Ay",
+      noLimit: "Bütçe yok",
+      covered: "üst kategoride",
+    },
+    periods: { 3: "Son 3 ay", 6: "Son 6 ay", 12: "Son 12 ay" } as Record<number, string>,
+    periodLabel: "Dönem",
+    rangeText: (from: string, to: string) => `${from} – ${to}`,
+    contacts: {
+      title: "Cari ve aynî borçlar",
+      description:
+        "Kim kime ne kadar borçlu; açık altın/döviz borç ve alacakları güncel değeriyle.",
+      owesMe: "Bana borçlu",
+      iOwe: "Ben borçluyum",
+      contact: "Cari",
+      balance: "Bakiye",
+      direction: "Yön",
+      due: "Vade",
+      noContacts: "Bakiyesi olan cari yok.",
+      inKindTitle: "Açık aynî borç ve alacaklar",
+      csvContacts: "Cariler CSV",
+      csvInKind: "Aynî CSV",
+      inKindHint: "Kalan miktarın güncel fiyatla TL karşılığı (alacak alış, borç satış fiyatıyla).",
+      remaining: "Kalan",
+      value: "Güncel değer",
+      since: "Tarih",
+      noInKind: "Açık aynî kayıt yok.",
+      receivable: "Alacak",
+      debt: "Borç",
+      unpriced: (n: number) => `${n} kaydın fiyatı yok; toplama katılmadı.`,
+      dueStates: { overdue: "Vadesi geçti", upcoming: "Vadesi yaklaşıyor", none: "" } as Record<
+        string,
+        string
+      >,
+    },
+    assets: {
+      title: "Birikim kâr/zarar",
+      description:
+        "Varlık başına maliyet, güncel değer (alış fiyatı) ve kâr/zarar; seçilen dönemin özeti.",
+      ranges: { "3": "Son 3 ay", "6": "Son 6 ay", "12": "Son 12 ay", tum: "Tümü" } as Record<
+        string,
+        string
+      >,
+      asset: "Varlık",
+      quantity: "Miktar",
+      cost: "Maliyet",
+      value: "Güncel değer",
+      unrealized: "Gerçekleşmemiş K/Z",
+      realized: "Gerçekleşen K/Z",
+      noPrice: "Fiyat yok",
+      periodTitle: "Dönem özeti",
+      startValue: "Dönem başı değer",
+      invested: "Yatırılan",
+      proceeds: "Satıştan alınan",
+      endValue: "Dönem sonu değer",
+      profit: "Dönem kârı",
+      excluded: (n: number) => `${n} varlığın fiyatı olmadığı için dönem toplamına katılmadı.`,
+      empty: "Varlık yok.",
+      total: "Toplam",
+    },
+    shopping: {
+      title: "Alışveriş raporu",
+      description: "Tamamlanan listelerde plan ve gerçekleşen; mağaza bazlı harcama.",
+      listsTitle: "Liste ve gerçekleşen",
+      listsEmpty: "Bu dönemde tamamlanan alışveriş yok.",
+      list: "Liste",
+      date: "Tarih",
+      planned: "Planlanan",
+      actual: "Gerçekleşen",
+      diff: "Fark",
+      counts: (same: number, sub: number, skipped: number, extra: number) =>
+        `${same} aynı · ${sub} muadil · ${skipped} alınmadı · ${extra} ekstra`,
+      storesTitle: "Mağaza bazlı harcama",
+      storesHint: "Alıcısı mağaza adıyla başlayan gerçekleşmiş giderler (şubeler birlikte).",
+      store: "Mağaza",
+      amount: "Tutar",
+      count: "İşlem",
+      share: "Oran",
+      fromLists: "Listelerden",
+      storesEmpty: "Bu dönemde mağaza adıyla eşleşen gider yok.",
+      total: "Toplam",
+      csvLists: "Listeler CSV",
+      csvStores: "Mağazalar CSV",
+    },
+    unitPrice: {
+      title: "Birim fiyat geçmişi",
+      description: "Ürün tipi başına son 12 bütçe ayında en düşük ve ortalama birim fiyat.",
+      type: "Ürün tipi",
+      noTypes: "Henüz fiyat kaydı yok.",
+      min: "En düşük",
+      avg: "Ortalama",
+      month: "Ay",
+      count: "Kayıt",
+      chartLabel: (name: string) => `${name}: aylık en düşük ve ortalama birim fiyat`,
+      storesTitle: "Mağazalarda dönemin en düşük birim fiyatı",
+      store: "Mağaza",
+      last: "Son kayıt",
+      records: (n: number) => `${n} kayıt`,
+    },
+    waste: {
+      title: "Fire / zarar",
+      description: "Ürün tipi başına fire miktarı, alıma oranı, nedenleri ve tahmini maliyeti.",
+      total: "Tahmini toplam maliyet",
+      product: "Ürün tipi",
+      wasted: "Fire",
+      purchased: "Alım",
+      ratio: "Fire / alım",
+      cost: "Tahmini maliyet",
+      reasonsTitle: "Nedenler",
+      count: (n: number) => `${n} kayıt`,
+      empty: "Bu dönemde fire kaydı yok.",
+      unpriced: (n: number) => `${n} ürün tipinin fiyatı yok; maliyete katılmadı.`,
+      costHint: "Fire miktarı × ürün tipinin son bilinen birim fiyatı.",
+    },
+    csvFiles: {
+      categories: (month: string) => `butcem-kategori-dagilimi-${month}.csv`,
+      trend: (date: string) => `butcem-aylik-trend-${date}.csv`,
+      people: (month: string) => `butcem-kisi-bazli-${month}.csv`,
+      accounts: (month: string) => `butcem-hesap-bazli-${month}.csv`,
+      budget: (month: string) => `butcem-butce-gerceklesen-${month}.csv`,
+      contacts: (date: string) => `butcem-cari-${date}.csv`,
+      inKind: (date: string) => `butcem-ayni-${date}.csv`,
+      assets: (date: string) => `butcem-birikim-${date}.csv`,
+      lists: (date: string) => `butcem-alisveris-listeleri-${date}.csv`,
+      stores: (date: string) => `butcem-magaza-harcama-${date}.csv`,
+      unitPrice: (name: string, date: string) => `butcem-birim-fiyat-${name}-${date}.csv`,
+      waste: (date: string) => `butcem-fire-${date}.csv`,
+    },
+    csvHeaders: {
+      categories: [
+        "Üst kategori",
+        "Kategori",
+        "Tutar",
+        "Toplam gidere oran (%)",
+        "Önceki ay",
+        "Değişim",
+        "Değişim (%)",
+      ],
+      trend: ["Ay", "Gelir", "Gider", "Net", "Tasarruf oranı (%)"],
+      people: ["Kişi", "Gider", "İşlem sayısı", "Oran (%)"],
+      accounts: [
+        "Hesap",
+        "Gelir",
+        "Gider",
+        "Gelen transfer",
+        "Giden transfer",
+        "Net değişim",
+        "İşlem sayısı",
+      ],
+      budget: ["Kategori", "Limit", "Gerçekleşen", "Kalan", "Kullanım (%)"],
+      contacts: ["Cari", "Bakiye (+ bana borçlu, − ben borçluyum)", "Vade"],
+      inKind: ["Cari", "Yön", "Kalan", "Güncel değer", "Tarih"],
+      assets: [
+        "Varlık",
+        "Miktar",
+        "Maliyet",
+        "Güncel değer",
+        "Gerçekleşmemiş K/Z",
+        "Gerçekleşen K/Z",
+      ],
+      lists: [
+        "Tarih",
+        "Liste",
+        "Planlanan",
+        "Gerçekleşen",
+        "Fark",
+        "Aynı",
+        "Muadil",
+        "Alınmadı",
+        "Ekstra",
+      ],
+      stores: ["Mağaza", "Tutar", "İşlem", "Oran (%)", "Listelerden"],
+      unitPrice: ["Ay", "En düşük birim fiyat", "Ortalama birim fiyat", "Kayıt"],
+      waste: ["Ürün tipi", "Birim", "Fire", "Alım", "Fire / alım (%)", "Tahmini maliyet"],
+    },
+  },
   dashboard: {
     title: "Ana sayfa",
     welcome: (name: string) => `Hoş geldin, ${name}`,
@@ -1639,6 +2173,23 @@ export const tr = {
       netWorth: "Net varlık",
     },
     noData: "Henüz veri yok",
+    overview: {
+      title: "Gelir, bütçe ve gider",
+      description: (range: string) => `${range}. Bütçe ayına göre.`,
+      periods: { week: "Haftalık", month: "Aylık", half: "Altı aylık", year: "Yıllık" },
+      views: { cumulative: "Kümülatif", periodic: "Dönemsel" },
+      periodLabel: "Periyot",
+      viewLabel: "Görünüm",
+      series: {
+        plannedIncome: "Planlanan gelir",
+        budget: "Planlanan gider (bütçe)",
+        actual: "Gerçekleşen gider",
+      },
+      chartLabel: "Planlanan gelir, planlanan gider ve gerçekleşen gider çizgi grafiği",
+      noBudget: "Bütçesi olmayan dönemde planlanan gider çizgisi boş kalır.",
+      table: "Tablo olarak göster",
+      bucket: { day: "Gün", month: "Ay" },
+    },
   },
   adminUsers: {
     title: "Kullanıcılar",

src/models/audit-log.ts

@@ -45,6 +45,7 @@ export const AUDIT_ACTIONS = [
   "product.archive",
   "product.unarchive",
   "price.delete",
+  "shoppingList.delete",
 ] as const;
 export type AuditAction = (typeof AUDIT_ACTIONS)[number];
 

src/models/product-type.ts

@@ -22,6 +22,13 @@ const productTypeSchema = new Schema(
     /** Sayım sıklığı (gün); null ise kategoriden devralınır (Faz 11b). */
     countEveryDays: { type: Number, default: null, min: 1, max: 365 },
     note: { type: String, default: "", maxlength: 300 },
+    /** Ağır/hacimli (su, deterjan): akıllı öneri zahmetli fiziksel mağazadan uzak tutar (Faz 13). */
+    bulky: { type: Boolean, default: false },
+    /**
+     * Eşik önerisi reddedildi: bu tarihten sonra alım hareketi gelene (stok yenilenene) kadar
+     * öneri gösterilmez (Faz 13).
+     */
+    suggestionDismissedAt: { type: Date, default: null },
     archivedAt: { type: Date, default: null },
     seedRef: { type: String, default: null },
     createdBy: { type: Schema.Types.ObjectId, required: true },

src/models/shopping-list.ts

@@ -0,0 +1,63 @@
+import { model, models, Schema, type InferSchemaType, type Model } from "mongoose";
+import {
+  SHOPPING_ITEM_KINDS,
+  SHOPPING_ITEM_SOURCES,
+  SHOPPING_LIST_STATUSES,
+} from "@/shared/shopping";
+
+/**
+ * Alışveriş kalemi (Bölüm 6.12): ürün tipi (genel), belirli ürün (marka/paket) ya da serbest metin.
+ * Miktar binde bir: ürün tipinde tipin biriminde, üründe paket adedi, serbest metinde `unit` ile.
+ * `checked`: alışveriş modunda sepete alındı.
+ */
+const shoppingItemSchema = new Schema(
+  {
+    kind: { type: String, enum: SHOPPING_ITEM_KINDS, required: true },
+    productTypeId: { type: Schema.Types.ObjectId, default: null },
+    productId: { type: Schema.Types.ObjectId, default: null },
+    text: { type: String, default: "", trim: true, maxlength: 120 },
+    /** Boşsa "1 paket" kabul edilir. */
+    quantity: { type: Number, default: null, min: 0 },
+    /** Serbest metin kaleminin birimi. */
+    unit: { type: String, default: "", trim: true, maxlength: 20 },
+    note: { type: String, default: "", trim: true, maxlength: 200 },
+    source: { type: String, enum: SHOPPING_ITEM_SOURCES, default: "manual" },
+    checked: { type: Boolean, default: false },
+    checkedBy: { type: Schema.Types.ObjectId, default: null },
+    checkedAt: { type: Date, default: null },
+    addedBy: { type: Schema.Types.ObjectId, required: true },
+    addedAt: { type: Date, default: () => new Date() },
+  },
+  { _id: true },
+);
+
+/** Alışveriş listesi; hane içinde ortak. Birden çok aktif liste olabilir. Silme: soft delete. */
+const shoppingListSchema = new Schema(
+  {
+    householdId: { type: Schema.Types.ObjectId, required: true },
+    name: { type: String, required: true, trim: true, maxlength: 80 },
+    status: { type: String, enum: SHOPPING_LIST_STATUSES, default: "active" },
+    note: { type: String, default: "", trim: true, maxlength: 300 },
+    items: { type: [shoppingItemSchema], default: [] },
+    completedAt: { type: Date, default: null },
+    /** Tamamlama anındaki karşılaştırma görüntüsü (ShoppingCompletion; etiketler sabitlenir). */
+    completion: { type: Schema.Types.Mixed, default: null },
+    deletedAt: { type: Date, default: null },
+    seedRef: { type: String, default: null },
+    createdBy: { type: Schema.Types.ObjectId, required: true },
+    updatedBy: { type: Schema.Types.ObjectId, required: true },
+  },
+  { timestamps: true, collection: "shoppingLists" },
+);
+
+shoppingListSchema.index({ householdId: 1, deletedAt: 1, status: 1, updatedAt: -1 });
+shoppingListSchema.index(
+  { householdId: 1, seedRef: 1 },
+  { unique: true, partialFilterExpression: { seedRef: { $type: "string" } } },
+);
+
+export type ShoppingList = InferSchemaType<typeof shoppingListSchema>;
+
+export const ShoppingListModel: Model<ShoppingList> =
+  (models.ShoppingList as Model<ShoppingList> | undefined) ??
+  model<ShoppingList>("ShoppingList", shoppingListSchema);

src/models/stock-movement.ts

@@ -21,6 +21,8 @@ const stockMovementSchema = new Schema(
     initial: { type: Boolean, default: false },
     /** Sayım oturumu (Faz 11b). */
     countId: { type: Schema.Types.ObjectId, default: null },
+    /** Alışverişi tamamlamadan gelen alım (Faz 13b). */
+    shoppingListId: { type: Schema.Types.ObjectId, default: null },
     deletedAt: { type: Date, default: null },
     seedRef: { type: String, default: null },
     createdBy: { type: Schema.Types.ObjectId, required: true },

src/models/transaction.ts

@@ -76,6 +76,8 @@ const transactionSchema = new Schema(
     reconciledAccountIds: { type: [Schema.Types.ObjectId], default: [] },
     /** Mutabakat düzeltme işlemi: kategorisiz; düzenlenemez, yalnızca silinebilir. */
     isAdjustment: { type: Boolean, default: false },
+    /** Alışverişi tamamlamadan gelen mağaza gideri (Faz 13b). */
+    shoppingListId: { type: Schema.Types.ObjectId, default: null },
     deletedAt: { type: Date, default: null },
     /** Seed verisinin idempotent yüklenmesi için sabit anahtar. */
     seedRef: { type: String, default: null },

src/shared/overview.test.ts

@@ -0,0 +1,53 @@
+import { describe, expect, it } from "vitest";
+import { cumulative, overviewRange, weekday } from "./overview";
+
+describe("overviewRange", () => {
+  it("haftalık: Pazartesi–Pazar, bugünü içerir", () => {
+    // 2026-11-07 Cumartesi.
+    expect(weekday("2026-11-07")).toBe(5);
+    const r = overviewRange("week", "2026-11-07");
+    expect(r).toMatchObject({ granularity: "day", from: "2026-11-02", to: "2026-11-08" });
+    expect(r.buckets).toHaveLength(7);
+    // Ay sınırını aşan hafta.
+    expect(overviewRange("week", "2026-12-01").from).toBe("2026-11-30");
+  });
+
+  it("aylık: bütçe ayının günleri (başlangıç günü 15)", () => {
+    const r = overviewRange("month", "2026-11-07", 15);
+    expect(r.from).toBe("2026-10-15");
+    expect(r.to).toBe("2026-11-14");
+    expect(r.buckets).toHaveLength(31);
+    expect(overviewRange("month", "2026-11-07").buckets).toHaveLength(30);
+  });
+
+  it("altı aylık ve yıllık: bu ay dahil son 6 / 12 bütçe ayı", () => {
+    const half = overviewRange("half", "2026-11-07");
+    expect(half).toMatchObject({ granularity: "month", from: "2026-06-01", to: "2026-11-30" });
+    expect(half.buckets).toEqual([
+      "2026-06",
+      "2026-07",
+      "2026-08",
+      "2026-09",
+      "2026-10",
+      "2026-11",
+    ]);
+    const year = overviewRange("year", "2026-01-20", 15);
+    expect(year.buckets[0]).toBe("2025-02");
+    expect(year.buckets.at(-1)).toBe("2026-01");
+  });
+});
+
+describe("cumulative", () => {
+  it("seriler ayrı birikir; boş nokta boş kalır, toplamı bozmaz", () => {
+    const out = cumulative([
+      { key: "a", plannedIncome: 100, budget: 50, actual: 10 },
+      { key: "b", plannedIncome: 0, budget: null, actual: 20 },
+      { key: "c", plannedIncome: 50, budget: 30, actual: null },
+    ]);
+    expect(out.map((p) => [p.plannedIncome, p.budget, p.actual])).toEqual([
+      [100, 50, 10],
+      [100, null, 30],
+      [150, 80, null],
+    ]);
+  });
+});

src/shared/overview.ts

@@ -0,0 +1,76 @@
+import { budgetPeriod, daysBetween, periodOfDate, shiftMonth } from "./budget";
+import { addDays } from "./recurrence";
+
+/**
+ * Dashboard ana grafiği (Bölüm 6.13): Planlanan Gelir, Planlanan Gider (Bütçe), Gerçekleşen Gider.
+ * Saf fonksiyonlar: periyot aralığı ve kümülatif dönüşüm.
+ *
+ * Periyotlar: Haftalık (bu hafta, Pazartesi–Pazar, günlük), Aylık (içinde bulunulan bütçe ayı,
+ * günlük), Altı Aylık ve Yıllık (bu bütçe ayı dahil son 6 / 12 bütçe ayı, aylık).
+ */
+
+export const OVERVIEW_PERIODS = ["week", "month", "half", "year"] as const;
+export type OverviewPeriod = (typeof OVERVIEW_PERIODS)[number];
+
+export type OverviewRange = {
+  granularity: "day" | "month";
+  /** Günlükte "YYYY-MM-DD", aylıkta bütçe ayı "YYYY-MM". */
+  buckets: string[];
+  from: string;
+  to: string;
+};
+
+/** "YYYY-MM-DD" → haftanın günü (0 = Pazartesi … 6 = Pazar). */
+export function weekday(ymd: string): number {
+  const d = new Date(`${ymd}T12:00:00Z`).getUTCDay();
+  return (d + 6) % 7;
+}
+
+export function overviewRange(period: OverviewPeriod, today: string, startDay = 1): OverviewRange {
+  if (period === "week") {
+    const from = addDays(today, -weekday(today));
+    const buckets = Array.from({ length: 7 }, (_, i) => addDays(from, i));
+    return { granularity: "day", buckets, from, to: buckets[6]! };
+  }
+  const current = periodOfDate(today, startDay);
+  if (period === "month") {
+    const { from, to } = budgetPeriod(current, startDay);
+    const buckets = Array.from({ length: daysBetween(from, to) }, (_, i) => addDays(from, i));
+    return { granularity: "day", buckets, from, to };
+  }
+  const n = period === "half" ? 6 : 12;
+  const buckets = Array.from({ length: n }, (_, i) => shiftMonth(current, i - n + 1));
+  return {
+    granularity: "month",
+    buckets,
+    from: budgetPeriod(buckets[0]!, startDay).from,
+    to: budgetPeriod(buckets.at(-1)!, startDay).to,
+  };
+}
+
+export type OverviewPoint = {
+  key: string;
+  plannedIncome: number | null;
+  budget: number | null;
+  actual: number | null;
+};
+
+const SERIES = ["plannedIncome", "budget", "actual"] as const;
+
+/**
+ * Kümülatif görünüm: her seri kendi içinde birikir. Boş (null) nokta boş kalır ama birikime 0
+ * katar; böylece bütçesi olmayan ay ya da gelecek günler çizgiyi koparır, toplamı bozmaz.
+ */
+export function cumulative(points: readonly OverviewPoint[]): OverviewPoint[] {
+  const run = { plannedIncome: 0, budget: 0, actual: 0 };
+  return points.map((p) => {
+    const out: OverviewPoint = { ...p };
+    for (const k of SERIES) {
+      const v = p[k];
+      if (v === null) continue;
+      run[k] += v;
+      out[k] = run[k];
+    }
+    return out;
+  });
+}

src/shared/reports.test.ts

@@ -0,0 +1,100 @@
+import { describe, expect, it } from "vitest";
+import {
+  categoryBreakdown,
+  changePct,
+  matchStoreName,
+  monthlyUnitPrices,
+  savingsRate,
+  sharePct,
+} from "./reports";
+
+describe("oranlar", () => {
+  it("toplam gidere oran bir ondalıklı (35.000 içinde 5.000 → %14,3)", () => {
+    expect(sharePct(5_000_00, 35_000_00)).toBe(14.3);
+    expect(sharePct(1, 0)).toBe(0);
+  });
+  it("önceki aya göre değişim; önceki 0 ise null", () => {
+    expect(changePct(120, 100)).toBe(20);
+    expect(changePct(90, 120)).toBe(-25);
+    expect(changePct(50, 0)).toBeNull();
+  });
+  it("tasarruf oranı; gelir yoksa null, gider gelirden fazlaysa negatif", () => {
+    expect(savingsRate(50_000_00, 35_000_00)).toBe(30);
+    expect(savingsRate(10_000_00, 12_000_00)).toBe(-20);
+    expect(savingsRate(0, 100)).toBeNull();
+  });
+});
+
+describe("categoryBreakdown", () => {
+  const cats = [
+    { id: "fatura", parentId: null, name: "Faturalar", order: 1 },
+    { id: "elektrik", parentId: "fatura", name: "Elektrik", order: 1 },
+    { id: "su", parentId: "fatura", name: "Su", order: 2 },
+    { id: "market", parentId: null, name: "Market", order: 2 },
+    { id: "gida", parentId: "market", name: "Gıda", order: 1 },
+    { id: "ulasim", parentId: null, name: "Ulaşım", order: 3 },
+  ];
+
+  it("üst kategori alt ağacı toplar; oranlar toplam gidere göre; boşlar gizli", () => {
+    const current = new Map([
+      ["elektrik", 3_000_00],
+      ["su", 2_000_00],
+      ["gida", 25_000_00],
+      ["market", 5_000_00],
+    ]);
+    const previous = new Map([
+      ["elektrik", 2_500_00],
+      ["gida", 20_000_00],
+      ["ulasim", 1_000_00],
+    ]);
+    const b = categoryBreakdown(cats, current, previous);
+    expect(b.totalMinor).toBe(35_000_00);
+    expect(b.prevTotalMinor).toBe(23_500_00);
+    expect(b.rows.map((r) => [r.id, r.amountMinor, r.sharePct])).toEqual([
+      ["market", 30_000_00, 85.7],
+      ["fatura", 5_000_00, 14.3],
+      // Bu ay harcama yok ama geçen ay vardı: değişimi göstermek için kalır.
+      ["ulasim", 0, 0],
+    ]);
+    const fatura = b.rows.find((r) => r.id === "fatura")!;
+    expect(fatura.children.map((c) => [c.id, c.amountMinor, c.changePct])).toEqual([
+      ["elektrik", 3_000_00, 20],
+      ["su", 2_000_00, null],
+    ]);
+    const market = b.rows.find((r) => r.id === "market")!;
+    expect(market.ownMinor).toBe(5_000_00);
+    expect(market.changePct).toBe(50);
+    expect(b.rows.find((r) => r.id === "ulasim")!.changeMinor).toBe(-1_000_00);
+  });
+});
+
+describe("matchStoreName", () => {
+  const fold = (s: string) => s.toLocaleLowerCase("tr-TR");
+  const names = ["Şok", "Migros", "Migros Jet", "A101"];
+  it("katlanmış başlangıç eşleşmesi, en uzun ad, kelime sınırı", () => {
+    expect(matchStoreName("Şok · Rasimpaşa", names, fold)).toBe("Şok");
+    expect(matchStoreName("ŞOK MARKET", names, fold)).toBe("Şok");
+    expect(matchStoreName("Migros Jet Moda", names, fold)).toBe("Migros Jet");
+    expect(matchStoreName("A101x", names, fold)).toBeNull();
+    expect(matchStoreName("Ev sahibi", names, fold)).toBeNull();
+    expect(matchStoreName("", names, fold)).toBeNull();
+  });
+});
+
+describe("monthlyUnitPrices", () => {
+  it("ay başına en düşük ve ortalama; kayıt yoksa boş", () => {
+    const out = monthlyUnitPrices(
+      [
+        { month: "2026-10", unitPriceMinor: 100 },
+        { month: "2026-10", unitPriceMinor: 140 },
+        { month: "2026-11", unitPriceMinor: 90 },
+      ],
+      ["2026-09", "2026-10", "2026-11"],
+    );
+    expect(out).toEqual([
+      { month: "2026-09", minMinor: null, avgMinor: null, count: 0 },
+      { month: "2026-10", minMinor: 100, avgMinor: 120, count: 2 },
+      { month: "2026-11", minMinor: 90, avgMinor: 90, count: 1 },
+    ]);
+  });
+});

src/shared/reports.ts

@@ -0,0 +1,175 @@
+/**
+ * Raporlar (Bölüm 6.14). Saf hesaplar: kategori dağılımı (üst kategori toplamları ve alt kategori
+ * kırılımı), toplam gidere oran, önceki aya göre değişim, tasarruf oranı. Tutarlar kuruş; oranlar
+ * bir ondalıklı yüzde (14,3).
+ */
+
+/** Payın toplamdaki yüzdesi, bir ondalık (toplam 0 ise 0). */
+export function sharePct(part: number, total: number): number {
+  if (total <= 0) return 0;
+  return Math.round((part * 1000) / total) / 10;
+}
+
+/** Önceki döneme göre yüzde değişim; önceki 0 ise hesaplanamaz (null). */
+export function changePct(current: number, previous: number): number | null {
+  if (previous === 0) return null;
+  return Math.round(((current - previous) * 1000) / previous) / 10;
+}
+
+/** Tasarruf oranı = (gelir − gider) / gelir; gelir yoksa null. */
+export function savingsRate(incomeMinor: number, expenseMinor: number): number | null {
+  if (incomeMinor <= 0) return null;
+  return sharePct(incomeMinor - expenseMinor, incomeMinor);
+}
+
+export type ReportCategory = {
+  id: string;
+  parentId: string | null;
+  name: string;
+  order: number;
+};
+
+export type CategoryShare = {
+  id: string;
+  name: string;
+  depth: number;
+  amountMinor: number;
+  sharePct: number;
+  prevMinor: number;
+  changeMinor: number;
+  changePct: number | null;
+};
+
+export type TopCategoryShare = CategoryShare & {
+  /** Alt kategoriler (ağaç sırasıyla, derinlik 1+); tutarları kendi tutarlarıdır. */
+  children: CategoryShare[];
+  /** Üst kategoriye doğrudan (alt kategori seçilmeden) yazılan tutar. */
+  ownMinor: number;
+};
+
+export type CategoryBreakdown = {
+  totalMinor: number;
+  prevTotalMinor: number;
+  rows: TopCategoryShare[];
+};
+
+/**
+ * Üst kategori toplamları (alt ağaç dahil) ve alt kategori kırılımı. Tutarı ve önceki tutarı
+ * sıfır olan kategoriler gösterilmez. Satırlar tutara göre büyükten küçüğe.
+ */
+export function categoryBreakdown(
+  categories: readonly ReportCategory[],
+  current: ReadonlyMap<string, number>,
+  previous: ReadonlyMap<string, number>,
+): CategoryBreakdown {
+  const byId = new Map(categories.map((c) => [c.id, c]));
+  const children = new Map<string, ReportCategory[]>();
+  const roots: ReportCategory[] = [];
+  for (const c of categories) {
+    if (c.parentId && byId.has(c.parentId))
+      children.set(c.parentId, [...(children.get(c.parentId) ?? []), c]);
+    else roots.push(c);
+  }
+  const sorted = (list: ReportCategory[]) =>
+    [...list].sort((a, b) => a.order - b.order || a.name.localeCompare(b.name, "tr"));
+  const totalMinor = [...current.values()].reduce((a, b) => a + b, 0);
+  const prevTotalMinor = [...previous.values()].reduce((a, b) => a + b, 0);
+
+  const share = (id: string, name: string, depth: number, cur: number, prev: number) => ({
+    id,
+    name,
+    depth,
+    amountMinor: cur,
+    sharePct: sharePct(cur, totalMinor),
+    prevMinor: prev,
+    changeMinor: cur - prev,
+    changePct: changePct(cur, prev),
+  });
+
+  const rows: TopCategoryShare[] = [];
+  for (const root of roots) {
+    const kids: CategoryShare[] = [];
+    let cur = current.get(root.id) ?? 0;
+    let prev = previous.get(root.id) ?? 0;
+    const walk = (list: ReportCategory[], depth: number, seen: Set<string>) => {
+      for (const c of sorted(list)) {
+        if (seen.has(c.id)) continue;
+        seen.add(c.id);
+        const a = current.get(c.id) ?? 0;
+        const p = previous.get(c.id) ?? 0;
+        cur += a;
+        prev += p;
+        const sub = children.get(c.id) ?? [];
+        const before = kids.length;
+        kids.push(share(c.id, c.name, depth, a, p));
+        walk(sub, depth + 1, seen);
+        // Kendisi ve altı boşsa satırı çıkar.
+        if (a === 0 && p === 0 && kids.length === before + 1) kids.pop();
+      }
+    };
+    walk(children.get(root.id) ?? [], 1, new Set([root.id]));
+    if (cur === 0 && prev === 0) continue;
+    rows.push({
+      ...share(root.id, root.name, 0, cur, prev),
+      ownMinor: current.get(root.id) ?? 0,
+      children: kids,
+    });
+  }
+  rows.sort((a, b) => b.amountMinor - a.amountMinor || a.name.localeCompare(b.name, "tr"));
+  return { totalMinor, prevTotalMinor, rows };
+}
+
+// --- Alışveriş raporları ---
+
+/** Rapor dönemi: içinde bulunulan dahil son N bütçe ayı. */
+export const REPORT_PERIODS = [3, 6, 12] as const;
+export type ReportPeriod = (typeof REPORT_PERIODS)[number];
+
+export const parsePeriod = (x: unknown): ReportPeriod =>
+  REPORT_PERIODS.includes(Number(x) as ReportPeriod) ? (Number(x) as ReportPeriod) : 6;
+
+/**
+ * Gider alıcısını mağaza adına eşler: Türkçe katlanmış alıcı adı mağaza adıyla başlıyorsa
+ * (en uzun eşleşme). "Şok · Rasimpaşa" ve "ŞOK MARKET" → "Şok". Eşleşme yoksa null.
+ */
+export function matchStoreName(
+  payee: string,
+  storeNames: readonly string[],
+  fold: (s: string) => string,
+): string | null {
+  const p = fold(payee).trim();
+  if (!p) return null;
+  let best: string | null = null;
+  for (const name of storeNames) {
+    const n = fold(name).trim();
+    if (!n || !p.startsWith(n)) continue;
+    // Kelime sınırı: "a101x" "a101" ile eşleşmesin.
+    const next = p.charAt(n.length);
+    if (next && /[\p{L}\p{N}]/u.test(next)) continue;
+    if (!best || n.length > fold(best).length) best = name;
+  }
+  return best;
+}
+
+export type UnitPricePoint = {
+  month: string;
+  minMinor: number | null;
+  avgMinor: number | null;
+  count: number;
+};
+
+/** Ay başına en düşük ve ortalama birim fiyat (kayıt yoksa boş). Birim fiyat kesirli kuruş. */
+export function monthlyUnitPrices(
+  records: readonly { month: string; unitPriceMinor: number }[],
+  months: readonly string[],
+): UnitPricePoint[] {
+  return months.map((month) => {
+    const xs = records.filter((r) => r.month === month).map((r) => r.unitPriceMinor);
+    return {
+      month,
+      minMinor: xs.length ? Math.min(...xs) : null,
+      avgMinor: xs.length ? xs.reduce((a, b) => a + b, 0) / xs.length : null,
+      count: xs.length,
+    };
+  });
+}

src/shared/schemas/shopping.ts

@@ -0,0 +1,163 @@
+import { z } from "zod";
+import { tr } from "../../i18n/tr";
+import { parseMoney } from "../money";
+import { parseQuantity } from "../quantity";
+
+const s = tr.shopping.validation;
+const id = z.string().regex(/^[a-f0-9]{24}$/i);
+const optionalId = z
+  .string()
+  .regex(/^([a-f0-9]{24})?$/i)
+  .transform((x) => (x === "" ? null : x));
+
+/** Boş → null (1 paket / belirtilmemiş); dolu → binde bir pozitif tamsayı. */
+const optionalQuantity = z.preprocess(
+  (x) => (x === undefined || x === null || String(x).trim() === "" ? null : x),
+  z
+    .string()
+    .trim()
+    .transform((x, ctx) => {
+      const q = parseQuantity(x);
+      if (q === null || q <= 0) {
+        ctx.addIssue({ code: "custom", message: s.quantity });
+        return z.NEVER;
+      }
+      return q;
+    })
+    .nullable(),
+);
+
+export const shoppingListFormSchema = z.object({
+  name: z.string().trim().min(1, tr.common.required).max(80, tr.validation.nameMax),
+  note: z.string().trim().max(300).default(""),
+});
+export type ShoppingListFormInput = z.input<typeof shoppingListFormSchema>;
+export type ShoppingListForm = z.output<typeof shoppingListFormSchema>;
+
+/** Kalem: ürün tipi, belirli ürün (marka/paket) ya da serbest metin. */
+export const shoppingItemFormSchema = z
+  .object({
+    kind: z.enum(["type", "product", "text"]),
+    productTypeId: optionalId.default(""),
+    productId: optionalId.default(""),
+    text: z.string().trim().max(120).default(""),
+    quantity: optionalQuantity.default(null),
+    unit: z.string().trim().max(20).default(""),
+    note: z.string().trim().max(200).default(""),
+  })
+  .superRefine((x, ctx) => {
+    if (x.kind === "type" && !x.productTypeId)
+      ctx.addIssue({ code: "custom", path: ["productTypeId"], message: s.productType });
+    if (x.kind === "product" && !x.productId)
+      ctx.addIssue({ code: "custom", path: ["productId"], message: s.product });
+    if (x.kind === "text" && !x.text)
+      ctx.addIssue({ code: "custom", path: ["text"], message: s.text });
+  })
+  .transform((x) => ({
+    ...x,
+    productTypeId: x.kind === "type" ? x.productTypeId : null,
+    productId: x.kind === "product" ? x.productId : null,
+    text: x.kind === "text" ? x.text : "",
+    unit: x.kind === "text" ? x.unit : "",
+  }));
+export type ShoppingItemFormInput = z.input<typeof shoppingItemFormSchema>;
+export type ShoppingItemForm = z.output<typeof shoppingItemFormSchema>;
+
+/** Kalem düzenleme: miktar ve not (serbest metinde metin ve birim de). */
+export const shoppingItemUpdateSchema = z.object({
+  quantity: optionalQuantity.default(null),
+  text: z.string().trim().max(120).default(""),
+  unit: z.string().trim().max(20).default(""),
+  note: z.string().trim().max(200).default(""),
+});
+export type ShoppingItemUpdate = z.output<typeof shoppingItemUpdateSchema>;
+
+export const shoppingItemRefSchema = z.object({ listId: id, itemId: id });
+
+const positiveQuantity = z
+  .string()
+  .trim()
+  .transform((x, ctx) => {
+    const q = parseQuantity(x);
+    if (q === null || q <= 0) {
+      ctx.addIssue({ code: "custom", message: s.quantity });
+      return z.NEVER;
+    }
+    return q;
+  });
+
+const amount = z
+  .string()
+  .trim()
+  .transform((x, ctx) => {
+    const minor = parseMoney(x);
+    if (minor === null || minor <= 0) {
+      ctx.addIssue({ code: "custom", message: s.amount });
+      return z.NEVER;
+    }
+    return minor;
+  });
+
+/**
+ * Alışverişi tamamla. Satır: liste kalemi (itemId) ya da plansız ekstra (itemId boş). Ürün
+ * kaleminde/ekstrada ürün zorunlu; serbest metin kaleminde ürün yok. Tutar satırın ödenen tutarı.
+ */
+export const shoppingCompletionSchema = z
+  .object({
+    date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, tr.validation.date),
+    lines: z
+      .array(
+        z.object({
+          itemId: optionalId.default(""),
+          productId: optionalId.default(""),
+          storeId: id,
+          packages: positiveQuantity,
+          amount,
+        }),
+      )
+      .min(1, s.noLines)
+      .max(200),
+    stores: z
+      .array(
+        z.object({
+          storeId: id,
+          accountId: z.string().regex(/^[a-f0-9]{24}$/i, s.account),
+          attachmentIds: z.array(id).max(10).default([]),
+        }),
+      )
+      .max(10),
+    /** Gider kategorisine eşlenmemiş stok kategorilerindeki kalemler için. */
+    fallbackCategoryId: optionalId.default(""),
+    leftover: z.object({
+      action: z.enum(["move", "new", "drop"]),
+      targetListId: optionalId.default(""),
+      newListName: z.string().trim().max(80).default(""),
+    }),
+  })
+  .superRefine((x, ctx) => {
+    const items = x.lines.map((l) => l.itemId).filter(Boolean);
+    if (new Set(items).size !== items.length)
+      ctx.addIssue({ code: "custom", path: ["lines"], message: s.duplicateLine });
+    x.lines.forEach((l, i) => {
+      if (!l.itemId && !l.productId)
+        ctx.addIssue({ code: "custom", path: ["lines", i, "productId"], message: s.product });
+    });
+    const stores = new Set(x.stores.map((st) => st.storeId));
+    if (stores.size !== x.stores.length)
+      ctx.addIssue({ code: "custom", path: ["stores"], message: s.duplicateStore });
+    for (const l of x.lines)
+      if (!stores.has(l.storeId)) {
+        ctx.addIssue({ code: "custom", path: ["stores"], message: s.account });
+        break;
+      }
+    if (x.leftover.action === "move" && !x.leftover.targetListId)
+      ctx.addIssue({ code: "custom", path: ["leftover", "targetListId"], message: s.targetList });
+    if (x.leftover.action === "new" && !x.leftover.newListName)
+      ctx.addIssue({
+        code: "custom",
+        path: ["leftover", "newListName"],
+        message: tr.common.required,
+      });
+  });
+export type ShoppingCompletionInput = z.input<typeof shoppingCompletionSchema>;
+export type ShoppingCompletionForm = z.output<typeof shoppingCompletionSchema>;

src/shared/schemas/stock.ts

@@ -77,6 +77,8 @@ export const productTypeFormSchema = z.object({
   step: quantity(),
   countEveryDays,
   note: z.string().trim().max(300).default(""),
+  /** Ağır/hacimli: akıllı mağaza önerisinde taşıma cezası. */
+  bulky: z.boolean().default(false),
   /** Yalnızca yeni ürün tipinde: evdeki başlangıç miktarı. */
   initialQuantity: optionalQuantity.default(null),
 });

src/shared/shopping-compare.test.ts

@@ -0,0 +1,75 @@
+import { describe, expect, it } from "vitest";
+import { compareShopping, matchKind, type ComparisonRow } from "./shopping-compare";
+
+const plan = (productId: string, packages: number, priceMinor: number) => ({
+  productId,
+  packages: packages * 1000,
+  priceMinor,
+  costMinor: packages * priceMinor,
+});
+const actual = (productId: string | null, packages: number, amountMinor: number) => ({
+  productId,
+  packages: packages * 1000,
+  amountMinor,
+});
+
+describe("matchKind", () => {
+  it("ürün tipi kalemi: planlanan marka aynı, başka marka muadil, plan yoksa aynı", () => {
+    const item = { kind: "type" as const, productId: null };
+    expect(matchKind(item, plan("a", 1, 100), actual("a", 1, 100))).toBe("same");
+    expect(matchKind(item, plan("a", 1, 100), actual("b", 1, 100))).toBe("substitute");
+    expect(matchKind(item, null, actual("b", 1, 100))).toBe("same");
+    expect(matchKind(item, plan("a", 1, 100), null)).toBe("skipped");
+  });
+
+  it("ürün kalemi başka ürünle muadil; serbest metin alındıysa aynı; listede yoksa ekstra", () => {
+    expect(matchKind({ kind: "product", productId: "a" }, null, actual("c", 1, 100))).toBe(
+      "substitute",
+    );
+    expect(matchKind({ kind: "text", productId: null }, null, actual(null, 1, 100))).toBe("same");
+    expect(matchKind(null, null, actual("x", 1, 100))).toBe("extra");
+  });
+});
+
+describe("compareShopping", () => {
+  it("fark nedenlere ayrışır ve toplamı farka eşittir", () => {
+    const rows: ComparisonRow[] = [
+      // Aynı ürün: 2 paket planlandı (100), 3 alındı ve paket 110 → fiyat +30, miktar +100.
+      { match: "same", plan: plan("a", 2, 100), actual: actual("a", 3, 330) },
+      // Muadil: plan 200, gerçek 180.
+      { match: "substitute", plan: plan("b", 1, 200), actual: actual("b2", 1, 180) },
+      // Alınmadı: −50.
+      { match: "skipped", plan: plan("c", 1, 50), actual: null },
+      // Fiyatı bilinmeyen kalem alındı: +40.
+      { match: "same", plan: null, actual: actual("d", 1, 40) },
+      // Ekstra: +75.
+      { match: "extra", plan: null, actual: actual("e", 1, 75) },
+    ];
+    const s = compareShopping(rows);
+    expect(s.plannedMinor).toBe(200 + 200 + 50);
+    expect(s.actualMinor).toBe(330 + 180 + 40 + 75);
+    expect(s.reasons).toEqual({
+      price: 30,
+      quantity: 100,
+      substitute: -20,
+      skipped: -50,
+      extra: 75,
+      unplanned: 40,
+    });
+    const sum = Object.values(s.reasons).reduce((a, b) => a + b, 0);
+    expect(sum).toBe(s.diffMinor);
+    expect(s.counts).toEqual({ same: 2, substitute: 1, skipped: 1, extra: 1 });
+  });
+
+  it("kesirli paket: plan fiyatıyla beklenen yuvarlanır, toplam yine tam", () => {
+    const s = compareShopping([
+      {
+        match: "same",
+        plan: plan("a", 1, 999),
+        actual: { productId: "a", packages: 1500, amountMinor: 1500 },
+      },
+    ]);
+    expect(s.reasons.price + s.reasons.quantity).toBe(s.diffMinor);
+    expect(s.reasons.quantity).toBe(1499 - 999);
+  });
+});

src/shared/shopping-compare.ts

@@ -0,0 +1,115 @@
+/**
+ * Alışveriş sonrası karşılaştırma (Bölüm 6.12). Saf fonksiyonlar.
+ *
+ * Her liste kalemi için: aynı (planlanan ürün alındı), muadil (aynı ürün tipinde başka marka/paket),
+ * alınmadı; listede olmayanlar plansız ekstra. Planlanan tutar, tamamlama anındaki akıllı önerinin
+ * (önerilen dağılım) kalem maliyetidir; fiyatı bilinmeyen kalemin planı yoktur.
+ *
+ * Fark (gerçek − plan) nedenlere ayrıştırılır ve toplamları farka tam eşittir:
+ *   - fiyat: aynı ürünün paket fiyatı farkı × alınan paket,
+ *   - miktar: (alınan − planlanan paket) × planlanan paket fiyatı,
+ *   - muadil: muadil kalemlerde gerçek − plan,
+ *   - alınmayan: alınmayan planlı kalemlerin planı (eksi),
+ *   - ekstra: plansız ekstraların tutarı,
+ *   - fiyatsız: planı olmayan (fiyatı bilinmeyen) kalemlerin tutarı.
+ */
+
+export const MATCH_KINDS = ["same", "substitute", "skipped", "extra"] as const;
+export type MatchKind = (typeof MATCH_KINDS)[number];
+
+/** Liste kalemi veya ekstra için gerçekleşen alım. Paket adedi binde bir. */
+export type ActualPurchase = { productId: string | null; packages: number; amountMinor: number };
+
+/** Akıllı önerinin kalem için planı. */
+export type PlannedPurchase = {
+  productId: string;
+  packages: number;
+  priceMinor: number;
+  costMinor: number;
+};
+
+/**
+ * Kalemin eşleşmesi. Ürün kalemi: aynı ürün → aynı. Ürün tipi kalemi: planlanan markayla aynı
+ * ürün (ya da plan yoksa herhangi bir ürün) → aynı; başka marka/paket → muadil. Serbest metin
+ * kalemi alındıysa aynı.
+ */
+export function matchKind(
+  item: { kind: "type" | "product" | "text"; productId: string | null } | null,
+  plan: PlannedPurchase | null,
+  actual: ActualPurchase | null,
+): MatchKind {
+  if (!item) return "extra";
+  if (!actual) return "skipped";
+  if (item.kind === "text") return "same";
+  const expected = item.kind === "product" ? item.productId : (plan?.productId ?? null);
+  return expected === null || expected === actual.productId ? "same" : "substitute";
+}
+
+export type ComparisonRow = {
+  match: MatchKind;
+  plan: PlannedPurchase | null;
+  actual: ActualPurchase | null;
+};
+
+export type ComparisonReasons = {
+  price: number;
+  quantity: number;
+  substitute: number;
+  skipped: number;
+  extra: number;
+  unplanned: number;
+};
+
+export type ComparisonSummary = {
+  plannedMinor: number;
+  actualMinor: number;
+  diffMinor: number;
+  reasons: ComparisonReasons;
+  counts: Record<MatchKind, number>;
+};
+
+export function compareShopping(rows: readonly ComparisonRow[]): ComparisonSummary {
+  const reasons: ComparisonReasons = {
+    price: 0,
+    quantity: 0,
+    substitute: 0,
+    skipped: 0,
+    extra: 0,
+    unplanned: 0,
+  };
+  const counts: Record<MatchKind, number> = { same: 0, substitute: 0, skipped: 0, extra: 0 };
+  let plannedMinor = 0;
+  let actualMinor = 0;
+  for (const r of rows) {
+    counts[r.match]++;
+    if (r.plan) plannedMinor += r.plan.costMinor;
+    if (r.actual) actualMinor += r.actual.amountMinor;
+    switch (r.match) {
+      case "extra":
+        reasons.extra += r.actual?.amountMinor ?? 0;
+        break;
+      case "skipped":
+        reasons.skipped -= r.plan?.costMinor ?? 0;
+        break;
+      case "substitute":
+        if (r.plan) reasons.substitute += r.actual!.amountMinor - r.plan.costMinor;
+        else reasons.unplanned += r.actual!.amountMinor;
+        break;
+      case "same": {
+        const a = r.actual!;
+        if (!r.plan || a.productId !== r.plan.productId) {
+          // Plansız (fiyatı bilinmeyen) ya da serbest metin.
+          if (r.plan) reasons.substitute += a.amountMinor - r.plan.costMinor;
+          else reasons.unplanned += a.amountMinor;
+          break;
+        }
+        // Paket adedi binde bir: plan fiyatıyla beklenen = paket × fiyat.
+        const expectedAtPlanPrice = Math.round((a.packages * r.plan.priceMinor) / 1000);
+        reasons.price += a.amountMinor - expectedAtPlanPrice;
+        reasons.quantity += expectedAtPlanPrice - r.plan.costMinor;
+        break;
+      }
+    }
+  }
+  return { plannedMinor, actualMinor, diffMinor: actualMinor - plannedMinor, reasons, counts };
+}

src/shared/shopping-plan.test.ts

@@ -0,0 +1,269 @@
+import { describe, expect, it } from "vitest";
+import {
+  BULKY_PENALTY_PER_POINT,
+  planShopping,
+  VISIT_PENALTY_PER_POINT,
+  type PlanInput,
+  type PlanItem,
+  type PlanOffer,
+  type PlanStore,
+} from "./shopping-plan";
+import { effortScore } from "./stores";
+
+const store = (id: string, over: Partial<PlanStore> = {}): PlanStore => ({
+  id,
+  kind: "market",
+  distanceM: 0,
+  carryDifficulty: 1,
+  deliveryFeeMinor: null,
+  freeDeliveryMinMinor: null,
+  mealCardProviders: [],
+  ...over,
+});
+
+const item = (
+  id: string,
+  type: string,
+  quantity = 1000,
+  over: Partial<PlanItem> = {},
+): PlanItem => ({
+  id,
+  productTypeId: type,
+  quantity,
+  productId: null,
+  bulky: false,
+  ...over,
+});
+
+const offer = (
+  storeId: string,
+  type: string,
+  priceMinor: number,
+  over: Partial<PlanOffer> = {},
+): PlanOffer => ({
+  productId: `${type}-p`,
+  productTypeId: type,
+  storeId,
+  priceMinor,
+  inTypeUnit: 1000,
+  ...over,
+});
+
+const base = (over: Partial<PlanInput>): PlanInput => ({
+  items: [],
+  offers: [],
+  stores: [],
+  mealCards: [],
+  extraStoreThresholdMinor: 10_000,
+  ...over,
+});
+
+const storesOf = (o: { stores: { storeId: string }[] } | null) => o?.stores.map((s) => s.storeId);
+
+describe("planShopping", () => {
+  it("fiyatı olmayan kalemler ayrılır; hiç fiyat yoksa plan yok", () => {
+    const r = planShopping(base({ items: [item("i1", "t1")], stores: [store("A")] }));
+    expect(r.recommended).toBeNull();
+    expect(r.single).toBeNull();
+    expect(r.unpriced).toEqual(["i1"]);
+  });
+
+  it("paket sayısı ihtiyaca göre yukarı yuvarlanır; mağazada en az harcamalı paket seçilir", () => {
+    const r = planShopping(
+      base({
+        items: [item("i1", "t1", 2500)],
+        stores: [store("A")],
+        offers: [
+          offer("A", "t1", 3000, { productId: "small", inTypeUnit: 1000 }),
+          // Birim fiyatı daha ucuz ama 5 birimlik paket: harcama 12.000 > 3 × 3.000.
+          offer("A", "t1", 12_000, { productId: "big", inTypeUnit: 5000 }),
+        ],
+      }),
+    );
+    const line = r.recommended!.stores[0]!.lines[0]!;
+    expect(line).toMatchObject({ productId: "small", packages: 3, costMinor: 9000 });
+    // En ucuz birim fiyat bilgisi büyük paketi gösterir.
+    expect(r.cheapest.i1!.productId).toBe("big");
+  });
+
+  it("belirli marka istenen kalemde yalnızca o ürünün fiyatı kullanılır", () => {
+    const r = planShopping(
+      base({
+        items: [item("i1", "t1", 1000, { productId: "ariel" })],
+        stores: [store("A"), store("B")],
+        offers: [
+          offer("A", "t1", 5000, { productId: "ariel" }),
+          offer("B", "t1", 3000, { productId: "omo" }),
+        ],
+      }),
+    );
+    expect(storesOf(r.recommended)).toEqual(["A"]);
+    expect(r.recommended!.totalMinor).toBe(5000);
+  });
+
+  it("tasarruf eşiği aşılmazsa tek mağazada toplar", () => {
+    const r = planShopping(
+      base({
+        items: [item("i1", "t1"), item("i2", "t2")],
+        stores: [store("A"), store("B")],
+        offers: [
+          offer("A", "t1", 10_000),
+          offer("A", "t2", 10_000),
+          offer("B", "t1", 9_000),
+          offer("B", "t2", 10_500),
+        ],
+        extraStoreThresholdMinor: 10_000,
+      }),
+    );
+    // A: 200 TL, B: 195 TL tek başına; ikisi birden 190 TL (5 TL fark < 100 TL eşik).
+    expect(storesOf(r.single)).toEqual(["B"]);
+    expect(storesOf(r.recommended)).toEqual(["B"]);
+    expect(r.savingMinor).toBe(0);
+  });
+
+  it("tasarruf eşiği aşılırsa ek mağaza önerilir", () => {
+    const r = planShopping(
+      base({
+        items: [item("i1", "t1"), item("i2", "t2"), item("i3", "t3")],
+        stores: [store("A"), store("B")],
+        offers: [
+          offer("A", "t1", 50_000),
+          offer("A", "t2", 50_000),
+          offer("A", "t3", 50_000),
+          offer("B", "t1", 30_000),
+          offer("B", "t2", 60_000),
+          offer("B", "t3", 60_000),
+        ],
+        extraStoreThresholdMinor: 10_000,
+      }),
+    );
+    expect(storesOf(r.single)).toEqual(["A"]);
+    expect(r.recommended!.stores.map((s) => [s.storeId, s.lines.length])).toEqual([
+      ["A", 2],
+      ["B", 1],
+    ]);
+    expect(r.recommended!.totalMinor).toBe(130_000);
+    expect(r.savingMinor).toBe(20_000);
+  });
+
+  it("tek mağaza her şeyi karşılamıyorsa en az mağazalı eksiksiz plan önerilir", () => {
+    const r = planShopping(
+      base({
+        items: [item("i1", "t1"), item("i2", "t2")],
+        stores: [store("A"), store("B")],
+        offers: [offer("A", "t1", 1000), offer("B", "t2", 1000)],
+      }),
+    );
+    expect(r.single!.missing).toHaveLength(1);
+    expect(r.recommended!.missing).toEqual([]);
+    expect(r.recommended!.stores).toHaveLength(2);
+    expect(r.savingMinor).toBeNull();
+  });
+
+  it("uzaklık ve taşıma güçlüğü ziyaret cezası olarak puana eklenir", () => {
+    const far = store("FAR", { distanceM: 20_000, carryDifficulty: 5 });
+    const near = store("NEAR");
+    const r = planShopping(
+      base({
+        items: [item("i1", "t1")],
+        stores: [far, near],
+        offers: [offer("FAR", "t1", 10_000), offer("NEAR", "t1", 13_000)],
+      }),
+    );
+    // FAR 30 TL ucuz ama zahmet 100 → 50 TL ceza.
+    expect(effortScore(far) * VISIT_PENALTY_PER_POINT).toBe(5000);
+    expect(storesOf(r.recommended)).toEqual(["NEAR"]);
+    expect(storesOf(r.single)).toEqual(["NEAR"]);
+  });
+
+  it("hacimli kalemler zahmetli fiziksel mağaza yerine online'a yönelir", () => {
+    const hard = store("HARD", { distanceM: 10_000, carryDifficulty: 5 });
+    const online = store("ONLINE", { kind: "online", distanceM: null, deliveryFeeMinor: 0 });
+    const items = [item("water", "w", 1000, { bulky: true }), item("bread", "b")];
+    const offers = [
+      offer("HARD", "w", 10_000),
+      offer("ONLINE", "w", 10_500),
+      offer("HARD", "b", 1000),
+    ];
+    const bulky = planShopping(
+      base({ items, stores: [hard, online], offers, extraStoreThresholdMinor: 0 }),
+    );
+    const line = bulky.recommended!.stores.find((s) => s.storeId === "ONLINE")?.lines[0];
+    expect(line?.itemId).toBe("water");
+    // Aynı kalem hacimli değilse 5 TL ucuz olan HARD seçilir.
+    const plain = planShopping(
+      base({
+        items: [item("water", "w"), item("bread", "b")],
+        stores: [hard, online],
+        offers,
+        extraStoreThresholdMinor: 0,
+      }),
+    );
+    expect(storesOf(plain.recommended)).toEqual(["HARD"]);
+    expect(effortScore(hard) * BULKY_PENALTY_PER_POINT).toBeGreaterThan(500);
+  });
+
+  it("online teslimat ücreti ücretsiz teslimat limitinin altında eklenir", () => {
+    const online = store("ON", {
+      kind: "online",
+      distanceM: null,
+      deliveryFeeMinor: 3000,
+      freeDeliveryMinMinor: 50_000,
+    });
+    const shop = store("SHOP");
+    const offers = [offer("ON", "t1", 10_000), offer("SHOP", "t1", 11_000)];
+    const small = planShopping(base({ items: [item("i1", "t1")], stores: [online, shop], offers }));
+    // 100 TL + 30 TL teslimat > 110 TL.
+    expect(storesOf(small.recommended)).toEqual(["SHOP"]);
+    const big = planShopping(
+      base({ items: [item("i1", "t1", 5000)], stores: [online, shop], offers }),
+    );
+    // 500 TL ≥ limit: teslimat ücretsiz, online 50 TL ucuz.
+    expect(storesOf(big.recommended)).toEqual(["ON"]);
+    expect(big.recommended!.stores[0]!.deliveryFeeMinor).toBe(0);
+  });
+
+  it("yemek kartı bakiyesi varsa fiyatı yakın kalemler kart geçen mağazaya yönelir", () => {
+    const meal = store("MEAL", { mealCardProviders: ["multinet"] });
+    const other = store("OTHER");
+    const offers = [offer("MEAL", "t1", 10_300), offer("OTHER", "t1", 10_000)];
+    const items = [item("i1", "t1")];
+    const without = planShopping(base({ items, stores: [meal, other], offers }));
+    expect(storesOf(without.recommended)).toEqual(["OTHER"]);
+    const withCard = planShopping(
+      base({
+        items,
+        stores: [meal, other],
+        offers,
+        mealCards: [{ provider: "multinet", balanceMinor: 50_000 }],
+      }),
+    );
+    expect(storesOf(withCard.recommended)).toEqual(["MEAL"]);
+    expect(withCard.recommended!.mealCardMinor).toBe(10_300);
+    // Kart sağlayıcısı mağazada geçmiyorsa öncelik yok.
+    const wrong = planShopping(
+      base({
+        items,
+        stores: [meal, other],
+        offers,
+        mealCards: [{ provider: "sodexo", balanceMinor: 50_000 }],
+      }),
+    );
+    expect(storesOf(wrong.recommended)).toEqual(["OTHER"]);
+  });
+
+  it("yemek kartı bakiyesi mağazalar arasında bir kez harcanır", () => {
+    const a = store("A", { mealCardProviders: ["multinet"] });
+    const b = store("B", { mealCardProviders: ["multinet"] });
+    const r = planShopping(
+      base({
+        items: [item("i1", "t1"), item("i2", "t2")],
+        stores: [a, b],
+        offers: [offer("A", "t1", 30_000), offer("B", "t2", 20_000)],
+        mealCards: [{ provider: "multinet", balanceMinor: 40_000 }],
+      }),
+    );
+    expect(r.recommended!.mealCardMinor).toBe(40_000);
+    expect(r.recommended!.stores.map((s) => s.mealCardMinor).sort()).toEqual([10_000, 30_000]);
+  });
+});

src/shared/shopping-plan.ts

@@ -0,0 +1,307 @@
+import { effortScore, type StoreKind } from "./stores";
+
+/**
+ * Akıllı mağaza önerisi (Bölüm 6.12). Saf fonksiyon; son bilinen fiyatlarla listedeki her kalemi
+ * bir mağazaya ve markaya dağıtır.
+ *
+ * Kalem maliyeti: ihtiyacı karşılayan paket sayısı × paket fiyatı (gerçek harcama). Bir mağazada
+ * birden çok marka/paket varsa en az harcamalı olan, eşitlikte birim fiyatı düşük olan seçilir.
+ *
+ * Planın puanı (küçük olan iyi) = harcama + teslimat ücretleri + zahmet cezaları − yemek kartı payı:
+ *   - Ziyaret cezası: fiziksel mağaza başına zahmet skoru × ZİYARET_KATSAYISI (online: 0).
+ *   - Hacimli kalem cezası: fiziksel mağazada hacimli kalem başına zahmet skoru × HACİMLİ_KATSAYI.
+ *   - Online teslimat: ara toplam ücretsiz teslimat alt limitinin altındaysa (limit yoksa her
+ *     zaman) teslimat ücreti eklenir.
+ *   - Yemek kartı önceliği: yemek kartı geçen mağazalarda kartla ödenebilecek tutarın
+ *     MEAL_CARD_PREFERENCE_PCT'si puandan düşülür; böylece fiyatı yakın kalemler karta yönelir.
+ *
+ * Seçim: tüm fiyatlı kalemleri karşılayan en az mağazalı plandan başlanır; bir mağaza daha
+ * eklemek ancak puanı eşikten (hane ayarı) fazla düşürüyorsa kabul edilir.
+ */
+
+/** Ziyaret cezası: zahmet puanı başına kuruş (zahmet 100 → 50 TL). */
+export const VISIT_PENALTY_PER_POINT = 50;
+/** Hacimli kalem cezası: zahmet puanı başına kuruş (zahmet 100 → kalem başına 15 TL). */
+export const BULKY_PENALTY_PER_POINT = 15;
+/** Yemek kartıyla ödenebilecek tutarın puandan düşülen yüzdesi. */
+export const MEAL_CARD_PREFERENCE_PCT = 10;
+/** Bir planda en fazla bu kadar mağaza. */
+export const MAX_PLAN_STORES = 4;
+
+export type PlanStore = {
+  id: string;
+  kind: StoreKind;
+  distanceM: number | null;
+  carryDifficulty: number;
+  deliveryFeeMinor: number | null;
+  freeDeliveryMinMinor: number | null;
+  /** Yemek kartı geçmiyorsa boş. */
+  mealCardProviders: readonly string[];
+};
+
+export type PlanOffer = {
+  productId: string;
+  productTypeId: string;
+  storeId: string;
+  /** Paket fiyatı (kuruş). */
+  priceMinor: number;
+  /** Bir paketin ürün tipi birimindeki miktarı (binde bir). */
+  inTypeUnit: number;
+};
+
+export type PlanItem = {
+  id: string;
+  productTypeId: string;
+  /** Gereken miktar, ürün tipi biriminde (binde bir). */
+  quantity: number;
+  /** Belirli marka/ürün istenmişse yalnızca o ürünün fiyatları. */
+  productId: string | null;
+  bulky: boolean;
+};
+
+export type PlanMealCard = { provider: string; balanceMinor: number };
+
+export type PlanInput = {
+  items: readonly PlanItem[];
+  offers: readonly PlanOffer[];
+  stores: readonly PlanStore[];
+  mealCards: readonly PlanMealCard[];
+  /** Ek mağaza eşiği (kuruş). */
+  extraStoreThresholdMinor: number;
+};
+
+export type PlanLine = {
+  itemId: string;
+  productId: string;
+  storeId: string;
+  packages: number;
+  priceMinor: number;
+  costMinor: number;
+  /** Ürün tipi biriminde 1 birimin fiyatı (kesirli kuruş). */
+  unitPriceMinor: number;
+  bulkyPenaltyMinor: number;
+};
+
+export type PlanStoreGroup = {
+  storeId: string;
+  lines: PlanLine[];
+  subtotalMinor: number;
+  deliveryFeeMinor: number;
+  visitPenaltyMinor: number;
+  /** Bu mağazada yemek kartıyla ödenebilecek tutar. */
+  mealCardMinor: number;
+};
+
+export type PlanOption = {
+  stores: PlanStoreGroup[];
+  /** Harcama + teslimat. */
+  totalMinor: number;
+  /** Zahmet cezaları (ziyaret + hacimli). */
+  penaltyMinor: number;
+  mealCardMinor: number;
+  /** Karşılaştırma puanı (kesirli olabilir). */
+  score: number;
+  /** Bu planda alınamayan (fiyatlı) kalemler. */
+  missing: string[];
+};
+
+export type PlanResult = {
+  /** Tek mağazanın en iyisi (hepsini karşılayan yoksa en çok kalemi karşılayan). */
+  single: PlanOption | null;
+  /** Önerilen dağılım; tek mağaza en iyiyse onunla aynı. */
+  recommended: PlanOption | null;
+  /** Tek mağazaya göre harcama farkı (pozitif = tasarruf); karşılaştırılamıyorsa null. */
+  savingMinor: number | null;
+  /** Hiçbir mağazada fiyatı bilinmeyen kalemler. */
+  unpriced: string[];
+  /** Kalem başına birim fiyatı en düşük teklif (mağaza ve marka). */
+  cheapest: Record<string, PlanLine>;
+};
+
+const unitOf = (o: PlanOffer) => (o.priceMinor * 1000) / o.inTypeUnit;
+
+/** Bir teklifle kalemi karşılamak: paket sayısı ve harcama. */
+function lineFor(item: PlanItem, o: PlanOffer, store: PlanStore): PlanLine {
+  const packages = Math.max(1, Math.ceil(item.quantity / o.inTypeUnit));
+  const physical = store.kind !== "online";
+  return {
+    itemId: item.id,
+    productId: o.productId,
+    storeId: o.storeId,
+    packages,
+    priceMinor: o.priceMinor,
+    costMinor: packages * o.priceMinor,
+    unitPriceMinor: unitOf(o),
+    bulkyPenaltyMinor: item.bulky && physical ? effortScore(store) * BULKY_PENALTY_PER_POINT : 0,
+  };
+}
+
+const better = (a: PlanLine, b: PlanLine) =>
+  a.costMinor !== b.costMinor ? a.costMinor < b.costMinor : a.unitPriceMinor < b.unitPriceMinor;
+
+/** Mağazalardaki yemek kartı payı: kart bakiyeleri bir kez harcanır, büyük ara toplam önce. */
+function allocateMealCards(
+  groups: PlanStoreGroup[],
+  stores: Map<string, PlanStore>,
+  cards: readonly PlanMealCard[],
+) {
+  const left = cards.map((c) => ({ ...c }));
+  const order = [...groups].sort((a, b) => b.subtotalMinor - a.subtotalMinor);
+  for (const g of order) {
+    const accepted = new Set(stores.get(g.storeId)!.mealCardProviders);
+    let need = g.subtotalMinor + g.deliveryFeeMinor;
+    for (const c of left) {
+      if (need <= 0) break;
+      if (!accepted.has(c.provider) || c.balanceMinor <= 0) continue;
+      const use = Math.min(need, c.balanceMinor);
+      c.balanceMinor -= use;
+      need -= use;
+      g.mealCardMinor += use;
+    }
+  }
+}
+
+function* subsets(n: number, k: number, start = 0, acc: number[] = []): Generator<number[]> {
+  if (acc.length === k) {
+    yield [...acc];
+    return;
+  }
+  for (let i = start; i <= n - (k - acc.length); i++) {
+    acc.push(i);
+    yield* subsets(n, k, i + 1, acc);
+    acc.pop();
+  }
+}
+
+export function planShopping(input: PlanInput): PlanResult {
+  const storeById = new Map(input.stores.map((s) => [s.id, s]));
+  // Kalem × mağaza en iyi satır.
+  const best = new Map<string, Map<string, PlanLine>>();
+  const cheapest: Record<string, PlanLine> = {};
+  for (const item of input.items) {
+    const byStore = new Map<string, PlanLine>();
+    for (const o of input.offers) {
+      if (o.inTypeUnit <= 0 || o.productTypeId !== item.productTypeId) continue;
+      if (item.productId && o.productId !== item.productId) continue;
+      const store = storeById.get(o.storeId);
+      if (!store) continue;
+      const line = lineFor(item, o, store);
+      const prev = byStore.get(o.storeId);
+      if (!prev || better(line, prev)) byStore.set(o.storeId, line);
+      const c = cheapest[item.id];
+      if (!c || line.unitPriceMinor < c.unitPriceMinor) cheapest[item.id] = line;
+    }
+    best.set(item.id, byStore);
+  }
+  const priced = input.items.filter((i) => best.get(i.id)!.size > 0);
+  const unpriced = input.items.filter((i) => best.get(i.id)!.size === 0).map((i) => i.id);
+  const candidates = input.stores.filter((s) => priced.some((i) => best.get(i.id)!.has(s.id)));
+
+  if (priced.length === 0 || candidates.length === 0)
+    return { single: null, recommended: null, savingMinor: null, unpriced, cheapest };
+
+  function evaluate(chosen: PlanStore[]): PlanOption {
+    const groups = new Map<string, PlanStoreGroup>();
+    const missing: string[] = [];
+    for (const item of priced) {
+      const options = best.get(item.id)!;
+      let pick: PlanLine | null = null;
+      for (const s of chosen) {
+        const line = options.get(s.id);
+        if (!line) continue;
+        if (
+          !pick ||
+          line.costMinor + line.bulkyPenaltyMinor < pick.costMinor + pick.bulkyPenaltyMinor ||
+          (line.costMinor + line.bulkyPenaltyMinor === pick.costMinor + pick.bulkyPenaltyMinor &&
+            line.unitPriceMinor < pick.unitPriceMinor)
+        )
+          pick = line;
+      }
+      if (!pick) {
+        missing.push(item.id);
+        continue;
+      }
+      const g = groups.get(pick.storeId) ?? {
+        storeId: pick.storeId,
+        lines: [],
+        subtotalMinor: 0,
+        deliveryFeeMinor: 0,
+        visitPenaltyMinor: 0,
+        mealCardMinor: 0,
+      };
+      g.lines.push(pick);
+      g.subtotalMinor += pick.costMinor;
+      groups.set(pick.storeId, g);
+    }
+    const list = [...groups.values()];
+    for (const g of list) {
+      const s = storeById.get(g.storeId)!;
+      if (s.kind === "online") {
+        const fee = s.deliveryFeeMinor ?? 0;
+        const free = s.freeDeliveryMinMinor;
+        g.deliveryFeeMinor = free !== null && g.subtotalMinor >= free ? 0 : fee;
+      } else g.visitPenaltyMinor = effortScore(s) * VISIT_PENALTY_PER_POINT;
+    }
+    allocateMealCards(list, storeById, input.mealCards);
+    const totalMinor = list.reduce((a, g) => a + g.subtotalMinor + g.deliveryFeeMinor, 0);
+    const penaltyMinor = list.reduce(
+      (a, g) => a + g.visitPenaltyMinor + g.lines.reduce((b, l) => b + l.bulkyPenaltyMinor, 0),
+      0,
+    );
+    const mealCardMinor = list.reduce((a, g) => a + g.mealCardMinor, 0);
+    return {
+      stores: list.sort(
+        (a, b) => b.lines.length - a.lines.length || b.subtotalMinor - a.subtotalMinor,
+      ),
+      totalMinor,
+      penaltyMinor,
+      mealCardMinor,
+      score: totalMinor + penaltyMinor - (mealCardMinor * MEAL_CARD_PREFERENCE_PCT) / 100,
+      missing,
+    };
+  }
+
+  // Boyut başına en iyi tam (eksiksiz) plan; tek mağazada eksiksiz yoksa en çok kalemi karşılayan.
+  const bestBySize: (PlanOption | null)[] = [];
+  let single: PlanOption | null = null;
+  const maxK = Math.min(MAX_PLAN_STORES, candidates.length);
+  for (let k = 1; k <= maxK; k++) {
+    let top: PlanOption | null = null;
+    for (const idx of subsets(candidates.length, k)) {
+      const option = evaluate(idx.map((i) => candidates[i]!));
+      // Kullanılmayan mağaza içeren alt küme daha küçük boyutta zaten değerlendirildi.
+      if (option.stores.length < k) continue;
+      if (
+        k === 1 &&
+        (!single ||
+          option.missing.length < single.missing.length ||
+          (option.missing.length === single.missing.length && option.score < single.score))
+      )
+        single = option;
+      if (option.missing.length === 0 && (!top || option.score < top.score)) top = option;
+    }
+    bestBySize[k] = top;
+  }
+
+  let k = bestBySize.findIndex((o, i) => i > 0 && o !== null);
+  let recommended: PlanOption | null = k > 0 ? bestBySize[k]! : null;
+  // Tüm alt kümeler sınırı aştıysa (kalemler çok dağınık): en iyi eksikli plan.
+  if (!recommended) recommended = single;
+  else
+    while (k + 1 <= maxK) {
+      const next = bestBySize[k + 1];
+      if (!next || recommended.score - next.score <= input.extraStoreThresholdMinor) break;
+      recommended = next;
+      k++;
+    }
+
+  const comparable =
+    single && recommended && single.missing.length === 0 && recommended.missing.length === 0;
+  return {
+    single,
+    recommended,
+    savingMinor: comparable ? single!.totalMinor - recommended!.totalMinor : null,
+    unpriced,
+    cheapest,
+  };
+}

src/shared/shopping.test.ts

@@ -0,0 +1,28 @@
+import { describe, expect, it } from "vitest";
+import { requiredQuantity, suggestionHidden } from "./shopping";
+
+describe("requiredQuantity", () => {
+  it("ürün tipi kaleminde girilen miktar; boşsa 0", () => {
+    expect(requiredQuantity({ kind: "type", quantity: 2500 }, null)).toBe(2500);
+    expect(requiredQuantity({ kind: "type", quantity: null }, null)).toBe(0);
+  });
+
+  it("ürün kaleminde paket adedi × paketin tip karşılığı; boşsa 1 paket", () => {
+    // 2 paket × 50 yıkama
+    expect(requiredQuantity({ kind: "product", quantity: 2000 }, 50_000)).toBe(100_000);
+    expect(requiredQuantity({ kind: "product", quantity: null }, 500)).toBe(500);
+    expect(requiredQuantity({ kind: "product", quantity: 2000 }, null)).toBe(0);
+  });
+});
+
+describe("suggestionHidden", () => {
+  const d = (s: string) => new Date(s);
+  it("reddedilmemişse görünür", () => {
+    expect(suggestionHidden(null, null)).toBe(false);
+  });
+  it("redden sonra alım yoksa gizli, alım gelince yeniden görünür", () => {
+    expect(suggestionHidden(d("2026-11-01"), null)).toBe(true);
+    expect(suggestionHidden(d("2026-11-01"), d("2026-10-20"))).toBe(true);
+    expect(suggestionHidden(d("2026-11-01"), d("2026-11-03"))).toBe(false);
+  });
+});

src/shared/shopping.ts

@@ -0,0 +1,90 @@
+import { QUANTITY_SCALE } from "./quantity";
+
+/** Alışveriş listeleri (Bölüm 6.12): sabitler ve saf yardımcılar. */
+
+export const SHOPPING_LIST_STATUSES = ["active", "completed"] as const;
+export type ShoppingListStatus = (typeof SHOPPING_LIST_STATUSES)[number];
+
+export const SHOPPING_ITEM_KINDS = ["type", "product", "text"] as const;
+export type ShoppingItemKind = (typeof SHOPPING_ITEM_KINDS)[number];
+
+export const SHOPPING_ITEM_SOURCES = ["manual", "suggestion"] as const;
+export type ShoppingItemSource = (typeof SHOPPING_ITEM_SOURCES)[number];
+
+/** Aile üyeleri aynı listeyi kullanır: sayfa odaklanınca ve bu aralıkla yenilenir. */
+export const SHOPPING_REFRESH_MS = 30_000;
+
+/**
+ * Planlayıcı için gereken miktar (ürün tipi biriminde, binde bir):
+ * - ürün tipi kalemi: girilen miktar; boşsa 0 (en az bir paket alınır),
+ * - ürün kalemi: paket adedi × paketin tip birimindeki karşılığı.
+ */
+export function requiredQuantity(
+  item: { kind: ShoppingItemKind; quantity: number | null },
+  inTypeUnit: number | null,
+): number {
+  if (item.kind === "product") {
+    if (!inTypeUnit) return 0;
+    const packages = item.quantity ?? QUANTITY_SCALE;
+    return Math.round((packages * inTypeUnit) / QUANTITY_SCALE);
+  }
+  return item.quantity ?? 0;
+}
+
+/**
+ * Reddedilen eşik önerisi, reddedildikten sonra alım hareketi girilene (stok yenilenene) kadar
+ * gizli kalır; sonra ürün yine eşiğin altına düşerse öneri yeniden çıkar.
+ */
+export function suggestionHidden(dismissedAt: Date | null, lastPurchaseAt: Date | null): boolean {
+  if (!dismissedAt) return false;
+  return !lastPurchaseAt || lastPurchaseAt.getTime() <= dismissedAt.getTime();
+}
+
+/** Alınmayan kalemler: başka aktif listeye taşı, yeni liste aç ya da bırak. */
+export const LEFTOVER_ACTIONS = ["move", "new", "drop"] as const;
+export type LeftoverAction = (typeof LEFTOVER_ACTIONS)[number];
+
+/** Tamamlanan listede saklanan görüntü (etiketler tamamlama anındaki hâliyle). */
+export type CompletionRow = {
+  itemId: string | null;
+  match: "same" | "substitute" | "skipped" | "extra";
+  /** Kalem adı (liste kalemi ya da ekstra ürün). */
+  label: string;
+  /** Alınan: ürün etiketi ve paketi; serbest metinde boş. */
+  productId: string | null;
+  productLabel: string;
+  storeId: string | null;
+  storeLabel: string;
+  /** Paket adedi (binde bir). */
+  packages: number;
+  /** Alınan miktar metni ("4 paket", markasızda "2,5 kg"); alınmadıysa boş. */
+  quantityLabel?: string;
+  amountMinor: number | null;
+  plan: {
+    productId: string;
+    productLabel: string;
+    storeId: string;
+    storeLabel: string;
+    packages: number;
+    priceMinor: number;
+    costMinor: number;
+  } | null;
+};
+
+export type CompletionStore = {
+  storeId: string;
+  label: string;
+  accountId: string;
+  accountName: string;
+  transactionId: string;
+  amountMinor: number;
+  attachmentCount: number;
+};
+
+export type ShoppingCompletion = {
+  date: string;
+  completedBy: string;
+  rows: CompletionRow[];
+  stores: CompletionStore[];
+  movedTo: { listId: string; name: string } | null;
+};