Documentación FdezNet

Paso a paso

Guías de uso, en el orden de tu operación

Síguelas en orden la primera vez: cada guía deja listo lo que necesita la siguiente. Después sirven como consulta para tu equipo.

Comenzar

¿Qué administra FdezNet?

FdezNet centraliza clientes, contratos, facturación, pagos, red, fibra, inventario, órdenes y atención por WhatsApp. Cada instalación tiene su propia base de datos y configuración.

Infraestructura

Dos modalidades, la misma plataforma

Licencia propia

El ISP proporciona una VPS compatible y administra su proveedor, dominio y capacidad. FdezNet instala el sistema, entrega actualizaciones autorizadas y brinda soporte según el plan.

Servicio administrado

FdezNet prepara y mantiene una VPS privada, monitoreo, HTTPS, actualizaciones y respaldo externo. El ISP conserva sus accesos operativos y puede usar subdominio o dominio propio.

Instalación

Flujo de puesta en marcha

1. Preparación: VPS Ubuntu compatible, IP pública limpia y acceso administrativo temporal.
2. Registro: se crea la instalación y se emite un token de un solo uso desde el panel central.
3. Instalación: el instalador verifica recursos, prepara base de datos, API, frontend, Nginx, firewall, copias y agente de actualización.
4. Validación: comprueba migraciones, API, página principal, servicios, tareas programadas y comunicación de licencia.
5. Entrega: se cambia la contraseña inicial, se retira el acceso temporal y se completa la configuración del ISP.

Requisitos recomendados

• Ubuntu 24.04 LTS actualizado.
• 2 vCPU, 4 GB RAM y 40 GB SSD como base; ajustar al volumen y OCR.
• Puertos 80/443 y UDP de WireGuard permitidos.
• DNS apuntando a la VPS cuando se utilizará un dominio.
• Acceso saliente HTTPS hacia control de licencia y proveedores configurados.

Primer día

Configuración inicial

1. Cambia la contraseña de admin y crea cuentas personales por rol.
2. En Empresa y marca carga nombre comercial, logotipo, colores, moneda, zona horaria y datos fiscales.
3. Crea planes de Internet, perfiles y reglas de facturación.
4. Registra routers y OLT con credenciales dedicadas de privilegio mínimo.
5. Configura cuentas receptoras, datos de pago, horarios y mensajes.
6. Conecta WhatsApp y prueba el flujo con un cliente interno.
7. Importa clientes por lotes pequeños y revisa los resultados antes de continuar.

Los números de cuenta o tarjeta se administran desde Configuración; no están fijados en el código.

Ingresos

Facturación y validación de pagos

Las facturas se generan según el ciclo de cobro de cada cliente; el sistema corta a quien no pagó y reconecta en cuanto paga. Los comprobantes que llegan por WhatsApp se pueden confirmar de dos formas, a elección de cada ISP:

• Solo con la captura: el pago se aplica al momento con el folio, o con monto, fecha y hora. Cada transferencia genera un código único y una captura repetida rebota. El correo del banco queda como auditoría.
• Con el correo del banco: el pago se aplica cuando llega a Gmail el aviso del banco con el mismo folio o el mismo monto y hora.

Los casos dudosos (montos fuera de lo normal, pagos repetidos, titular que no coincide) no se aplican solos: quedan en la bandeja de comprobantes por revisar. Detalle en la guía 05 y la guía 06.

Atención

Agente de IA, bot de menú y asistente técnico

Cada ISP elige quién contesta a sus clientes: un agente de IA que consulta el sistema (saldo, conexión, promesas, comprobantes, solicitudes de instalación), el mismo agente con aprobación de un asesor, o un bot de menú que se arma en un editor visual. Todo se configura sin modificar código.

Asistente para técnicos

Desde su número autorizado, el técnico consulta por contrato la sesión PPPoE, la ONU y su potencia, el router, la caja NAP y el puerto. Nunca se envían contraseñas y cada consulta queda en la bitácora.

Detalle en la guía 06.

Conectividad

MikroTik, OLT y planta externa

Los routers pueden conectarse directamente por red privada o mediante WireGuard. Usa siempre un usuario API dedicado, limita su origen y evita reutilizar la contraseña administrativa.

Las funciones de OLT y ONU dependen del controlador y modelo soportado que se haya configurado. Primero valida consulta, potencia y búsqueda con una ONU de prueba; después habilita acciones de escritura.

• Asocia servicio, PPPoE y router al mismo cliente.
• Registra OLT, tarjeta, PON, ONU, caja NAP y puerto.
• Define umbrales de potencia óptica según tu red.
• Prueba suspensión y reconexión fuera de horario crítico.

Rutina

Operación diaria y cierre

Revisa al inicio del día alertas de red, pagos pendientes, comprobantes en revisión y trabajos abiertos. La bitácora identifica quién realizó cada cambio relevante.

El módulo de almacenamiento desglosa el espacio consumido por comprobantes, facturas, evidencias y respaldos. La política de retención puede limpiar rechazados y temporales automáticamente, mientras los documentos contables se conservan conforme a la política del negocio. El cierre manual permite archivar un periodo sin borrar su historial.

Ciclo de vida

Actualizaciones controladas

Cada VPS consulta la versión autorizada por el panel central. Antes de aplicar una versión, genera un respaldo y fija revisiones exactas de backend y frontend. Al terminar ejecuta migraciones y pruebas de disponibilidad; una versión no autorizada no se instala.

Programa actualizaciones en una ventana de mantenimiento y confirma que el respaldo externo más reciente esté disponible.

Recuperación

Respaldos y retención

Una estrategia completa conserva base de datos, archivos privados, configuración crítica y evidencia de la versión instalada. El servicio administrado añade una copia externa cifrada.

• Revisa diariamente el resultado de la tarea automática.
• Conserva varias generaciones con retención definida.
• No almacenes la única copia en la misma VPS.
• Ejecuta una prueba de restauración periódica y documenta el tiempo.

Protección

Lista esencial de seguridad

• HTTPS obligatorio cuando exista dominio.
• Contraseñas únicas, roles mínimos y sesiones protegidas.
• Credenciales de routers y OLT cifradas en reposo.
• Comprobantes y evidencias fuera de rutas públicas.
• Firewall activo; base de datos y API internas sin exposición directa.
• SSH con llave, root remoto restringido y accesos temporales revocados.
• Registro de auditoría para pagos, cambios de red y administración.
• Respaldo externo cifrado con prueba de recuperación.

Ayuda

Diagnóstico rápido

El panel no abre

Confirma DNS/IP, HTTPS, Nginx y el estado de la API. Un error 403 en una instalación nueva suele indicar permisos de lectura del directorio web; un 502 indica que el proxy no recibe respuesta de la API.

El bot no responde

Comprueba el estado de la sesión, el teléfono normalizado con código de país, el rol asignado, el nodo inicial del flujo y el horario configurado.

No encuentra el pago

Si confirmas con el correo del banco, valida la conexión al buzón, el remitente permitido, la cuenta receptora, la referencia y la tolerancia. Si el correo no llegó pero ves el depósito en la app del banco, apruébalo desde comprobantes por revisar dejando la nota de dónde lo verificaste.

La OLT aparece no disponible

Verifica que el asistente consulte el mismo controlador que Radar OLT, credenciales, modelo, puerto, ruta de red y asociación de la ONU.

Si el problema continúa, conserva la hora exacta y el identificador afectado y compártelo con soporte, sin incluir contraseñas ni tokens.