# yusufcanesener/sahiplendirme-fullstack architecture

> Architecture diagram of the GitHub repository yusufcanesener/sahiplendirme-fullstack, 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/yusufcanesener/sahiplendirme-fullstack
- Repository: https://github.com/yusufcanesener/sahiplendirme-fullstack

## Overview

PawFinder is an animal-adoption web application with a primary Express/Mongoose API for accounts, adoption listings, and blogs, plus a separate Express server exposing mock pet and shelter endpoints. The main user workflow is browsing or managing adoption listings: a user interacts with the public pages, the API handles requests, and MongoDB-backed models persist domain records. Account login and role-based navigation, blog publishing, maps, donations, and shelter/pet browsing are additional product capabilities. The README is empty; unsampled pages and routes are represented only where their paths are present in the tree, without inferred API links.

Main entry points: [`app.js`](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/app.js) (Primary API), [`public/server/index.js`](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/server/index.js) (Pet API server), [`public/shelters.html`](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/shelters.html) (Adoption pages), [`public/js/navbar.js`](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/js/navbar.js) (Role-aware navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Public web experience"]
  node_webpages["Adoption pages<br/>[shelters.html]"]
  node_authpages["Account pages<br/>[login.html]"]
  node_blogpages["Blog pages<br/>[blog.html]"]
  node_profilepages["Profile and roles<br/>[profile.html]"]
  node_maps["Maps and donations<br/>[maps.html]"]
  node_navbar["Role-aware navigation<br/>[navbar.js]"]
  node_notifications["Notifications<br/>[notification.js]"]
  node_loginclient["Login client<br/>[login.js]"]
  node_pets["Pet and shelter pages<br/>[pets.html]"]
end

subgraph group_core["Core API"]
  node_mainapi["Primary API<br/>[app.js]"]
  node_users["Account service<br/>[app.js]"]
  node_ads["Ad service<br/>[app.js]"]
  node_blogs["Blog service<br/>[app.js]"]
  node_admin["Role administration<br/>[app.js]"]
end

subgraph group_domain["Domain records"]
  node_userrecord[("User records<br/>[User.js]")]
  node_adrecord[("Ad records<br/>[Ad.js]")]
  node_blogrecord[("Blog records<br/>[Blog.js]")]
end

subgraph group_mock["Mock pet services"]
  node_auxserver["Pet API server<br/>[index.js]"]
  node_petroutes["Pet endpoints<br/>[pets.js]"]
  node_shelterroutes["Shelter endpoints<br/>[shelters.js]"]
  node_authroutes["Mock auth endpoints<br/>[auth.js]"]
end

node_visitor(("Visitor"))
node_mongodb[("MongoDB")]

node_visitor -->|"browses"| node_webpages
node_visitor -->|"uses"| node_authpages
node_webpages -.-> node_mainapi
node_authpages -.->|"loads"| node_loginclient
node_loginclient -->|"posts login"| node_mainapi
node_visitor -->|"reads"| node_blogpages
node_visitor -->|"manages account"| node_profilepages
node_visitor -->|"explores"| node_maps
node_visitor -->|"browses"| node_pets
node_navbar -->|"links to"| node_profilepages
node_navbar -->|"links to"| node_webpages
node_mainapi -->|"routes account requests"| node_users
node_mainapi -->|"routes ad requests"| node_ads
node_mainapi -->|"routes blog requests"| node_blogs
node_mainapi -->|"handles roles"| node_admin
node_users -->|"reads and writes"| node_userrecord
node_ads -->|"reads and writes"| node_adrecord
node_blogs -->|"reads and writes"| node_blogrecord
node_admin -->|"updates roles"| node_userrecord
node_mainapi -->|"connects"| node_mongodb
node_auxserver -->|"mounts"| node_authroutes
node_auxserver -->|"mounts"| node_petroutes
node_auxserver -->|"mounts"| node_shelterroutes
node_pets -.-> node_auxserver

click node_webpages "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/shelters.html"
click node_authpages "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/login.html"
click node_blogpages "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/blog.html"
click node_profilepages "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/profile.html"
click node_maps "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/maps.html"
click node_navbar "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/js/navbar.js"
click node_notifications "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/js/notification.js"
click node_loginclient "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/js/login.js"
click node_mainapi "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/app.js"
click node_users "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/app.js"
click node_ads "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/app.js"
click node_blogs "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/app.js"
click node_admin "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/app.js"
click node_userrecord "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/models/User.js"
click node_adrecord "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/models/Ad.js"
click node_blogrecord "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/models/Blog.js"
click node_auxserver "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/server/index.js"
click node_petroutes "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/server/routes/pets.js"
click node_shelterroutes "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/server/routes/shelters.js"
click node_authroutes "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/server/routes/auth.js"
click node_pets "https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/pets.html"

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_webpages,node_authpages,node_blogpages,node_profilepages,node_maps,node_navbar,node_notifications,node_loginclient,node_pets toneBlue
class node_mainapi,node_users,node_ads,node_blogs,node_admin,node_mongodb toneAmber
class node_userrecord,node_adrecord,node_blogrecord toneMint
class node_auxserver,node_petroutes,node_shelterroutes,node_authroutes toneRose
class node_visitor toneIndigo
```

## Components

### Public web experience

- [Adoption pages](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/shelters.html): `public/shelters.html`
- [Account pages](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/login.html): `public/login.html`
- [Blog pages](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/blog.html): `public/blog.html`
- [Profile and roles](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/profile.html): `public/profile.html`
- [Maps and donations](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/maps.html): `public/maps.html`
- [Role-aware navigation](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/js/navbar.js): `public/js/navbar.js`
- [Notifications](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/js/notification.js): `public/js/notification.js`
- [Login client](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/js/login.js): `public/js/login.js`
- [Pet and shelter pages](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/pets.html): `public/pets.html`

### Core API

- [Primary API](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/app.js): `app.js`
- [Account service](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/app.js): `app.js`
- [Ad service](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/app.js): `app.js`
- [Blog service](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/app.js): `app.js`
- [Role administration](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/app.js): `app.js`

### Domain records

- [User records](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/models/User.js): `models/User.js`
- [Ad records](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/models/Ad.js): `models/Ad.js`
- [Blog records](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/models/Blog.js): `models/Blog.js`

### Mock pet services

- [Pet API server](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/server/index.js): `public/server/index.js`
- [Pet endpoints](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/server/routes/pets.js): `public/server/routes/pets.js`
- [Shelter endpoints](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/server/routes/shelters.js): `public/server/routes/shelters.js`
- [Mock auth endpoints](https://github.com/yusufcanesener/sahiplendirme-fullstack/blob/main/public/server/routes/auth.js): `public/server/routes/auth.js`

### Other components

- **Visitor**
- **MongoDB**

## Connections

- Visitor → Adoption pages: browses
- Visitor → Account pages: uses
- Adoption pages → Primary API
- Account pages → Login client: loads
- Login client → Primary API: posts login (evidence: `public/js/login.js`)
- Visitor → Blog pages: reads
- Visitor → Profile and roles: manages account
- Visitor → Maps and donations: explores
- Visitor → Pet and shelter pages: browses
- Role-aware navigation → Profile and roles: links to (evidence: `public/js/navbar.js`)
- Role-aware navigation → Adoption pages: links to (evidence: `public/js/navbar.js`)
- Primary API → Account service: routes account requests (evidence: `app.js`)
- Primary API → Ad service: routes ad requests (evidence: `app.js`)
- Primary API → Blog service: routes blog requests (evidence: `app.js`)
- Primary API → Role administration: handles roles (evidence: `app.js`)
- Account service → User records: reads and writes (evidence: `app.js`)
- Ad service → Ad records: reads and writes (evidence: `app.js`)
- Blog service → Blog records: reads and writes (evidence: `app.js`)
- Role administration → User records: updates roles (evidence: `app.js`)
- Primary API → MongoDB: connects (evidence: `app.js`)
- Pet API server → Mock auth endpoints: mounts (evidence: `public/server/index.js`)
- Pet API server → Pet endpoints: mounts (evidence: `public/server/index.js`)
- Pet API server → Shelter endpoints: mounts (evidence: `public/server/index.js`)
- Pet and shelter pages → Pet API server
