# marcosdavi-dev/memories architecture

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

- Interactive diagram: https://gitdiagram.com/marcosdavi-dev/memories
- Repository: https://github.com/marcosdavi-dev/memories

## Overview

This is a small Express/Mongoose backend for managing memories with images. A client sends requests to the mounted memory API; route handlers apply upload middleware where needed and dispatch operations to the controller, which validates requests, reads or updates memory records, and returns JSON responses. Image uploads are saved under the public directory, while MongoDB stores memory metadata, favorites, and comments. The source excerpts show server wiring and these core operations; no README documents additional product capabilities.

Main entry points: [`backend/controllers/MemoryController.js`](https://github.com/marcosdavi-dev/memories/blob/main/backend/controllers/MemoryController.js) (Memory operations), [`backend/routes.js`](https://github.com/marcosdavi-dev/memories/blob/main/backend/routes.js) (Memory routes), [`backend/app.js`](https://github.com/marcosdavi-dev/memories/blob/main/backend/app.js) (Express app), [`backend/public/images`](https://github.com/marcosdavi-dev/memories/tree/main/backend/public/images) (Public images)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["Server"]
  node_app["Express app<br/>[app.js]"]
end

subgraph group_memory["Memory API"]
  node_routes["Memory routes<br/>[routes.js]"]
  node_upload["Image upload<br/>[upload.js]"]
  node_controller["Memory operations"]
end

subgraph group_storage["Persistence"]
  node_model["Memory schema<br/>[Memory.js]"]
  node_mongo_conn["Mongo connection<br/>[conn.js]"]
  node_images[("Public images")]
end

node_client(("API client"))
node_mongo[("MongoDB")]

node_client -->|"sends requests"| node_routes
node_app -->|"mounts at /memories"| node_routes
node_app -->|"initializes connection"| node_mongo_conn
node_routes -->|"applies middleware"| node_upload
node_routes -->|"dispatches operations"| node_controller
node_controller -->|"queries and saves"| node_model
node_mongo_conn -->|"connects to"| node_mongo
node_upload -->|"writes uploads"| node_images
node_controller -->|"deletes old images"| node_images
node_app -->|"serves static files"| node_images
node_controller -->|"returns JSON"| node_client

click node_app "https://github.com/marcosdavi-dev/memories/blob/main/backend/app.js"
click node_routes "https://github.com/marcosdavi-dev/memories/blob/main/backend/routes.js"
click node_upload "https://github.com/marcosdavi-dev/memories/blob/main/backend/helpers/upload.js"
click node_controller "https://github.com/marcosdavi-dev/memories/blob/main/backend/controllers/MemoryController.js"
click node_model "https://github.com/marcosdavi-dev/memories/blob/main/backend/models/Memory.js"
click node_mongo_conn "https://github.com/marcosdavi-dev/memories/blob/main/backend/db/conn.js"
click node_images "https://github.com/marcosdavi-dev/memories/tree/main/backend/public/images"

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_app,node_client toneBlue
class node_routes,node_upload,node_controller,node_mongo toneAmber
class node_model,node_mongo_conn,node_images toneMint
```

## Components

### Server

- [Express app](https://github.com/marcosdavi-dev/memories/blob/main/backend/app.js): `backend/app.js`

### Memory API

- [Memory routes](https://github.com/marcosdavi-dev/memories/blob/main/backend/routes.js): `backend/routes.js`
- [Image upload](https://github.com/marcosdavi-dev/memories/blob/main/backend/helpers/upload.js): `backend/helpers/upload.js`
- [Memory operations](https://github.com/marcosdavi-dev/memories/blob/main/backend/controllers/MemoryController.js): `backend/controllers/MemoryController.js`

### Persistence

- [Memory schema](https://github.com/marcosdavi-dev/memories/blob/main/backend/models/Memory.js): `backend/models/Memory.js`
- [Mongo connection](https://github.com/marcosdavi-dev/memories/blob/main/backend/db/conn.js): `backend/db/conn.js`
- [Public images](https://github.com/marcosdavi-dev/memories/tree/main/backend/public/images): `backend/public/images`

### Other components

- **API client**
- **MongoDB**

## Connections

- API client → Memory routes: sends requests (evidence: `backend/routes.js`)
- Express app → Memory routes: mounts at /memories (evidence: `backend/app.js`)
- Express app → Mongo connection: initializes connection (evidence: `backend/app.js`)
- Memory routes → Image upload: applies middleware (evidence: `backend/routes.js`)
- Memory routes → Memory operations: dispatches operations (evidence: `backend/routes.js`)
- Memory operations → Memory schema: queries and saves (evidence: `backend/controllers/MemoryController.js`)
- Mongo connection → MongoDB: connects to (evidence: `backend/db/conn.js`)
- Image upload → Public images: writes uploads (evidence: `backend/helpers/upload.js`)
- Memory operations → Public images: deletes old images (evidence: `backend/controllers/MemoryController.js`)
- Express app → Public images: serves static files (evidence: `backend/app.js`)
- Memory operations → API client: returns JSON (evidence: `backend/controllers/MemoryController.js`)
