# vedaai25/astro_assist architecture

> Architecture diagram of the GitHub repository vedaai25/astro_assist, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vedaai25/astro_assist
- Repository: https://github.com/vedaai25/astro_assist

## Overview

Astro_assist is a Vedic astrology application with a React frontend and a Node backend. The main user journey is entering birth details and location, requesting a natal chart, then exploring chart views and personalized readings, dasha phases, and transits. The tree also shows dedicated features for daily alerts, long-range forecasts, karma, consultations, and self-analysis. Frontend excerpts establish chart-query and rendering relationships; the README gives no architectural detail, and most backend routes and calculations were not sampled, so their connections are left unspecified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/App.jsx) (Chart Experience), [`frontend/src/hooks/useChartQuery.js`](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/hooks/useChartQuery.js) (Chart Query), [`frontend/src/components/OnboardingWizard/OnboardingWizard.jsx`](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/components/OnboardingWizard/OnboardingWizard.jsx) (Birth Onboarding), [`frontend/src/components/Chart/SouthIndianChart.jsx`](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/components/Chart/SouthIndianChart.jsx) (Chart Views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_app["Chart Experience<br/>[App.jsx]"]
  node_onboarding["Birth Onboarding"]
  node_chart_views["Chart Views"]
  node_reading_views["Reading Pages<br/>[ReadingPage.jsx]"]
  node_transit_views["Transit Views<br/>[TransitPage.jsx]"]
  node_current_time["Current Time"]
end

subgraph group_frontend_data["Frontend Data"]
  node_onboarding_state["Onboarding State<br/>[onboardingSlice.js]"]
  node_location_state["Location State<br/>[locationSlice.js]"]
  node_chart_query["Chart Query<br/>[useChartQuery.js]"]
  node_chart_api["Chart API Client<br/>[chartApi.js]"]
  node_readings_state["Reading State<br/>[readingsSlice.js]"]
  node_transit_api["Transit API Client<br/>[transitApi.js]"]
end

subgraph group_astrology["Astrology Domain"]
  node_vedic_calcs["Vedic Calculations<br/>[vedic-utils.js]"]
  node_alert_engine["Daily Alert Engine<br/>[horaEngine.js]"]
  node_consultation_engine["Consultation Engine<br/>[questionEngine.js]"]
  node_astro_context["Chart Context<br/>[context.js]"]
  node_chart_calculator["Chart Calculator<br/>[chartCalculator.js]"]
end

subgraph group_backend_services["Backend Services"]
  node_backend_routes["API Routes<br/>[chart.js]"]
  node_reading_routes["Reading Routes<br/>[index.js]"]
  node_profile_store[("Profile Store<br/>[profileStore.js]")]
  node_gemini["Gemini Service<br/>[gemini.js]"]
end

node_user(("Astrology User"))

node_user -->|"enters birth details"| node_onboarding
node_user -->|"explores astrology"| node_app
node_app -->|"requests chart"| node_chart_query
node_chart_query -->|"calls"| node_chart_api
node_app -->|"renders"| node_chart_views

click node_app "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/App.jsx"
click node_onboarding "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/components/OnboardingWizard/OnboardingWizard.jsx"
click node_chart_views "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/components/Chart/SouthIndianChart.jsx"
click node_reading_views "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/components/ReadingPage.jsx"
click node_transit_views "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/components/TransitPage.jsx"
click node_current_time "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/components/CurrentTimePage.jsx"
click node_onboarding_state "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/features/onboarding/onboardingSlice.js"
click node_location_state "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/features/location/locationSlice.js"
click node_chart_query "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/hooks/useChartQuery.js"
click node_chart_api "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/features/chart/chartApi.js"
click node_readings_state "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/features/readings/readingsSlice.js"
click node_transit_api "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/features/transit/transitApi.js"
click node_vedic_calcs "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/utils/vedic-utils.js"
click node_alert_engine "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/utils/dailyAlerts/horaEngine.js"
click node_consultation_engine "https://github.com/vedaai25/astro_assist/blob/main/frontend/src/utils/consultation/questionEngine.js"
click node_astro_context "https://github.com/vedaai25/astro_assist/blob/main/backend/src/astro/context.js"
click node_chart_calculator "https://github.com/vedaai25/astro_assist/blob/main/backend/src/astro/chartCalculator.js"
click node_backend_routes "https://github.com/vedaai25/astro_assist/blob/main/backend/src/routes/chart.js"
click node_reading_routes "https://github.com/vedaai25/astro_assist/blob/main/backend/src/routes/readings/index.js"
click node_profile_store "https://github.com/vedaai25/astro_assist/blob/main/backend/src/db/profileStore.js"
click node_gemini "https://github.com/vedaai25/astro_assist/blob/main/backend/src/utils/gemini.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_onboarding,node_chart_views,node_reading_views,node_transit_views,node_current_time,node_user toneBlue
class node_onboarding_state,node_location_state,node_chart_query,node_chart_api,node_readings_state,node_transit_api toneAmber
class node_vedic_calcs,node_alert_engine,node_consultation_engine,node_astro_context,node_chart_calculator toneMint
class node_backend_routes,node_reading_routes,node_profile_store,node_gemini toneRose
```

## Components

### User Experience

- [Chart Experience](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Birth Onboarding](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/components/OnboardingWizard/OnboardingWizard.jsx): `frontend/src/components/OnboardingWizard/OnboardingWizard.jsx`
- [Chart Views](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/components/Chart/SouthIndianChart.jsx): `frontend/src/components/Chart/SouthIndianChart.jsx`
- [Reading Pages](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/components/ReadingPage.jsx): `frontend/src/components/ReadingPage.jsx`
- [Transit Views](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/components/TransitPage.jsx): `frontend/src/components/TransitPage.jsx`
- [Current Time](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/components/CurrentTimePage.jsx): `frontend/src/components/CurrentTimePage.jsx`

### Frontend Data

- [Onboarding State](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/features/onboarding/onboardingSlice.js): `frontend/src/features/onboarding/onboardingSlice.js`
- [Location State](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/features/location/locationSlice.js): `frontend/src/features/location/locationSlice.js`
- [Chart Query](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/hooks/useChartQuery.js): `frontend/src/hooks/useChartQuery.js`
- [Chart API Client](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/features/chart/chartApi.js): `frontend/src/features/chart/chartApi.js`
- [Reading State](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/features/readings/readingsSlice.js): `frontend/src/features/readings/readingsSlice.js`
- [Transit API Client](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/features/transit/transitApi.js): `frontend/src/features/transit/transitApi.js`

### Astrology Domain

- [Vedic Calculations](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/utils/vedic-utils.js): `frontend/src/utils/vedic-utils.js`
- [Daily Alert Engine](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/utils/dailyAlerts/horaEngine.js): `frontend/src/utils/dailyAlerts/horaEngine.js`
- [Consultation Engine](https://github.com/vedaai25/astro_assist/blob/main/frontend/src/utils/consultation/questionEngine.js): `frontend/src/utils/consultation/questionEngine.js`
- [Chart Context](https://github.com/vedaai25/astro_assist/blob/main/backend/src/astro/context.js): `backend/src/astro/context.js`
- [Chart Calculator](https://github.com/vedaai25/astro_assist/blob/main/backend/src/astro/chartCalculator.js): `backend/src/astro/chartCalculator.js`

### Backend Services

- [API Routes](https://github.com/vedaai25/astro_assist/blob/main/backend/src/routes/chart.js): `backend/src/routes/chart.js`
- [Reading Routes](https://github.com/vedaai25/astro_assist/blob/main/backend/src/routes/readings/index.js): `backend/src/routes/readings/index.js`
- [Profile Store](https://github.com/vedaai25/astro_assist/blob/main/backend/src/db/profileStore.js): `backend/src/db/profileStore.js`
- [Gemini Service](https://github.com/vedaai25/astro_assist/blob/main/backend/src/utils/gemini.js): `backend/src/utils/gemini.js`

### Other components

- **Astrology User**

## Connections

- Astrology User → Birth Onboarding: enters birth details
- Astrology User → Chart Experience: explores astrology
- Chart Experience → Chart Query: requests chart (evidence: `frontend/src/App.jsx`)
- Chart Query → Chart API Client: calls (evidence: `frontend/src/hooks/useChartQuery.js`)
- Chart Experience → Chart Views: renders (evidence: `frontend/src/App.jsx`)
