How ursusz/essenza works
Essenza is a perfume-focused web app whose documented capabilities include visual scanning, perfume catalog and community scores, anti-counterfeit guidance, a personal wardrobe, and gamification. Its principal scan workflow is intended to take a user image through API scan handling and an S3-triggered processor, then return recognition results through an internal callback. Most domain modules are represented only by directory structure, and the scan processor is explicitly unfinished; the graph therefore distinguishes documented structure from unverified runtime connections.
Main entry points: EssenzaApplication.java API application · App.tsx PWA interface · scan Scan decisions · handler.py Image processor
Components 16
Web client
- PWA interface
web/src/App.tsx - Web entry point
web/src/main.tsx
Spring API
- API application
api/src/main/java/ro/unibuc/essenza/EssenzaApplication.java - Accounts and JWT
api/src/main/java/ro/unibuc/essenza/auth - Scan decisions
api/src/main/java/ro/unibuc/essenza/scan - Perfume catalog
api/src/main/java/ro/unibuc/essenza/catalog - Reviews and scores
api/src/main/java/ro/unibuc/essenza/review - Authenticity checks
api/src/main/java/ro/unibuc/essenza/authenticity - Personal wardrobe
api/src/main/java/ro/unibuc/essenza/wardrobe - Gamification
api/src/main/java/ro/unibuc/essenza/gamification - Influencer articles
api/src/main/java/ro/unibuc/essenza/article
Scan processing
- Scan object store
- Image processor
scan-processor/app/handler.py
Catalog and data
- Catalog ingestion
ingest/ingest/__main__.py - Application database
api/src/main/resources/db/migration
Other components
- Perfume user
Connections 16
- Web entry point → PWA interface: renders
web/src/main.tsx - Perfume user → PWA interface: uses
- PWA interface → API application: API requests
- API application → Scan decisions: routes scans
- Scan decisions → Scan object store: uploads scans
README.md - Scan object store → Image processor: object-created event
scan-processor/app/handler.py - Image processor → Scan decisions: recognition callback
README.md - API application → Accounts and JWT: provides security
README.md - API application → Perfume catalog: serves catalog
README.md - API application → Reviews and scores: serves reviews
README.md - API application → Authenticity checks: serves checks
README.md - API application → Personal wardrobe: serves wardrobe
README.md - API application → Gamification: serves features
README.md - API application → Influencer articles: serves articles
README.md - Catalog ingestion → Perfume catalog: loads catalog
ingest/ingest/__main__.py - API application → Application database: persists data