# PuntoCampo - Documentación Completa para LLMs

> Marketplace B2B agropecuario de Argentina que conecta productores, compradores y transportistas para compra/venta de ganado, granos, maquinaria agrícola y servicios de flete.

## Información de la Empresa

- **Nombre**: PuntoCampo
- **Tipo**: Marketplace B2B
- **Industria**: Agropecuaria / AgTech
- **País**: Argentina
- **Idioma principal**: Español (es-AR)
- **URL**: https://puntocampo.com

## Propósito y Misión

PuntoCampo conecta productores agropecuarios directamente, eliminando intermediarios innecesarios para lograr:
- Mejores precios para vendedores
- Transparencia en las transacciones
- Logística integrada con transportistas verificados
- Información de mercado en tiempo real

## Usuarios y Roles

### Productor (rol por defecto)
- Puede publicar ofertas de venta de ganado y granos
- Puede crear alertas de compra
- Puede contratar servicios y fletes
- Puede conectar con otros productores

### Transportista
- Puede publicar disponibilidad de fletes
- Puede cotizar transporte de hacienda y granos
- Acceso a panel de gestión de viajes

### Administrador
- Gestión de usuarios y verificaciones
- Moderación de publicaciones
- Configuración del sistema

## Sistema de Niveles de Usuario

| Nivel | Estado | Capacidades |
|-------|--------|-------------|
| 1 | Sin verificar | Solo puede navegar y crear alertas |
| 2+ | Verificado | Puede publicar con créditos |

## Categorías de Publicaciones

### 1. Ganado (Hacienda)

#### Vientres
- Vacas preñadas
- Vacas vacías
- Vaquillonas preñadas
- Vaquillonas vacías

#### Gordos
- Novillos
- Vacas de descarte
- Vaquillonas gordas
- Toros

#### Invernada
- Terneros (machos)
- Terneras
- Novillitos
- Vaquillonas livianas

#### Cabaña
- Toros reproductores
- Vaquillonas de pedigree
- Genética bovina

### 2. Granos y Oleaginosas
- Soja
- Maíz
- Trigo
- Girasol
- Sorgo
- Cebada
- Avena
- Centeno

### 3. Servicios Agrícolas
- Siembra directa
- Cosecha
- Pulverización terrestre
- Pulverización aérea
- Fertilización
- Laboreo

### 4. Fletes
- Transporte de hacienda (jaulas)
- Transporte de granos (cerealeras)
- Corta, media y larga distancia

## Flujo de Publicaciones

```
1. Creación → revision (pendiente de aprobación)
2. Aprobación → activa (visible al público)
3. Match → matcheada (en proceso de transacción)
4. Cierre → cerrada (transacción completada)
```

## Sistema de Precios de Mercado

### Precios de Hacienda
- **Fuentes**: Mercado de Liniers, Rosgan
- **Categorías**: Vientres, Gordos, Invernada
- **Actualización**: Diaria
- **Formato**: $/kg vivo

### Precios de Granos
- Cotizaciones de la Bolsa de Comercio de Rosario
- Precios disponibles, futuros

### Cotización del Dólar
- Dólar oficial
- Dólar MEP
- Dólar blue

## Sistema de Créditos

Los usuarios verificados necesitan créditos para publicar:
- Cada publicación consume créditos según su tipo
- Los créditos se compran en packs
- Sistema de referidos para obtener créditos bonus

## Sistema de Alertas

Los compradores pueden crear alertas con criterios específicos:
- Tipo de producto (ganado, granos)
- Categoría y subcategoría
- Rango de peso
- Ubicación geográfica
- Rango de precio

Cuando se publica algo que coincide, el usuario recibe notificación.

## Sistema de Matches

Cuando un comprador y vendedor acuerdan:
1. Se crea un match
2. Se coordinan detalles de la transacción
3. Se puede solicitar flete integrado
4. Se confirma entrega
5. Se cierran con reseñas mutuas

## Gestión de Fletes

### Para vendedores/compradores:
- Solicitar cotización de flete
- Ver ofertas de transportistas
- Aceptar y coordinar

### Para transportistas:
- Recibir solicitudes de cotización
- Enviar propuestas
- Gestionar calendario de viajes

## Tecnología

- **Frontend**: Next.js 15, React 19, TypeScript
- **Styling**: Tailwind CSS v4
- **Backend**: Supabase (PostgreSQL + Auth + Realtime)
- **Hosting**: Vercel
- **Analytics**: Vercel Analytics

## Páginas Principales

| URL | Descripción |
|-----|-------------|
| / | Página de inicio con hero y categorías |
| /publicaciones | Listado de publicaciones activas |
| /precios | Precios de mercado en tiempo real |
| /preguntas-frecuentes | FAQ del sitio |
| /login | Inicio de sesión |
| /register | Registro de usuarios |
| /dashboard | Panel de usuario (requiere auth) |
| /empresa/[id] | Perfil público de empresa |
| /perfil/[id] | Perfil público de usuario |

## API Endpoints Públicos

### Precios
- `GET /api/precios-hacienda` - Precios generales de hacienda
- `GET /api/precios-hacienda/vientres` - Precios de vientres
- `GET /api/precios-hacienda/invernada` - Precios de invernada
- `GET /api/precios-hacienda/indices` - Índices de mercado

## Términos del Dominio Agropecuario

| Término | Significado |
|---------|-------------|
| Hacienda | Ganado bovino |
| Vientres | Vacas para reproducción |
| Gordos | Animales para faena |
| Invernada | Animales jóvenes para engorde |
| Cabaña | Establecimiento de cría |
| Novillito | Macho joven castrado |
| Vaquillona | Hembra joven sin parir |
| Ternero/a | Cría bovina recién destetada |
| Kg vivo | Peso del animal en pie |
| Jaula | Camión para transporte de hacienda |
| Cerealera | Camión para transporte de granos |

## Contacto

- **Web**: https://puntocampo.com
- **Email**: contacto@puntocampo.com

## Última actualización

Enero 2025