feat(ADM-018): completed feature

2026-08-17 22:23:10 +02:00
parent cf1c69fc8b
commit d595b4871f
871 changed files with 47411 additions and 281 deletions
--- a/project/specs/brand-migration/TASKS.md
+++ b/project/specs/brand-migration/TASKS.md
@@ -0,0 +1,298 @@
+# BRAND MIGRATION — TASKS.md
+
+## Phase 1: Asset Extraction
+
+### BRAND-FE-001
+**ID**: BRAND-FE-001
+**Title**: Extract legacy CSS and brand colors
+**Goal**: Get exact hex values from mercadodevida.es stylesheet
+**Why**: Do not approximate brand colors
+**Dependencies**: None
+**Applications**: Frontend, Admin
+**Modules**: Design tokens
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: Inspect legacy site CSS via DevTools or curl; compare with current tokens; update @theme if needed
+**Tests**: Visual comparison of legacy vs new site colors
+**Expected blast radius**: Low — purely visual
+**Definition of Done**: Extracted colors documented in BRAND_INVENTORY.md; any divergence from current tokens identified
+
+### BRAND-FE-002
+**ID**: BRAND-FE-002
+**Title**: Download official logo
+**Goal**: Get highest quality logo from legacy site
+**Why**: No AI reconstruction or approximation allowed
+**Dependencies**: BRAND-FE-001
+**Applications**: Frontend, Admin
+**Modules**: Public assets
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: Find logo image URL from legacy HTML; download SVG/PNG; save to /public/images/; generate favicon variants
+**Tests**: Logo renders at correct size in Header and Footer; favicon loads
+**Expected blast radius**: Low
+**Definition of Done**: Logo file exists in /public/images/; renders in Header, Footer, and Admin sidebar
+
+## Phase 2: Business Configuration
+
+### BRAND-FE-003
+**ID**: BRAND-FE-003
+**Title**: Create businessConfig constant
+**Goal**: Single source of truth for company information
+**Why**: No duplicate address/phone/email strings
+**Dependencies**: BRAND-FE-001
+**Applications**: Frontend (all pages)
+**Modules**: frontend/src/lib/businessConfig.ts
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: Create businessConfig.ts with all known company info; use `as const` for type safety; mark social URLs as null pending extraction
+**Tests**: businessConfig type check; usage in Footer, Header, Contact, About, Checkout confirmation
+**Expected blast radius**: Frontend text content
+**Definition of Done**: All company info references businessConfig; no hardcoded strings in components
+
+## Phase 3: Storefront Brand Application
+
+### BRAND-FE-004
+**ID**: BRAND-FE-004
+**Title**: Update Header with logo + business config
+**Goal**: Header reflects official brand identity
+**Why**: Primary brand touchpoint
+**Dependencies**: BRAND-FE-002, BRAND-FE-003
+**Applications**: Frontend
+**Modules**: Header component
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: Replace inline SVG logo with actual logo file; use businessConfig for nav text; verify no hardcoded strings remain
+**Tests**: Logo renders; nav links correct; business name in correct places
+**Expected blast radius**: Low
+**Definition of Done**: Header matches brand; logo correct size and quality
+
+### BRAND-FE-005
+**ID**: BRAND-FE-005
+**Title**: Update Footer with full business info + social
+**Goal**: Footer contains all business contact information
+**Why**: Trust and legal requirement (company info on all pages)
+**Dependencies**: BRAND-FE-002, BRAND-FE-003
+**Applications**: Frontend
+**Modules**: Footer component
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: Use businessConfig for all footer data; add social links; add company registration info; verify copyright year is dynamic
+**Tests**: All footer fields populated from businessConfig; no placeholder text
+**Expected blast radius**: Low
+**Definition of Done**: Footer contains address, phone, email, WhatsApp, hours, social, legal links, dynamic copyright
+
+### BRAND-FE-006
+**ID**: BRAND-FE-006
+**Title**: Migrate About page content
+**Goal**: Faithful migration of /quienes-somos content
+**Why**: Preserve founder story and brand voice
+**Dependencies**: BRAND-FE-003
+**Applications**: Frontend
+**Modules**: /about page
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: Replace current /about content with migrated content from BRAND_INVENTORY.md; use ContentPage component; add legal flag comment
+**Tests**: Page renders migrated content correctly; text fidelity verified
+**Expected blast radius**: Low
+**Definition of Done**: About page matches legacy /quienes-somos; founders' story preserved; noted as needing legal review if claims made
+
+### BRAND-FE-007
+**ID**: BRAND-FE-007
+**Title**: Update Contact page
+**Goal**: Contact information from businessConfig + contact form
+**Why**: Customer trust; functional contact channel
+**Dependencies**: BRAND-FE-003
+**Applications**: Frontend
+**Modules**: /contact page
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: Use businessConfig for all contact info; add functional contact form (mailto or API endpoint); include map/location if feasible; hours from businessConfig
+**Tests**: All contact methods displayed; form submits successfully
+**Expected blast radius**: Low
+**Definition of Done**: Phone, email, WhatsApp, address, hours all correct and functional
+
+### BRAND-FE-008
+**ID**: BRAND-FE-008
+**Title**: Migrate/create legal pages (Terms, Privacy, Cookies)
+**Goal**: Legal pages exist with migrated or new content
+**Why**: Legal compliance; customer trust
+**Dependencies**: None (can run parallel)
+**Applications**: Frontend
+**Modules**: /terms, /privacy, /cookies pages
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: For Terms: migrate from legacy (see BRAND_INVENTORY.md); for Privacy/Cookies: create RGPD-compliant templates; add ⚠️LEGAL_REVIEW flag to all; use ContentPage component
+**Tests**: All three pages accessible at correct routes; content renders; links in footer correct
+**Expected blast radius**: Low
+**Definition of Done**: Pages exist and are accessible; flagged as needing legal review; legal links work
+
+### BRAND-FE-009
+**ID**: BRAND-FE-009
+**Title**: Migrate/create Shipping page
+**Goal**: Shipping policy accessible
+**Why**: Customer information requirement
+**Dependencies**: BRAND-FE-003
+**Applications**: Frontend
+**Modules**: /shipping page
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: Review existing /shipping page; enhance with additional shipping methods, costs, estimated delivery times, geographical coverage (Spain peninsular); use businessConfig for company info
+**Tests**: Shipping page complete with all delivery options; pricing included if applicable
+**Expected blast radius**: Low
+**Definition of Done**: Shipping page reflects current shipping policy; clear geographic scope stated
+
+## Phase 4: SEO Redirects
+
+### BRAND-FE-010
+**ID**: BRAND-FE-010
+**Title**: Implement legacy URL redirects in next.config.ts
+**Goal**: Preserve SEO equity; no broken links for indexed URLs
+**Why**: Indexed legacy URLs must not 404
+**Dependencies**: Complete LEGACY_REDIRECT_MAP.md
+**Applications**: Frontend (Next.js config)
+**Modules**: next.config.ts
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: Add `redirects()` async function in next.config.ts; implement all confirmed 308 redirects from LEGACY_REDIRECT_MAP.md; handle OpenCart route patterns with 410
+**Tests**: curl each legacy URL → correct redirect or target page
+**Expected blast radius**: Low — purely routing
+**Definition of Done**: All legacy static page URLs redirect correctly; OpenCart query-string routes return 404
+
+### BRAND-FE-011
+**ID**: BRAND-FE-011
+**Title**: Product slug redirects
+**Goal**: Redirect legacy product URLs to new product pages
+**Why**: Preserve SEO on indexed product pages
+**Dependencies**: BRAND-FE-010 (part of same config update)
+**Applications**: Frontend
+**Modules**: next.config.ts
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: Evaluate Option A vs B from LEGACY_REDIRECT_MAP.md; implement accordingly
+**Tests**: At least 5 legacy product URLs from sitemap → correct redirect
+**Expected blast radius**: Low
+**Definition of Done**: Legacy product slugs handled (either redirect to matching slug or to /products)
+
+## Phase 5: Admin
+
+### BRAND-ADM-001
+**ID**: BRAND-ADM-001
+**Title**: Admin sidebar logo
+**Goal**: Admin sidebar uses real logo instead of inline SVG
+**Why**: Brand consistency
+**Dependencies**: BRAND-FE-002
+**Applications**: Admin
+**Modules**: DashboardLayout sidebar
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: Copy logo to apps/admin/public/; update sidebar to use <img> instead of inline SVG
+**Tests**: Logo visible in admin sidebar
+**Expected blast radius**: Low
+**Definition of Done**: Admin sidebar shows actual logo; correct size
+
+## SEO
+
+### BRAND-SEO-001
+**ID**: BRAND-SEO-001
+**Title**: Sitemap update after migration
+**Goal**: New sitemap reflects migrated routes
+**Why**: Search engine indexing
+**Dependencies**: BRAND-FE-006, BRAND-FE-007, BRAND-FE-008, BRAND-FE-009, BRAND-FE-010
+**Applications**: Frontend
+**Modules**: sitemap.ts
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: Update frontend/src/app/sitemap.ts to include /about, /contact, /shipping, /terms, /privacy, /cookies; verify /products and /categories still included
+**Tests**: sitemap.xml accessible; contains all expected routes
+**Expected blast radius**: Low
+**Definition of Done**: Sitemap valid XML; includes all public routes
+
+### BRAND-SEO-002
+**ID**: BRAND-SEO-002
+**Title**: robots.txt update
+**Goal**: Allow crawlers for new routes; block legacy OpenCart routes
+**Why**: SEO and security
+**Dependencies**: BRAND-FE-010
+**Applications**: Frontend
+**Modules**: robots.ts
+**Database impact**: None
+**API contracts**: None
+**Permissions**: N/A
+**Implementation**: Update robots.ts to reflect new site structure; add Sitemap directive pointing to new sitemap
+**Tests**: /robots.txt accessible; correct directives present
+**Expected blast radius**: Low
+**Definition of Done**: robots.txt allows crawling of all public pages; blocks admin and legacy internals
+
+## QA
+
+### BRAND-QA-001
+**ID**: BRAND-QA-001
+**Title**: Visual regression and route tests
+**Goal**: Brand elements render correctly; redirects work
+**Why**: Quality assurance
+**Dependencies**: All FE/ADM tasks
+**Applications**: QA
+**Modules**: E2E or visual tests
+**Tests**:
+- Logo renders on Header, Footer, Admin sidebar
+- Footer contains all business contact info from businessConfig
+- About page renders migrated content
+- Legacy redirects: /quienes-somos → /about (308), /contacto → /contact (308)
+- Sitemap contains all public routes
+- No hardcoded company info outside businessConfig
+**Expected blast radius**: N/A
+**Definition of Done**: All tests pass; visual QA sign-off
+
+---
+
+## Task Summary Table
+
+| Task | Layer | Feature | Depends On | Risk | Parallel |
+|------|-------|---------|-----------|------|---------|
+| BRAND-FE-001 | FE | Extract legacy CSS | — | Low | * |
+| BRAND-FE-002 | FE | Download logo | BRAND-FE-001 | Low | * |
+| BRAND-FE-003 | FE | businessConfig | BRAND-FE-001 | Low | * |
+| BRAND-FE-004 | FE | Header update | BRAND-FE-002, BRAND-FE-003 | Low | * |
+| BRAND-FE-005 | FE | Footer update | BRAND-FE-002, BRAND-FE-003 | Low | * |
+| BRAND-FE-006 | FE | About page | BRAND-FE-003 | Low | * |
+| BRAND-FE-007 | FE | Contact page | BRAND-FE-003 | Low | * |
+| BRAND-FE-008 | FE | Legal pages | — | Medium | * |
+| BRAND-FE-009 | FE | Shipping page | BRAND-FE-003 | Low | * |
+| BRAND-FE-010 | FE | Static page redirects | BRAND-FE-001 | Low | BRAND-FE-006..009 |
+| BRAND-FE-011 | FE | Product slug redirects | BRAND-FE-010 | Medium | * |
+| BRAND-ADM-001 | Admin | Admin logo | BRAND-FE-002 | Low | * |
+| BRAND-SEO-001 | SEO | Sitemap update | BRAND-FE-006..009 | Low | * |
+| BRAND-SEO-002 | SEO | robots.txt update | BRAND-FE-010 | Low | * |
+| BRAND-QA-001 | QA | Visual + route tests | All above | Low | After FE tasks |
+
+**Parallel group**: BRAND-FE-001 through BRAND-FE-003 can run in parallel. BRAND-FE-004 through BRAND-FE-009 can run in parallel after FE-003. BRAND-FE-010 depends on BRAND-FE-001 (extract URLs). BRAND-SEO-001 and BRAND-SEO-002 depend on content pages being done.
+
+**Recommended order**:
+1. BRAND-FE-001, BRAND-FE-002, BRAND-FE-003 (parallel)
+2. BRAND-FE-004, BRAND-FE-005, BRAND-FE-006, BRAND-FE-007, BRAND-FE-008, BRAND-FE-009 (parallel)
+3. BRAND-FE-010 + BRAND-FE-011 (after FE-001)
+4. BRAND-ADM-001 (after FE-002)
+5. BRAND-SEO-001 + BRAND-SEO-002 (after content pages)
+6. BRAND-QA-001 (after everything)
+
+**High-risk tasks**:
+- BRAND-FE-008 (legal pages — requires human review, cannot be auto-approved)
+- BRAND-FE-011 (product redirects — wrong option could lose SEO equity)
+
+**Migration risks**:
+- Legal text is legacy and may not comply with current RGPD — must be reviewed by human before publishing
+- Legacy site may still be actively used — coordinate go-live date
+- Legacy product slugs may not match new platform slug format — requires slug mapping