How sriram-dee/happiffie works
Happiffie is an event-vendor marketplace whose main host workflow turns a natural-language or structured request into saved criteria, eligible vendors, scored and ranked recommendations, and invitations. The backend separates parsing, hard eligibility, scoring, and ranking; it can use MongoDB or in-memory data and optionally Gemini. The README documents audit breakdowns and vendor/admin workflows; their detailed API interactions are not fully shown in the excerpts, so those links are documented rather than inferred from co-location.
Main entry points: matching.service.js Matching orchestrator · App.jsx Marketplace app · requirement.controller.js Requirement API · vendor.controller.js Vendor management API
Components 27
Host matching
- Marketplace app
frontend/src/App.jsx - Requirement studio
frontend/src/components/RequirementForm.jsx - Recommendations
frontend/src/components/RecommendationCard.jsx - Score audit
frontend/src/components/ScoreBreakdownModal.jsx - Invitation tracker
frontend/src/components/InvitationsView.jsx
Matching engine
- Requirement parsing and rationale
backend/services/gemini.service.js - Hard eligibility
backend/services/eligibility.service.js - Seven-factor scoring
backend/services/scoring.service.js - Recommendation ranking
backend/services/ranking.service.js - Matching orchestrator
backend/services/matching.service.js
Vendor marketplace
- Vendor portal
frontend/src/components/VendorPortal.jsx - Vendor access
frontend/src/components/VendorAuthGate.jsx - Marketplace landing
frontend/src/components/LandingPage.jsx
Vendor and admin operations
- Admin console
frontend/src/components/AdminDashboard.jsx
Persistence and API
- Requirement API
backend/controllers/requirement.controller.js - Vendor management API
backend/controllers/vendor.controller.js - Invitation API
backend/controllers/invitation.controller.js - REST routes
backend/routes/api.js - Vendor records
backend/models/Vendor.js - Requirement records
backend/models/Requirement.js - Match records
backend/models/Match.js - Invitation records
backend/models/Invitation.js - MongoDB connection
backend/config/db.js
Other components
- Event host
- Gemini AI
- Administrator
- Vendor
Connections 31
- Event host → Marketplace app: uses
README.md - Marketplace app → Requirement studio: renders
frontend/src/App.jsx - Marketplace app → Requirement API: submits request
frontend/src/App.jsx - REST routes → Requirement API: routes to
backend/routes/api.js - Requirement API → Requirement parsing and rationale: parses with
backend/controllers/requirement.controller.js - Requirement API → Requirement records: saves
backend/controllers/requirement.controller.js - Requirement API → Matching orchestrator: starts matching
backend/controllers/requirement.controller.js - Matching orchestrator → Vendor records: loads vendors
backend/services/matching.service.js - Matching orchestrator → Hard eligibility: filters
backend/services/matching.service.js - Matching orchestrator → Seven-factor scoring: scores eligible
backend/services/matching.service.js - Matching orchestrator → Recommendation ranking: ranks pool
backend/services/matching.service.js - Matching orchestrator → Requirement parsing and rationale: explains matches
backend/services/matching.service.js - Matching orchestrator → Match records: saves matches
backend/services/matching.service.js - Requirement parsing and rationale → Gemini AI: calls optionally
README.md - Marketplace app → Recommendations: renders
frontend/src/App.jsx - Marketplace app → Score audit: renders
frontend/src/App.jsx - Marketplace app → Invitation tracker: renders
frontend/src/App.jsx - Recommendations → Score audit: opens audit
README.md - Recommendations → Invitation API: invites vendor
README.md - REST routes → Vendor management API: routes vendor calls
backend/routes/api.js - REST routes → Invitation API: routes invitations
backend/routes/api.js - Invitation API → Invitation records: reads and writes
backend/controllers/invitation.controller.js - Vendor management API → Vendor records: reads and updates
backend/controllers/vendor.controller.js - Vendor management API → MongoDB connection: checks connection
backend/controllers/vendor.controller.js - Vendor management API → Vendor records: uses seed data
backend/controllers/vendor.controller.js - Vendor → Vendor portal: uses
README.md - Vendor portal → Vendor access: authenticates through
frontend/src/components/VendorPortal.jsx - Vendor portal → Invitation API: responds to invitations
README.md - Administrator → Admin console: uses
README.md - Admin console → Vendor management API: manages vendors
README.md - Admin console → Match records: inspects matches
README.md