How maanavar/sanstro works
Vinaadi AI is a Tamil-first bilingual astrology companion with Expo mobile and Next.js web clients backed by a FastAPI service. The user-facing path runs from account and birth details to chart generation, then to personalized readings, daily guidance, and tools such as panchangam and muhurta. The backend also covers numerology, relationships, notifications, and personal records. The graph reflects documented client/API boundaries and sampled module references; several domain implementations are unsampled, so their internal call paths are not asserted.
Main entry points: main.py FastAPI app · public_tools.py Public tools · charts.py Chart endpoints · narrative_engine.py Narrative guidance
Components 22
Client apps
- Mobile app
mobile/app - Web app
web/app - Shared API package
packages/shared/src/api
API and identity
- FastAPI app
app/main.py - Authentication
app/api/auth.py - Birth profiles
app/api/birth_profiles.py - Chart endpoints
app/api/charts.py - Public tools
app/api/public_tools.py
Astrology and guidance
- Chart calculations
app/calculations/astro.py - Chart strength
app/calculations/chart_strength.py - Astrology display names
app/calculations/display_names.py - Narrative guidance
app/services/narrative_engine.py - Daily guidance
app/services/daily_guidance_service.py - Panchangam
app/calculations/panchangam.py - Transits
app/calculations/transits.py - Muhurta
app/calculations/muhurta_engine.py - Numerology
app/calculations/numerology.py
Data and operations
- Database sessions
app/db/session.py - Domain records
app/models - Configuration
app/core/config.py - Age gate
app/core/age_gate.py
Other components
- User
Connections 24
- User → Mobile app: uses
README.md - User → Web app: uses
README.md - Mobile app → Shared API package: uses API
- Web app → FastAPI app: proxies requests
README.md - Mobile app → FastAPI app: calls API
README.md - FastAPI app → Authentication: registers routes
app/main.py - FastAPI app → Birth profiles: registers routes
app/main.py - FastAPI app → Chart endpoints: registers routes
app/main.py - FastAPI app → Public tools: registers routes
app/main.py - Authentication → Database sessions: opens session
app/api/auth.py - Birth profiles → Database sessions: opens session
app/api/birth_profiles.py - Chart endpoints → Chart calculations: uses calculations
app/api/charts.py - Chart endpoints → Chart strength: uses calculations
app/api/charts.py - Narrative guidance → Chart calculations: uses calculations
app/services/narrative_engine.py - Narrative guidance → Chart strength: uses calculations
app/services/narrative_engine.py - Narrative guidance → Astrology display names: uses labels
app/services/narrative_engine.py - Public tools → Muhurta: exposes tool
- Public tools → Panchangam: exposes tool
- Public tools → Numerology: exposes tool
- Database sessions → Configuration: reads settings
app/db/session.py - Database sessions → Domain records: persists records
app/models/__init__.py - Chart endpoints → Age gate: checks access
app/api/charts.py - Public tools → Transits: offers astrology
- Daily guidance → Narrative guidance: builds guidance