# Fliinow AI Context File
# https://viaja.fliinow.com/llm.txt

## About This Project

Fliinow is a Spanish travel platform that connects travelers with specialized travel agencies and provides integrated financing options. The core value proposition is "dream validator + agency matcher + financing enabler" - helping users realize their travel dreams by removing payment barriers.

## Brand Identity

- **Name**: Fliinow
- **Tagline**: "El viaje no falla. Lo que falla es cómo se paga."
- **Mission**: Convert "I'd love to travel" into "I'm doing it" by validating dreams and enabling financial viability
- **Language**: Spanish (Spain)

## Domain Ecosystem

- viaja.fliinow.com - Traveler gateway landing page (this site)
- marketplace.fliinow.com - Agency marketplace
- legal.fliinow.com - Legal/compliance content
- simulador.fliinow.com - Financing simulator
- fliinow.com - Main company domain

## Key Features

### Smart AI Search
Users describe their ideal trip in natural language. The system uses AI (Google Gemini 2.5 Flash) to:
- Extract trip category (luna-de-miel, low-cost, familia, lujo, aventura, relax, cultural, gastronomico)
- Identify destination
- Determine trip type
- Match with specialized agencies

### Financing Integration
- Amount range: €60 - €5,000
- Terms: 3, 6, 9, or 12 months
- Interest rates: 1.48% (3m) to 8.38% (12m)
- TIN: 18%, TAE: 19.56%

## Brand Colors

- Dark: #1F1034 (hsl 270 53% 14%) - backgrounds, primary text
- Primary Green: #1CBC50 (hsl 145 73% 48%) - CTAs, highlights
- Accent Blue: #008DFF (hsl 207 100% 50%) - links, secondary elements

## Target Audience

Spanish-speaking travelers looking to book trips through specialized agencies with flexible payment options. The platform emphasizes affordability and accessibility over price comparison.

## Content Guidelines

- Focus on dream validation, not price comparison
- Emphasize financing makes travel accessible
- Highlight agency expertise and specialization
- Use inspiring, trustworthy tone
- Avoid technical jargon

---

## API Documentation

### AI Search Endpoint

**Purpose**: Analyze natural language travel queries and extract structured data for agency matching.

**Endpoint**: `POST https://mzgxkxcezxurkbihibsn.supabase.co/functions/v1/ai-search`

**Request**:
```json
{
  "query": "Luna de miel en Maldivas para agosto"
}
```

**Response**:
```json
{
  "category": "luna-de-miel",
  "destination": "Maldivas",
  "tripType": "playa",
  "confidence": 0.95,
  "reasoning": "Query mentions honeymoon and beach destination",
  "fromCache": false
}
```

### Available Categories

| Slug | Description | Keywords |
|------|-------------|----------|
| luna-de-miel | Honeymoon trips | luna de miel, novios, romántico |
| low-cost | Budget travel | barato, mochilero, low cost, económico |
| familia | Family vacations | familia, niños, hijos |
| lujo | Luxury travel | lujo, vip, cinco estrellas, premium |
| aventura | Adventure trips | aventura, trekking, safari, expedición |
| relax | Relaxation | spa, wellness, descanso, relax |
| cultural | Cultural experiences | cultura, museos, historia, arte |
| gastronomico | Food & wine | gastronomía, vino, cocina, restaurantes |
| todos | Default/general | (fallback when no match) |

### Example Queries

```
"Quiero ir con mi familia a Disneyland Paris"
→ category: familia, destination: París, tripType: parque-tematico

"Safari barato en Kenia para septiembre"
→ category: aventura, destination: Kenia, tripType: safari

"Escapada romántica a la Toscana con catas de vino"
→ category: gastronomico, destination: Toscana, tripType: enogastronomía

"Viaje de lujo a Dubai, hoteles 5 estrellas"
→ category: lujo, destination: Dubai, tripType: urbano
```

### Marketplace URL Format

After AI analysis, users are redirected to:
```
https://marketplace.fliinow.com/search?cat={category}&q={query}&ai=true&dest={destination}&type={tripType}
```

---

## Financing Calculator

### Formula

1. Fliinow commission = amount × 2%
2. Financing commission = (amount × 0.60%) + €0.50
3. Total fees = Fliinow commission + Financing commission
4. Subtotal = amount + Total fees
5. Interest = Subtotal × interest rate
6. Total to pay = Subtotal + Interest
7. Monthly payment = Total to pay ÷ months

### Interest Rates by Term

| Months | Interest Rate |
|--------|--------------|
| 3 | 1.48% |
| 6 | 3.76% |
| 9 | 6.06% |
| 12 | 8.38% |

### Example Calculation

For €1,000 in 6 months:
- Fliinow commission: €20
- Financing commission: €6.50
- Subtotal: €1,026.50
- Interest (3.76%): €38.60
- Total: €1,065.10
- Monthly: €177.52

---

## Contact

- Website: https://fliinow.com
- Marketplace: https://marketplace.fliinow.com
- Legal: https://legal.fliinow.com
- Simulator: https://simulador.fliinow.com