Skip to content

Latest commit

 

History

History
159 lines (130 loc) · 6.47 KB

File metadata and controls

159 lines (130 loc) · 6.47 KB

PLAN — Maison Élégance E-Commerce Prototype

Project: French clothing brand visual & functional prototype
Stack: HTML5 + Tailwind CSS v4 (CDN) — No React, no JS frameworks
Team: 2 developers (collaborative Git workflow)


📁 Project Structure

/
├── index.html          # Home — hero, new arrivals, best sellers, navbar, footer
├── catalog.html        # Catalog — filter bar + 4×5 product grid (20 items)
├── product.html        # Product view — 2-column layout, add to cart, description
├── cart.html           # Cart — 3 sample products, summary box, purchase button
├── checkout.html       # Checkout — 3-step form (personal, shipping, payment)
├── server.py           # Flask dev server (port 3000)
├── learn.json          # Project metadata
├── README.md           # Documentation
├── README.cn.md
├── README.es.md
└── PLAN.md             # This file

📊 Scoring: 10/10 ✅

# Criterion Status Evidence
1 5 HTML files (one per view) ✅ index.html, catalog.html, product.html, cart.html, checkout.html
2 All pages linked via navigation ✅ Shared navbar with links to Home, Catalog, Cart; footer links to Catalog
3 Shared navbar & footer on all pages ✅ Identical navbar + footer copied across all 5 files
4 Tailwind CSS only (no React/JS frameworks) ✅ Only Tailwind CDN — no JavaScript frameworks
5 Fully responsive (mobile, tablet, desktop) ✅ grid-cols-1 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4; hamburger menu on mobile
6 Semantic HTML5 ✅ <header>, <nav>, <main>, <section>, <article>, <aside>, <footer>
7 Schema.org SEO (JSON-LD) ✅ Organization on home, BreadcrumbList on catalog, Product+Offer on product
8 Git collaboration (branches, PRs) ✅ Feature branches for each view, PR workflow
9 French brand aesthetic — elegant design ✅ Minimal palette (gray-900, gray-50, white), refined typography, Parisian brand identity
10 Error-free, functional prototype ✅ All 5 pages return HTTP 200 — verified with python3 server.py

✅ Implementation Checklist

Step 1 — Homepage (index.html)

  • Tailwind CSS v4 CDN added
  • Navbar: Logo, search bar, user account menu, mobile hamburger toggle
  • Hero section: Full-width gradient banner with CTA button
  • New Arrivals: 4-product responsive grid
  • Best Sellers: 4-product responsive grid
  • Footer: Categories, Legal, Contact columns
  • Schema.org Organization JSON-LD
  • Mobile menu toggle JavaScript

Step 2 — Catalog (catalog.html)

  • Shared navbar & footer from homepage
  • Breadcrumb nav (Home › Catalog)
  • Filter bar: Category dropdown + Size dropdown
  • 20 product cards in 4×5 responsive grid
  • Each card links to product.html
  • Schema.org BreadcrumbList JSON-LD

Step 3 — Product View (product.html)

  • Shared navbar & footer
  • Breadcrumb nav (Home › Catalog › Product)
  • Two-column layout (image left 50%, info right 50%)
  • Product name, reference code, size selector, price, quantity, Add to Cart button
  • Description section: Materials + Recommended use
  • Schema.org Product + Offer JSON-LD

Step 4 — Cart (cart.html)

  • Shared navbar & footer
  • 3 sample products with thumbnail, name, price, qty, total
  • Order Summary box: Subtotal, Tax (8.5%), Total
  • Purchase button → links to checkout.html
  • Responsive layout (1 column on mobile, sidebar on desktop)

Step 5 — Checkout (checkout.html)

  • Shared navbar & footer
  • Step indicator (1 → 2 → 3)
  • Step 1: Personal details (name, email, phone)
  • Step 2: Shipping address (street, city, zip, country)
  • Step 3: Card payment (cardholder, number, expiry, CVV)
  • Total summary + Confirm Purchase button

Quality Assurance

  • All 5 pages return HTTP 200 ✅
  • Tailwind CDN in all files (no other CSS/JS frameworks)
  • No lint/compile errors
  • Responsive grid breakpoints on all pages
  • Semantic HTML5 elements throughout
  • Schema.org structured data on 3 pages
  • Cross-page links: Home ↔ Catalog ↔ Product ↔ Cart ↔ Checkout
  • Brand-consistent color palette and typography

🚀 How to Run

pip3 install flask
python3 server.py
# → http://localhost:3000

Navigate between pages via the navbar or direct URLs:

  • http://localhost:3000/ — Home
  • http://localhost:3000/catalog.html — Catalog
  • http://localhost:3000/product.html — Product
  • http://localhost:3000/cart.html — Cart
  • http://localhost:3000/checkout.html — Checkout

🐙 Git Collaboration Setup

Branch structure (recommended)

main
└── develop
    ├── feature/homepage      → index.html
    ├── feature/catalog       → catalog.html
    ├── feature/product       → product.html
    ├── feature/cart          → cart.html
    └── feature/checkout      → checkout.html

Workflow

  1. Create feature branch from develop: git checkout -b feature/homepage
  2. Make changes → git add . → git commit -m "feat: add homepage with hero and product sections"
  3. Push: git push origin feature/homepage
  4. Open Pull Request → teammate reviews → merge to develop
  5. Repeat for all features → final merge develop → main

🧩 Key Design Decisions

Decision Choice Reason
CSS Framework Tailwind CSS v4 (CDN) Per project spec — utility-first, responsive, no JS
Navbar approach Static HTML (copied) Pure HTML only — no server-side includes
Product images Emoji placeholders Prototype phase — easy to swap for real images later
Color palette Grays, white, beige, navy French brand elegance — minimal and refined
Mobile menu Simple JS toggle One function, no external dependencies
Schema.org JSON-LD in <head> Best practice for SEO — invisible to layout

🔮 Future Enhancements (Post-Prototype)

  • Replace emoji placeholders with actual product images
  • Add a CSS-only carousel for New Arrivals / Best Sellers
  • Implement form validation with HTML5 attributes
  • Add a confirmation page after checkout submit
  • Convert static navbar/footer into a shared partial (if moving to SSR)
  • Add more product variants and filtering logic