+
+
+
+
+
+
+
+
+
+
+ Delete All Data?
+
+ This will permanently delete all generated data from the database.
+ This action cannot be undone.
+
+
+
+ Cancel
+
+ Delete All Data
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ )
+}
+```
+
+---
+
+## API HOOKS
+
+```tsx
+// hooks/use-seeder.ts
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
+import { api } from '@/lib/api'
+
+interface SeederStatus {
+ stores: number
+ products: number
+ calendar: number
+ sales: number
+ inventory: number
+ price_history: number
+ promotions: number
+ date_range_start: string | null
+ date_range_end: string | null
+ last_updated: string | null
+}
+
+interface GenerateParams {
+ scenario?: string
+ seed?: number
+ stores?: number
+ products?: number
+ start_date?: string
+ end_date?: string
+ dry_run?: boolean
+}
+
+interface DeleteParams {
+ scope: 'all' | 'facts' | 'dimensions'
+}
+
+interface VerifyResult {
+ passed: boolean
+ checks: Array<{
+ name: string
+ status: 'passed' | 'warning' | 'failed'
+ message: string
+ details?: string[]
+ }>
+}
+
+export function useSeederStatus() {
+ return useQuery({
+ queryKey: ['seeder', 'status'],
+ queryFn: () => api.get('/seeder/status'),
+ refetchInterval: 30000, // Refresh every 30 seconds
+ })
+}
+
+export function useGenerateData() {
+ const queryClient = useQueryClient()
+
+ return useMutation({
+ mutationFn: (params: GenerateParams) =>
+ api.post('/seeder/generate', params),
+ onSuccess: () => {
+ queryClient.invalidateQueries({ queryKey: ['seeder', 'status'] })
+ queryClient.invalidateQueries({ queryKey: ['analytics'] })
+ },
+ })
+}
+
+export function useAppendData() {
+ const queryClient = useQueryClient()
+
+ return useMutation({
+ mutationFn: (params: GenerateParams) =>
+ api.post('/seeder/append', params),
+ onSuccess: () => {
+ queryClient.invalidateQueries({ queryKey: ['seeder', 'status'] })
+ },
+ })
+}
+
+export function useDeleteData() {
+ const queryClient = useQueryClient()
+
+ return useMutation({
+ mutationFn: (params: DeleteParams) =>
+ api.delete('/seeder/data', { data: params }),
+ onSuccess: () => {
+ queryClient.invalidateQueries({ queryKey: ['seeder', 'status'] })
+ queryClient.invalidateQueries({ queryKey: ['analytics'] })
+ },
+ })
+}
+
+export function useVerifyData() {
+ return useMutation({
+ mutationFn: () => api.post('/seeder/verify'),
+ })
+}
+
+export function useSeederScenarios() {
+ return useQuery({
+ queryKey: ['seeder', 'scenarios'],
+ queryFn: () => api.get>('/seeder/scenarios'),
+ staleTime: Infinity, // Scenarios don't change
+ })
+}
+```
+
+---
+
+## BACKEND API ENDPOINTS (New Feature Slice)
+
+### Routes
+
+```python
+# app/features/seeder/routes.py
+from fastapi import APIRouter, Depends
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.core.database import get_db
+from app.features.seeder import schemas, service
+
+router = APIRouter(prefix="/seeder", tags=["seeder"])
+
+
+@router.get("/status", response_model=schemas.SeederStatus)
+async def get_status(db: AsyncSession = Depends(get_db)) -> schemas.SeederStatus:
+ """Get current database row counts and date range."""
+ return await service.get_status(db)
+
+
+@router.get("/scenarios", response_model=list[schemas.ScenarioInfo])
+async def list_scenarios() -> list[schemas.ScenarioInfo]:
+ """List available scenario presets."""
+ return service.list_scenarios()
+
+
+@router.post("/generate", response_model=schemas.GenerateResult)
+async def generate_data(
+ params: schemas.GenerateParams,
+ db: AsyncSession = Depends(get_db),
+) -> schemas.GenerateResult:
+ """Generate new synthetic dataset."""
+ return await service.generate_data(db, params)
+
+
+@router.post("/append", response_model=schemas.GenerateResult)
+async def append_data(
+ params: schemas.AppendParams,
+ db: AsyncSession = Depends(get_db),
+) -> schemas.GenerateResult:
+ """Append data to existing dataset."""
+ return await service.append_data(db, params)
+
+
+@router.delete("/data", response_model=schemas.DeleteResult)
+async def delete_data(
+ params: schemas.DeleteParams,
+ db: AsyncSession = Depends(get_db),
+) -> schemas.DeleteResult:
+ """Delete data with specified scope."""
+ return await service.delete_data(db, params)
+
+
+@router.post("/verify", response_model=schemas.VerifyResult)
+async def verify_data(
+ db: AsyncSession = Depends(get_db),
+) -> schemas.VerifyResult:
+ """Run data integrity verification."""
+ return await service.verify_data(db)
+```
+
+### Schemas
+
+```python
+# app/features/seeder/schemas.py
+from datetime import date
+from typing import Literal
+
+from pydantic import BaseModel, Field
+
+
+class SeederStatus(BaseModel):
+ """Current database state."""
+ stores: int
+ products: int
+ calendar: int
+ sales: int
+ inventory: int
+ price_history: int
+ promotions: int
+ date_range_start: date | None
+ date_range_end: date | None
+ last_updated: str | None
+
+
+class ScenarioInfo(BaseModel):
+ """Scenario preset information."""
+ name: str
+ description: str
+ stores: int
+ products: int
+
+
+class GenerateParams(BaseModel):
+ """Parameters for data generation."""
+ scenario: str = "retail_standard"
+ seed: int = Field(default=42, ge=0)
+ stores: int = Field(default=10, ge=1, le=100)
+ products: int = Field(default=50, ge=1, le=500)
+ start_date: date = Field(default_factory=lambda: date(2024, 1, 1))
+ end_date: date = Field(default_factory=lambda: date(2024, 12, 31))
+ sparsity: float = Field(default=0.0, ge=0.0, le=1.0)
+ dry_run: bool = False
+
+
+class AppendParams(BaseModel):
+ """Parameters for appending data."""
+ start_date: date
+ end_date: date
+ seed: int = Field(default=43, ge=0)
+
+
+class DeleteParams(BaseModel):
+ """Parameters for data deletion."""
+ scope: Literal["all", "facts", "dimensions"] = "all"
+
+
+class GenerateResult(BaseModel):
+ """Result of generation operation."""
+ success: bool
+ records_created: dict[str, int]
+ duration_seconds: float
+ message: str
+
+
+class DeleteResult(BaseModel):
+ """Result of deletion operation."""
+ success: bool
+ records_deleted: dict[str, int]
+ message: str
+
+
+class VerifyCheck(BaseModel):
+ """Single verification check result."""
+ name: str
+ status: Literal["passed", "warning", "failed"]
+ message: str
+ details: list[str] | None = None
+
+
+class VerifyResult(BaseModel):
+ """Data verification result."""
+ passed: bool
+ checks: list[VerifyCheck]
+```
+
+---
+
+## CONFIGURATION
+
+### Environment Variables
+
+```env
+# Seeder Configuration (already in CLAUDE.md)
+SEEDER_DEFAULT_SEED=42
+SEEDER_DEFAULT_STORES=10
+SEEDER_DEFAULT_PRODUCTS=50
+SEEDER_BATCH_SIZE=1000
+SEEDER_ENABLE_PROGRESS=True
+SEEDER_ALLOW_PRODUCTION=False
+SEEDER_REQUIRE_CONFIRM=True
+```
+
+### Frontend Environment
+
+```env
+# frontend/.env
+VITE_API_BASE_URL=http://localhost:8123
+VITE_ENABLE_SEEDER_PANEL=true # Feature flag for seeder UI
+```
+
+---
+
+## EXAMPLES
+
+### examples/ui/seeder-panel.md
+
+```markdown
+# Data Seeder Panel
+
+## Quick Start
+
+1. Navigate to Admin Panel: http://localhost:5173/admin
+2. Click "Data Seeder" tab
+3. Select a scenario (e.g., "Holiday Rush")
+4. Click "Generate New" to create synthetic data
+5. View progress in the Operation Log panel
+
+## Scenario Selection
+
+| Scenario | Best For |
+|----------|----------|
+| retail_standard | General development and testing |
+| holiday_rush | Seasonal forecasting models |
+| high_variance | Robustness testing |
+| stockout_heavy | Inventory optimization |
+| new_launches | Product launch forecasting |
+| sparse | Gap handling validation |
+
+## Verification
+
+After generating data, run "Verify" to check:
+- Foreign key integrity
+- Non-negative constraints
+- Date range coverage
+- Unique constraint compliance
+```
+
+---
+
+## SUCCESS CRITERIA
+
+### Functional Requirements
+- [ ] Status panel shows accurate row counts for all 7 tables
+- [ ] Date range displays correctly (min/max from sales_daily)
+- [ ] Generate button triggers full-new with selected scenario
+- [ ] Delete button shows confirmation dialog before executing
+- [ ] Append button adds data without affecting existing records
+- [ ] Verify button runs all integrity checks
+- [ ] Scenario selector updates generation parameters
+- [ ] Configuration form validates input ranges
+
+### UX Requirements
+- [ ] Loading states shown during API calls
+- [ ] Success/error toasts for all operations
+- [ ] Progress indicator during long operations
+- [ ] Disabled states for buttons during pending operations
+- [ ] Responsive layout on tablet and mobile
+- [ ] Keyboard accessible (focus states, enter to submit)
+
+### Performance
+- [ ] Status query returns in < 500ms
+- [ ] UI remains responsive during generation
+- [ ] No memory leaks from polling/subscriptions
+
+### Safety
+- [ ] Delete requires explicit confirmation
+- [ ] Production environment check (SEEDER_ALLOW_PRODUCTION)
+- [ ] Clear error messages for failed operations
+
+---
+
+## CROSS-MODULE INTEGRATION
+
+| Direction | Module | Integration Point |
+|-----------|--------|-------------------|
+| **← Data Platform** | Phase 1 | Queries all 7 tables for status |
+| **← Shared Seeder** | Phase 12 | Uses existing DataSeeder orchestrator |
+| **→ Analytics** | Phase 7 | Invalidates KPI cache after generation |
+| **→ Dashboard** | Phase 10 | Refreshes dashboard data after changes |
+| **→ Explorer** | Phase 10 | New data appears in explorer tables |
+| **→ Admin** | Phase 10 | Extends existing admin page with new tab |
+
+---
+
+## DOCUMENTATION LINKS
+
+### shadcn/ui Components Used
+- [Card](https://ui.shadcn.com/docs/components/card) — Container layout
+- [Tabs](https://ui.shadcn.com/docs/components/tabs) — Admin panel navigation
+- [Button](https://ui.shadcn.com/docs/components/button) — Action triggers
+- [AlertDialog](https://ui.shadcn.com/docs/components/alert-dialog) — Destructive confirmations
+- [Select](https://ui.shadcn.com/docs/components/select) — Scenario picker
+- [Input](https://ui.shadcn.com/docs/components/input) — Configuration values
+- [Progress](https://ui.shadcn.com/docs/components/progress) — Operation progress
+- [Badge](https://ui.shadcn.com/docs/components/badge) — Status indicators
+- [Skeleton](https://ui.shadcn.com/docs/components/skeleton) — Loading states
+- [Accordion](https://ui.shadcn.com/docs/components/accordion) — Collapsible sections
+- [Calendar](https://ui.shadcn.com/docs/components/calendar) — Date picker
+- [Popover](https://ui.shadcn.com/docs/components/popover) — Date picker container
+
+### TanStack
+- [TanStack Query Mutations](https://tanstack.com/query/latest/docs/react/guides/mutations)
+- [Query Invalidation](https://tanstack.com/query/latest/docs/react/guides/query-invalidation)
+
+### Project References
+- [CLAUDE.md](./CLAUDE.md) — Project coding standards
+- [INITIAL-12.md](./INITIAL-12.md) — Data Seeder backend (The Forge)
+- [docs/DATA-SEEDER.md](./docs/DATA-SEEDER.md) — Seeder documentation
+- [app/shared/seeder/](./app/shared/seeder/) — Seeder implementation
+
+---
+
+## OTHER CONSIDERATIONS
+
+### Best Practices
+
+1. **Reuse Admin Patterns** — Follow existing RagSourcesPanel and AliasesPanel patterns
+2. **Optimistic UI** — Show immediate feedback, rollback on error
+3. **Cache Invalidation** — Invalidate analytics queries after data changes
+4. **Feature Flag** — `VITE_ENABLE_SEEDER_PANEL` to hide in production
+
+### Security
+
+- **Production Guard** — Check `SEEDER_ALLOW_PRODUCTION` before any mutation
+- **Confirmation Required** — AlertDialog for all destructive operations
+- **Rate Limiting** — Prevent rapid repeated generation requests
+- **Audit Logging** — Log all seeder operations with user context
+
+### Observability
+
+- **Structured Logging** — Log events: `seeder.generate_started`, `seeder.generate_completed`
+- **Metrics** — Track generation duration, records created
+- **Error Tracking** — Capture and display detailed error messages
+
+### Future Enhancements
+
+- WebSocket streaming for real-time progress
+- YAML configuration editor
+- Data preview (sample rows)
+- Generation history with rollback
+- Scheduled data refresh
+- Multi-tenant isolation
+
+---
+
+## IMPLEMENTATION ORDER
+
+1. **Backend API** — Create `app/features/seeder/` feature slice with routes/schemas/service
+2. **Frontend Hooks** — Add `hooks/use-seeder.ts` with TanStack Query
+3. **Status Panel** — DataStatusCard component with row counts
+4. **Quick Actions** — QuickActionsCard with generate/delete buttons
+5. **Configuration** — ConfigurationCard with form inputs
+6. **Operation Log** — OperationLogCard with progress display
+7. **Admin Integration** — Add Seeder tab to existing admin page
+8. **Verification** — VerifyResult display component
+9. **Testing** — Unit tests for hooks and components
+10. **Documentation** — Update README and add examples
+
+---
+
+*Phase 13: The Forge UI — Where developers interact with the data factory.*
diff --git a/PRPs/PRP-13-data-seeder-dashboard.md b/PRPs/PRP-13-data-seeder-dashboard.md
new file mode 100644
index 00000000..c197bdbf
--- /dev/null
+++ b/PRPs/PRP-13-data-seeder-dashboard.md
@@ -0,0 +1,855 @@
+# PRP-13: Data Seeder Dashboard (The Forge UI)
+
+**Phase**: 13
+**Status**: Ready for Implementation
+**PRP Score**: 9/10 (High confidence for one-pass implementation)
+**Estimated Complexity**: Medium
+
+---
+
+## Goal
+
+Build the frontend admin interface for The Forge data seeder - a dashboard panel that allows users to:
+1. View current database state (row counts for all 7 tables, date ranges)
+2. Generate new synthetic datasets with scenario presets
+3. Append data to existing datasets
+4. Delete data with scope selection
+5. Run data integrity verification
+
+The backend API already exists at `/seeder/*` endpoints - this PRP focuses exclusively on the **frontend implementation**.
+
+---
+
+## Why
+
+- **Developer Experience**: Provides visual interface for synthetic data operations instead of CLI
+- **Testing Workflow**: Quick data generation for development and testing scenarios
+- **Integration**: Extends existing Admin panel with consistent UI patterns
+- **Safety**: Built-in confirmations for destructive operations, dry-run previews
+
+---
+
+## What
+
+### User-Visible Behavior
+
+1. New "Data Seeder" tab in Admin panel (`/admin`)
+2. Status cards showing row counts for stores, products, calendar, sales, inventory, price_history, promotions
+3. Date range display (earliest to latest sales date)
+4. Scenario dropdown with 6 presets: retail_standard, holiday_rush, high_variance, stockout_heavy, new_launches, sparse
+5. Action buttons: Generate, Append, Delete, Verify
+6. Configuration form: seed, stores, products, dates, sparsity
+7. AlertDialog confirmations for destructive actions
+8. Loading states, success/error toasts
+
+### Success Criteria
+
+- [ ] Status panel displays all 7 table counts correctly
+- [ ] Date range shows min/max from sales_daily (or "No data" when empty)
+- [ ] Scenario selector lists 6 presets with descriptions
+- [ ] Generate button creates dataset with selected scenario and config
+- [ ] Delete button shows AlertDialog confirmation before executing
+- [ ] Verify button runs integrity checks and displays results
+- [ ] Loading spinners shown during API operations
+- [ ] Toast notifications on success/error
+- [ ] Tab integrates seamlessly with existing RAG Sources and Aliases tabs
+- [ ] All TypeScript types are correct (no `any`)
+- [ ] ESLint passes with no errors
+
+---
+
+## All Needed Context
+
+### Documentation & References
+
+```yaml
+# MUST READ - Existing Patterns to Follow
+- file: frontend/src/pages/admin.tsx
+ why: Pattern for admin tabs, RagSourcesPanel and AliasesPanel show exact component structure
+
+- file: frontend/src/hooks/use-runs.ts
+ why: TanStack Query patterns for useQuery and useMutation with cache invalidation
+
+- file: frontend/src/hooks/use-rag-sources.ts
+ why: Mutation pattern with refetch, shows useIndexDocument pattern
+
+- file: frontend/src/lib/api.ts
+ why: API client usage - api(endpoint, config)
+
+- file: frontend/src/types/api.ts
+ why: Type definition patterns, add seeder types here
+
+# Backend API Reference (already implemented)
+- file: app/features/seeder/schemas.py
+ why: Exact response shapes - SeederStatus, ScenarioInfo, GenerateResult, DeleteResult, VerifyResult
+
+- file: app/features/seeder/routes.py
+ why: API endpoint signatures and HTTP methods/status codes
+
+# shadcn/ui Components (all already installed)
+- url: https://ui.shadcn.com/docs/components/tabs
+ why: Tab structure pattern
+
+- url: https://ui.shadcn.com/docs/components/card
+ why: Status cards, configuration panels
+
+- url: https://ui.shadcn.com/docs/components/alert-dialog
+ why: Destructive action confirmation
+
+- url: https://ui.shadcn.com/docs/components/select
+ why: Scenario picker
+
+- url: https://ui.shadcn.com/docs/components/input
+ why: Configuration form inputs
+
+- url: https://ui.shadcn.com/docs/components/badge
+ why: Status indicators
+
+- url: https://ui.shadcn.com/docs/components/calendar
+ why: Date picker in Popover
+
+- url: https://ui.shadcn.com/docs/components/progress
+ why: Operation progress indicator
+```
+
+### Current Codebase Tree (Frontend Focus)
+
+```bash
+frontend/src/
+├── App.tsx # Routes - no changes needed
+├── components/
+│ ├── common/
+│ │ ├── error-display.tsx # ErrorDisplay component to reuse
+│ │ └── loading-state.tsx # LoadingState component to reuse
+│ └── ui/ # 26 shadcn/ui components (all needed are installed)
+│ ├── alert-dialog.tsx
+│ ├── badge.tsx
+│ ├── button.tsx
+│ ├── calendar.tsx
+│ ├── card.tsx
+│ ├── checkbox.tsx
+│ ├── collapsible.tsx
+│ ├── dialog.tsx
+│ ├── input.tsx
+│ ├── popover.tsx
+│ ├── progress.tsx
+│ ├── select.tsx
+│ ├── skeleton.tsx
+│ ├── sonner.tsx
+│ └── tabs.tsx
+├── hooks/
+│ ├── index.ts # Export all hooks - ADD use-seeder export
+│ ├── use-runs.ts # Pattern: useQuery/useMutation with cache invalidation
+│ └── use-rag-sources.ts # Pattern: mutations with refetch
+├── lib/
+│ └── api.ts # api function
+├── pages/
+│ └── admin.tsx # ADD SeederPanel to Tabs
+└── types/
+ └── api.ts # ADD seeder types
+```
+
+### Desired Codebase Tree (New/Modified Files)
+
+```bash
+frontend/src/
+├── hooks/
+│ ├── index.ts # MODIFY: Add 'export * from './use-seeder''
+│ └── use-seeder.ts # CREATE: TanStack Query hooks for seeder API
+├── pages/
+│ └── admin.tsx # MODIFY: Add SeederPanel tab
+└── types/
+ └── api.ts # MODIFY: Add Seeder* type interfaces
+```
+
+### Known Gotchas & Library Quirks
+
+```typescript
+// CRITICAL: TanStack Query v5 patterns
+// useMutation uses isPending (not isLoading)
+const mutation = useMutation({ mutationFn: ... })
+mutation.isPending // ✅ correct in v5
+mutation.isLoading // ❌ deprecated
+
+// CRITICAL: API client returns Promise, not { data: T }
+const data = await api('/seeder/status') // ✅
+// data is directly the response, not wrapped
+
+// CRITICAL: DELETE with body requires special handling
+// Our api() function supports body in DELETE:
+api('/seeder/data', {
+ method: 'DELETE',
+ body: { scope: 'all', dry_run: false }
+})
+
+// CRITICAL: Date handling for API
+// Backend expects date format: YYYY-MM-DD (ISO date string)
+// Use format(date, 'yyyy-MM-dd') from date-fns
+
+// CRITICAL: POST returns 201 for /generate and /append
+// The api() function handles this transparently
+
+// CRITICAL: void queryClient.invalidateQueries()
+// Always use void prefix to satisfy TypeScript/ESLint for floating promises
+```
+
+---
+
+## Implementation Blueprint
+
+### Data Models (TypeScript Types)
+
+Add to `frontend/src/types/api.ts`:
+
+```typescript
+// === Seeder ===
+export interface SeederStatus {
+ stores: number
+ products: number
+ calendar: number
+ sales: number
+ inventory: number
+ price_history: number
+ promotions: number
+ date_range_start: string | null // ISO date "2024-01-01"
+ date_range_end: string | null
+ last_updated: string | null // ISO datetime
+}
+
+export interface ScenarioInfo {
+ name: string
+ description: string
+ stores: number
+ products: number
+ start_date: string // ISO date
+ end_date: string
+}
+
+export interface GenerateParams {
+ scenario?: string // default: "retail_standard"
+ seed?: number // default: 42
+ stores?: number // 1-100, default: 10
+ products?: number // 1-500, default: 50
+ start_date?: string // ISO date
+ end_date?: string
+ sparsity?: number // 0.0-1.0
+ dry_run?: boolean
+}
+
+export interface AppendParams {
+ start_date: string // Required
+ end_date: string // Required
+ seed?: number
+}
+
+export interface DeleteParams {
+ scope?: 'all' | 'facts' | 'dimensions' // default: "all"
+ dry_run?: boolean
+}
+
+export interface GenerateResult {
+ success: boolean
+ records_created: Record
+ duration_seconds: number
+ message: string
+ seed: number
+}
+
+export interface DeleteResult {
+ success: boolean
+ records_deleted: Record
+ message: string
+ dry_run: boolean
+}
+
+export type VerifyCheckStatus = 'passed' | 'warning' | 'failed'
+
+export interface VerifyCheck {
+ name: string
+ status: VerifyCheckStatus
+ message: string
+ details: string[] | null
+}
+
+export interface VerifyResult {
+ passed: boolean
+ checks: VerifyCheck[]
+ total_checks: number
+ passed_count: number
+ warning_count: number
+ failed_count: number
+}
+```
+
+---
+
+## Tasks (Implementation Order)
+
+### Task 1: Add TypeScript Types
+**MODIFY** `frontend/src/types/api.ts`
+- FIND pattern: After the `// === Error Response (RFC 7807) ===` section
+- ADD: All seeder interfaces before EOF
+
+```typescript
+// ADD these interfaces at the end of the file, before the closing empty line
+// === Seeder ===
+export interface SeederStatus { ... }
+export interface ScenarioInfo { ... }
+// ... (all types from Data Models section above)
+```
+
+### Task 2: Create Seeder Hooks
+**CREATE** `frontend/src/hooks/use-seeder.ts`
+- MIRROR pattern from: `frontend/src/hooks/use-runs.ts`
+- Uses TanStack Query v5 patterns
+
+```typescript
+// frontend/src/hooks/use-seeder.ts
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
+import { api } from '@/lib/api'
+import type {
+ SeederStatus,
+ ScenarioInfo,
+ GenerateParams,
+ GenerateResult,
+ AppendParams,
+ DeleteParams,
+ DeleteResult,
+ VerifyResult,
+} from '@/types/api'
+
+// Query: Get database status (row counts, date range)
+export function useSeederStatus() {
+ return useQuery({
+ queryKey: ['seeder', 'status'],
+ queryFn: () => api('/seeder/status'),
+ // Refresh every 30 seconds to catch external changes
+ refetchInterval: 30000,
+ })
+}
+
+// Query: Get available scenarios (cached indefinitely - they don't change)
+export function useSeederScenarios() {
+ return useQuery({
+ queryKey: ['seeder', 'scenarios'],
+ queryFn: () => api('/seeder/scenarios'),
+ staleTime: Infinity,
+ })
+}
+
+// Mutation: Generate new dataset
+export function useGenerateData() {
+ const queryClient = useQueryClient()
+ return useMutation({
+ mutationFn: (params: GenerateParams) =>
+ api('/seeder/generate', { method: 'POST', body: params }),
+ onSuccess: () => {
+ // Invalidate status to refresh counts
+ void queryClient.invalidateQueries({ queryKey: ['seeder', 'status'] })
+ // Also invalidate analytics as data changed
+ void queryClient.invalidateQueries({ queryKey: ['analytics'] })
+ void queryClient.invalidateQueries({ queryKey: ['kpis'] })
+ },
+ })
+}
+
+// Mutation: Append data to existing dataset
+export function useAppendData() {
+ const queryClient = useQueryClient()
+ return useMutation({
+ mutationFn: (params: AppendParams) =>
+ api('/seeder/append', { method: 'POST', body: params }),
+ onSuccess: () => {
+ void queryClient.invalidateQueries({ queryKey: ['seeder', 'status'] })
+ void queryClient.invalidateQueries({ queryKey: ['analytics'] })
+ void queryClient.invalidateQueries({ queryKey: ['kpis'] })
+ },
+ })
+}
+
+// Mutation: Delete data
+export function useDeleteData() {
+ const queryClient = useQueryClient()
+ return useMutation({
+ mutationFn: (params: DeleteParams) =>
+ api('/seeder/data', { method: 'DELETE', body: params }),
+ onSuccess: () => {
+ void queryClient.invalidateQueries({ queryKey: ['seeder', 'status'] })
+ void queryClient.invalidateQueries({ queryKey: ['analytics'] })
+ void queryClient.invalidateQueries({ queryKey: ['kpis'] })
+ },
+ })
+}
+
+// Mutation: Verify data integrity
+export function useVerifyData() {
+ return useMutation({
+ mutationFn: () => api('/seeder/verify', { method: 'POST' }),
+ })
+}
+```
+
+### Task 3: Export Seeder Hooks
+**MODIFY** `frontend/src/hooks/index.ts`
+- ADD export line
+
+```typescript
+// ADD this line at the end of the file
+export * from './use-seeder'
+```
+
+### Task 4: Add SeederPanel to Admin Page
+**MODIFY** `frontend/src/pages/admin.tsx`
+
+This is the main implementation task. Follow the exact pattern of RagSourcesPanel and AliasesPanel.
+
+#### 4a: Add Imports (at top of file)
+
+```typescript
+// ADD to existing imports
+import { format } from 'date-fns'
+import {
+ Flame, // Generate icon
+ Plus, // Append icon
+ CheckCircle, // Verify icon
+ RefreshCw, // Refresh icon
+ Store, // Stats icon
+ Package, // Stats icon
+ Calendar, // Stats icon
+ TrendingUp, // Stats icon (sales)
+ Warehouse, // Stats icon (inventory)
+ History, // Stats icon (price history)
+ Percent, // Stats icon (promotions)
+} from 'lucide-react'
+import {
+ useSeederStatus,
+ useSeederScenarios,
+ useGenerateData,
+ useDeleteData,
+ useVerifyData,
+} from '@/hooks/use-seeder'
+import { Badge } from '@/components/ui/badge'
+import { Skeleton } from '@/components/ui/skeleton'
+import { Progress } from '@/components/ui/progress'
+import { toast } from 'sonner'
+import type {
+ ScenarioInfo,
+ VerifyCheck,
+ VerifyCheckStatus,
+} from '@/types/api'
+```
+
+#### 4b: Add Tab to AdminPage Component
+
+```tsx
+// MODIFY the Tabs component - ADD new TabsTrigger and TabsContent
+
+
+
+
+ RAG Sources
+
+
+
+ Deployment Aliases
+
+ {/* ADD THIS NEW TAB */}
+
+
+ Data Seeder
+
+
+
+
+
+
+
+
+
+
+
+ {/* ADD THIS NEW TAB CONTENT */}
+
+
+
+
+```
+
+#### 4c: Create SeederPanel Component (new function in same file)
+
+```tsx
+function SeederPanel() {
+ const { data: status, isLoading, error, refetch } = useSeederStatus()
+ const { data: scenarios } = useSeederScenarios()
+ const generateMutation = useGenerateData()
+ const deleteMutation = useDeleteData()
+ const verifyMutation = useVerifyData()
+
+ const [selectedScenario, setSelectedScenario] = useState('retail_standard')
+ const [deleteDialogOpen, setDeleteDialogOpen] = useState(false)
+ const [verifyResult, setVerifyResult] = useState<{
+ passed: boolean
+ checks: VerifyCheck[]
+ passed_count: number
+ warning_count: number
+ failed_count: number
+ } | null>(null)
+
+ const handleGenerate = async () => {
+ try {
+ const result = await generateMutation.mutateAsync({
+ scenario: selectedScenario,
+ })
+ toast.success(`Generated ${result.records_created.sales?.toLocaleString() ?? 0} sales records in ${result.duration_seconds.toFixed(1)}s`)
+ } catch (err) {
+ toast.error(err instanceof Error ? err.message : 'Generation failed')
+ }
+ }
+
+ const handleDelete = async () => {
+ try {
+ const result = await deleteMutation.mutateAsync({ scope: 'all' })
+ setDeleteDialogOpen(false)
+ toast.success(result.message)
+ } catch (err) {
+ toast.error(err instanceof Error ? err.message : 'Delete failed')
+ }
+ }
+
+ const handleVerify = async () => {
+ try {
+ const result = await verifyMutation.mutateAsync()
+ setVerifyResult(result)
+ if (result.passed) {
+ toast.success('All integrity checks passed')
+ } else {
+ toast.warning(`${result.failed_count} checks failed`)
+ }
+ } catch (err) {
+ toast.error(err instanceof Error ? err.message : 'Verification failed')
+ }
+ }
+
+ if (error) {
+ return
+ }
+
+ return (
+
+ {/* Status Card */}
+
+
+
+ Current Data Summary
+
+ {status?.date_range_start && status?.date_range_end
+ ? `${status.date_range_start} → ${status.date_range_end}`
+ : 'No data yet'}
+
+