How jeonjas25/cardfolio works
Cardfolio manages a personal baseball-card collection, with a principal workflow from collection browsing or card entry through API-backed persistence to card details and price history. Photo identification fills card fields through Claude; price refreshes dispatch background work that searches eBay, filters listings, computes a median, and records history. The README also documents scheduled stale-price refreshes. The graph uses the sampled endpoint, task, service, and UI calls; some integrations and the scheduler are documented but their configuration details were not sampled.
Main entry points: main.py REST endpoints · App.jsx Route shell · CollectionPage.jsx Collection browser · services.py Refresh service
Components 21
Collection interface
- Route shell
frontend/src/App.jsx - Collection browser
frontend/src/components/CollectionPage.jsx - Search and filters
frontend/src/components/CollectionToolbar.jsx - Card tile
frontend/src/components/Card.jsx - Add card form
frontend/src/components/AddCardForm.jsx - Card details
frontend/src/components/CardDetail.jsx - Price history chart
frontend/src/components/PriceHistoryChart.jsx
Card API
- HTTP client
frontend/src/api.js - REST endpoints
backend/main.py - Request responses
backend/schemas.py - Card record
backend/models.py - PostgreSQL
backend/database.py - Image identification
backend/ai.py
Market pricing
- Celery dispatch
backend/celery_app.py - Price refresh tasks
backend/tasks.py - Refresh service
backend/services.py - eBay listings
backend/ebay.py - Listing matching
backend/pricing.py
Other components
- Collector
- Claude Vision
- eBay Browse API
Connections 25
- Collector → Route shell: uses
- Route shell → Collection browser: routes to
frontend/src/App.jsx - Route shell → Add card form: routes to
frontend/src/App.jsx - Route shell → Card details: routes to
frontend/src/App.jsx - Collection browser → HTTP client: loads cards
frontend/src/components/CollectionPage.jsx - Collection browser → Search and filters: renders
frontend/src/components/CollectionPage.jsx - Collection browser → Card tile: renders
frontend/src/components/CollectionPage.jsx - Add card form → HTTP client: creates and identifies
frontend/src/components/AddCardForm.jsx - Card details → HTTP client: reads and updates
frontend/src/components/CardDetail.jsx - Card details → Price history chart: renders
frontend/src/components/CardDetail.jsx - HTTP client → REST endpoints: HTTP requests
frontend/src/api.js - REST endpoints → Request responses: validates responses
backend/main.py - REST endpoints → Card record: reads and writes
backend/main.py - Card record → PostgreSQL: maps records
backend/models.py - REST endpoints → Image identification: identifies image
backend/main.py - Image identification → Claude Vision: analyzes image
README.md - REST endpoints → Celery dispatch: dispatches refresh
backend/main.py - Celery dispatch → Price refresh tasks: runs tasks
backend/tasks.py - Price refresh tasks → PostgreSQL: queries cards
backend/tasks.py - Price refresh tasks → Refresh service: refreshes card
backend/tasks.py - Refresh service → eBay listings: searches listings
backend/services.py - eBay listings → eBay Browse API: queries sold listings
README.md - Refresh service → Listing matching: filters and prices
backend/services.py - Refresh service → PostgreSQL: commits history
backend/services.py - Collector → REST endpoints: requests stale refresh
README.md