# Portal Náutico - Website Structure & Navigation Guide

## Website Overview

**Portal Náutico** (www.portalnautico.com.br) is a comprehensive Brazilian maritime/nautical marketplace where users can:
- Browse and buy boats (barcos, lanchas, veleiros, botes, jet skis)
- Search for marinas and boat clubs
- Find shipyards (estaleiros) and services
- Browse nautical motors and accessories
- Read maritime news and articles
- List boats for sale
- Connect with other maritime professionals

Language: Portuguese (Brazilian Portuguese)

---

## Public Navigation Structure

### Main Entry Points

#### 1. Homepage / Root Path
- **URL**: `/` or `/index`
- **Title**: "Portal Náutico Classificados de Barcos Lanchas Veleiros Botes"
- **Key Sections**:
  - Search bar for boats (prominent, top of page)
  - Featured boats carousel ("Barcos à venda em Destaque")
  - Most viewed boats carousel ("Mais acessados")
  - Call-to-action panels ("Anuncie Grátis")
  - Footer with links
- **Dynamic Content**:
  - `${destaques}` - Featured listings
  - `${maisAcessados}` - Top viewed listings

#### 2. Main Navigation Menu (Header)
Located in all pages via `fragments/header.html`. Contains:

**Dropdown Menu ("Menu" + dropdown)**:
- Lanchas à Venda → `/barcos/1.-lanchas-a-venda`
- Veleiros à Venda → `/barcos/2.-veleiros-a-venda`
- Notícias Náuticas → `/noticias-nauticas/`
- Marinas e Clubes → `/marinas`
- Acessórios Náuticos → `/acessorios/`
- Motores Náuticos → `/motores/`
- Estaleiros → `/estaleiros/`

**Primary Navigation**:
- Classificados → `/barcos/`
- Lanchas → `/barcos/1.-lanchas-a-venda`
- Veleiros → `/barcos/2.-veleiros-a-venda`
- Estaleiros → `/estaleiros/`
- Notícias Náuticas → `/noticias-nauticas/`

**User Section** (Top right):
- Login button → `/login/`
- Sign up button → `/cadastro/`

---

## Public Pages & Routes

### Boat Browsing & Listings

#### All Boats / Boats Listing
- **URL**: `/barcos/`
- **Title**: Dynamic (from `${title}` variable)
- **Meta Description**: Dynamic (from `${metaDescription}`)
- **Features**:
  - Advanced search form with boat type dropdown
  - Search by model/brand input
  - Breadcrumb navigation
  - Category filtering
  - Results grid/list display
  - Filters by type and category
- **Query Parameters**:
  - `query` - Search term (model/brand)
  - `alertMessage` - Alert message if needed
- **Filter Types** (from dropdown):
  - Populated from `${tipoBarco}` database
  - Each type has a slug: `tipoBarco.slug`

#### Category: Speedboats (Lanchas)
- **URL**: `/barcos/1.-lanchas-a-venda`
- **Shows**: All speedboats for sale
- **Breadcrumb**: Home > Lanchas

#### Category: Sailboats (Veleiros)
- **URL**: `/barcos/2.-veleiros-a-venda`
- **Shows**: All sailboats for sale
- **Breadcrumb**: Home > Veleiros

#### Boat Detail Page
- **URL**: `/barcos/{id}-{slug}` or similar pattern
- **Title**: Boat model + year
- **Shows**:
  - Full boat specifications
  - Photo gallery with lightbox
  - Listing price
  - Location (city/state)
  - Owner/seller info
  - "Add to Favorites" button
  - "Contact" form for inquiries
  - Related listings carousel

#### Sold Boats Archive
- **URL**: Likely `/barcos/vendidos/` or similar
- **Shows**: Archive of sold boats with status badge

---

### Marinas & Clubs (Marinas)

#### All Marinas Listing
- **URL**: `/marinas`
- **Shows**:
  - Marina/club listings
  - Location map integration
  - Search and filter options
  - Cards with marina info

#### Marina Detail Page
- **URL**: `/marinas/{id}-{slug}` or `/detalhe-marina`
- **Shows**:
  - Marina name and location
  - Services offered
  - Contact information
  - Map/location display
  - Photos/gallery

#### Marina Category Index
- **URL**: `/ind-marina/` or similar
- **Shows**: Marina categories/locations

---

### Shipyards (Estaleiros)

#### All Shipyards Listing
- **URL**: `/estaleiros/`
- **Shows**:
  - Shipyard/boatyard listings
  - Services offered
  - Location and contact info
  - Search/filter by location or service

#### Shipyard Detail Page
- **URL**: `/detalhe-estaleiro`
- **Shows**:
  - Shipyard name, location, description
  - Services and specialties
  - Contact information
  - Photos
  - Brands/models they work with

#### Shipyard Category Index
- **URL**: `/ind-estaleiro/`
- **Shows**: Shipyard categories by location or service type

---

### Motors (Motores Náuticos)

#### Motors Listing
- **URL**: `/motores/`
- **Shows**:
  - Marine motors and engines
  - Brand, horsepower, specifications
  - Price range
  - Compatibility info

---

### Accessories (Acessórios Náuticos)

#### Accessories Listing
- **URL**: `/acessorios/`
- **Shows**:
  - Nautical accessories and products
  - Categories
  - Prices
  - Descriptions

---

### News & Articles (Notícias Náuticas)

#### News Listing
- **URL**: `/noticias-nauticas/`
- **Shows**:
  - Blog/news articles
  - List of maritime articles
  - Publication date
  - Author info

#### Article Detail Page
- **URL**: `/detalhe-noticia`
- **Shows**:
  - Full article content (uses TinyMCE rich text)
  - Publication date
  - Author information
  - Related articles
  - Share buttons
  - Comments section (if enabled)

---

### Contact & Information

#### Contact Form (Fale Conosco)
- **URL**: `/faleConosco/`
- **Shows**:
  - Contact form with:
    - Name field
    - Email field
    - Subject field
    - Message (textarea)
  - Email submission to company
  - Confirmation message

#### About Page (Sobre)
- **URL**: `/sobre/`
- **Shows**:
  - Company information
  - History
  - Team info
  - Mission/values

---

### User Authentication Pages

#### Login
- **URL**: `/login/`
- **Shows**:
  - Email/username input
  - Password input
  - "Remember me" checkbox
  - "Forgot password" link → `/esqueci/`
  - "Sign up" link → `/cadastro/`
- **On Success**: Redirects to `/home`

#### Sign Up / Registration
- **URL**: `/cadastro/`
- **Shows**:
  - User registration form:
    - Name
    - Email
    - Phone
    - Password
    - Confirm password
    - Terms & conditions checkbox
  - "Already have account" link → `/login/`

#### Forgot Password
- **URL**: `/esqueci/`
- **Shows**:
  - Email input field
  - "Send recovery email" button
  - Link to login → `/login/`

#### Change Password
- **URL**: `/esqueci-troca-senha/`
- **Shows**:
  - New password field
  - Confirm password field
  - "Change password" button

---

## Error Pages

#### 404 Not Found
- **URL**: `/error` or page-not-found
- **Shows**: Custom 404 error page with navigation back to home

#### Generic Error
- **URL**: `/error.html`
- **Shows**: Error message and suggestions

---


## Landing Pages (SEO Optimized)

Located at `/landing/*` routes, designed for search engine optimization:

- **Speedboats for Sale**: `/landing/lanchas-a-venda.html`
- **Sailboats for Sale**: `/landing/veleiros-a-venda.html`
- **Boats for Sale**: `/landing/barcos-a-venda.html`
- **Jet Skis for Sale**: `/landing/jet-ski-a-venda.html`
- **Small Boats for Sale**: `/landing/botes-a-venda.html`
- **Speedboats by Brand**: `/landing/lanchas-marca.html`

Each landing page:
- Contains category-specific content
- Has SEO meta tags
- Links to relevant listings
- Optimized for specific keywords

---

## Page Components & Fragments

### Reusable Components (Included in Multiple Pages)

#### Header Navigation (`fragments/header.html`)
- **Included in**: ALL pages
- **Contains**:
  - Logo and branding
  - Main navigation menu (categories, search)
  - User authentication links (Login/Sign up)
  - Google Tag Manager tracking
  - Google AdSense ad slots
- **Variables**:
  - Authentication state check for conditional rendering

#### Footer (`fragments/footer.html`)
- **Included in**: ALL pages
- **Contains**:
  - Company info
  - Links (About, Contact, Terms)
  - Social media links
  - Copyright notice
  - Newsletter signup (possibly)

#### Search Form (`fragments/busca-home.html`)
- **Included in**: Homepage, listing pages
- **Contains**:
  - Boat type dropdown (populated by `${tipoBarco}`)
  - Search text input (placeholder: "Digite o modelo ou marca do barco...")
  - Search button
  - Advanced filters (price, location, year, etc.)


#### Loading Spinner (`fragments/loading.html`)
- **Included in**: Pages with AJAX operations
- **Shows**: Animated loading indicator during async operations

---

## Data Models & Display Patterns

### Boat/Listing Card Display
Each boat listing shows:
```
[Image] Model - Year
Type / Category
R$ Price
📍 City / State
[Link to detail]
```

Example from homepage:
- `${destaque.fotoPrincipal}` - Main photo
- `${destaque.modelo}` + `${destaque.ano}` - Title
- `${destaque.tipoBarco.nome}` / `${destaque.categoriaBarco.nome}` - Type/Category
- `R$ ${destaque.valorFormatado}` - Price
- `${destaque.cidade.nome}` / `${destaque.estado.uf}` - Location
- `${destaque.url}` - Link to detail page

### Listing Status
Boats can have statuses:
- Active (currently for sale)
- Sold (archived in `/barcos/vendido` pages)
- Expired (no longer active)
- Pending (awaiting approval)

### Search & Filter System

#### Navigation by Type
Type filtering uses URL pattern: `/barcos/{type-slug}`
- `1.-lanchas-a-venda` - Speedboats
- `2.-veleiros-a-venda` - Sailboats
- Custom type slugs from database

#### Search Parameters
Form posts to `/barcos/` with:
- `query` - Text search (model/brand)
- `type` - Boat type filter
- `category` - Boat category filter
- Other filters (price range, location, year, etc.)

---

## SEO Elements

### Meta Tags
All pages include:
- `<meta name="title">` - Page title
- `<meta name="Description">` - Meta description
- `<meta name="Keywords">` - Keywords
- `<meta name="Abstract">` - Summary
- `<link rel="canonical">` - Canonical URL (prevents duplicate content)

### Robots & Sitemap
- `robots.txt` - Crawler directives
- `sitemap.xml` - XML sitemap for search engines
- `ads.txt` - Authorized digital sellers

### Structured Data
- Dynamic meta descriptions for listings
- Canonical URLs prevent duplicate indexing
- Category landing pages for keyword targeting

---

## Third-Party Integrations

### Analytics & Tracking
- **Google Analytics**: GA ID `G-7XHHZQH9X7` (via GTM script)
- **Google Tag Manager**: Script in header for tracking events
- **Google Search Console**: Verification file included

### Advertising
- **Google AdSense**: Publisher ID `ca-pub-1273332957675208`
- Ad slots in header and content areas
- Prebid.js for ad exchange integration

### External Services
- **Google Maps**: Map display in marina/location pages
- **DigitalOcean Spaces**: CDN for images (storage-pn.sfo3.digitaloceanspaces.com)
- **Google Fonts**: Ubuntu and Signika Negative fonts

---

## Common User Journeys

### Journey 1: Browse and Buy
1. Visit homepage `/`
2. Use search bar to find boat type → `/barcos/1.-lanchas-a-venda`
3. Apply filters (price, location, year)
4. Click boat to view details → `/barcos/{id}-{slug}`
5. Contact owner via form on detail page

### Journey 2: Explore Services
1. Browse marinas → `/marinas`
2. View marina details → `/detalhe-marina`
3. Explore shipyards → `/estaleiros/`
4. View shipyard details → `/detalhe-estaleiro`
5. Contact via form or contact info

### Journey 3: Read News
1. Visit homepage `/`
2. Click "Notícias Náuticas" → `/noticias-nauticas/`
3. Browse article list with publication dates
4. Click article → `/detalhe-noticia`
5. Read full article content

### Journey 4: Search for Specific Boats
1. Visit homepage `/`
2. Enter search term in search bar (model/brand)
3. Click "Buscar" → `/barcos/?query=search-term`
4. Results displayed with filters available
5. Refine search using category dropdowns

---

## Technical Navigation Notes

### URL Conventions
- **Public pages**: `/page-name/` or `/page-name`
- **Authenticated pages**: `/home/*`
- **Admin pages**: `/home/*` with role checking
- **Detail pages**: `/detalhe-{type}` or `/{type}/{id}-{slug}`
- **Listing pages**: `/{type}/` or `/{type}/{filter}`

### Query Parameters
- `query=search-term` - Search boats by model/brand
- `alertMessage=message` - Display alerts
- `filter=category` - Category filtering
- Dynamic filtering for listings

### Session Variables
- `${session?.usuario?.primeiroNome}` - User's first name
- `${session?.usuario?.email}` - User's email (implied)
- User authentication state via Spring Security

### Dynamic Content
- `${destaques}` - Featured boats on homepage
- `${maisAcessados}` - Top viewed boats
- `${tipoBarco}` - Available boat types for filters
- `${metaDescription}` - Dynamic SEO meta description
- `${title}` - Dynamic page title
- `${canonicalUrl}` - Dynamic canonical URL

---

## Content Types

### Boat Listings
- Images: Multiple photos with gallery view
- Text: Rich text descriptions (TinyMCE)
- Metadata: Type, category, year, price, location
- Features: Favorites, contact form, view counter

### News Articles
- Images: Featured image/cover
- Text: Full rich text content (TinyMCE)
- Metadata: Author, publication date, category
- Features: Share buttons, related articles

### Services (Marinas, Shipyards)
- Images: Location photos, facility images
- Text: Description, services list
- Metadata: Location, contact info, hours
- Features: Map integration, contact form

---

## Key Pages Reference Table

| Page | URL | Purpose |
|------|-----|---------|
| Homepage | `/` | Browse featured boats, search |
| All Boats | `/barcos/` | Search and browse listings |
| Boat Detail | `/barcos/{id}` | View full boat information |
| Speedboats | `/barcos/1.-lanchas-a-venda` | Browse speedboats category |
| Sailboats | `/barcos/2.-veleiros-a-venda` | Browse sailboats category |
| Marinas | `/marinas` | Browse marina services |
| Shipyards | `/estaleiros/` | Browse shipyard services |
| News | `/noticias-nauticas/` | Read maritime news |
| Motors | `/motores/` | Browse motors |
| Accessories | `/acessorios/` | Browse accessories |
| About | `/sobre/` | Company information |
| Contact | `/faleConosco/` | Send inquiry message |
| Login | `/login/` | User authentication |
| Sign Up | `/cadastro/` | Create new account |

---

## Summary for AI/Bot Crawling

When accessing www.portalnautico.com.br:

1. **Start at root** `/` to discover main navigation and featured content
2. **Navigation is in header** - contains all public category links
3. **Key public sections**:
   - `/barcos/` - Main marketplace with listings
   - `/marinas` - Marina services
   - `/estaleiros/` - Shipyard services
   - `/noticias-nauticas/` - News/blog
   - `/motores/` - Motors catalog
   - `/acessorios/` - Accessories catalog
   - `/sobre/` - Company information
   - `/faleConosco/` - Contact form
4. **Search functionality**: Available from header on all pages
5. **Category filtering**: Accessible via dropdown on listing pages
6. **Dynamic URLs**: Listing pages use pattern `/barcos/{filter}` where filter is category slug
7. **Pagination**: DataTables used for large result sets with sorting/filtering
8. **Forms**: Search form in header; contact forms on service pages
9. **Images**: Main images from database objects (fotoPrincipal), some from DigitalOcean CDN
10. **Meta tags**: Every page has SEO tags for proper indexing
11. **Protected content**: Pages under `/home/*`, `/login`, `/cadastro`, `/esqueci*` and `/anunciar` are not publicly accessible and not documented here