Files
AndreaSlopFotografie/aidlc-docs/_shared/reverse-engineering/business-overview.md
T
SluijsensandClaude Opus 5.5 26106f280f Plans the Over mij page
Refreshes the reverse engineering docs after the homepage sections and
records the requirements, execution plan and application design for the
Over mij page: live texts in the design's structure, an indexed page with
its own structured data and preview image, and shared building blocks
(PageSection, MediaText, Eyebrow) reused by the homepage.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 23:35:21 +02:00

66 lines
4.9 KiB
Markdown

# Business Overview
## Business Context Diagram
```mermaid
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
- *Placeholder pages (noindex)*: Over mij, Portfolio, Soorten fotoshoots, Contact, Privacyverklaring
- *Planned (static design only)*: Over mij page (intro with portrait, "Hoe het begon", photo duo, "Buiten de camera om", booking button), 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