feat(gemini): Skiva 1 – Gemini 2.5 Flash som lärar-tier för kylskåpsskanning

- Gemini-adapter bakom AamosClient-interface (AAMOS_MODE=gemini)
- Serversida/worker: hämtar bild, anropar Gemini, mappar mot canonical_ingredients
- Kostnad/tokens bokförs i ai_usage_counters; global dagsbudget via BudgetStore
- Redis-backed budget i worker, in-memory i tester
- Migration 0019: ai_cost_usd_microcents
- Hermetiska tester med inspelad fixture; separat pnpm eval:scan
- docs/09 uppdaterad ärligt: AAMOS-status, Gemini-flöde, säkerhet/kostnad
- REQUIRE_REAL=1 stödjer AAMOS_MODE=gemini; deploy-grind uppdaterad

apps/api/src/config.ts

@@ -42,11 +42,16 @@ const configSchema = z.object({
   S3_ACCESS_KEY_ID: z.string().default(""),
   S3_SECRET_ACCESS_KEY: z.string().default(""),
 
-  AAMOS_MODE: z.enum(["http", "mock"]).default("http"),
+  AAMOS_MODE: z.enum(["http", "mock", "gemini"]).default("http"),
   AAMOS_API_URL: z.string().optional(),
   AAMOS_API_KEY: z.string().optional(),
   AAMOS_TIMEOUT_MS: z.coerce.number().int().default(60_000),
 
+  GEMINI_API_KEY: z.string().optional(),
+  GEMINI_MODEL: z.string().default("gemini-2.5-flash"),
+  GEMINI_TIMEOUT_MS: z.coerce.number().int().default(60_000),
+  GEMINI_DAILY_BUDGET_USD: z.coerce.number().default(0),
+
   APP_STORE_MODE: z.enum(["production", "sandbox"]).default("sandbox"),
   EMAIL_MODE: z.enum(["log", "smtp"]).default("log"),
   SMTP_HOST: z.string().default(""),
@@ -89,6 +94,10 @@ export function loadConfig(env: NodeJS.ProcessEnv = process.env): AppConfig {
       console.error("SÄKERHETSSTOPP: AAMOS_MODE=mock är inte tillåtet i produktion.");
       process.exit(1);
     }
+    if (cfg.AAMOS_MODE === "gemini" && !cfg.GEMINI_API_KEY) {
+      console.error("SÄKERHETSSTOPP: AAMOS_MODE=gemini kräver GEMINI_API_KEY i produktion.");
+      process.exit(1);
+    }
   }
   return cfg;
 }

apps/api/src/plugins/core.ts

@@ -77,6 +77,10 @@ export const corePlugin = fp(async (app: FastifyInstance, opts: { config: AppCon
       AAMOS_API_URL: config.AAMOS_API_URL,
       AAMOS_API_KEY: config.AAMOS_API_KEY,
       AAMOS_TIMEOUT_MS: String(config.AAMOS_TIMEOUT_MS),
+      GEMINI_API_KEY: config.GEMINI_API_KEY,
+      GEMINI_MODEL: config.GEMINI_MODEL,
+      GEMINI_TIMEOUT_MS: String(config.GEMINI_TIMEOUT_MS),
+      GEMINI_DAILY_BUDGET_USD: String(config.GEMINI_DAILY_BUDGET_USD),
     }),
   );