feat: newm-admin Earnings dashboard

Author: AndrewWestberg

.agent/task/admin/newm-admin.md

@@ -76,12 +76,144 @@ graph LR
 
 **Priority:** High
 
+#### API Endpoints
+
+The admin app uses JWT-protected admin endpoints from the backend:
+
+| Endpoint | Method | Purpose |
+|----------|--------|---------|
+| `/v1/earnings/admin` | GET | Fetch all earnings records |
+| `/v1/earnings/admin` | POST | Batch create earnings (accepts `List<Earning>`) |
+| `/v1/earnings/admin/{songIdOrIsrc}` | GET | Get earnings by song ID or ISRC |
+| `/v1/earnings/admin/{songIdOrIsrc}` | POST | Create royalty splits for a song |
+
+**Earning Model Fields:**
+- `id` (UUID), `songId` (UUID), `stakeAddress`, `amount` (Long, 6 decimals)
+- `memo`, `startDate`, `endDate`, `claimed`, `claimedAt`, `claimOrderId`
+- `createdAt`, `nftPolicyId`, `nftAssetName`
+
+**AddSongRoyaltyRequest:** Either `newmAmount` or `usdAmount` (BigInteger, 6 decimals)
+
+---
+
+#### UI Components
+
+##### Summary Boxes
+
+Three summary cards at the top of the Earnings dashboard, calculated from the filtered data:
+
+| Box | Description | Calculation |
+|-----|-------------|-------------|
+| **Total Earnings** | Sum of all earnings in current filter | `Σ earning.amount` |
+| **Claimed Earnings** | Sum of claimed earnings | `Σ earning.amount WHERE claimed == true` |
+| **Unclaimed Earnings** | Sum of unclaimed earnings | `Total - Claimed` |
+
+> [!NOTE]
+> All amounts display in NEWM tokens with 6 decimal places, prefixed with `Ɲ` symbol (e.g., `Ɲ 1,234.567890`).
+
+##### Earnings Table
+
+A sortable, filterable table displaying all earnings:
+
+| Column | Sortable | Filterable | Notes |
+|--------|----------|------------|-------|
+| ID | ❌ | ❌ | UUID |
+| Song ID | ✅ | ✅ | UUID or display song title if available |
+| Stake Address | ✅ | ✅ | Cardano stake address |
+| Amount | ✅ | ❌ | Display as `Ɲ X.XXXXXX` |
+| Memo | ❌ | ✅ | Freeform text |
+| Claimed | ✅ | ✅ | Boolean (checkbox filter) |
+| Claimed At | ✅ | ❌ | DateTime, null if unclaimed |
+| Created At | ✅ | ✅ | DateTime (supports date range filter) |
+
+**Table Features:**
+- **Refresh Button:** Fetches latest data from server
+- **Date Range Filter:** Filter by `createdAt` date range (critical requirement)
+- **Infinite Scroll:** Virtual list handles large datasets efficiently
+
+##### Toast Notification System
+
+A toast notification system to inform users of API operation results:
+
+| Toast Type | Behavior | Auto-Dismiss |
+|------------|----------|--------------|
+| **Success** | Green background, checkmark icon | 5 seconds |
+| **Warning** | Yellow/orange background, warning icon | Manual X close required |
+| **Error** | Red background, error icon | Manual X close required |
+
+Toast content should include:
+- Clear message describing success or failure
+- For failures: Include error message from API response
+- Position: Top-right corner of the work area, stacked if multiple
+
+---
+
+#### Workflows
+
+##### Add Earnings (Single Song)
+
+**Button:** "Add Earnings" in the toolbar
+
+**Dialog Fields:**
+| Field | Type | Description |
+|-------|------|-------------|
+| Song ID or ISRC | Text input | Accepts UUID or ISRC format (e.g., `USRC12345678`) |
+| Amount (USD) | Decimal input | User enters USD value (e.g., `10.50`) |
+
+**Process:**
+1. User enters songId/ISRC and USD amount
+2. Convert amount to 6-decimal integer: `10.50` → `10500000`
+3. Call `POST /v1/earnings/admin/{songIdOrIsrc}` with `{ usdAmount: 10500000 }`
+4. On success: Show success toast, refresh table
+5. On failure: Show error toast with API error message
+
+##### Upload Earnings CSV
+
+**Button:** "Upload CSV" in the toolbar
+
+**CSV Format (Input):**
+```csv
+songId_or_isrc,amount_usd
+550e8400-e29b-41d4-a716-446655440000,10.50
+USRC12345678,25.00
+```
+
+**Process:**
+1. User selects CSV file via native file picker
+2. Parse CSV, validate format (2 columns required)
+3. For each row:
+   - Convert USD to 6-decimal integer
+   - Call `POST /v1/earnings/admin/{songIdOrIsrc}`
+   - Record result (success or error message)
+4. Modify CSV to add result column
+5. Save modified CSV with results
+
+**CSV Format (Output):**
+```csv
+songId_or_isrc,amount_usd,result
+550e8400-e29b-41d4-a716-446655440000,10.50,Success
+USRC12345678,25.00,Error: No song found with ISRC: USRC12345678
+```
+
+6. Show summary toast: "Processed X records: Y succeeded, Z failed"
+7. If any failures: Show warning toast prompting user to check output file
+
+---
+
+#### Implementation Status
+
 | Requirement | Status |
 |-------------|--------|
-| List all earnings with pagination | ⬜ Not started |
-| Filter by artist, song, date range | ⬜ Not started |
-| View earnings details | ⬜ Not started |
-| Export earnings data | ⬜ Not started |
+| List all earnings with sortable, scrollable table | ✅ Completed |
+| Filter by date range | ✅ Completed |
+| Filter by stake address, song, memo | ✅ Completed |
+| Summary boxes (Total/Claimed/Unclaimed) | ✅ Completed |
+| NEWM token display with Ɲ symbol | ✅ Completed |
+| Refresh button | ✅ Completed |
+| Toast notification system | ✅ Completed |
+| Add Earnings dialog | ✅ Completed |
+| Upload CSV workflow | ⬜ Not started |
+| CSV result export | ⬜ Not started |
 
 ### 🔲 Refunds Processing
 
@@ -178,6 +310,7 @@ The admin app communicates with the NEWM backend:
 
 | Date | Feature | Description |
 |------|---------|-------------|
+| 2026-01-08 | Earnings Table | Full-featured earnings table with filtering, sorting, date range, summary stats, copy-to-clipboard |
 | 2026-01-07 | Dashboard | Added sidebar nav with Earnings/Refunds, work area panels |
 | 2026-01-07 | Auth | JWT admin validation, login view with environment selector |
 | 2026-01-06 | Init | Project setup with GPUI, basic login UI |

newm-admin/Cargo.lock

@@ -28,3 +28,4 @@ anyhow = "1"
 
 # JWT Parsing
 base64 = "0.22"
+chrono = "0.4.42"

newm-admin/Cargo.toml

@@ -1,5 +1,8 @@
 use gpui::*;
+use gpui_component::Root;
 
+use crate::auth::{Environment, LoginResponse};
+use crate::session::{Session, SessionExpiredEvent};
 use crate::views::dashboard::DashboardView;
 use crate::views::login::LoginView;
 
@@ -15,6 +18,7 @@ pub struct AdminApp {
     current_view: AppView,
     login_view: Entity<LoginView>,
     dashboard_view: Entity<DashboardView>,
+    session: Option<Session>,
 }
 
 impl AdminApp {
@@ -25,31 +29,66 @@ impl AdminApp {
         // Subscribe to login success events
         cx.subscribe(
             &login_view,
-            |this, _login, _event: &LoginSuccessEvent, cx| {
+            |this, _login, event: &LoginSuccessEvent, cx| {
+                // Create session from login response
+                this.session = Some(Session::new(
+                    event.login_response.clone(),
+                    event.environment,
+                ));
+
+                // Update dashboard with session
+                this.dashboard_view.update(cx, |dashboard, cx| {
+                    dashboard.set_session(this.session.clone(), cx);
+                });
+
                 this.current_view = AppView::Dashboard;
                 cx.notify();
             },
         )
         .detach();
 
+        // Subscribe to session expired events from dashboard
+        cx.subscribe(
+            &dashboard_view,
+            |this, _dashboard, event: &SessionExpiredEvent, cx| {
+                tracing::warn!("Session expired: {}", event.message);
+
+                // Clear session and return to login
+                this.session = None;
+                this.current_view = AppView::Login;
+
+                cx.notify();
+            },
+        )
+        .detach();
+
         Self {
             current_view: AppView::default(),
             login_view,
             dashboard_view,
+            session: None,
         }
     }
 }
 
 impl Render for AdminApp {
-    fn render(&mut self, _window: &mut Window, _cx: &mut Context<Self>) -> impl IntoElement {
-        div().size_full().child(match self.current_view {
-            AppView::Login => self.login_view.clone().into_any_element(),
-            AppView::Dashboard => self.dashboard_view.clone().into_any_element(),
-        })
+    fn render(&mut self, window: &mut Window, cx: &mut Context<Self>) -> impl IntoElement {
+        div()
+            .size_full()
+            .child(match self.current_view {
+                AppView::Login => self.login_view.clone().into_any_element(),
+                AppView::Dashboard => self.dashboard_view.clone().into_any_element(),
+            })
+            // Render notification layer on top
+            .children(Root::render_notification_layer(window, cx))
     }
 }
 
-/// Event emitted when login succeeds
-pub struct LoginSuccessEvent;
+/// Event emitted when login succeeds, contains tokens and environment
+pub struct LoginSuccessEvent {
+    pub login_response: LoginResponse,
+    pub environment: Environment,
+}
 
 impl EventEmitter<LoginSuccessEvent> for LoginView {}
+impl EventEmitter<SessionExpiredEvent> for DashboardView {}