feat(stock): sayım oturumları, fire ayarlı öneri motoru ve tüketim analizi

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

scripts/seed/stock.ts

@@ -2,6 +2,7 @@ import { Types } from "mongoose";
 import { installDefaultStockCategories } from "@/features/stock/service";
 import { ProductTypeModel } from "@/models/product-type";
 import { StockCategoryModel } from "@/models/stock-category";
+import { StockCountModel } from "@/models/stock-count";
 import { StockMovementModel } from "@/models/stock-movement";
 import { todayIstanbul } from "@/shared/dates";
 import { addDays } from "@/shared/recurrence";
@@ -9,8 +10,10 @@ import { foldTr } from "@/shared/search";
 
 /**
  * Örnek ev stoğu (Faz 11). Varsayılan stok kategorileri her haneye; Çakır Ailesi'ne ürün tipleri
- * ve son 6 ayın haftalık tüketim simülasyonu (alım, tüketim, fire, sayım, SKT). Deterministik;
- * idempotent: ürün tipi `seedRef` ile bir kez oluşturulur. Miktarlar binde bir.
+ * ve son 6 ayın haftalık tüketim simülasyonu (alım, tüketim, fire, periyodik sayım, SKT).
+ * Sayım: Mutfak 15 günde bir (son sayım 21 gün önce → gecikmiş), Genel Temizlik 30 günde bir
+ * (son sayım 14 gün önce). Deterministik; idempotent: ürün tipi `seedRef` ile bir kez
+ * oluşturulur, sayım oturumları `seedRef` ile paylaşılır. Miktarlar binde bir.
  */
 
 type SeedProduct = {
@@ -30,8 +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;
-  /** Her n haftada bir küçük sayım farkı (−%). */
-  countDrift?: { everyWeeks: number; pct: number };
+  /** Her n. sayımda küçük eksik (−%, hedefin yüzdesi). */
+  countDrift?: { everyCounts: number; pct: number };
 };
 
 const K = 1000;
@@ -188,7 +191,7 @@ export const PRODUCTS: SeedProduct[] = [
     pack: 50 * K,
     perDay: 700,
     location: "Banyo dolabı",
-    countDrift: { everyWeeks: 8, pct: 4 },
+    countDrift: { everyCounts: 2, pct: 4 },
   },
   {
     ref: "yumusatici",
@@ -221,7 +224,7 @@ export const PRODUCTS: SeedProduct[] = [
     pack: 16 * K,
     perDay: 600,
     location: "Banyo dolabı",
-    countDrift: { everyWeeks: 10, pct: 6 },
+    countDrift: { everyCounts: 3, pct: 6 },
   },
   // Kişisel Temizlik
   {
@@ -259,6 +262,12 @@ export const PRODUCTS: SeedProduct[] = [
 
 const START_DAYS_AGO = 182;
 
+/** Sayım sıklığı (gün) ve sayım günü kuralı (gün önce), ana stok kategorisine göre. */
+const COUNT_PLANS: Record<string, { everyDays: number; on: (daysAgo: number) => boolean }> = {
+  mutfak: { everyDays: 15, on: (d) => d >= 21 && d % 14 === 7 },
+  "genel-temizlik": { everyDays: 30, on: (d) => d % 28 === 14 },
+};
+
 type Row = {
   kind: "purchase" | "consume" | "waste" | "count_adjust";
   daysAgo: number;
@@ -267,17 +276,24 @@ type Row = {
   wasteReason?: string | null;
   note?: string;
   initial?: boolean;
+  /** Bu satır hangi sayıma ait (gün önce). */
+  countDaysAgo?: number;
 };
 
-/** Haftalık simülasyon: tüketim, eşikte alım, fire ve sayım farkı. Stok asla eksiye düşmez. */
-export function simulate(p: SeedProduct, today: string): Row[] {
+export type SeedCount = { daysAgo: number; expected: number; actual: number };
+
+/**
+ * Haftalık simülasyon: tüketim, periyodik sayım (farkı nadiren), eşikte alım ve fire. Stok asla
+ * eksiye düşmez.
+ */
+export function simulate(p: SeedProduct, today: string): { rows: Row[]; counts: SeedCount[] } {
   const rows: Row[] = [];
+  const counts: SeedCount[] = [];
+  const plan = COUNT_PLANS[p.category.split(".")[0]!];
   let stock = p.target;
   let purchases = 0;
   rows.push({ kind: "count_adjust", daysAgo: START_DAYS_AGO, quantity: stock, initial: true });
-  let week = 0;
   for (let d = START_DAYS_AGO - 7; d >= 0; d -= 7) {
-    week++;
     // Haftalık tüketim azaltma adımının katı (ör. tam tablet, 0,25 kg).
     const step = p.step ?? K;
     const consume = Math.min(stock, Math.max(step, Math.round((p.perDay * 7) / step) * step));
@@ -285,12 +301,21 @@ export function simulate(p: SeedProduct, today: string): Row[] {
       rows.push({ kind: "consume", daysAgo: d, quantity: consume });
       stock -= consume;
     }
-    if (p.countDrift && week % p.countDrift.everyWeeks === 0 && stock > 0) {
-      const drift = Math.min(stock, Math.round((p.target * p.countDrift.pct) / 100));
-      if (drift > 0) {
-        rows.push({ kind: "count_adjust", daysAgo: d, quantity: -drift, note: "Sayım" });
+    if (plan?.on(d)) {
+      const expected = stock;
+      const nth = counts.length + 1;
+      if (p.countDrift && nth % p.countDrift.everyCounts === 0 && stock > 0) {
+        const drift = Math.min(stock, Math.round((p.target * p.countDrift.pct) / 100));
+        rows.push({
+          kind: "count_adjust",
+          daysAgo: d,
+          quantity: -drift,
+          note: "Sayım",
+          countDaysAgo: d,
+        });
         stock -= drift;
       }
+      counts.push({ daysAgo: d, expected, actual: stock });
     }
     const canRefill = p.stopRefillDaysAgo === undefined || d > p.stopRefillDaysAgo;
     if (canRefill && stock < (p.target * 35) / 100) {
@@ -311,7 +336,7 @@ export function simulate(p: SeedProduct, today: string): Row[] {
       }
     }
   }
-  return rows;
+  return { rows, counts };
 }
 
 export async function seedStock(
@@ -321,6 +346,12 @@ export async function seedStock(
   const actor = new Types.ObjectId(users.get("ayse")!);
   for (const [, id] of householdIds) await installDefaultStockCategories(id, actor);
   const householdId = householdIds.get("Çakır Ailesi")!;
+  // Periyodik sayım sıklığı (kullanıcı ayarladıysa dokunulmaz).
+  for (const [key, plan] of Object.entries(COUNT_PLANS))
+    await StockCategoryModel.updateOne(
+      { householdId, defaultKey: key, countEveryDays: null },
+      { $set: { countEveryDays: plan.everyDays } },
+    );
   const cats = await StockCategoryModel.find({ householdId, defaultKey: { $type: "string" } })
     .select({ defaultKey: 1 })
     .lean<{ _id: Types.ObjectId; defaultKey: string }[]>();
@@ -344,9 +375,33 @@ export async function seedStock(
       updatedBy: actor,
     });
     const base = Date.now() - START_DAYS_AGO * 86_400_000;
+    const { rows, counts } = simulate(p, today);
+    // Sayım oturumu kategori başına ortak: ürün satırı oturuma eklenir.
+    const root = p.category.split(".")[0]!;
+    const countIds = new Map<number, Types.ObjectId>();
+    for (const c of counts) {
+      const session = await StockCountModel.findOneAndUpdate(
+        { householdId, seedRef: `${root}:${c.daysAgo}` },
+        {
+          $setOnInsert: {
+            householdId,
+            date: addDays(today, -c.daysAgo),
+            categoryId: catByKey.get(root) ?? null,
+            note: "",
+            seedRef: `${root}:${c.daysAgo}`,
+            createdBy: actor,
+          },
+          $push: {
+            items: { productTypeId: doc._id, expected: c.expected, actual: c.actual, wasted: 0 },
+          },
+        },
+        { upsert: true, returnDocument: "after" },
+      ).lean<{ _id: Types.ObjectId }>();
+      countIds.set(c.daysAgo, session!._id);
+    }
     // Ham ekleme: aynı tarihli hareketlerin sırası (createdAt) korunur.
     await StockMovementModel.collection.insertMany(
-      simulate(p, today).map((r, i) => {
+      rows.map((r, i) => {
         const at = new Date(base + i * 1000);
         return {
           householdId,
@@ -358,7 +413,7 @@ export async function seedStock(
           expiryDate: r.expiryDate ?? null,
           note: r.note ?? "",
           initial: r.initial ?? false,
-          countId: null,
+          countId: r.countDaysAgo === undefined ? null : (countIds.get(r.countDaysAgo) ?? null),
           deletedAt: null,
           seedRef: `${p.ref}:${i}`,
           createdBy: actor,