Manual del administrador. Cómo dejar RanchoOS listo para todo tu rancho: configuración, equipo y permisos, el bot de Telegram, reportes, dinero y seguridad. Para el uso diario, comparte el Manual de usuario.
Configura tu rancho
Como administrador (dueño), tú dejas el rancho listo para todos. Todo esto vive en Ajustes.
- Datos del rancho: nombre, ciudad, estado y ubicación en el mapa (de ahí sale el clima y el índice de calor).
- Logo del rancho: súbelo para que aparezca en el panel y en los reportes.
- Idioma: cada usuario elige el suyo (ES · EN · PT); no afecta a los demás.
- Precios de mercado y parámetros por especie (ver sección 06): la base para estimar valor y "listos para vender".
Orden sugerido 1) Datos y ubicación → 2) Precios por especie → 3) Da de alta a tu equipo → 4) Conecta Telegram.
Tu equipo y permisos
Invita a tu gente y dale a cada quien exactamente lo que necesita. En Equipo agregas miembros y eliges su rol.
| Rol | Qué puede hacer |
|---|---|
| Administrador | Todo el rancho: ganado, tierra, ventas, finanzas, equipo y ajustes. |
| Trabajador (vaquero) | Registrar animales y eventos, y capturar gastos — por app o por Telegram. |
| Veterinario | Sanidad: eventos y bitácora de tratamientos y diagnósticos. |
Permisos finos
Cada acción pide un permiso; el rol trae un paquete por defecto y el bot respeta lo mismo que la web:
- animales.registrar · animales.vender — altas y ventas.
- eventos.registrar · sanidad.bitacora — pesos, partos, tratamientos.
- lotes.gestionar — mover animales entre potreros/lotes.
- finanzas.ver · finanzas.gastos — ver dinero y registrar gastos.
- equipo.gestionar · ajustes.gestionar — administrar personas y configuración.
Cuida quién es admin El administrador puede todo, incluido vender y borrar. Da ese rol solo a quien de verdad lo necesita.
Conectar Telegram
El bot es la forma más rápida de que tu gente capture desde el potrero. Hay dos maneras de vincular a alguien:
La fácil: código de vinculación
- En Equipo, abre a la persona y toca Generar código de vinculación.
- Comparte el código (o el enlace directo) por WhatsApp. Dura 30 minutos.
- La persona abre el bot y pega el código (o toca el enlace). Queda vinculada al instante.
La manual: por ID de Telegram
La persona escribe /start al bot, este le da su ID, y tú lo pegas en su ficha de Equipo.
Tu propio chat El dueño se vincula desde Ajustes → configuración de Telegram (token del bot y chat), que también recibe los reportes.
El bot con IA
El bot entiende lenguaje natural y decide si anota o responde. Ya viene con IA lista; tú solo conectas tu Telegram (sección 03).
- Anota: altas, pesos, ventas, compras, vacunas, gastos y traslados — escribiendo como se habla.
- Responde: cuántos animales hay, cuáles vender, gastos del mes, pendientes.
- Botones: Mi ganado · Pendientes · Para vender · Reporte · Cómo registrar · Ayuda.
- Fotos (detecta solo): foto de un ticket → crea el gasto; foto de un arete → te dice de qué animal es o lo da de alta. Ficha por arete: manda el arete y sale su historial.
Arete oficial SINIIGA Cada animal admite arete interno + SINIIGA (SINIIGA/UPP) vinculados: se registra y busca por cualquiera, útil para trazabilidad y movilización. Se vincula por chat ("a la BOR-05 ponle siniiga 07 0000 0001 23") o en el formulario del animal.
Acciones irreversibles Vender y registrar una muerte piden confirmar con SÍ. El bot exige los mismos permisos que la web.
Reportes y alertas automáticas
- Reporte de la mañana (7:00 AM): estado del hato, listos para vender, clima, pendientes, finanzas del mes y alertas.
- Resumen del día (8:00 PM): lo registrado en el día.
- Alertas proactivas dentro del reporte: retiro que se libera, partos de la semana, potreros por rotar y hembras vacías.
A demanda Desde Ajustes puedes enviar el reporte al instante con un botón, o pedirle al bot “¿qué debo atender?”.
Precios y especies
De aquí sale el valor del hato y el aviso de listos para vender. Mantenlo al día.
- Precios de mercado por especie (por kilo o por pieza). Ajústalos y el valor se recalcula solo.
- Parámetros por especie: peso de mercado, gestación, etc. Ya vienen por defecto; ajústalos a tu manejo.
- Soporta ovinos, caprinos, bovinos, porcinos y aves — incluido gallo de pelea con valor por ejemplar.
Control del dinero
- Gastos por categoría (alimento, medicina, agua, mano de obra, infraestructura, otros) — y por foto del ticket. Anota los kilos de alimento para medir la conversión (FCR).
- Rentabilidad por lote (en Análisis): ingresos − gasto directo + valor del ganado vivo, con ROI.
- Neto del mes en el panel, y reporte PDF descargable.
Tip de precisión Asigna cada gasto a un lote cuando se pueda: así la rentabilidad por lote sale exacta. Los gastos sin lote se marcan aparte.
Indicadores para inversionistas (¿es negocio?)
Como administrador ves la tarjeta de Inversión en Análisis: ROI sobre capital, utilidad bruta realizada, conversión alimenticia (FCR) y meses de reserva. Para que salgan bien:
- Registra el costo y fecha de compra de los animales (al darlos de alta o en el alta por lote).
- Captura los kilos en los gastos de alimento.
- Lleva los aportes y retiros de capital en Análisis → Inversión (solo el admin los ve y edita).
Suscripción y prueba gratis
Cada rancho arranca con 14 días de prueba con todo abierto, sin tarjeta. Al terminar, el rancho pasa a modo solo lectura para registrar: todos siguen entrando y consultando, pero crear animales, gastos y eventos queda pausado hasta activar el plan.
- El estado del plan (días de prueba, activo, vencido) se ve en Ajustes → Suscripción, y un aviso aparece arriba cuando se acerca el fin de la prueba.
- Activas el plan desde ahí; el pago es mensual por rancho (Stripe).
- El bot de Telegram no se bloquea por la suscripción: el equipo puede seguir consultando por chat.
🔧 Configuración de la plataforma (superadmin)
Las llaves de cobro (Stripe) y de SMS de registro (Twilio) las pone el superadministrador en Plataforma — no cada rancho. Ahí se pegan las credenciales (se guardan cifradas) y se define el precio y el modo. Ver la Referencia rápida.
Seguridad y auditoría
- Acceso por cuenta: cada quien con su usuario y contraseña; permisos por rol.
- Auditoría (en Equipo): quién hizo qué y cuándo.
- Conexión cifrada (HTTPS) en tu propio dominio.
Buenas contraseñas Usa contraseñas fuertes y no las compartas. Si sospechas que alguien la vio, cámbiala de inmediato.
Respaldos y datos
- Respaldo diario automático de toda la información del rancho.
- Las fotos (logo, tickets) se guardan con los datos y entran en el respaldo.
- Funciona sin señal: lo capturado en campo se sincroniza al reconectar.
Poner al equipo a bordo
Una guía corta para que la adopción sea rápida:
- Empieza tú: carga unos animales y prueba el bot un día.
- Vincula a un vaquero con el código de Telegram y pídele que registre pesos y ventas por chat.
- Revisa el reporte de la mañana en equipo: qué vender, qué atender.
- Sube al veterinario para la bitácora de sanidad.
- Mantén precios y gastos al día para que la rentabilidad sea real.
¿Buscas el manual de uso diario? Comparte con tu gente el Manual de usuario (registro por app y por Telegram).
Solución de problemas
| Si pasa esto… | Haz esto |
|---|---|
| Un miembro no recibe los reportes/avisos | Verifica que tenga su Telegram vinculado (sección 03) y que el reporte diario esté activado en Ajustes. |
| El bot no responde a un vaquero | Debe estar dado de alta en Equipo (por ID o código) y su rol debe permitir registrar eventos. |
| El código de vinculación no funciona | Dura 30 minutos; genera uno nuevo desde Equipo. |
| No llegan los reportes al Telegram del rancho | Revisa el token del bot y el chat configurados en Ajustes (Telegram). |
| El valor del hato o "listos para vender" se ven raros | Actualiza los precios de mercado por especie en Ajustes. |
| Un usuario no ve una sección | Ajusta su rol/permisos en Equipo. |
| Quiero quitar a alguien del equipo | En Equipo elimínalo; deja de tener acceso al instante (queda en la auditoría). |
Referencia rápida
Roles y permisos
| Permiso | Admin | Trabajador | Veterinario |
|---|---|---|---|
| Registrar animales (altas) | ✓ | ✓ | — |
| Vender / registrar muerte | ✓ | — | — |
| Registrar eventos y pesos | ✓ | ✓ | ✓ |
| Sanidad / bitácora | ✓ | — | ✓ |
| Mover lotes entre potreros | ✓ | — | — |
| Ver finanzas | ✓ | — | — |
| Registrar gastos | ✓ | ✓ | — |
| Gestionar equipo | ✓ | — | — |
| Gestionar ajustes | ✓ | — | — |
¿Dónde configuro qué?
| Quiero… | Voy a… |
|---|---|
| Datos del rancho, logo e idioma | Ajustes |
| Precios y parámetros por especie | Ajustes |
| Telegram: token, chat y reportes | Ajustes |
| Invitar gente, roles y códigos de vinculación | Equipo |
| Ver quién hizo qué (auditoría) | Equipo |
| Rentabilidad por lote y gráficas | Análisis |
| Aportes/retiros de capital y ROI | Análisis → Inversión |
| Ver mi plan y activar la suscripción | Ajustes → Suscripción |
| Llaves de cobro (Stripe) — superadmin | Plataforma |
| SMS de registro (Twilio) — superadmin | Plataforma |
Cómo entran los nuevos miembros
Quien se registra crea su cuenta con celular + contraseña y confirma un código por SMS (así validamos el número). Tú, como admin, los invitas y les asignas rol desde Equipo; también puedes darles un código de vinculación para el bot de Telegram (ver Conectar Telegram).
Plataforma (solo superadministrador)
El superadmin de RanchoOS configura, una sola vez y para toda la plataforma, en Plataforma:
- 📩 SMS (Twilio): credenciales para enviar los códigos de registro. Se recomienda Twilio Verify (Twilio genera y valida el código). El auth token se guarda cifrado y nunca se muestra de vuelta.
- 💳 Cobro (Stripe): llave secreta, secreto del webhook y precios (MXN/USD) del plan mensual. También se guardan cifrados.
- 🤖 IA del bot: llave del modelo que da inteligencia al bot de Telegram.
Cuida las llaves Estas credenciales dan acceso a cobros y envío de SMS. No las compartas por chat ni por foto. Si una se te escapó, rótala en el proveedor (Stripe/Twilio) y vuelve a pegarla en Plataforma.