> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/No-Country-simulation/S02-26-Equipo-33-Web-App/llms.txt
> Use this file to discover all available pages before exploring further.

# Horse Trust Documentation

> A trusted marketplace platform for buying and selling horses with secure transactions and verified sellers.

# Welcome to Horse Trust

A comprehensive equestrian marketplace platform connecting buyers and sellers with verified listings, real-time communication, and secure transactions.

<CardGroup cols={2}>
  <Card title="Get Started" icon="rocket" href="/quickstart">
    Set up your development environment in minutes
  </Card>

  <Card title="API Reference" icon="code" href="/api/auth/register">
    Explore the complete REST API documentation
  </Card>
</CardGroup>

## Platform Overview

Horse Trust is a full-stack SaaS platform built for the equestrian community. Our platform enables secure horse transactions with built-in seller verification, comprehensive listings management, and real-time buyer-seller communication.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Get your development environment set up and running in minutes
  </Card>

  <Card title="Architecture" icon="diagram-project" href="/architecture">
    Understand the technical architecture and system design
  </Card>

  <Card title="Authentication" icon="shield-halved" href="/features/authentication">
    Learn about JWT-based auth and role-based access control
  </Card>

  <Card title="API Reference" icon="code" href="/api/auth/register">
    Explore the complete REST API documentation
  </Card>
</CardGroup>

## Core Features

Discover the powerful features that make Horse Trust a trusted marketplace platform.

<CardGroup cols={3}>
  <Card title="User Authentication" icon="user-shield" href="/features/authentication">
    JWT-based authentication with role-based access for admins and sellers
  </Card>

  <Card title="Horse Listings" icon="horse" href="/features/horse-listings">
    Comprehensive listing management with photos, videos, and location tracking
  </Card>

  <Card title="Marketplace" icon="store" href="/features/marketplace">
    Advanced filtering, search, and discovery of horses for sale
  </Card>

  <Card title="Real-Time Chat" icon="comments" href="/features/real-time-chat">
    Socket.io-powered messaging between buyers and sellers
  </Card>

  <Card title="Seller Verification" icon="badge-check" href="/features/seller-verification">
    Identity verification system with document upload and approval workflow
  </Card>

  <Card title="Veterinary Records" icon="notes-medical" href="/api/horses/vet-records">
    Track and manage health records for each horse
  </Card>
</CardGroup>

## Technology Stack

Built with modern, scalable technologies for performance and reliability.

<CardGroup cols={2}>
  <Card title="Frontend Guide" icon="browser" href="/frontend/overview">
    Next.js 16 with React 19, TypeScript, and Tailwind CSS
  </Card>

  <Card title="Backend Guide" icon="server" href="/backend/overview">
    Express.js REST API with MongoDB and Socket.io
  </Card>

  <Card title="Database Models" icon="database" href="/backend/database-models">
    MongoDB schemas for Users, Horses, Chat, and more
  </Card>

  <Card title="Deployment" icon="cloud" href="/deployment/setup">
    Production deployment guides and environment configuration
  </Card>
</CardGroup>

## API Reference

Comprehensive REST API documentation with request/response examples.

<CardGroup cols={2}>
  <Card title="Authentication API" icon="key" href="/api/auth/register">
    User registration, login, and profile management endpoints
  </Card>

  <Card title="Horses API" icon="horse-head" href="/api/horses/list">
    Create, read, update, and delete horse listings
  </Card>

  <Card title="Chat API" icon="message" href="/api/chat/conversations">
    Real-time messaging and conversation management
  </Card>

  <Card title="Admin API" icon="user-gear" href="/api/admin/overview">
    Administrative endpoints for platform management
  </Card>
</CardGroup>

## Contributing

Join our development community and help improve Horse Trust.

<Card title="Contribution Guide" icon="code-pull-request" href="/contributing/git-workflow">
  Learn about our Git workflow, coding standards, and pull request process
</Card>
