How mus1eh/auctionapi works
Auction API supports account and role management, product listing and admin approval, timed bidding, owner decisions, CSV imports, and queued email notifications; a React frontend drives those workflows through the REST API. The principal path is marketplace user → API → product approval/listing → bids → scheduled auction closure and owner decision → email outbox delivery. Edges reflect the README, source-index references, and shown excerpts; unsampled service and frontend internals limit finer call-level links.
Main entry points: tasks.py Scheduled tasks · routers API routes · product.py Product repository · database.py PostgreSQL database
Components 21
Auction frontend
- Marketplace UI
frontend/src/App.tsx - Session handling
frontend/src/auth/AuthProvider.tsx - API client
frontend/src/api/client.ts
REST API
- FastAPI application
app/main.py - API routes
app/routers
Auction workflows
- Authentication
app/services/authentication - Product lifecycle
app/services/products - Bidding decisions
app/services/bids - Admin actions
app/services/admin - Auction closure
app/services/auctions/close.py
Persistence
- Domain records
app/models - Product repository
app/repositories/product.py - Bid repository
app/repositories/bids.py - Auth repository
app/repositories/authentication.py - Email outbox repository
app/repositories/email_outbox.py - PostgreSQL database
app/core/database.py
Background delivery
- Celery worker and beat
app/worker/celery_app.py - Scheduled tasks
app/worker/tasks.py - SMTP mailer
app/mailer/service.py
Other components
- Marketplace user
- SMTP service
Connections 24
- Marketplace user → Marketplace UI: uses
README.md - Marketplace UI → API client: requests through
frontend/src/App.tsx - Session handling → API client: manages session
frontend/src/auth/AuthProvider.tsx - API client → API routes: calls REST API
README.md - FastAPI application → API routes: registers
app/main.py - API routes → Authentication: invokes
app/routers/authentication.py - API routes → Product lifecycle: invokes
app/routers/product.py - API routes → Admin actions: serves admin actions
app/routers/admin.py - Product lifecycle → Product repository: uses
app/services/products/csv.py - Bidding decisions → Product repository: reads and locks
app/services/bids/approvebid.py - Bidding decisions → Bid repository: uses
app/services/bids/approvebid.py - Bidding decisions → Email outbox repository: queues notices
app/services/bids/approvebid.py - Scheduled tasks → Auction closure: closes auctions
app/worker/tasks.py - Scheduled tasks → Product repository: locks expired products
app/worker/tasks.py - Scheduled tasks → Bid repository: loads bids
app/worker/tasks.py - Scheduled tasks → Email outbox repository: processes outbox
app/worker/tasks.py - Scheduled tasks → SMTP mailer: sends queued email
app/worker/tasks.py - SMTP mailer → SMTP service: sends mail
README.md - Celery worker and beat → Scheduled tasks: runs scheduled tasks
app/worker/tasks.py - Product repository → PostgreSQL database: queries and writes
app/repositories/product.py - Auth repository → PostgreSQL database: stores tokens
app/repositories/authentication.py - Email outbox repository → PostgreSQL database: stores email queue
app/worker/tasks.py - Domain records → PostgreSQL database: maps records
app/models/__init__.py - Authentication → Auth repository: uses
app/services/authentication/login.py