# rotistorage-boop/archivein architecture

> Architecture diagram of the GitHub repository rotistorage-boop/archivein, 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/rotistorage-boop/archivein
- Repository: https://github.com/rotistorage-boop/archivein

## Overview

ArchiveIn is an academic-material archive and photo gallery with public browsing and an admin workspace. Visitors open the home page to browse gallery groups and, for permitted roles, a semester-to-course archive with detailed content. Admins manage academic and practical materials, gallery content, users, and sessions. Google OAuth establishes user sessions; archive/gallery services persist structured records and use external storage for media. The sampled files show key service and login relationships, but most admin route implementations were not sampled, so their connections are omitted where unverified.

Main entry points: [`src/routes/(app)/+page.server.ts`](https://github.com/rotistorage-boop/archivein/blob/main/src/routes/(app)/%2Bpage.server.ts) (Home page loader), [`src/lib/server/db/schema.ts`](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/db/schema.ts) (Application database), [`src/routes/login/google/callback/+server.ts`](https://github.com/rotistorage-boop/archivein/blob/main/src/routes/login/google/callback/%2Bserver.ts) (Google login), [`src/lib/server/services/storage.service.ts`](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/storage.service.ts) (Media storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public browsing"]
  node_home["Home page loader<br/>[+page.server.ts]"]
  node_gallery_ui["Gallery views<br/>[Gallery.svelte]"]
  node_archive_ui["Archive detail views<br/>[Detail.svelte]"]
end

subgraph group_admin["Admin workspace"]
  node_admin_routes["Admin routes"]
  node_dashboard["Dashboard<br/>[+page.svelte]"]
end

subgraph group_identity["Identity and access"]
  node_login["Google login<br/>[+server.ts]"]
  node_auth["Session auth<br/>[auth.ts]"]
  node_email["Email notifications<br/>[email.service.ts]"]
end

subgraph group_content["Content services"]
  node_archive_service["Academic archive<br/>[archive.service.ts]"]
  node_gallery_service["Gallery catalog<br/>[gallery.service.ts]"]
  node_image_service["Image processing<br/>[image.service.ts]"]
  node_praktikum_service["Praktikum content"]
  node_session_service["Session management<br/>[session.service.ts]"]
  node_users_service["User management<br/>[user.service.ts]"]
end

subgraph group_platform["Persistence and media"]
  node_database[("Application database<br/>[schema.ts]")]
  node_db_client["Database client<br/>[index.ts]"]
  node_storage["Media storage<br/>[storage.service.ts]"]
  node_seed["Initial content data<br/>[seed.ts]"]
end

node_visitor(("Visitor"))
node_admin_actor(("Administrator"))
node_google["Google services"]
node_imagekit["ImageKit"]

node_visitor -->|"opens"| node_home
node_home -->|"loads gallery"| node_gallery_service
node_home -->|"loads permitted archive"| node_archive_service
node_home -.->|"provides gallery data"| node_gallery_ui
node_home -.->|"provides archive data"| node_archive_ui
node_admin_actor -.->|"manages content"| node_admin_routes
node_admin_routes -.->|"serves dashboard"| node_dashboard
node_login -->|"exchanges OAuth profile"| node_google
node_login -->|"reads and writes users"| node_database
node_login -->|"creates session"| node_auth
node_login -->|"sends login notices"| node_email
node_archive_service -->|"reads and writes archive"| node_database
node_archive_service -->|"deletes item media"| node_storage
node_gallery_service -->|"reads and writes gallery"| node_database
node_gallery_service -->|"deletes gallery media"| node_storage
node_storage -->|"uploads and deletes files"| node_google
node_storage -->|"uploads and deletes images"| node_imagekit
node_seed -->|"inserts starter records"| node_database
node_session_service -->|"reads and deletes sessions"| node_database

click node_home "https://github.com/rotistorage-boop/archivein/blob/main/src/routes/(app)/%2Bpage.server.ts"
click node_gallery_ui "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/components/archive/Gallery.svelte"
click node_archive_ui "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/components/archive/Detail.svelte"
click node_admin_routes "https://github.com/rotistorage-boop/archivein/tree/main/src/routes/(admin)/dashboard"
click node_dashboard "https://github.com/rotistorage-boop/archivein/blob/main/src/routes/(admin)/dashboard/%2Bpage.svelte"
click node_login "https://github.com/rotistorage-boop/archivein/blob/main/src/routes/login/google/callback/%2Bserver.ts"
click node_auth "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/auth.ts"
click node_email "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/email.service.ts"
click node_archive_service "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/archive.service.ts"
click node_gallery_service "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/gallery.service.ts"
click node_image_service "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/image.service.ts"
click node_praktikum_service "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/praktikum.service.ts"
click node_database "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/db/schema.ts"
click node_db_client "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/db/index.ts"
click node_storage "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/storage.service.ts"
click node_seed "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/db/seed.ts"
click node_session_service "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/session.service.ts"
click node_users_service "https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/user.service.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_home,node_gallery_ui,node_archive_ui toneBlue
class node_admin_routes,node_dashboard toneAmber
class node_login,node_auth,node_email toneMint
class node_archive_service,node_gallery_service,node_image_service,node_praktikum_service,node_session_service,node_users_service toneRose
class node_database,node_db_client,node_storage,node_seed,node_visitor,node_admin_actor,node_google,node_imagekit toneIndigo
```

## Components

### Public browsing

- [Home page loader](https://github.com/rotistorage-boop/archivein/blob/main/src/routes/(app)/%2Bpage.server.ts): `src/routes/(app)/+page.server.ts`
- [Gallery views](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/components/archive/Gallery.svelte): `src/lib/components/archive/Gallery.svelte`
- [Archive detail views](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/components/archive/Detail.svelte): `src/lib/components/archive/Detail.svelte`

### Admin workspace

- [Admin routes](https://github.com/rotistorage-boop/archivein/tree/main/src/routes/(admin)/dashboard): `src/routes/(admin)/dashboard`
- [Dashboard](https://github.com/rotistorage-boop/archivein/blob/main/src/routes/(admin)/dashboard/%2Bpage.svelte): `src/routes/(admin)/dashboard/+page.svelte`

### Identity and access

- [Google login](https://github.com/rotistorage-boop/archivein/blob/main/src/routes/login/google/callback/%2Bserver.ts): `src/routes/login/google/callback/+server.ts`
- [Session auth](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/auth.ts): `src/lib/server/auth.ts`
- [Email notifications](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/email.service.ts): `src/lib/server/services/email.service.ts`

### Content services

- [Academic archive](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/archive.service.ts): `src/lib/server/services/archive.service.ts`
- [Gallery catalog](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/gallery.service.ts): `src/lib/server/services/gallery.service.ts`
- [Image processing](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/image.service.ts): `src/lib/server/services/image.service.ts`
- [Praktikum content](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/praktikum.service.ts): `src/lib/server/services/praktikum.service.ts`
- [Session management](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/session.service.ts): `src/lib/server/services/session.service.ts`
- [User management](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/user.service.ts): `src/lib/server/services/user.service.ts`

### Persistence and media

- [Application database](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/db/schema.ts): `src/lib/server/db/schema.ts`
- [Database client](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/db/index.ts): `src/lib/server/db/index.ts`
- [Media storage](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/services/storage.service.ts): `src/lib/server/services/storage.service.ts`
- [Initial content data](https://github.com/rotistorage-boop/archivein/blob/main/src/lib/server/db/seed.ts): `src/lib/server/db/seed.ts`

### Other components

- **Visitor**
- **Administrator**
- **Google services**
- **ImageKit**

## Connections

- Visitor → Home page loader: opens (evidence: `src/routes/(app)/+page.server.ts`)
- Home page loader → Gallery catalog: loads gallery (evidence: `src/routes/(app)/+page.server.ts`)
- Home page loader → Academic archive: loads permitted archive (evidence: `src/routes/(app)/+page.server.ts`)
- Home page loader → Gallery views: provides gallery data
- Home page loader → Archive detail views: provides archive data
- Administrator → Admin routes: manages content
- Admin routes → Dashboard: serves dashboard
- Google login → Google services: exchanges OAuth profile (evidence: `src/routes/login/google/callback/+server.ts`)
- Google login → Application database: reads and writes users (evidence: `src/routes/login/google/callback/+server.ts`)
- Google login → Session auth: creates session (evidence: `src/routes/login/google/callback/+server.ts`)
- Google login → Email notifications: sends login notices (evidence: `src/routes/login/google/callback/+server.ts`)
- Academic archive → Application database: reads and writes archive (evidence: `src/lib/server/services/archive.service.ts`)
- Academic archive → Media storage: deletes item media (evidence: `src/lib/server/services/archive.service.ts`)
- Gallery catalog → Application database: reads and writes gallery (evidence: `src/lib/server/services/gallery.service.ts`)
- Gallery catalog → Media storage: deletes gallery media (evidence: `src/lib/server/services/gallery.service.ts`)
- Media storage → Google services: uploads and deletes files (evidence: `src/lib/server/services/storage.service.ts`)
- Media storage → ImageKit: uploads and deletes images (evidence: `src/lib/server/services/storage.service.ts`)
- Initial content data → Application database: inserts starter records (evidence: `src/lib/server/db/seed.ts`)
- Session management → Application database: reads and deletes sessions (evidence: `src/lib/server/services/session.service.ts`)
