first commit

src/recommendations/types.ts

@@ -0,0 +1,39 @@
+import type { Market } from "@/src/domain/types";
+
+export type RecommendationSegment =
+  | "OPEN_AUCTION"
+  | "MIDDAY"
+  | "AFTER_HOURS";
+
+export type RecommendationSignal = {
+  name: string;
+  value: number | string;
+  pass: boolean;
+};
+
+export type RecommendationItem = {
+  code: string;
+  market: Market;
+  rank: number;
+  score: number;
+
+  reasons: string[];
+  risks: string[];
+  signals: RecommendationSignal[];
+};
+
+export type RecommendationSnapshot = {
+  userId: string;
+  date: string; // YYYY-MM-DD
+  segment: RecommendationSegment;
+  generatedAt: string; // ISO
+  screeningVersion: string; // e.g. v0.1
+
+  universe: {
+    watchlistCount: number;
+    importedPoolCount: number;
+    totalCount: number;
+  };
+
+  items: RecommendationItem[];
+};