rikrdo/mercadodevida
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
290ced173b7cce3ffc386fd8a4e7042f4b8a49fc
mercadodevida/project/specs/brand-migration/TASKS.md
chattie d595b4871f feat(ADM-018): completed feature
2026-08-17 22:23:10 +02:00

299 lines
13 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
Reference in New Issue View Git Blame Copy Permalink