# Product

<!-- impeccable:product-schema 1 -->

## Platform

web

## Users

**Consumers** — Angolan families and individuals looking for groceries, household items, and daily essentials at a trusted supermarket. They use the site to find nearby stores, check product availability and prices, and discover promotions.

**Business Clients** — restaurants, hotels, resellers, supermarkets, and groceries seeking B2B supply partnership with Mangolê. They use the inquiry form at `/para-negocios`.

**Suppliers** — agricultural producers, official distributors, manufacturers/industry, and service/logistics providers who want to supply products to Mangolê stores. They use the supplier portal at `/fornecedores`.

**Job Seekers** — people exploring career opportunities at Mangolê via the careers page.

**Partners** — existing or prospective commercial and institutional partners.

## Product Purpose

Mangolê is a supermarket chain in Angola providing fresh products, fair prices, and customer service. The website is the brand's digital storefront — it helps customers find stores, browse the catalogue, learn about campaigns and news, and connect with the business for supply partnerships, supplier onboarding, careers, and other opportunities. The site is informational and lead-generation oriented, not an e-commerce platform.

## Positioning

Mangolê differentiates across multiple dimensions simultaneously:
- **Frescura e qualidade** — fresh, high-quality products
- **Preços baixos** — competitive everyday pricing
- **Capilaridade nacional** — broadest store network across Angolan provinces
- **Apoio ao produtor angolano** — commitment to local producers and national development
- **Experiência de cliente** — trusted, welcoming service

## Operating Context

Consumers visit the site from desktop and mobile devices across Angola, often with varying connection quality and technical literacy. The site is entirely in Portuguese (Angola variant). The primary use case is discovering store locations, checking products and prices, and staying informed about promotions and news. Business users submit inquiry forms; suppliers apply through a multi-step form with file uploads. All content is managed through an admin CMS (Filament).

## Capabilities and Constraints

- **Store locator** — Leaflet/OpenStreetMap map with search, province/municipality filters, service type filter, open-now status, store detail pages with hours/services/contact
- **Product catalog** — grid with category sidebar, brand filter, search, sort by name/price, product detail pages with related products
- **Campaigns** — promotional listings with scheduling, assets, and CTAs
- **News articles** — authored content with scheduling, rich text, categories
- **B2B inquiries** — form with business type selection and rate limiting (5/min per IP)
- **Supplier portal** — landing page with benefits, process timeline, case study testimonials, FAQ accordion, application form with file upload (PDF/DOC/PNG/JPG, 10MB max), status tracking
- **Careers** — job vacancy listings with external application links
- **Partners** — partner showcase with levels (standard/gold/platinum)
- **Admin CMS** — Filament panel for managing all content
- **NOT an e-commerce platform** — no cart, checkout, payments, or online purchasing
- **Client card / loyalty card** — a dedicated section to highlight the supermarket's customer loyalty card is requested but not yet implemented

## Brand Commitments

- **Name:** Mangolê (also appears as Mangole in domain)
- **Domain:** mangole.ao
- **Email:** @mangole.ao (admin), @mwangole.co.ao (info, negocios, compras)
- **Social media:** @mwangole (Facebook, Instagram, YouTube, LinkedIn)
- **Tagline:** "O teu supermercado de confiança em Angola" / "O Supermercado da Família Angolana"
- **Colors:** Blue structural (#0055A5 / #002D62) + Yellow accent/CTA (#FFC72C)
- **Font:** Instrument Sans (headings and body)
- **Voice:** Portuguese (Angola), warm, trustworthy, family-oriented
- **Logo:** `public/images/logo-mangole.jpeg`

## Evidence on Hand

- Full Laravel application with 20 completed rebuild phases and 79 passing tests
- Real product data in MySQL database (stores, products, categories, campaigns, etc.)
- Existing supplier case studies and testimonials in the codebase
- Complete set of brand assets (logo, favicon, brand colors in CSS custom properties)
- All page copy is in Portuguese and editable via CMS settings

## Product Principles

1. **Trust first** — the site must inspire confidence in the brand and its products
2. **Accessible to all** — serve every Angolan consumer regardless of device or connection quality; mobile-first, lightweight
3. **Local first** — prioritise Angolan producers, content, and cultural relevance
4. **Clarity over cleverness** — information is easy to find and understand; no unnecessary complexity
5. **Conversion without friction** — forms and applications are simple, fast, and reliable

## Accessibility & Inclusion

The site serves a broad Angolan audience with varying levels of technical literacy and device quality. Mobile-first responsive design, clear navigation, simple form interactions, and fast load times are essential. Portuguese language throughout.
