# joe-ship-it-nice/joefriends-backend-sigma-mission-9 architecture

> Architecture diagram of the GitHub repository joe-ship-it-nice/joefriends-backend-sigma-mission-9, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9
- Repository: https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9

## Overview

Joefriends is an authenticated social API. Clients register or log in, use a bearer token for protected actions, and can create or read posts and manage friend requests. The route handlers in index.js implement these workflows and use a configured Supabase client to reach Supabase Auth and PostgreSQL. The README documents the API capabilities and privacy rules; sampled source shows the route-level operations. Edges cite the file or documentation that supports each relationship.

Main entry points: [`index.js`](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js) (API routes), [`supabaseClient.js`](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/supabaseClient.js) (Client configuration), [`index.html`](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.html) (API homepage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API surface"]
  node_routes["API routes<br/>[index.js]"]
  node_docs["API homepage<br/>[index.html]"]
end

subgraph group_identity["Identity and access"]
  node_signup["Registration<br/>[index.js]"]
  node_login["Login<br/>[index.js]"]
  node_authcheck["Token verification<br/>[index.js]"]
  node_profile["User profile<br/>[index.js]"]
end

subgraph group_social["Social features"]
  node_users["User listing<br/>[index.js]"]
  node_posts["Post operations<br/>[index.js]"]
  node_friendrequests["Friend requests<br/>[index.js]"]
  node_friendships["Friendships<br/>[index.js]"]
end

subgraph group_platform["Supabase platform"]
  node_supabaseclient["Client configuration<br/>[supabaseClient.js]"]
  node_supaauth["Supabase Auth"]
  node_postgres[("PostgreSQL data")]
end

node_client(("API client"))

node_client -->|"calls"| node_routes
node_client -->|"opens"| node_docs
node_routes -->|"routes to"| node_signup
node_routes -->|"routes to"| node_login
node_routes -->|"routes to"| node_profile
node_routes -->|"routes to"| node_posts
node_routes -->|"routes to"| node_users
node_routes -->|"routes to"| node_friendrequests
node_routes -->|"routes to"| node_friendships
node_signup -->|"creates client"| node_supabaseclient
node_login -->|"creates client"| node_supabaseclient
node_authcheck -->|"creates client"| node_supabaseclient
node_posts -->|"creates client"| node_supabaseclient
node_users -->|"creates client"| node_supabaseclient
node_friendrequests -->|"creates client"| node_supabaseclient
node_friendships -->|"creates client"| node_supabaseclient
node_signup -->|"registers account"| node_supaauth
node_login -->|"authenticates"| node_supaauth
node_authcheck -->|"validates token"| node_supaauth
node_posts -->|"reads and writes"| node_postgres
node_users -->|"reads users"| node_postgres
node_friendrequests -->|"creates request"| node_postgres
node_friendships -->|"reads and updates"| node_postgres

click node_routes "https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js"
click node_docs "https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.html"
click node_signup "https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js"
click node_login "https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js"
click node_authcheck "https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js"
click node_profile "https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js"
click node_users "https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js"
click node_posts "https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js"
click node_friendrequests "https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js"
click node_friendships "https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js"
click node_supabaseclient "https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/supabaseClient.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_routes,node_docs,node_client toneBlue
class node_signup,node_login,node_authcheck,node_profile toneAmber
class node_users,node_posts,node_friendrequests,node_friendships toneMint
class node_supabaseclient,node_supaauth,node_postgres toneRose
```

## Components

### API surface

- [API routes](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js): `index.js`
- [API homepage](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.html): `index.html`

### Identity and access

- [Registration](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js): `index.js`
- [Login](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js): `index.js`
- [Token verification](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js): `index.js`
- [User profile](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js): `index.js`

### Social features

- [User listing](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js): `index.js`
- [Post operations](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js): `index.js`
- [Friend requests](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js): `index.js`
- [Friendships](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/index.js): `index.js`

### Supabase platform

- [Client configuration](https://github.com/joe-ship-it-nice/joefriends-backend-sigma-mission-9/blob/main/supabaseClient.js): `supabaseClient.js`
- **Supabase Auth**
- **PostgreSQL data**

### Other components

- **API client**

## Connections

- API client → API routes: calls (evidence: `readme.md`)
- API client → API homepage: opens (evidence: `readme.md`)
- API routes → Registration: routes to (evidence: `index.js`)
- API routes → Login: routes to (evidence: `index.js`)
- API routes → User profile: routes to (evidence: `index.js`)
- API routes → Post operations: routes to (evidence: `index.js`)
- API routes → User listing: routes to (evidence: `index.js`)
- API routes → Friend requests: routes to (evidence: `index.js`)
- API routes → Friendships: routes to (evidence: `index.js`)
- Registration → Client configuration: creates client (evidence: `index.js`)
- Login → Client configuration: creates client (evidence: `index.js`)
- Token verification → Client configuration: creates client (evidence: `index.js`)
- Post operations → Client configuration: creates client (evidence: `index.js`)
- User listing → Client configuration: creates client (evidence: `index.js`)
- Friend requests → Client configuration: creates client (evidence: `index.js`)
- Friendships → Client configuration: creates client (evidence: `index.js`)
- Registration → Supabase Auth: registers account (evidence: `index.js`)
- Login → Supabase Auth: authenticates (evidence: `index.js`)
- Token verification → Supabase Auth: validates token (evidence: `index.js`)
- Post operations → PostgreSQL data: reads and writes (evidence: `index.js`)
- User listing → PostgreSQL data: reads users (evidence: `index.js`)
- Friend requests → PostgreSQL data: creates request (evidence: `index.js`)
- Friendships → PostgreSQL data: reads and updates (evidence: `index.js`)
