# CampoInteligencia & Tambofy — Documentación Completa para Modelos de Lenguaje (LLMs)

## 1. Información General del Sistema
- **Nombre de la Plataforma**: CampoInteligencia
- **Módulo Principal**: Tambofy (Dairy Herd Management & Analytics)
- **Subdominios Integrados**: BitácoraMaq (`https://bitacoramaq.campointeligencia.com`)
- **Dominio Principal**: `https://campointeligencia.com`
- **Público Objetivo**: Productores lecheros, Médicos Veterinarios, Ingenieros Agrónomos, Tamberos, Administradores de Empresas Agropecuarias en Argentina y el Cono Sur.

---

## 2. Módulos y Arquitectura Funcional

### 2.1. Gestión de Rodeo y Animales
- **Identificación**: Caravana (Visual / RFID), CUI, RP, Raza (Holando Argentino, Jersey, Cruza), Categoría (Vaca en Ordeñe, Vaca Seca, Vaquillona, Ternera).
- **Historial de Vida**: Fecha de nacimiento, genealogía (padre, madre), registros de partos, abortos y descartes.
- **Lactancias**: Días en Leche (DEL), pico de producción (días 45-60), persistencia láctea, secado programado a los 220 días de gestación (aprox. 60 días antes del parto esperado).

### 2.2. Producción Láctea y Calidad
- **Controles Lecheros**: Registro periódico (1 a 2 veces por mes) de litros individuales, porcentaje de Grasa Butirosa (% GB), Proteína (% PB) y Recuento de Células Somáticas (RCS).
- **Umbral de Mastitis**: RCS > 200.000 cél/ml indica sospecha de mastitis subclínica.
- **Tanque de Frío**: Litros diarios despachados a la industria láctea, temperatura de conservación, extracto seco magro.

### 2.3. Reproducción Bovina
- **Período de Espera Voluntario (PEV/VWP)**: Típicamente 50 a 60 días posparto.
- **Tasa de Detección de Celos (TDC)**: % de vacas aptas inseminadas en un ciclo de 21 días (Objetivo > 65%).
- **Tasa de Concepción (TC)**: % de servicios que resultan en preñez confirmada (Objetivo > 35-40%).
- **Tasa de Preñez (TP)**: TDC x TC a los 21 días (Objetivo > 22-25%).
- **Días Abiertos**: Días transcurridos desde el parto hasta la concepción efectiva (Objetivo < 120 días).
- **Intervalo Entre Partos (IEP)**: Objetivo 12.5 a 13.5 meses.

### 2.4. Nutrición y Raciones TMR (Total Mixed Ration)
- **Componentes**: Silaje de maíz / sorgo, pasturas base alfalfa, heno / rollos, grano de maíz molido, harina de soja, subproductos (afrechillo, gluten feed), núcleos vitamínico-minerales y buffers (bicarbonato de sodio).
- **Cálculo de Consumo**: Consumo estimado de 3.2% a 3.8% del peso vivo en Materia Seca (kg MS/vaca/día).
- **Eficiencia de Conversión**: Litros de leche producidos por kg de Materia Seca consumida (Objetivo > 1.35 - 1.50 L/kg MS).

### 2.5. Sanidad y Bienestar Animal
- **Mastitis Clínica vs Subclínica**: Grados 1, 2 y 3. Protocolos de tratamiento intramamario con período de descarte de leche (retiro) obligatorio.
- **Podología / Rengueras**: Score de locomoción (1 a 5). Tratamientos en manga de desvasado.
- **Salud Reproductiva**: Metritis puerperal, endometritis, retención de placenta y quistes ováricos.

### 2.6. Economía y Finanzas del Tambo (Argentina)
- **Moneda**: Pesos Argentinos (ARS) y equivalencia en USD oficial / libre.
- **Costo Operativo Corto Plazo (COCP) y Costo Total (CT)**: Alimentación (50-60% del costo total), mano de obra (15-20%), sanidad y reproducción (5-8%), amortizaciones y gastos de estructura.
- **Precio Cobrado**: Referencia mensual SIGLEA (Sistema Integrado de Gestión de la Lechería Argentina) y estadísticas OCLA (Observatorio de la Cadena Láctea Argentina).

### 2.7. Asistente Inteligente Tambofy (Google Gemini)
- **Modo de Operación**: Híbrido local-first (cálculos matemáticos exactos en Firestore del usuario) + RAG con base de conocimiento técnico-agronómica + LLM generativo Google Gemini.
- **Seguridad**: No emite diagnósticos veterinarios vinculantes; recomienda siempre la consulta con el profesional actuante ante cuadros de emergencia.

---

## 3. BitácoraMaq (`https://bitacoramaq.campointeligencia.com`)
- Sistema PWA para gestión del parque de maquinaria agrícola (tractores, sembradoras, cosechadoras, mixers, desmalezadoras, tolvas).
- Control de consumos de gasoil (L/hora, L/hectárea), odómetros, horómetros, alertas de service (filtros, aceite de motor, transmisión, engrase) y órdenes de trabajo para operarios de campo.