Skip to content

SavvyDealer vCard

Repo: savvydealer-adam/savvydealer-vcard · Path: C:/Users/adam/savvydealer-vcard · Owner: Adam Status: Live · % Done: 80 · Last commit: 2026-01-19 Deployed: Cloud Run (GCP savvydealer-website)

What it is

Self-service digital business card (vCard) generator — dealership staff create their own shareable card with photo + QR code without going through IT.

Why it exists

Dealership sales reps turn over constantly; manual vCard production is a time sink. Give staff a self-serve tool, get a consistent brand-compliant card every time, and share via QR code.

How it works

  • Python/FastAPI single-file app (main.py)
  • SQLite local DB (vcard.db) for stored cards
  • Photo upload via multipart form → stored in uploads/photos/
  • qrcode library generates scannable QR pointing to the hosted card URL
  • Google OAuth admin authentication (added 2026-01-19)
  • HTML responses rendered directly (no separate frontend framework)

What's done

  • vCard create + share + QR flow
  • Photo upload + storage
  • Admin panel with Google OAuth
  • Cloud Run deploy

What's next

  • Optional: migrate from SQLite to Postgres if multi-instance scaling needed
  • Deeper integration with SavvyDealer CRM for auto-card-on-hire
  • Export to Apple Wallet / Google Wallet passes

Where the code lives

  • App: main.py
  • DB: vcard.db (SQLite)
  • Uploads: uploads/photos/
  • Deploy: Dockerfile + cloudbuild.yaml
  • Deps: requirements.txt

Integrations

  • Google OAuth (admin)
  • Standalone — no coupling to other SavvyDealer products yet (candidate for CRM auto-provisioning)

Don't rebuild this — extend it

For any dealer staff digital-card / QR-share need, extend this service. Don't build a parallel card generator.