How farnai/jester works
JESTER is a people-discovery and relationship-intelligence product: users register and provide birth/profile details, discover people, inspect compatibility, and continue through connections and messaging. Its backend calculates private natal astrology, derives deterministic synastry, and resolves signals into contextual interpretation; discovery itself is documented as bounded and does not recalculate astrology. The graph combines sampled call/import evidence with README-documented capabilities. Unsampled feature implementations are represented at supported directory paths; their internal call wiring is not inferred.
Main entry points: comparisons/router.py Comparison API · api/router.py API router · client.ts API client · AppRoutes.tsx App routes
Components 23
Web client
- App routes
frontend/src/navigation/AppRoutes.tsx - Auth screens
frontend/src/modules/auth - Birth onboarding
frontend/src/modules/onboarding - API client
frontend/src/core/api/client.ts - Discover people
frontend/src/modules/discover - Compatibility views
frontend/src/modules/compatibility - Social surfaces
frontend/src/modules/connections - Messages and chat
frontend/src/modules/messages
Identity and profiles
- JWT identity
backend/app/auth/dependencies.py - Profiles and photos
backend/app/profiles/router.py - Canonical locations
backend/app/geo/service.py
Astrology and interpretation
- Natal astrology
backend/app/astrology/natal.py - Synastry scoring
backend/app/compatibility/engine.py - Interpretation engine
backend/app/interpretation/engine.py - Georgian content
backend/app/interpretation/library.py
Discovery and relationships
- Discovery API
backend/app/discovery/router.py - Comparison API
backend/app/comparisons/router.py - Connection states
backend/app/connections/router.py - Conversations
backend/app/conversations/router.py
API and persistence
- API router
backend/app/api/router.py - PostgreSQL / Supabase
backend/app/core/database.py
Other components
- Person
- Supabase Auth
Connections 35
- Person → App routes: uses
README.md - App routes → Auth screens: routes to
frontend/src/navigation/AppRoutes.tsx - App routes → Birth onboarding: routes to
frontend/src/navigation/AppRoutes.tsx - App routes → Discover people: routes to
frontend/src/navigation/AppRoutes.tsx - App routes → Compatibility views: routes to
frontend/src/navigation/AppRoutes.tsx - Person → Auth screens: registers
README.md - Auth screens → Supabase Auth: authenticates
README.md - Birth onboarding → API client: submits details
- Discover people → API client: requests people
- Compatibility views → API client: requests comparison
- Social surfaces → API client: uses API
- Messages and chat → API client: uses API
- API client → API router: calls API
README.md - API router → Discovery API: registers
backend/app/api/router.py - API router → Comparison API: registers
backend/app/api/router.py - API router → Profiles and photos: registers
backend/app/api/router.py - API router → Connection states: registers
backend/app/api/router.py - API router → Conversations: registers
backend/app/api/router.py - Supabase Auth → JWT identity: issues JWT
README.md - Profiles and photos → JWT identity: depends on
backend/app/profiles/router.py - Profiles and photos → Canonical locations: uses locations
backend/app/profiles/router.py - Discovery API → JWT identity: depends on
backend/app/discovery/router.py - Discovery API → PostgreSQL / Supabase: queries profiles
backend/app/discovery/router.py - Comparison API → JWT identity: depends on
backend/app/comparisons/router.py - Comparison API → PostgreSQL / Supabase: reads and writes
backend/app/comparisons/router.py - Comparison API → Natal astrology: recalculates charts
backend/app/comparisons/router.py - Comparison API → Synastry scoring: calculates synastry
backend/app/comparisons/router.py - Synastry scoring → Interpretation engine: provides signals
README.md - Comparison API → Interpretation engine: resolves analysis
backend/app/comparisons/router.py - Interpretation engine → Georgian content: resolves copy
backend/app/interpretation/engine.py - Natal astrology → PostgreSQL / Supabase: stores private chart
README.md - Connection states → PostgreSQL / Supabase: stores states
README.md - Conversations → PostgreSQL / Supabase: stores messages
README.md - Discover people → Social surfaces: opens profiles
- Compatibility views → Social surfaces: invites connection