Commit Graph
2 Commits
Author SHA1 Message Date
john-okeefe bd9715c272 Fix and refine frontend scan button implementation plan
Updated TASKS-scanning-progress.md Part 1 with critical fixes and
clarifications for implementing the admin page scan button functionality.

Fixes Applied:
- Converted inline JavaScript to TypeScript using existing web/src/admin.ts
- Fixed animation implementation to use TailwindCSS classes instead of custom CSS
- Added missing implementation steps:
  * Include admin.js in admin.templ
  * Remove old quickScan() function after migration
  * Build frontend assets step
- Fixed animation trigger by removing opacity/transform classes that prevented display
- Corrected API endpoint usage (/api/libraries/{id}/scan not /api/scanner/scan)

Root Cause Analysis:
- Original quickScan() sent empty folder_paths array causing 400 errors
- No "scan all libraries" endpoint exists - must scan each library individually
- Frontend had admin.ts but wasn't including it in templates

Implementation Approach:
- Fetch all libraries via GET /api/libraries
- Trigger scan for each library via POST /api/libraries/{id}/scan
- Display consolidated progress UI with animation
- Handle errors gracefully per library
- Use TypeScript for type safety
- Leverage TailwindCSS for all styling (no custom CSS)

Documentation Structure:
- Part 1: Admin scan button implementation (frontend)
- Part 2: Dashboard diagnosis and fixes (to be completed after backend work)

This plan is now ready for implementation after backend progress tracking
is completed (as documented in TASKS-backend-progress-tracking.md).
2026-02-25 10:40:10 -05:00
john-okeefe e8effeb666 docs: add comprehensive scanning progress implementation plan
Add detailed implementation plan for fixing Scan Library button and
diagnosing dashboard display issues. Documents investigation findings,
implementation steps, and testing requirements.

Content Sections:
- Fixed Issues: Bruno JSON syntax correction
- Issue 1: Scan Library Button (frontend fix needed)
- Issue 2: Scanned Books Not Showing on Dashboard (diagnosis needed)
- Complete Implementation Plan with code examples
- Diagnostic Steps for dashboard issue
- Potential fixes for all scenarios
- Testing checklist
- Related files and dependencies

Key Findings Documented:
1. Scan Library Button
   - Current: Sends folder_paths: [] → 400 error
   - Fix: Fetch all libraries, scan each, track progress
   - Includes full JavaScript implementation

2. Dashboard Display Issue
   - Books exist in database after scan
   - Not appearing on dashboard UI
   - Root cause requires diagnosis
   - Multiple hypotheses provided

3. Implementation Priority
   - HIGH: Fix Scan button (2-3 hours)
   - MEDIUM: Diagnose dashboard (30 min)
   - LOW: Fix dashboard (unknown)

Implementation Details:
- Complete quickScan() rewrite with error handling
- Progress UI with real-time polling
- Per-library progress tracking
- Results summary display
- CSS animations and styling
- Full diagnostic checklist

Benefits:
- Single source of truth for scanning work
- Can resume implementation at any time
- Documents all investigation findings
- Includes copy-paste ready code examples
- Testing checklist for validation

File: TASKS-scanning-progress.md
Lines: 600+
Related: templates/admin.templ, templates/dashboard.templ
2026-02-24 21:33:55 -05:00