102 lines
3.3 KiB
HTML
102 lines
3.3 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
<title>Logical Architecture</title>
|
|
<link rel="stylesheet" href="./style.css" />
|
|
</head>
|
|
<body>
|
|
<header>
|
|
<h1>Logical Architecture</h1>
|
|
<div class="meta">Next.js App Router, Prisma/Postgres, role-based auth, email verification, approvals.</div>
|
|
</header>
|
|
<main class="grid">
|
|
<section class="card">
|
|
<h2>Component map</h2>
|
|
<div class="diagram">
|
|
<pre class="mermaid">
|
|
flowchart LR
|
|
Browser["Client browser"] -->|"HTTPS"| Traefik["Traefik ingress"]
|
|
Traefik --> Varnish["Varnish cache\n(static + /api/images/*)"]
|
|
Varnish --> Next["Next.js App Router\nSSR/ISR + API routes"]
|
|
Next --> Auth["Auth/session module\n(JWT cookie)"]
|
|
Next --> Prisma["Prisma ORM"]
|
|
Prisma --> Postgres[(PostgreSQL\nlistings + images)]
|
|
Next --> Mailer["SMTP mailer\nsmtp.lomavuokraus.fi (CNAME) + DKIM"]
|
|
Admin["Admins & moderators"] --> Traefik
|
|
</pre>
|
|
</div>
|
|
<div class="callout">Edit the Mermaid block above to evolve the architecture.</div>
|
|
</section>
|
|
|
|
<section class="card">
|
|
<h2>Domain model</h2>
|
|
<div class="diagram">
|
|
<pre class="mermaid">erDiagram
|
|
USER ||--o{ LISTING : owns
|
|
USER ||--o{ LISTING : approves
|
|
LISTING ||--|{ LISTINGTRANSLATION : has
|
|
LISTING ||--o{ LISTINGIMAGE : has
|
|
|
|
USER {
|
|
string id
|
|
string email
|
|
string passwordHash
|
|
string role
|
|
string status
|
|
datetime emailVerifiedAt
|
|
datetime approvedAt
|
|
datetime rejectedAt
|
|
datetime removedAt
|
|
}
|
|
LISTING {
|
|
string id
|
|
string status
|
|
datetime approvedAt
|
|
datetime rejectedAt
|
|
datetime removedAt
|
|
string country
|
|
string region
|
|
string city
|
|
float latitude
|
|
float longitude
|
|
}
|
|
LISTINGTRANSLATION {
|
|
string id
|
|
string slug
|
|
string title
|
|
string locale
|
|
string teaser
|
|
}
|
|
LISTINGIMAGE {
|
|
string id
|
|
string url
|
|
string data
|
|
string mimeType
|
|
int size
|
|
string altText
|
|
boolean isCover
|
|
int order
|
|
}
|
|
</pre>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="card">
|
|
<h2>Key notes</h2>
|
|
<ul>
|
|
<li><strong>Web</strong>: Next.js app (App Router), server-rendered pages, client hooks for auth state.</li>
|
|
<li><strong>API routes</strong>: Authentication, admin approvals, listings CRUD (soft-delete), profile update.</li>
|
|
<li><strong>Data</strong>: Postgres via Prisma (models: User, Listing, ListingTranslation, ListingImage, VerificationToken); listing images stored as bytes + metadata and served through <code>/api/images/:id</code>.</li>
|
|
<li><strong>Caching</strong>: Varnish sidecar caches <code>/api/images/*</code> (24h) and <code>/_next/static</code> assets (7d) before requests reach Next.js.</li>
|
|
<li><strong>Mail</strong>: SMTP (smtp.lomavuokraus.fi CNAME to smtp.sohva.org) + DKIM signing for verification emails.</li>
|
|
<li><strong>Auth</strong>: Email/password, verified+approved requirement, JWT session cookie (<code>session_token</code>), roles.</li>
|
|
</ul>
|
|
</section>
|
|
</main>
|
|
<script type="module">
|
|
import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs';
|
|
mermaid.initialize({ startOnLoad: true, theme: 'dark' });
|
|
</script>
|
|
</body>
|
|
</html>
|