How dave0321/ecosync works
EcoSync orchestrates startup–mentor discovery: users register, startup and mentor profiles are represented semantically, and the documented AI pipeline combines graph, historical-context, and semantic signals into explainable recommendations. Organizers review pending matches and approve relationships; dashboards expose programme, ecosystem, analytics, and lifecycle views. Sampled backend routes confirm profile extraction and programme generation, but not match-generation routing. Other pipeline stages and frontend capabilities are documented in the README; their internal call wiring was not sampled.
Main entry points: main.py FastAPI engine · embeddings.py Semantic embeddings · services Match lifecycle service · page.tsx Organizer console
Components 26
User Workspaces
- Startup workspace
frontend/src/app/startup/matches/page.tsx - Mentor workspace
frontend/src/app/mentor/matches/page.tsx - Organizer console
frontend/src/app/admin/dashboard/page.tsx
Identity and Data
- Account signup
frontend/src/app/auth/signup/page.tsx - Firebase client
frontend/src/lib/firebase.ts - Supabase client
frontend/src/lib/supabase.ts - Backend database client
ai_engine/database.py - Ecosystem store
AI Matching Engine
- FastAPI engine
ai_engine/main.py - Profile and match models
ai_engine/models.py - Profile extraction
ai_engine/services/extraction.py - Semantic embeddings
ai_engine/services/embeddings.py - Ecosystem graph
ai_engine/services - HGT link prediction
ai_engine/services/hgt_model.py - RAG retrieval
ai_engine/services - Hybrid ranking
ai_engine/services - Match explanations
ai_engine/services - Programme generation
ai_engine/services/generator.py
Match Lifecycle
- Match lifecycle service
ai_engine/services - Pending recommendations
- Mentorship relationships
- Outcome feedback
Other components
- Startup, mentor, organizer
- Firebase Authentication
- Google Gemini
- Supabase PostgreSQL
Connections 33
- Startup, mentor, organizer → Account signup: registers
frontend/src/app/auth/signup/page.tsx - Account signup → Firebase client: creates account
frontend/src/app/auth/signup/page.tsx - Account signup → Supabase client: registers profile
frontend/src/app/auth/signup/page.tsx - Firebase client → Firebase Authentication: authenticates
- Supabase client → Supabase PostgreSQL: accesses data
- Startup, mentor, organizer → Startup workspace: uses
- Startup, mentor, organizer → Mentor workspace: uses
- Startup, mentor, organizer → Organizer console: uses
- Startup workspace → FastAPI engine: requests matching
- Mentor workspace → FastAPI engine: requests matching
- Organizer console → FastAPI engine: uses REST API
- FastAPI engine → Backend database client: checks health
ai_engine/main.py - Backend database client → Ecosystem store: queries
- FastAPI engine → Profile extraction: extracts profile
ai_engine/main.py - FastAPI engine → Programme generation: generates details
ai_engine/main.py - Profile extraction → Google Gemini: extracts JSON
ai_engine/services/extraction.py - Programme generation → Google Gemini: generates JSON
ai_engine/services/generator.py - Profile extraction → Semantic embeddings: feeds profiles
- Semantic embeddings → Supabase PostgreSQL: stores vectors
- Semantic embeddings → Ecosystem graph: provides vectors
- Ecosystem graph → HGT link prediction: builds graph input
- Semantic embeddings → RAG retrieval: embeds knowledge
- RAG retrieval → Supabase PostgreSQL: retrieves context
- HGT link prediction → Hybrid ranking: supplies graph score
- RAG retrieval → Hybrid ranking: supplies history
- Semantic embeddings → Hybrid ranking: supplies semantic score
- Hybrid ranking → Match explanations: selects top match
- Match explanations → Google Gemini: generates narrative
- FastAPI engine → Match lifecycle service: manages matches
ai_engine/main.py - Match lifecycle service → Pending recommendations: creates pending
- Match lifecycle service → Mentorship relationships: activates approved
- Match lifecycle service → Outcome feedback: records outcomes
- Organizer console → Pending recommendations: reviews pending