# akshaymarch7/make-my-marriage architecture

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

- Interactive diagram: https://gitdiagram.com/akshaymarch7/make-my-marriage
- Repository: https://github.com/akshaymarch7/make-my-marriage

## Overview

Make My Marriage is a wedding-planning SaaS for couples and families. The main workflow is account creation/sign-in, wedding setup with an initial Admin membership, then managing wedding details and planning records from the dashboard. Other major capabilities include member invitations and role management, guest invitations and RSVPs, event planning, tasks, and photo galleries. The graph reflects documented capabilities and indexed module references; unsampled route and UI internals are represented at their enclosing directories, and uncertain UI-to-API links are omitted.

Main entry points: [`src/app/api`](https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/app/api) (HTTP API), [`src/modules/memberships/service.ts`](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/memberships/service.ts) (Membership access), [`src/modules/photos/service.ts`](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/photos/service.ts) (Photo management), [`src/modules/events/repository.ts`](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/events/repository.ts) (Event records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry points"]
  node_web["App screens"]
  node_api["HTTP API"]
  node_mongo[("MongoDB connection<br/>[mongoose.ts]")]
end

subgraph group_identity["Accounts and access"]
  node_authui["Account screens"]
  node_auth["Account workflows<br/>[service.ts]"]
  node_authrepo[("User records<br/>[repository.ts]")]
  node_sessions["Session security<br/>[sessions.ts]"]
end

subgraph group_planning["Wedding planning"]
  node_weddingui["Wedding setup and edit"]
  node_weddings["Wedding lifecycle<br/>[service.ts]"]
  node_weddingrepo[("Wedding records<br/>[repository.ts]")]
  node_events["Event planning<br/>[service.ts]"]
  node_eventrepo[("Event records<br/>[repository.ts]")]
  node_tasks["Task planning<br/>[service.ts]"]
  node_taskrepo[("Task records<br/>[repository.ts]")]
end

subgraph group_people["Guests and members"]
  node_guestui["Guest and RSVP screens"]
  node_guests["Guest management<br/>[service.ts]"]
  node_guestrepo[("Guest records<br/>[repository.ts]")]
  node_memberui["Member invitations"]
  node_members["Membership access<br/>[service.ts]"]
  node_memberrepo[("Membership records<br/>[repository.ts]")]
end

subgraph group_media["Gallery and storage"]
  node_galleryui["Photo gallery"]
  node_photos["Photo management<br/>[service.ts]"]
  node_photorepo[("Photo records<br/>[repository.ts]")]
  node_objectstore["R2 object storage<br/>[r2.ts]"]
end

node_browser(("Couple or family"))

node_browser -->|"uses"| node_web
node_web -.->|"requests"| node_api
node_api -->|"calls"| node_auth
node_api -->|"calls"| node_events
node_api -->|"calls"| node_guests
node_api -->|"calls"| node_tasks
node_api -->|"calls"| node_weddings
node_api -->|"calls"| node_members
node_api -->|"calls"| node_photos
node_authui -->|"collects credentials"| node_browser
node_auth -->|"reads and writes"| node_authrepo
node_auth -->|"creates sessions"| node_sessions
node_auth -->|"loads wedding context"| node_weddings
node_weddingui -.->|"submits changes"| node_api
node_weddings -->|"reads and writes"| node_weddingrepo
node_weddings -->|"creates Admin"| node_memberrepo
node_events -->|"manages events"| node_eventrepo
node_events -->|"checks access"| node_members
node_tasks -->|"manages tasks"| node_taskrepo
node_tasks -->|"checks membership"| node_members
node_tasks -->|"validates events"| node_eventrepo
node_guestui -.->|"manages guests"| node_api
node_guests -->|"manages guests"| node_guestrepo
node_guests -->|"checks access"| node_members
node_guests -->|"loads invited events"| node_eventrepo
node_memberui -.->|"manages members"| node_api
node_members -->|"manages membership"| node_memberrepo
node_members -->|"loads wedding"| node_weddingrepo
node_members -->|"looks up users"| node_authrepo
node_members -.->|"emails invitations"| node_browser
node_galleryui -.->|"uploads and browses"| node_api
node_photos -->|"manages photo records"| node_photorepo
node_photos -->|"signs and deletes objects"| node_objectstore
node_photos -->|"validates event"| node_eventrepo
node_photos -->|"checks access"| node_members
node_authrepo -->|"connects"| node_mongo
node_weddingrepo -->|"connects"| node_mongo
node_eventrepo -->|"connects"| node_mongo
node_memberrepo -->|"connects"| node_mongo

click node_web "https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/app"
click node_api "https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/app/api"
click node_authui "https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/components/auth"
click node_auth "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/auth/service.ts"
click node_authrepo "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/auth/repository.ts"
click node_sessions "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/server/auth/sessions.ts"
click node_weddingui "https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/components/wedding"
click node_weddings "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/weddings/service.ts"
click node_weddingrepo "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/weddings/repository.ts"
click node_events "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/events/service.ts"
click node_eventrepo "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/events/repository.ts"
click node_tasks "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/tasks/service.ts"
click node_taskrepo "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/tasks/repository.ts"
click node_guestui "https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/components/guests"
click node_guests "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/guests/service.ts"
click node_guestrepo "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/guests/repository.ts"
click node_memberui "https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/components/members"
click node_members "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/memberships/service.ts"
click node_memberrepo "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/memberships/repository.ts"
click node_galleryui "https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/components/gallery"
click node_photos "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/photos/service.ts"
click node_photorepo "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/photos/repository.ts"
click node_objectstore "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/server/storage/r2.ts"
click node_mongo "https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/server/db/mongoose.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_web,node_api,node_mongo toneBlue
class node_authui,node_auth,node_authrepo,node_sessions toneAmber
class node_weddingui,node_weddings,node_weddingrepo,node_events,node_eventrepo,node_tasks,node_taskrepo toneMint
class node_guestui,node_guests,node_guestrepo,node_memberui,node_members,node_memberrepo toneRose
class node_galleryui,node_photos,node_photorepo,node_objectstore,node_browser toneIndigo
```

## Components

### App entry points

- [App screens](https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/app): `src/app`
- [HTTP API](https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/app/api): `src/app/api`
- [MongoDB connection](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/server/db/mongoose.ts): `src/server/db/mongoose.ts`

### Accounts and access

- [Account screens](https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/components/auth): `src/components/auth`
- [Account workflows](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/auth/service.ts): `src/modules/auth/service.ts`
- [User records](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/auth/repository.ts): `src/modules/auth/repository.ts`
- [Session security](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/server/auth/sessions.ts): `src/server/auth/sessions.ts`

### Wedding planning

- [Wedding setup and edit](https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/components/wedding): `src/components/wedding`
- [Wedding lifecycle](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/weddings/service.ts): `src/modules/weddings/service.ts`
- [Wedding records](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/weddings/repository.ts): `src/modules/weddings/repository.ts`
- [Event planning](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/events/service.ts): `src/modules/events/service.ts`
- [Event records](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/events/repository.ts): `src/modules/events/repository.ts`
- [Task planning](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/tasks/service.ts): `src/modules/tasks/service.ts`
- [Task records](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/tasks/repository.ts): `src/modules/tasks/repository.ts`

### Guests and members

- [Guest and RSVP screens](https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/components/guests): `src/components/guests`
- [Guest management](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/guests/service.ts): `src/modules/guests/service.ts`
- [Guest records](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/guests/repository.ts): `src/modules/guests/repository.ts`
- [Member invitations](https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/components/members): `src/components/members`
- [Membership access](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/memberships/service.ts): `src/modules/memberships/service.ts`
- [Membership records](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/memberships/repository.ts): `src/modules/memberships/repository.ts`

### Gallery and storage

- [Photo gallery](https://github.com/akshaymarch7/make-my-marriage/tree/dev/src/components/gallery): `src/components/gallery`
- [Photo management](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/photos/service.ts): `src/modules/photos/service.ts`
- [Photo records](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/modules/photos/repository.ts): `src/modules/photos/repository.ts`
- [R2 object storage](https://github.com/akshaymarch7/make-my-marriage/blob/dev/src/server/storage/r2.ts): `src/server/storage/r2.ts`

### Other components

- **Couple or family**

## Connections

- Couple or family → App screens: uses (evidence: `README.md`)
- App screens → HTTP API: requests
- HTTP API → Account workflows: calls (evidence: `src/app/api/events/route.ts`)
- HTTP API → Event planning: calls (evidence: `src/app/api/events/route.ts`)
- HTTP API → Guest management: calls (evidence: `src/app/api/guests/route.ts`)
- HTTP API → Task planning: calls (evidence: `src/app/api/tasks/route.ts`)
- HTTP API → Wedding lifecycle: calls (evidence: `src/app/api/wedding/route.ts`)
- HTTP API → Membership access: calls (evidence: `src/app/api/members/route.ts`)
- HTTP API → Photo management: calls (evidence: `src/app/api/photos/route.ts`)
- Account screens → Couple or family: collects credentials (evidence: `src/components/auth/auth-form.tsx`)
- Account workflows → User records: reads and writes (evidence: `src/modules/auth/service.ts`)
- Account workflows → Session security: creates sessions (evidence: `src/modules/auth/service.ts`)
- Account workflows → Wedding lifecycle: loads wedding context (evidence: `src/modules/auth/service.ts`)
- Wedding setup and edit → HTTP API: submits changes
- Wedding lifecycle → Wedding records: reads and writes (evidence: `src/modules/weddings/service.ts`)
- Wedding lifecycle → Membership records: creates Admin (evidence: `src/modules/weddings/service.ts`)
- Event planning → Event records: manages events (evidence: `src/modules/events/service.ts`)
- Event planning → Membership access: checks access (evidence: `src/modules/events/service.ts`)
- Task planning → Task records: manages tasks (evidence: `src/modules/tasks/service.ts`)
- Task planning → Membership access: checks membership (evidence: `src/modules/tasks/service.ts`)
- Task planning → Event records: validates events (evidence: `src/modules/tasks/service.ts`)
- Guest and RSVP screens → HTTP API: manages guests
- Guest management → Guest records: manages guests (evidence: `src/modules/guests/service.ts`)
- Guest management → Membership access: checks access (evidence: `src/modules/guests/service.ts`)
- Guest management → Event records: loads invited events (evidence: `src/modules/guests/service.ts`)
- Member invitations → HTTP API: manages members
- Membership access → Membership records: manages membership (evidence: `src/modules/memberships/service.ts`)
- Membership access → Wedding records: loads wedding (evidence: `src/modules/memberships/service.ts`)
- Membership access → User records: looks up users (evidence: `src/modules/memberships/service.ts`)
- Membership access → Couple or family: emails invitations (evidence: `README.md`)
- Photo gallery → HTTP API: uploads and browses
- Photo management → Photo records: manages photo records (evidence: `src/modules/photos/service.ts`)
- Photo management → R2 object storage: signs and deletes objects (evidence: `src/modules/photos/service.ts`)
- Photo management → Event records: validates event (evidence: `src/modules/photos/service.ts`)
- Photo management → Membership access: checks access (evidence: `src/modules/photos/service.ts`)
- User records → MongoDB connection: connects (evidence: `src/modules/auth/repository.ts`)
- Wedding records → MongoDB connection: connects (evidence: `src/modules/weddings/repository.ts`)
- Event records → MongoDB connection: connects (evidence: `src/modules/events/repository.ts`)
- Membership records → MongoDB connection: connects (evidence: `src/modules/memberships/repository.ts`)
