Files
diana/specification/00-overview.md
2026-07-31 07:17:00 +02:00

65 lines
3.0 KiB
Markdown

# Diana Website — Specification Overview (v1)
## Brand
**Home Enhancement and Renovation — HER**
- Short-form: **HER** (used in logo/header)
- Full name: "Home Enhancement and Renovation" (footers, About, legal)
## Purpose
Build a **mobile-first, SEO-friendly, static website** for Diana (handywoman) that primarily **converts visitors into qualified quote requests**.
## Goals
1. **Generate qualified leads** via a lightweight quote/contact form.
2. Communicate Diana's differentiation: **trustworthy, easy to work with, female handyman/handywoman**, strong **project coordination/mediation** skills.
3. **SEO-first information architecture**: separate/grouped service pages with clear local relevance (San Francisco + 50-mile radius).
4. **Fast, mobile-first UX** (Core Web Vitals friendly, readable, tap-target safe).
## Non-goals / Out of scope (v1)
- Blog
- Booking / calendar scheduling
- Payments
- Analytics / tracking (no cookie consent banner required)
- Deployment/infrastructure work beyond "static site served behind Caddy reverse proxy"
## Key constraints
- Language: **English**.
- Site type: **static website**.
- Content updates expected to be infrequent (maintained by owner/you).
- Form should be **lightweight** (no file uploads in v1).
- Form backend: **existing AWS service** (details TBD — see OQ-3 / ADR-002).
## Primary user flows
1. Visitor lands on Home page → scans credibility/services → taps **Request a Quote** → submits form.
2. Visitor lands on a Service page (SEO) → sees what's included + service area + CTA → submits form.
3. Visitor checks About / Testimonials for trust → CTA → submits form.
## Intended information architecture
| Page | URL slug | Notes |
|------|----------|-------|
| Home | `/` | Hero, positioning, services overview, CTA |
| Services hub | `/services/` | Links to all service pages |
| Painting | `/services/painting/` | |
| Tile Setting | `/services/tile-setting/` | |
| Drywall & Sheetrocking | `/services/drywall/` | |
| Minor Plumbing | `/services/plumbing/` | |
| Minor Electrical | `/services/electrical/` | |
| Carpentry & Mounting | `/services/carpentry-and-mounting/` | |
| Flooring & Wood Refinishing | `/services/flooring/` | |
| Security & Safety Equipment | `/services/security-safety/` | |
| Boat Work | `/services/boat-work/` | |
| About Diana | `/about/` | Story, experience, credibility |
| Testimonials | `/testimonials/` | Customer quotes |
| Contact / Request a Quote | `/contact/` | Form + secondary contact (email, phone) |
## Specification documents
### Core specs (Phase 2)
- `00-overview.md` (this file)
- `01-requirements.md`
- `02-architecture-decisions.md`
- `99-open-questions.md`
### Themed specs (Phase 3 — planned)
- `33-frontend-spec.md` — pages, components, UX, mobile-first design, conversion flow
- `37-seo-content-spec.md` — page structure, metadata, schema.org, sitemap/robots, content requirements per page
- `38-lead-capture-spec.md` — form fields, validation, spam protection, delivery/routing, confirmation UX