# zydiemorris/keepsy architecture

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

- Interactive diagram: https://gitdiagram.com/zydiemorris/keepsy
- Repository: https://github.com/zydiemorris/keepsy

## Overview

Keepsy is a Laravel and Vue/Inertia photo-memory application with account management and interfaces for people and shared albums. A user enters through web routes; the memories controller lists, uploads, edits, and deletes photos, returning gallery data to the memories page. Fortify handles authentication and account creation, while separate controllers serve profile and security settings. The graph includes the photo/user domain and Inertia middleware as internal layers. Some UI and sharing capabilities are represented from the tree and controller render calls; their deeper wiring was not sampled.

Main entry points: [`routes/web.php`](https://github.com/zydiemorris/keepsy/blob/master/routes/web.php) (Web routes), [`app/Http/Controllers/MemoriesController.php`](https://github.com/zydiemorris/keepsy/blob/master/app/Http/Controllers/MemoriesController.php) (Memories controller), [`routes/settings.php`](https://github.com/zydiemorris/keepsy/blob/master/routes/settings.php) (Settings routes), [`bootstrap/app.php`](https://github.com/zydiemorris/keepsy/blob/master/bootstrap/app.php) (App bootstrap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_web_routes["Web routes<br/>[web.php]"]
  node_settings_routes["Settings routes<br/>[settings.php]"]
  node_app_boot["App bootstrap<br/>[app.php]"]
  node_inertia_middleware["Inertia middleware"]
end

subgraph group_memories["Photo memories"]
  node_memory_controller["Memories controller"]
  node_memory_requests["Memory requests"]
  node_photo_model["Photo model<br/>[Photo.php]"]
  node_memory_ui["Memories gallery<br/>[Index.vue]"]
end

subgraph group_identity["Authentication"]
  node_user_model["User model<br/>[User.php]"]
  node_fortify_provider["Fortify provider"]
  node_user_creation["User creation<br/>[CreateNewUser.php]"]
end

subgraph group_account["Account settings"]
  node_profile_controller["Profile controller"]
  node_profile_rules["Profile validation"]
  node_security_controller["Security controller"]
  node_security_ui["Security settings<br/>[Security.vue]"]
end

subgraph group_product["People and sharing"]
  node_people_controller["People controller"]
  node_people_ui["People page<br/>[Index.vue]"]
  node_shared_controller["Shared albums controller"]
  node_shared_ui["Shared albums page<br/>[Index.vue]"]
end

node_user(("User"))

node_user -->|"requests"| node_web_routes
node_user -->|"requests"| node_settings_routes
node_web_routes -->|"routes to"| node_memory_controller
node_web_routes -->|"routes to"| node_people_controller
node_web_routes -->|"routes to"| node_shared_controller
node_web_routes -->|"includes"| node_settings_routes
node_settings_routes -->|"routes to"| node_profile_controller
node_settings_routes -->|"routes to"| node_security_controller
node_app_boot -->|"loads routes"| node_web_routes
node_app_boot -->|"registers"| node_inertia_middleware
node_memory_controller -->|"validates with"| node_memory_requests
node_memory_controller -->|"reads and writes"| node_photo_model
node_memory_controller -->|"renders"| node_memory_ui
node_user_model -->|"owns photos"| node_photo_model
node_fortify_provider -->|"registers action"| node_user_creation
node_user_creation -->|"creates user"| node_user_model
node_profile_controller -.->|"validates with"| node_profile_rules
node_security_controller -->|"renders"| node_security_ui
node_people_controller -->|"renders"| node_people_ui
node_shared_controller -->|"renders"| node_shared_ui

click node_web_routes "https://github.com/zydiemorris/keepsy/blob/master/routes/web.php"
click node_settings_routes "https://github.com/zydiemorris/keepsy/blob/master/routes/settings.php"
click node_app_boot "https://github.com/zydiemorris/keepsy/blob/master/bootstrap/app.php"
click node_inertia_middleware "https://github.com/zydiemorris/keepsy/blob/master/app/Http/Middleware/HandleInertiaRequests.php"
click node_memory_controller "https://github.com/zydiemorris/keepsy/blob/master/app/Http/Controllers/MemoriesController.php"
click node_memory_requests "https://github.com/zydiemorris/keepsy/tree/master/app/Http/Requests/Memories"
click node_photo_model "https://github.com/zydiemorris/keepsy/blob/master/app/Models/Photo.php"
click node_memory_ui "https://github.com/zydiemorris/keepsy/blob/master/resources/js/pages/memories/Index.vue"
click node_user_model "https://github.com/zydiemorris/keepsy/blob/master/app/Models/User.php"
click node_fortify_provider "https://github.com/zydiemorris/keepsy/blob/master/app/Providers/FortifyServiceProvider.php"
click node_user_creation "https://github.com/zydiemorris/keepsy/blob/master/app/Actions/Fortify/CreateNewUser.php"
click node_profile_controller "https://github.com/zydiemorris/keepsy/blob/master/app/Http/Controllers/Settings/ProfileController.php"
click node_profile_rules "https://github.com/zydiemorris/keepsy/blob/master/app/Concerns/ProfileValidationRules.php"
click node_security_controller "https://github.com/zydiemorris/keepsy/blob/master/app/Http/Controllers/Settings/SecurityController.php"
click node_security_ui "https://github.com/zydiemorris/keepsy/blob/master/resources/js/pages/settings/Security.vue"
click node_people_controller "https://github.com/zydiemorris/keepsy/blob/master/app/Http/Controllers/PeopleController.php"
click node_people_ui "https://github.com/zydiemorris/keepsy/blob/master/resources/js/pages/people/Index.vue"
click node_shared_controller "https://github.com/zydiemorris/keepsy/blob/master/app/Http/Controllers/SharedController.php"
click node_shared_ui "https://github.com/zydiemorris/keepsy/blob/master/resources/js/pages/shared/Index.vue"

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_routes,node_settings_routes,node_app_boot,node_inertia_middleware,node_user toneBlue
class node_memory_controller,node_memory_requests,node_photo_model,node_memory_ui toneAmber
class node_user_model,node_fortify_provider,node_user_creation toneMint
class node_profile_controller,node_profile_rules,node_security_controller,node_security_ui toneRose
class node_people_controller,node_people_ui,node_shared_controller,node_shared_ui toneIndigo
```

## Components

### Web entry

- [Web routes](https://github.com/zydiemorris/keepsy/blob/master/routes/web.php): `routes/web.php`
- [Settings routes](https://github.com/zydiemorris/keepsy/blob/master/routes/settings.php): `routes/settings.php`
- [App bootstrap](https://github.com/zydiemorris/keepsy/blob/master/bootstrap/app.php): `bootstrap/app.php`
- [Inertia middleware](https://github.com/zydiemorris/keepsy/blob/master/app/Http/Middleware/HandleInertiaRequests.php): `app/Http/Middleware/HandleInertiaRequests.php`

### Photo memories

- [Memories controller](https://github.com/zydiemorris/keepsy/blob/master/app/Http/Controllers/MemoriesController.php): `app/Http/Controllers/MemoriesController.php`
- [Memory requests](https://github.com/zydiemorris/keepsy/tree/master/app/Http/Requests/Memories): `app/Http/Requests/Memories`
- [Photo model](https://github.com/zydiemorris/keepsy/blob/master/app/Models/Photo.php): `app/Models/Photo.php`
- [Memories gallery](https://github.com/zydiemorris/keepsy/blob/master/resources/js/pages/memories/Index.vue): `resources/js/pages/memories/Index.vue`

### Authentication

- [User model](https://github.com/zydiemorris/keepsy/blob/master/app/Models/User.php): `app/Models/User.php`
- [Fortify provider](https://github.com/zydiemorris/keepsy/blob/master/app/Providers/FortifyServiceProvider.php): `app/Providers/FortifyServiceProvider.php`
- [User creation](https://github.com/zydiemorris/keepsy/blob/master/app/Actions/Fortify/CreateNewUser.php): `app/Actions/Fortify/CreateNewUser.php`

### Account settings

- [Profile controller](https://github.com/zydiemorris/keepsy/blob/master/app/Http/Controllers/Settings/ProfileController.php): `app/Http/Controllers/Settings/ProfileController.php`
- [Profile validation](https://github.com/zydiemorris/keepsy/blob/master/app/Concerns/ProfileValidationRules.php): `app/Concerns/ProfileValidationRules.php`
- [Security controller](https://github.com/zydiemorris/keepsy/blob/master/app/Http/Controllers/Settings/SecurityController.php): `app/Http/Controllers/Settings/SecurityController.php`
- [Security settings](https://github.com/zydiemorris/keepsy/blob/master/resources/js/pages/settings/Security.vue): `resources/js/pages/settings/Security.vue`

### People and sharing

- [People controller](https://github.com/zydiemorris/keepsy/blob/master/app/Http/Controllers/PeopleController.php): `app/Http/Controllers/PeopleController.php`
- [People page](https://github.com/zydiemorris/keepsy/blob/master/resources/js/pages/people/Index.vue): `resources/js/pages/people/Index.vue`
- [Shared albums controller](https://github.com/zydiemorris/keepsy/blob/master/app/Http/Controllers/SharedController.php): `app/Http/Controllers/SharedController.php`
- [Shared albums page](https://github.com/zydiemorris/keepsy/blob/master/resources/js/pages/shared/Index.vue): `resources/js/pages/shared/Index.vue`

### Other components

- **User**

## Connections

- User → Web routes: requests (evidence: `routes/web.php`)
- User → Settings routes: requests (evidence: `routes/settings.php`)
- Web routes → Memories controller: routes to (evidence: `routes/web.php`)
- Web routes → People controller: routes to (evidence: `routes/web.php`)
- Web routes → Shared albums controller: routes to (evidence: `routes/web.php`)
- Web routes → Settings routes: includes (evidence: `routes/web.php`)
- Settings routes → Profile controller: routes to (evidence: `routes/settings.php`)
- Settings routes → Security controller: routes to (evidence: `routes/settings.php`)
- App bootstrap → Web routes: loads routes (evidence: `bootstrap/app.php`)
- App bootstrap → Inertia middleware: registers (evidence: `bootstrap/app.php`)
- Memories controller → Memory requests: validates with (evidence: `app/Http/Controllers/MemoriesController.php`)
- Memories controller → Photo model: reads and writes (evidence: `app/Http/Controllers/MemoriesController.php`)
- Memories controller → Memories gallery: renders (evidence: `app/Http/Controllers/MemoriesController.php`)
- User model → Photo model: owns photos (evidence: `app/Models/User.php`)
- Fortify provider → User creation: registers action (evidence: `app/Providers/FortifyServiceProvider.php`)
- User creation → User model: creates user (evidence: `app/Actions/Fortify/CreateNewUser.php`)
- Profile controller → Profile validation: validates with
- Security controller → Security settings: renders (evidence: `app/Http/Controllers/Settings/SecurityController.php`)
- People controller → People page: renders (evidence: `app/Http/Controllers/PeopleController.php`)
- Shared albums controller → Shared albums page: renders (evidence: `app/Http/Controllers/SharedController.php`)
