Files
AndreaSlopFotografie/aidlc-docs/_shared/reverse-engineering/business-overview.md
T
SluijsensandClaude Opus 5.5 e15215393e Adds the Over mij page
Replaces the placeholder with the page from the design and the texts from
the live site: Andrea's introduction with her portrait, how it started,
two photos, life outside photography and a booking button. The page is
now indexed, with its own title, description, preview image and AboutPage
data about Andrea.

The portrait loads straight away instead of after the page, since on
phones it is the largest paint. Lighthouse no longer lets every indexed
page use the homepage's lower mobile performance target; it now only
applies to the homepage itself.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 01:17:33 +02:00

4.9 KiB

Business Overview

Business Context Diagram

graph LR
    Visitor["Website visitor (prospective client)"] --> Site["Andrea Slop Fotografie website (React SPA)"]
    Crawler["Search engines and link previews"] --> Site
    Site --> Social["Facebook and Instagram profiles"]
    Site --> Mail["E-mail (mailto, address assembled in the browser)"]
    Site --> Umami["Umami (cookieless visitor stats)"]
    Site --> Sentry["Sentry (JS error reports)"]
    Owner["Andrea (photographer, content owner)"] -.-> CMS["Planned .NET API / CMS"]
    CMS -.-> Site
    classDef person fill:#f6e05e,stroke:#c05621,stroke-width:1px,color:#000;
    classDef system fill:#63b3ed,stroke:#2b6cb0,stroke-width:1px,color:#000;
    classDef external fill:#9ae6b4,stroke:#2f855a,stroke-width:1px,color:#000;
    classDef planned fill:#e2e8f0,stroke:#4a5568,stroke-width:1px,stroke-dasharray:5 5,color:#000;
    class Visitor,Owner,Crawler person;
    class Site system;
    class Social,Mail,Umami,Sentry external;
    class CMS planned;

Text alternative: visitors and crawlers use the website, which links out to social profiles and e-mail and reports to Umami and Sentry; a planned .NET API/CMS (dashed) will later supply content managed by Andrea.

Business Description

  • Business Description: Portfolio and marketing website for Andrea Slop Fotografie, a lifestyle photographer in Huizen (NL). It presents her work (loveshoots, family, pregnancy and newborn shoots), tells who she is, lists shoot types and prices, and gets prospective clients to make contact. It will replace the existing WordPress (Solene theme) site at andreaslop.nl; a test build runs at test.andreaslop.nl.
  • Business Transactions (current state — front-end only, no back-end):
    • Browse the homepage — hero slider with featured photos (autoplay, arrows, swipe, pause button, screen reader announcements), call-to-action to "Over mij"; below it Lifestyle fotografie (photo gallery), Over mij (intro + "Lees mijn verhaal" → /over-mij), Prijzen (packages), Lieve woorden (testimonials carousel), Contact and Instagram
    • Choose a package — "Boek" on a price card scrolls to Contact with that shoot preselected (?pakket=)
    • Contact the photographer — contact form (validation, anti-spam) shown dimmed under a "coming soon" notice until the API exists; mailto fallback with a subject
    • Navigate between pages — header navigation (desktop), full-screen menu (mobile), footer menu, skip link, back-to-top button
    • Visit social profiles — Facebook / Instagram links in the hero and footer
    • E-mail the photographer — mailto link in the footer
    • Share / discover pages — per-page title, description, canonical URL, Open Graph tags, JSON-LD (ProfessionalService), sitemap.xml, robots.txt
    • Recover from errors — 404 page inside the shell, error page with retry
    • Read about the photographer — Over mij page: introduction with portrait, how it started, two photos, life outside photography, links to the portfolio and contact, "Boek je shoot"
    • Placeholder pages (noindex): Portfolio, Soorten fotoshoots, Contact, Privacyverklaring
    • Planned (static design only): portfolio with lightbox, shoot types and pricing page, contact page
  • Business Dictionary:
    • Shell — the Header / page content / Footer frame shared by every page (see LAYOUT.md)
    • Hero — full-screen photo slider at the top of the homepage
    • Highlights / Lifestyle fotografie — homepage intro section with a four-photo gallery
    • Package (pakket) — a priced shoot offer (Newborn, Zwangerschap, Loveshoot) with what is included
    • Shoot — a photo session type (newborn, pregnancy, loveshoot, portraits)
    • Info menu / side area — slide-in panel from the design (out of scope, by owner decision)
    • CMS — the planned .NET API that will provide page content and receive the contact form; content is hard-coded in web/src/content/ until then
    • Placeholder page — a route that exists for navigation but shows "in de maak" and is noindex

Component Level Business Descriptions

web (React front-end)

  • Purpose: The public website visitors see
  • Responsibilities: Page routing, layout shell, homepage (hero + six sections, contact form behind a gate), SEO, monitoring, design system, server configuration for test (nginx) and production (IIS)

.gitea/workflows (CI/CD)

  • Purpose: Quality gate and delivery
  • Responsibilities: Lint, format, tests, build, audit, Lighthouse; deploy to test on merge to master; deploy to production manually from release/*

design/andreaslop-static (reference only)

  • Purpose: Static HTML/CSS/JS rebuild of the live site, the visual and structural source of truth
  • Responsibilities: Defines page sections, markup, design tokens and interactions to port to React

api (planned)

  • Purpose: .NET back-end for content and the contact form
  • Responsibilities: None yet — the folder is empty