# gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities architecture

> Architecture diagram of the GitHub repository gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities, 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/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities
- Repository: https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities

## Overview

Opportunity Compass is a two-sided opportunity discovery and distribution product for users and posters. Users sign in, complete a profile, discover and assess opportunities, then save/apply and track deadlines; posters onboard organizations, publish opportunities, and manage listings, applications, schedules, and analytics. The graph preserves the documented community, membership, and notification capabilities. Several route implementations were not sampled, so documented links use the README as evidence; unsampled implementation details are not inferred.

Main entry points: [`src/routes/poster.index.tsx`](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.index.tsx) (Poster dashboard), [`src/lib/session.ts`](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/lib/session.ts) (Role routing), [`src/routes/auth.login.tsx`](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/auth.login.tsx) (Sign-in & signup), [`src/integrations/supabase/client.ts`](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/integrations/supabase/client.ts) (Supabase auth)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; onboarding"]
  node_auth_routes["Sign-in &amp; signup<br/>[auth.login.tsx]"]
  node_session["Role routing<br/>[session.ts]"]
  node_user_onboard["User onboarding<br/>[onboarding.tsx]"]
  node_poster_onboard["Poster onboarding"]
end

subgraph group_user["User opportunity journey"]
  node_profile["User profile<br/>[useProfile.ts]"]
  node_home["Personalized home<br/>[home.tsx]"]
  node_opportunity_discovery["Opportunity discovery"]
  node_opportunity_detail["Opportunity detail"]
  node_application_tracking["Application tracking<br/>[applications.tsx]"]
  node_calendar["User deadlines<br/>[calendar.tsx]"]
  node_community["Communities"]
  node_membership["Membership<br/>[membership.tsx]"]
  node_notification["Notifications<br/>[notifications.tsx]"]
end

subgraph group_poster["Poster workspace"]
  node_poster_workspace["Poster dashboard<br/>[poster.index.tsx]"]
  node_poster_publish["Opportunity publishing<br/>[poster.new.tsx]"]
  node_poster_listings["Manage listings"]
  node_poster_applications["Review applications"]
  node_poster_calendar["Poster schedule"]
  node_poster_analytics["Performance analytics"]
  node_poster_org["Organization profile"]
end

subgraph group_platform["Shared platform services"]
  node_auth_service["Supabase auth<br/>[client.ts]"]
  node_domain_data["Opportunity &amp; app data<br/>[data.ts]"]
  node_supabase_store[("Supabase data store<br/>[client.ts]")]
end

node_user_actor(("User"))
node_poster_actor(("Poster"))

node_user_actor -->|"signs in"| node_auth_routes
node_poster_actor -->|"signs in"| node_auth_routes
node_auth_routes -->|"authenticates"| node_auth_service
node_auth_routes -->|"routes after login"| node_session
node_session -->|"reads role &amp; setup"| node_supabase_store
node_session -->|"routes user"| node_user_onboard
node_session -->|"routes poster"| node_poster_onboard
node_user_onboard -->|"saves onboarding"| node_auth_service
node_poster_onboard -->|"saves onboarding"| node_auth_service
node_home -->|"explore matches"| node_opportunity_discovery
node_profile -->|"loads profile"| node_auth_service
node_opportunity_discovery -->|"opens listing"| node_opportunity_detail
node_opportunity_detail -->|"apply &amp; track"| node_application_tracking
node_opportunity_detail -->|"track deadlines"| node_calendar
node_opportunity_discovery -.->|"uses opportunity data"| node_domain_data
node_application_tracking -->|"uses application data"| node_domain_data
node_home -->|"find communities"| node_community
node_home -->|"view notifications"| node_notification
node_membership -->|"unlocks participation"| node_community
node_poster_actor -->|"manages supply"| node_poster_workspace
node_poster_workspace -->|"creates listing"| node_poster_publish
node_poster_workspace -->|"manages listings"| node_poster_listings
node_poster_workspace -->|"reviews submissions"| node_poster_applications
node_poster_workspace -->|"schedules deadlines"| node_poster_calendar
node_poster_workspace -->|"views performance"| node_poster_analytics
node_poster_workspace -->|"manages organization"| node_poster_org

click node_auth_routes "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/auth.login.tsx"
click node_auth_service "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/integrations/supabase/client.ts"
click node_session "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/lib/session.ts"
click node_user_onboard "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/_authenticated/onboarding.tsx"
click node_poster_onboard "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/_authenticated/poster-onboarding.tsx"
click node_profile "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/hooks/useProfile.ts"
click node_home "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/home.tsx"
click node_opportunity_discovery "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/opportunities.index.tsx"
click node_opportunity_detail "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/opportunities.%24oppId.tsx"
click node_application_tracking "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/applications.tsx"
click node_calendar "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/calendar.tsx"
click node_community "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/communities.index.tsx"
click node_membership "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/membership.tsx"
click node_notification "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/notifications.tsx"
click node_poster_workspace "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.index.tsx"
click node_poster_publish "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.new.tsx"
click node_poster_listings "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.opportunities.tsx"
click node_poster_applications "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.applications.tsx"
click node_poster_calendar "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.calendar.tsx"
click node_poster_analytics "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.analytics.tsx"
click node_poster_org "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.organization.tsx"
click node_domain_data "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/lib/data.ts"
click node_supabase_store "https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/integrations/supabase/client.ts"

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_auth_routes,node_session,node_user_onboard,node_poster_onboard,node_user_actor toneBlue
class node_profile,node_home,node_opportunity_discovery,node_opportunity_detail,node_application_tracking,node_calendar,node_community,node_membership,node_notification toneAmber
class node_poster_workspace,node_poster_publish,node_poster_listings,node_poster_applications,node_poster_calendar,node_poster_analytics,node_poster_org toneMint
class node_auth_service,node_domain_data,node_supabase_store toneRose
class node_poster_actor toneIndigo
```

## Components

### Identity & onboarding

- [Sign-in & signup](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/auth.login.tsx): `src/routes/auth.login.tsx`
- [Role routing](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/lib/session.ts): `src/lib/session.ts`
- [User onboarding](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/_authenticated/onboarding.tsx): `src/routes/_authenticated/onboarding.tsx`
- [Poster onboarding](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/_authenticated/poster-onboarding.tsx): `src/routes/_authenticated/poster-onboarding.tsx`

### User opportunity journey

- [User profile](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/hooks/useProfile.ts): `src/hooks/useProfile.ts`
- [Personalized home](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/home.tsx): `src/routes/home.tsx`
- [Opportunity discovery](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/opportunities.index.tsx): `src/routes/opportunities.index.tsx`
- [Opportunity detail](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/opportunities.%24oppId.tsx): `src/routes/opportunities.$oppId.tsx`
- [Application tracking](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/applications.tsx): `src/routes/applications.tsx`
- [User deadlines](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/calendar.tsx): `src/routes/calendar.tsx`
- [Communities](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/communities.index.tsx): `src/routes/communities.index.tsx`
- [Membership](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/membership.tsx): `src/routes/membership.tsx`
- [Notifications](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/notifications.tsx): `src/routes/notifications.tsx`

### Poster workspace

- [Poster dashboard](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.index.tsx): `src/routes/poster.index.tsx`
- [Opportunity publishing](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.new.tsx): `src/routes/poster.new.tsx`
- [Manage listings](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.opportunities.tsx): `src/routes/poster.opportunities.tsx`
- [Review applications](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.applications.tsx): `src/routes/poster.applications.tsx`
- [Poster schedule](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.calendar.tsx): `src/routes/poster.calendar.tsx`
- [Performance analytics](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.analytics.tsx): `src/routes/poster.analytics.tsx`
- [Organization profile](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/routes/poster.organization.tsx): `src/routes/poster.organization.tsx`

### Shared platform services

- [Supabase auth](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/integrations/supabase/client.ts): `src/integrations/supabase/client.ts`
- [Opportunity & app data](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/lib/data.ts): `src/lib/data.ts`
- [Supabase data store](https://github.com/gsriharsha2006-coder/aws-project-sloth-ai-navigator-for-opportunities/blob/main/src/integrations/supabase/client.ts): `src/integrations/supabase/client.ts`

### Other components

- **User**
- **Poster**

## Connections

- User → Sign-in & signup: signs in
- Poster → Sign-in & signup: signs in
- Sign-in & signup → Supabase auth: authenticates (evidence: `src/routes/auth.login.tsx`)
- Sign-in & signup → Role routing: routes after login (evidence: `src/lib/session.ts`)
- Role routing → Supabase data store: reads role & setup (evidence: `src/lib/session.ts`)
- Role routing → User onboarding: routes user (evidence: `src/lib/session.ts`)
- Role routing → Poster onboarding: routes poster (evidence: `src/lib/session.ts`)
- User onboarding → Supabase auth: saves onboarding (evidence: `src/routes/_authenticated/onboarding.tsx`)
- Poster onboarding → Supabase auth: saves onboarding (evidence: `src/routes/_authenticated/poster-onboarding.tsx`)
- Personalized home → Opportunity discovery: explore matches
- User profile → Supabase auth: loads profile (evidence: `src/hooks/useProfile.ts`)
- Opportunity discovery → Opportunity detail: opens listing
- Opportunity detail → Application tracking: apply & track
- Opportunity detail → User deadlines: track deadlines
- Opportunity discovery → Opportunity & app data: uses opportunity data
- Application tracking → Opportunity & app data: uses application data (evidence: `src/routes/applications.tsx`)
- Personalized home → Communities: find communities
- Personalized home → Notifications: view notifications
- Membership → Communities: unlocks participation
- Poster → Poster dashboard: manages supply
- Poster dashboard → Opportunity publishing: creates listing
- Poster dashboard → Manage listings: manages listings
- Poster dashboard → Review applications: reviews submissions
- Poster dashboard → Poster schedule: schedules deadlines
- Poster dashboard → Performance analytics: views performance
- Poster dashboard → Organization profile: manages organization
