Skip to content

frontend-workflow.md

Latest commit

 

History

History
88 lines (66 loc) · 2.17 KB

frontend-workflow.md

File metadata and controls

88 lines (66 loc) · 2.17 KB
Raw

Frontend Workflow

User flows and state management for Resume Matcher.

Core User Flow

Dashboard → Upload Master Resume → Tailor for Job → View/Edit → Download PDF

Pages

1. Dashboard (/dashboard)

  • No master: "Initialize Master Resume" card
  • Has master: "Master Resume" card + tailored tiles
  • Create: "+" card opens /tailor
  • Auto-refreshes on window focus

2. Resume Viewer (/resumes/[id])

  • Read-only display at 250mm width
  • Actions: Back, Edit, Download PDF, Delete
  • Delete shows confirmation + success dialogs

3. Tailor (/tailor)

  • Job description textarea (min 50 chars)
  • Process: Upload JD → Improve → Redirect to viewer

4. Builder (/builder)

  • Left panel: Editor (forms + formatting)
  • Right panel: WYSIWYG preview
  • Tabs: Resume | Cover Letter | Outreach
  • Data priority: URL param → Context → localStorage → defaults

5. Settings (/settings)

  • System status (cached)
  • LLM configuration (6 providers)
  • Last fetched indicator + manual refresh

Pagination Rules

  • Sections CAN span pages
  • Individual items stay together
  • Pages ≥50% full before break
  • Headers never orphaned

State Management

localStorage

Key Purpose
master_resume_id Master resume UUID
resume_builder_draft Auto-saved form
resume_builder_settings Template prefs

StatusCache Context

  • Initial fetch on app start
  • 30-min auto-refresh
  • Optimistic counter updates

Delete Flow

  1. Click Delete → Confirmation dialog
  2. API: DELETE /resumes/{id}
  3. Clear localStorage if master
  4. Success dialog → Redirect to dashboard

Section Management

Action Result
Rename Click pencil icon
Reorder Up/down arrows
Hide Eye icon (hidden sections still editable)
Delete Hides default, removes custom
Add "Add Section" button

API Client

import { fetchResume, API_BASE } from '@/lib/api';

// Resume operations
fetchResume, fetchResumeList, updateResume, deleteResume
uploadJobDescriptions, improveResume, downloadResumePdf

// Config operations  
fetchLlmConfig, updateLlmConfig, testLlmConnection