implementation_log.md

## Implementation log

This file documents the implementation process in detail (decisions, structure, commands, and verification).

---

### 2025-12-14 — Project initialization

#### What I did
- Inspected reference screenshots (`landingpage.png`, `screenshot_1.png`–`screenshot_4.png`).
- Wrote a structured site specification in `website_description.md`.
- Set up progress tracking in `todo.md` using Linear-style issue IDs.

#### Key observations from screenshots
- Home page uses an Amazon-like header + secondary nav + large hero carousel.
- Autocomplete suggestions dropdown appears under the search bar.
- Search results page has a left filter sidebar and a dense grid of gift-card products with pagination.
- Product detail page is for a gift card with design selection and a delivery form (recipient email, sender, message, delivery date), plus reviews and legal info.

#### Next steps
- Scaffold a production-ready monorepo with:
  - Web app (Amazon-like UI)
  - API server (auth + product/search/cart/checkout/orders/reviews)
  - Database migrations and realistic seed data
  - Python SDK to access API

#### Implementation decisions (initial)
- **Frontend**: Next.js (App Router) + Tailwind CSS for rapid iteration and production-ready builds.
- **Backend**: FastAPI with JWT auth and a relational DB.
- **Database**: SQLite for local dev (simple, zero-install), designed to be switchable to Postgres via `DATABASE_URL`.
- **Seeding**: deterministic-ish seed script using `faker` + Unsplash images to populate hundreds of products and many reviews.
- **SDK**: Python package using `httpx` providing an ergonomic client, handling auth and pagination.