# LLMs.txt para Fletalo - Plataforma de Fletes 
# Archivo de configuración para Large Language Models

## PROYECTO
Nombre: Fletalo
Descripción: Plataforma web para conectar clientes particulares, comercios y empresas con fleteros.
Tecnología: Angular (Framework Frontend)
Tipo: Aplicación Web Empresarial

## CONTEXTO DEL NEGOCIO
Fletalo es una plataforma que conecta clientes (particulares, comercios y empresas) que necesitan servicios de flete con fleteros profesionales. La aplicación maneja todo el proceso desde la cotización hasta el pago, incluyendo calificaciones, liquidaciones, pagos, y sistema de referidos.

## FUNCIONALIDADES PRINCIPALES
- Sistema de cotizaciones para fletes
- Fletes urgentes
- Registro y gestión de fleteros
- Sistema de pagos (MercadoPago y efectivo)
- Calificaciones y reseñas
- Sistema de referidos
- Gestión de empresas
- Perfiles de usuario
- Sistema de autenticación con guards
- Páginas informativas (FAQ, términos, privacidad)

## ESTRUCTURA DEL PROYECTO
/src/
├── app/                          # Código principal de la aplicación
│   ├── about-us/                 # Página "Sobre Nosotros"
│   ├── authentication/           # Sistema de autenticación
│   ├── cash-payment/             # Pagos en efectivo
│   ├── companies/                # Gestión de empresas
│   ├── common/                   # Componentes y servicios compartidos
│   ├── core/                     # Funcionalidades base (interceptores, guards)
│   ├── error/                    # Páginas de error (404, 503, etc.)
│   ├── home/                     # Página principal y FAQ
│   ├── login/                    # Login de usuarios
│   ├── mp-payment/               # Pagos con MercadoPago
│   ├── privacy/                  # Política de privacidad
│   ├── qualification/            # Calificaciones y reseñas
│   ├── quote/                    # Cotizaciones y presupuestos
│   ├── register/                 # Registro general
│   ├── registerShipper/          # Registro de fleteros
│   ├── registerUser/             # Registro de usuarios
│   ├── shippers/                 # Gestión de fleteros
│   ├── shared/                   # Componentes, servicios y utilidades compartidas
│   ├── terms/                    # Términos y condiciones
│   ├── theme/                    # Sistema de temas y estilos
│   └── userProfile/              # Perfiles de usuario
├── assets/                       # Recursos estáticos
│   ├── documents/                # Documentos PDF y otros
│   ├── fonts/                    # Fuentes tipográficas
│   ├── i18n/                     # Internacionalización
│   ├── images/                   # Imágenes del sitio
│   └── styles/                   # Estilos globales
├── environments/                 # Configuraciones por ambiente
│   ├── dev/                      # Desarrollo
│   ├── prod/                     # Producción
│   └── qa/                       # Testing

## MODELOS DE NEGOCIO
- User: Datos personales, credenciales, tipo de cuenta
- Shipper: Fletero con perfil, vehículo, liquidaciones
- Quote: Cotización generada por el usuario, aceptada por un fletero
- Payment: Información sobre método y estado de pago
- Freight: Viajes realizados, tipo B2B o B2C
- ShipperSettlement: Liquidación generada para fleteros
- Company: Empresas registradas que solicitan servicios
- Rating: Calificaciones de clientes y fleteros

## RUTAS PÚBLICAS PRINCIPALES
- / (landing; home module bajo ruta vacía)
- /quote
- /quote/faq
- /companies
- /stores
- /register
- /registerShipper
- /registerUser
- /about-us
- /shippers
- /clients
- /shippers/faq
- /privacity (política de privacidad)
- /terms
- /user-terms
- /shipper-terms
- /authentication/signin
- /qualification/:code (calificación; requiere código en la URL)
- /referrals/shipper-to-company
- /referrals/shipper-to-shipper

## TECNOLOGÍAS UTILIZADAS
- Angular (Framework principal)
- TypeScript
- SCSS/CSS
- Bootstrap (UI Framework)
- RxJS (Programación reactiva)
- Angular Forms (Formularios reactivos)
- Angular Router (Navegación SPA)
- Angular HTTP Client (Consumo de APIs)

## INTEGRACIONES EXTERNAS
- Google Places API → autocompletado de direcciones
- MercadoPago → pasarela de pagos
- Firebase → notificaciones push y mensajes

## CONVENCIONES DE CÓDIGO
- Nomenclatura en inglés para el código
- Nomenclatura en español para comentarios y textos UI
- Estructura modular por funcionalidad
- Separación de responsabilidades: componentes, servicios, modelos, pipes
- Tipado estricto con interfaces TypeScript
- Validaciones con Angular Validators (reactivos)
- Naming por feature: `feature-name.component.ts`, `feature-name.service.ts`, etc.

## ARCHIVOS IMPORTANTES
- `main.ts`: Punto de entrada de la aplicación
- `app.module.ts`: Módulo principal de la app
- `app.routing.ts`: Ruteo principal de vistas
- `styles.scss`: Estilos globales y temas
- `angular.json`: Configuración del proyecto Angular
- `environments/`: Variables de entorno por ambiente
- `sitemap.xml`: Para indexación SEO
- `robots.txt`: Reglas para motores de búsqueda
- `llms.txt`: Contexto del proyecto para asistentes y herramientas (copiado en build)

## SEGURIDAD Y PRIVACIDAD
- Autenticación vía JWT con Interceptors
- Guards para proteger rutas sensibles
- Formularios con validaciones y mensajes de error
- No se almacenan contraseñas en texto plano
- Todas las solicitudes se realizan por HTTPS
- Manejo centralizado de errores HTTP
- Sanitización de inputs en formularios y envío a APIs

## CONSIDERACIONES ESPECIALES PARA LLMs
- Siempre responde en **español para el usuario**
- El código generado debe estar en **inglés**
- Pensar como una aplicación **empresarial de logística**
- Priorizar seguridad y validación en formularios
- Mantener coherencia con la arquitectura Angular existente
- No repetir código innecesario
- Usar patrones de diseño y principios SOLID cuando corresponda
- Considerar distintos tipos de usuarios (cliente, empresa, fletero)