# sulaymancodes/members-only architecture

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

- Interactive diagram: https://gitdiagram.com/sulaymancodes/members-only
- Repository: https://github.com/sulaymancodes/members-only

## Overview

Members-only is an Express/PostgreSQL web app for account creation, login, membership upgrades, profile settings, and anonymous posts. Users enter through the Express app; route modules dispatch requests to controllers, which apply authentication or membership checks, call database operations, and render EJS pages. Passport handles local credential verification and session identity, while PostgreSQL stores users, posts, and sessions. The README documents the broader capabilities; unsampled route and view behavior is represented only where documented or indexed, so some links are omitted.

Main entry points: [`app.js`](https://github.com/sulaymancodes/members-only/blob/main/app.js) (Express app), [`db/queries.js`](https://github.com/sulaymancodes/members-only/blob/main/db/queries.js) (Database operations), [`views`](https://github.com/sulaymancodes/members-only/tree/main/views) (EJS pages), [`db/pool.js`](https://github.com/sulaymancodes/members-only/blob/main/db/pool.js) (PostgreSQL pool)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web entry and pages"]
  node_express["Express app<br/>[app.js]"]
  node_index_routes["Index routes<br/>[indexRouter.js]"]
  node_not_found["Not-found route<br/>[404Router.js]"]
  node_pages["EJS pages"]
end

subgraph group_identity["Identity and accounts"]
  node_passport["Passport strategy<br/>[passport.js]"]
  node_login_route["Login routes<br/>[logInRouter.js]"]
  node_login_controller["Login controller<br/>[logInController.js]"]
  node_signup_route["Signup routes<br/>[signUpRouter.js]"]
  node_signup_controller["Signup controller"]
  node_account_route["Settings routes<br/>[settingsRouter.js]"]
  node_account_controller["Account settings"]
end

subgraph group_membership["Membership"]
  node_membership_route["Membership routes"]
  node_membership_controller["Membership upgrade"]
end

subgraph group_posts["Anonymous posts"]
  node_home_route["Home routes<br/>[homeRouter.js]"]
  node_home_controller["Post listing<br/>[homeController.js]"]
  node_message_route["Message routes<br/>[messageRouter.js]"]
  node_message_controller["Post creation"]
end

subgraph group_storage["Persistence"]
  node_queries["Database operations<br/>[queries.js]"]
  node_pool[("PostgreSQL pool<br/>[pool.js]")]
  node_session_store[("Session storage<br/>[app.js]")]
end

node_visitor(("Visitor"))
node_postgres[("PostgreSQL")]

node_visitor -->|"uses"| node_express
node_express -->|"mounts"| node_index_routes
node_express -->|"mounts"| node_home_route
node_express -->|"mounts"| node_signup_route
node_express -->|"mounts"| node_login_route
node_express -->|"mounts"| node_message_route
node_express -->|"mounts"| node_membership_route
node_express -->|"mounts"| node_account_route
node_express -->|"mounts"| node_not_found
node_express -->|"initializes"| node_passport
node_express -->|"configures sessions"| node_pool
node_login_route -->|"dispatches"| node_login_controller
node_login_route -->|"authenticates with"| node_passport
node_signup_route -->|"dispatches"| node_signup_controller
node_signup_controller -->|"creates user"| node_queries
node_account_route -->|"dispatches"| node_account_controller
node_account_controller -->|"reads and updates"| node_queries
node_membership_route -->|"dispatches"| node_membership_controller
node_membership_controller -->|"updates status"| node_queries
node_home_route -->|"dispatches"| node_home_controller
node_home_controller -->|"loads posts"| node_queries
node_message_route -->|"dispatches"| node_message_controller
node_message_controller -->|"saves post"| node_queries
node_signup_controller -->|"renders signup"| node_pages
node_home_controller -->|"renders home"| node_pages
node_membership_controller -->|"renders upgrade"| node_pages
node_account_controller -->|"renders settings"| node_pages
node_message_controller -->|"renders composer"| node_pages
node_queries -->|"executes queries"| node_pool
node_passport -->|"checks credentials"| node_pool
node_pool -->|"connects to"| node_postgres
node_session_store -->|"stores sessions"| node_postgres

click node_express "https://github.com/sulaymancodes/members-only/blob/main/app.js"
click node_index_routes "https://github.com/sulaymancodes/members-only/blob/main/routes/indexRouter.js"
click node_not_found "https://github.com/sulaymancodes/members-only/blob/main/routes/404Router.js"
click node_pages "https://github.com/sulaymancodes/members-only/tree/main/views"
click node_passport "https://github.com/sulaymancodes/members-only/blob/main/config/passport.js"
click node_login_route "https://github.com/sulaymancodes/members-only/blob/main/routes/logInRouter.js"
click node_login_controller "https://github.com/sulaymancodes/members-only/blob/main/controllers/logInController.js"
click node_signup_route "https://github.com/sulaymancodes/members-only/blob/main/routes/signUpRouter.js"
click node_signup_controller "https://github.com/sulaymancodes/members-only/blob/main/controllers/signUpController.js"
click node_account_route "https://github.com/sulaymancodes/members-only/blob/main/routes/settingsRouter.js"
click node_account_controller "https://github.com/sulaymancodes/members-only/blob/main/controllers/settingsController.js"
click node_membership_route "https://github.com/sulaymancodes/members-only/blob/main/routes/becomeMemberRouter.js"
click node_membership_controller "https://github.com/sulaymancodes/members-only/blob/main/controllers/becomeMemberController.js"
click node_home_route "https://github.com/sulaymancodes/members-only/blob/main/routes/homeRouter.js"
click node_home_controller "https://github.com/sulaymancodes/members-only/blob/main/controllers/homeController.js"
click node_message_route "https://github.com/sulaymancodes/members-only/blob/main/routes/messageRouter.js"
click node_message_controller "https://github.com/sulaymancodes/members-only/blob/main/controllers/messageController.js"
click node_queries "https://github.com/sulaymancodes/members-only/blob/main/db/queries.js"
click node_pool "https://github.com/sulaymancodes/members-only/blob/main/db/pool.js"
click node_session_store "https://github.com/sulaymancodes/members-only/blob/main/app.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_express,node_index_routes,node_not_found,node_pages toneBlue
class node_passport,node_login_route,node_login_controller,node_signup_route,node_signup_controller,node_account_route,node_account_controller,node_postgres toneAmber
class node_membership_route,node_membership_controller toneMint
class node_home_route,node_home_controller,node_message_route,node_message_controller toneRose
class node_queries,node_pool,node_session_store,node_visitor toneIndigo
```

## Components

### Web entry and pages

- [Express app](https://github.com/sulaymancodes/members-only/blob/main/app.js): `app.js`
- [Index routes](https://github.com/sulaymancodes/members-only/blob/main/routes/indexRouter.js): `routes/indexRouter.js`
- [Not-found route](https://github.com/sulaymancodes/members-only/blob/main/routes/404Router.js): `routes/404Router.js`
- [EJS pages](https://github.com/sulaymancodes/members-only/tree/main/views): `views`

### Identity and accounts

- [Passport strategy](https://github.com/sulaymancodes/members-only/blob/main/config/passport.js): `config/passport.js`
- [Login routes](https://github.com/sulaymancodes/members-only/blob/main/routes/logInRouter.js): `routes/logInRouter.js`
- [Login controller](https://github.com/sulaymancodes/members-only/blob/main/controllers/logInController.js): `controllers/logInController.js`
- [Signup routes](https://github.com/sulaymancodes/members-only/blob/main/routes/signUpRouter.js): `routes/signUpRouter.js`
- [Signup controller](https://github.com/sulaymancodes/members-only/blob/main/controllers/signUpController.js): `controllers/signUpController.js`
- [Settings routes](https://github.com/sulaymancodes/members-only/blob/main/routes/settingsRouter.js): `routes/settingsRouter.js`
- [Account settings](https://github.com/sulaymancodes/members-only/blob/main/controllers/settingsController.js): `controllers/settingsController.js`

### Membership

- [Membership routes](https://github.com/sulaymancodes/members-only/blob/main/routes/becomeMemberRouter.js): `routes/becomeMemberRouter.js`
- [Membership upgrade](https://github.com/sulaymancodes/members-only/blob/main/controllers/becomeMemberController.js): `controllers/becomeMemberController.js`

### Anonymous posts

- [Home routes](https://github.com/sulaymancodes/members-only/blob/main/routes/homeRouter.js): `routes/homeRouter.js`
- [Post listing](https://github.com/sulaymancodes/members-only/blob/main/controllers/homeController.js): `controllers/homeController.js`
- [Message routes](https://github.com/sulaymancodes/members-only/blob/main/routes/messageRouter.js): `routes/messageRouter.js`
- [Post creation](https://github.com/sulaymancodes/members-only/blob/main/controllers/messageController.js): `controllers/messageController.js`

### Persistence

- [Database operations](https://github.com/sulaymancodes/members-only/blob/main/db/queries.js): `db/queries.js`
- [PostgreSQL pool](https://github.com/sulaymancodes/members-only/blob/main/db/pool.js): `db/pool.js`
- [Session storage](https://github.com/sulaymancodes/members-only/blob/main/app.js): `app.js`

### Other components

- **Visitor**
- **PostgreSQL**

## Connections

- Visitor → Express app: uses (evidence: `README.md`)
- Express app → Index routes: mounts (evidence: `app.js`)
- Express app → Home routes: mounts (evidence: `app.js`)
- Express app → Signup routes: mounts (evidence: `app.js`)
- Express app → Login routes: mounts (evidence: `app.js`)
- Express app → Message routes: mounts (evidence: `app.js`)
- Express app → Membership routes: mounts (evidence: `app.js`)
- Express app → Settings routes: mounts (evidence: `app.js`)
- Express app → Not-found route: mounts (evidence: `app.js`)
- Express app → Passport strategy: initializes (evidence: `app.js`)
- Express app → PostgreSQL pool: configures sessions (evidence: `app.js`)
- Login routes → Login controller: dispatches (evidence: `routes/logInRouter.js`)
- Login routes → Passport strategy: authenticates with (evidence: `routes/logInRouter.js`)
- Signup routes → Signup controller: dispatches (evidence: `routes/signUpRouter.js`)
- Signup controller → Database operations: creates user (evidence: `controllers/signUpController.js`)
- Settings routes → Account settings: dispatches (evidence: `routes/settingsRouter.js`)
- Account settings → Database operations: reads and updates (evidence: `controllers/settingsController.js`)
- Membership routes → Membership upgrade: dispatches (evidence: `routes/becomeMemberRouter.js`)
- Membership upgrade → Database operations: updates status (evidence: `controllers/becomeMemberController.js`)
- Home routes → Post listing: dispatches (evidence: `routes/homeRouter.js`)
- Post listing → Database operations: loads posts (evidence: `controllers/homeController.js`)
- Message routes → Post creation: dispatches (evidence: `routes/messageRouter.js`)
- Post creation → Database operations: saves post (evidence: `controllers/messageController.js`)
- Signup controller → EJS pages: renders signup (evidence: `controllers/signUpController.js`)
- Post listing → EJS pages: renders home (evidence: `controllers/homeController.js`)
- Membership upgrade → EJS pages: renders upgrade (evidence: `controllers/becomeMemberController.js`)
- Account settings → EJS pages: renders settings (evidence: `controllers/settingsController.js`)
- Post creation → EJS pages: renders composer (evidence: `controllers/messageController.js`)
- Database operations → PostgreSQL pool: executes queries (evidence: `db/queries.js`)
- Passport strategy → PostgreSQL pool: checks credentials (evidence: `config/passport.js`)
- PostgreSQL pool → PostgreSQL: connects to (evidence: `db/pool.js`)
- Session storage → PostgreSQL: stores sessions (evidence: `app.js`)
