feat: enhance public vault UI with clearer descriptions and add an Admin Dashboard PRD.

ADMINDASHBOARD_PRD.md

@@ -0,0 +1,90 @@
+# Product Requirement Document: Admin Dashboard & Manual Analysis Workflow
+
+## 1. Overview
+The goal is to create a comprehensive Admin Dashboard for "Vault" that allows operations admins to monitor key platform metrics (users, videos, products) and manage a "Wizard of Oz" style workflow for AI product analysis. 
+
+Currently, AI analysis can be tracked via technical logs, but this change shifts control to a user-friendly admin interface. It introduces a manual review step ("Wizard of Oz" method) where admins must approve or manually add products before they are visible to the end user.
+
+## 2. User Roles & Permissions
+- **Admin**: Users with emails listed in the `ADMIN_EMAILS` environment variable. 
+- **User**: Standard platform user (Creator/Viewer).
+
+## 3. Features
+
+### 3.1 Admin Dashboard (`/admin/dashboard`)
+A central hub for monitoring platform health and activity.
+
+#### Key Metrics:
+1.  **User Stats**: 
+    - Total registered users.
+    - New users (last 24h/7d).
+2.  **Video Stats**:
+    - Total videos submitted.
+    - **Status Breakdown**: Pending Review, In Progress, Completed, Failed.
+3.  **Product Stats**:
+    - **Matched Products** (With Links): Number of detected objects matched to a marketplace product.
+    - **Unmatched Products** (Without Links): Detected objects pending a match.
+    - **Interest Pledges**: Count of user "I want this" interactions.
+    - **Suggestions**: Count of product suggestions from viewers (product requests) and affiliate proposals (suppliers).
+
+### 3.2 Manual "AI" Analysis Workflow
+Replace the fully automated trigger with a human-in-the-loop review process.
+
+#### Workflow Steps:
+1.  **User Trigger**: 
+    - User clicks "Analyze Video" (or auto-trigger on upload).
+    - **System Update**: Sets video `scan_status` to `pending_manual_review` (or similar status).
+    - **User Feedback**: Video shows "Analysis in Progress". Results are hidden until approved.
+
+2.  **Admin Queue (`/admin/analysis-queue`)**:
+    - Display list of videos with status `pending_manual_review`.
+    - Columns: Video Title, Creator, Submission Date, Current Status.
+    - Action: "Start Review".
+
+3.  **Analysis Interface**:
+    - **Video Player**: Watch the submitted video.
+    - **Manual Product Entry**:
+        - Form to add a "Detected Object" (Time, Category, Name).
+        - Form to add "Marketplace Match" (Affiliate Link, Product Name, Price, Image).
+    - **AI Assistance (Optional)**: "Run Auto-Analysis" button to pre-fill the list for admin review/editing.
+    - **Complete Review**:
+        - Button: "Publish Analysis".
+        - **System Update**: Sets `scan_status` to `completed`.
+        - **User Feedback**: Notification sent (optional), results become visible on the video page.
+
+### 3.3 Product Status Monitoring (`/admin/products`)
+A view to manage and improve product data quality.
+
+*   **Filterable List**:
+    - "Missing Link": Objects without marketplace matches.
+    - "Has Interest": Objects with high user interest pledges.
+    - "User Suggestion": Pending product requests/proposals.
+*   **Actions**:
+    - **Add Link**: Quick entry for affiliate URL.
+    - **Approve/Reject Suggestion**: Move a suggestion to a confirmed match.
+
+## 4. Technical Requirements
+
+### 4.1 Database Changes
+*   **Schema**:
+    - Ensure `video_scan_status` enum supports a manual review state (e.g., `pending_review`).
+    - Reuse existing `admin_moderation` table for logging admin actions, or create `admin_analysis_log`.
+*   **API**:
+    - `GET /api/admin/stats`: Aggregate counts for dashboard.
+    - `GET /api/admin/queue`: Fetch pending videos.
+    - `POST /api/admin/analysis/complete`: Publish results.
+
+### 4.2 UI Components
+*   **Dashboard**: Use `shadcn/ui` Cards for metrics.
+*   **Data Table**: Use `shadcn/ui` DataTable for video/product lists with filtering/sorting.
+*   **Forms**: `react-hook-form` and `zod` for validation of manual product entry.
+
+## 5. Future / Additional Suggestions
+1.  **Revenue & Click Tracking**:
+    - Visualize `affiliateRevenue` and `productClicks` data.
+    - Chart: Daily Clicks vs. Revenue.
+2.  **User Management**:
+    - Searchable user list.
+    - "Ban User" functionality for spam prevention.
+3.  **Performance Metrics**:
+    - Track "Time to Review" (Submission Time vs. Completion Time) to identify bottlenecks in the manual workflow.

src/features/vault/components/quick-analyze-tool.tsx

@@ -80,11 +80,18 @@ export function QuickAnalyzeTool() {
     return (
         <Card className="glass overflow-hidden shadow-sm hover:shadow-md transition-all duration-300">
             <CardContent className="p-4 space-y-4">
+                <div className="space-y-1">
+                    <h3 className="font-semibold text-lg tracking-tight">Create & Share a Public Vault</h3>
+                    <p className="text-sm text-muted-foreground">
+                        Add products to any YouTube video instantly. Your contributions are saved to the public vault for everyone to see. Create an account to claim any video for your own personal vault.
+                    </p>
+                </div>
+
                 <form onSubmit={handleSubmit} className="flex flex-col sm:flex-row items-center gap-3">
                     <div className="relative flex-1 w-full">
                         <Sparkles className="absolute left-3 top-1/2 -translate-y-1/2 h-4 w-4 text-amber-400/80" />
                         <Input
-                            placeholder="Paste any YouTube link to see Vault in action..."
+                            placeholder="Paste a YouTube link to add products & build a vault..."
                             value={url}
                             onChange={(e) => setUrl(e.target.value)}
                             className="pl-10 h-11 bg-secondary/50 border-border focus:border-primary/50 transition-all font-medium"
@@ -100,7 +107,7 @@ export function QuickAnalyzeTool() {
                             <Loader2 className="h-4 w-4 animate-spin" />
                         ) : (
                             <span className="flex items-center gap-2">
-                                See it in Action
+                                Create Public Vault
                             </span>
                         )}
                     </Button>
@@ -112,7 +119,7 @@ export function QuickAnalyzeTool() {
                         <div className="flex items-center gap-2 mb-3">
                             <Users className="h-3.5 w-3.5 text-primary" />
                             <span className="text-[10px] uppercase tracking-widest font-bold text-muted-foreground">
-                                Existing Community Vaults
+                                View Public Vaults created by others
                             </span>
                         </div>
 
@@ -151,7 +158,7 @@ export function QuickAnalyzeTool() {
                 <div className="flex items-center justify-between px-1">
                     <div className="flex items-center gap-2 text-[10px] uppercase tracking-wider font-bold text-muted-foreground/60">
                         <div className="h-1 w-1 rounded-full bg-emerald-500" />
-                        Instant Preview • No Account Required
+                        Instant Access • Public Vault • No Sign-up
                     </div>
                 </div>
 

token.txt

@@ -0,0 +1 @@
+rw_Fe26.2**697f4b3bc35ad47e30ed7b47caebab2f0b5fe6123b0c2e955619ff10d25afcd4*JdDh0I8b-Y0QD-8fscbaVQ*zNQztyWi6dfFMTxFaLxSqkyv5E9O1j7m1_EYHfdfQb7ZugO9_-siGysXRtU8Erd1pLbqKOJP4EWKsNdH3JXr6g*1771815081405*85be130ca8d17ce9de8c54567d932782ea8aff7f84c3f9b35193483b6445f8bf*mHVmPbon5WFHa9DjC01hTmTQYBTCmZx6mgl8_79O5pY