# Amigable Mascota

> Amigable Mascota is a comprehensive Spanish-language platform that connects pet owners with pet-friendly places, services, and products worldwide. Built with Next.js 15+, the platform features AI-powered tools, user profiles, marketplace functionality, and community features for pet lovers.

Amigable Mascota serves as a complete ecosystem for pet owners, offering everything from finding pet-friendly hotels and restaurants to AI-powered pet name generation and veterinary services. The platform includes user authentication, social features, a support system, and comprehensive search capabilities across multiple countries and cities.

Key technologies: Next.js 15+, TypeScript, Tailwind CSS 4+, ShadCN UI, NextAuth, AI integrations (Anthropic Claude, DeepSeek), Cloudinary, Resend, GraphQL, React Query, and Lucide icons.

## Dynamic URL Patterns

The platform uses a sophisticated dynamic routing system that supports multiple URL structures for geographic and category-based navigation:

**Geographic Routes:**
- `/co` - Country page (Colombia)
- `/co/medellin` - Country/City page 
- `/co/antioquia` - Country/State page
- `/co/hoteles-pet-friendly` - Country/Category page
- `/co/medellin/hoteles-pet-friendly` - Country/City/Category page
- `/co/antioquia/hoteles-pet-friendly` - Country/State/Category page

**Category Routes:**
- `/hoteles-pet-friendly` - Global category page
- `/veterinarios` - Global service category
- `/restaurantes-pet-friendly` - Global place category
- `/adopcion-de-perros` - Adoption category

**Category Combined With Location Routes:**
- `/co/hoteles-pet-friendly` - Country/Category page
- `/co/medellin/hoteles-pet-friendly` - Country/City/Category page
- `/co/antioquia/hoteles-pet-friendly` - Country/State/Category page

**Place Routes:**
- `/hoteles-pet-friendly/hotel-name` - Category/Place page

## Core Features

- **Authentication System**: Complete user registration, login, and profile management with NextAuth
- **Places Directory**: Pet-friendly locations including hotels, restaurants, parks, and routes
- **Services Marketplace**: Veterinarians, pet groomers, walkers, sitters, and daycare centers  
- **Shop Platform**: Pet products, accessories, and food marketplace
- **User Profiles**: Personal profiles with pet information and social following system
- **AI Chat Assistant**: Intelligent pet care advisor and consultation system

## Ideas & Resources System

The ideas section provides comprehensive pet care information with its own routing structure:

**Main Ideas Routes:**
- `/ideas` - Ideas homepage with all categories
- `/ideas/nombres-para-mascotas` - Pet names collection
- `/ideas/razas-de-perros` - Dog breeds database
- `/ideas/razas-de-gatos` - Cat breeds database
- `/ideas/comida-para-mascotas` - Pet food guides

**Specific Content Routes:**
- `/ideas/nombres-para-perros/luna` - Individual dog name pages
- `/ideas/nombres-para-gatos/mimi` - Individual cat name pages
- `/ideas/razas-de-perros/golden-retriever` - Specific breed information
- `/ideas/comida-para-mascotas/royal-canin` - Specific food brand info
- `/ideas/generar-nombres-mascotas-ia` - AI-powered name generator

## Shop System

The marketplace uses a two-level structure for products and categories:

**Shop Routes:**
- `/tienda` - Shop homepage
- `/tienda/categoria-slug` - Shop category pages
- `/tienda/producto-slug` - Individual product pages

## Special Features

- `/ubicaciones` - Global locations directory
- `/ai` - AI chat assistant for pet care advice
- `/comenzar` - Multi-step registration system for service providers

## Authentication & User Management

- **User Authentication**: Login, registration, and session management
- **User Profiles**: Personal profiles with pet information and social features
- **Following System**: Users can follow other pet owners and service providers

## AI & Automation

- **AI Chat API**: DeepSeek-powered chat assistant specializing in pet care advice
- **AI Name Generator**: Advanced pet name generation with personality analysis using Anthropic Claude
- **Email Generation**: AI-powered newsletter creation for pet-related content
- **Content Generation**: Anthropic Claude integration for dynamic content creation

## Backend Services

- **GraphQL API**: Comprehensive data layer with type-safe queries and mutations
- **Authentication Services**: NextAuth configuration with multiple providers
- **Email System**: Resend integration for transactional and marketing emails
- **Image Management**: Cloudinary integration for upload and optimization
- **Support System**: Ticket management and help desk functionality

## UI Components & Design

- **ShadCN Components**: Complete design system with accessible UI components following Tailwind 4+ standards
- **Responsive Layouts**: Mobile-first design with adaptive navigation
- **Lucide Icons**: Consistent iconography throughout the platform
- **Motion Design**: Framer Motion animations for enhanced user experience

## Optional

- **Configuration Files**: Onboarding flows, category definitions, and system setup
- **Development Tools**: TypeScript configuration, linting rules, and build optimization
- **Static Assets**: Brand assets, illustrations, and public images
- **Utility Libraries**: Helper functions, date utilities, and common operations