Adds the inception docs and design for the homepage sections

Refreshes the shared reverse engineering docs, adds the requirements,
application design and units for the homepage-sections feature, and
updates the static design: live prices and form fields, the new
Lieve woorden block and the coming-soon gate over the contact form.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-19 23:46:30 +02:00
co-authored by Claude Opus 5.5
parent 38c5c3e262
commit c81dcd3979
33 changed files with 2354 additions and 275 deletions
@@ -7,7 +7,9 @@ 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 (info@andreaslop.nl)"]
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;
@@ -16,32 +18,46 @@ graph LR
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 external;
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; a planned .NET API/CMS (dashed) will later supply content managed by Andrea.
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 replaces an existing WordPress (Solene theme) site at andreaslop.nl.
- **Business Transactions** (current state — front-end only, no back-end yet):
- **Browse the homepage** — hero slider with featured photos, call-to-action to "Over mij"
- **Navigate between pages** — header navigation (desktop) and hamburger menu (mobile)
- **Visit social profiles** — Facebook / Instagram links in the hero
- **Share / discover pages** — per-page title, meta description and Open Graph tags for search engines and link previews
- *Planned (static design only)*: portfolio browsing with lightbox, shoot types and pricing, contact form, Instagram feed
- **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"
- **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)*: homepage sections below the hero (lifestyle gallery, about, prices, contact form, Instagram), 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
- **Info menu / side area** — slide-in panel from the design with socials and e-mail (out of scope for this site, by owner decision)
- **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)
- **CMS** — the planned .NET API that will provide page content; content is hard-coded until then
- **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, SEO head tags, design system (colours, fonts, buttons)
- **Responsibilities**: Page routing, layout shell, homepage hero, 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, used as the visual and structural source of truth
- **Responsibilities**: Defines page sections, header/footer markup, design tokens and interactions to port to React
- **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