Manual del proveedor (Administrador) · Servicio de Agua Potable Rural

Manual de administración avanzada

🛠️ Guía para la empresa proveedora (Asesora): gestión de usuarios, contraseñas, opciones reservadas y seguridad del panel.

Reábrelo desde el menú del panel: Manual de Usuario. El cliente ve una versión reducida (solo contenido).

Dos roles. El cliente (APR / webcliente) administra solo el contenido. El proveedor (Administrador) —tú— tiene además acceso a gestión de usuarios y al grupo Modo Avanzado. Esas opciones no se muestran al cliente y, aunque se escriba la URL directa, el servidor las bloquea.

1 Roles y alcance

RolVe en el menúPuede hacer
Cliente (webcliente)Configuración Sitio, Página Principal, Páginas Interiores, Manual, Cambiar mi contraseña, SalirAdministrar contenido del sitio.
Administrador (proveedor)Todo lo anterior + grupo Modo Avanzado (Usuarios, Activar Modo Avanzado, Ordenar Páginas, Buscar en Pexels, Personalización)Todo el contenido + usuarios, estructura, personalización y configuración técnica.

2 Ingreso y contraseñas

  1. Entra a www.SITIO-WEB.cl/base/admin/ con tu usuario (RUT o nombre de ingreso) y tu contraseña.
  2. Presiona Ingresar.

Tu propia clave. Cámbiala desde Cambiar mi contraseña (menú Accesos Generales). Necesita la clave actual + la nueva (mínimo 6 caracteres).

Carga tu correo. En Usuarios → Editar correo, ponle un correo a tu propia cuenta de administrador: ahí recibirás las evidencias cuando crees o resetees usuarios.

3 Gestión de usuarios

Menú → Modo Avanzado → Usuarios. Desde ahí administras las cuentas del panel.

➕ Crear un usuario

  1. Completa Nombre, Usuario/RUT, Correo y Rol.
  2. Presiona Crear usuario.
  3. Se genera una clave aleatoria y se envía al correo del usuario.
  4. El usuario deberá cambiarla al ingresar.

🔑 Resetear la clave

  1. En la fila del usuario, Resetear clave.
  2. Se genera una nueva clave aleatoria y se envía a su correo.
  3. Tú no conoces esa clave (más seguro).
  4. Si el usuario no tiene correo, primero usa Editar correo.

✉️ Editar correo

  1. Editar correo en la fila del usuario.
  2. Escribe el correo y guarda.
  3. Necesario para poder resetear por correo.

🗑️ Eliminar un usuario

  1. Eliminar en la fila, y confirma.
  2. El usuario admin no se puede eliminar.
  3. No puedes eliminar tu propia cuenta.

Evidencia. Cada creación o reset envía además un correo de registro a tu casilla de administrador: qué acción, sobre qué usuario, a qué correo se envió la clave, quién y cuándo.

¿Se envió el correo? En Modo Avanzado → Log de correos ves el registro de cada envío (OK = aceptado / FALLO = rechazado) y un botón Enviar correo de prueba para verificar la entrega. Si aparece OK pero no llega, revisa spam y que el remitente (noreply@dominio) coincida con el dominio del sitio.

4 Clave provisoria y bloqueo del sistema

Cuando creas o reseteas un usuario, su clave queda como provisoria (temporal, enviada por correo). Mientras no la cambie:

  1. El sistema lo redirige a Cambiar mi contraseña en cada pantalla.
  2. Ningún cambio de contenido se guarda: los endpoints responden bloqueados.
  3. El bloqueo se levanta apenas define su nueva contraseña.

Instalación nueva. Existe un usuario inicial admin con clave provisoria 111111 para el primer ingreso. Cámbiala apenas entres. El sistema también fuerza ese cambio.

Requisito técnico. El bloqueo autoritativo (incluso a sesiones activas) usa la columna usuarios.debe_cambiar. Si no se ejecutó su migración, el bloqueo aplica igual pero solo al iniciar sesión.

5 Modo Avanzado

OpciónPara qué sirve
UsuariosCrear / resetear / eliminar cuentas (sección 3).
Activar Modo AvanzadoHabilita funciones extra de maquetación por página (layout).
Ordenar Páginas / SeccionesDefine el orden de las secciones de la portada. Incluye Restaurar orden original para volver al orden por defecto sin cambiar cuáles están activas.
Buscar en PexelsBuscar imágenes de banco para el sitio.
PersonalizaciónColores, color de fuente y tipografía del sitio, con vista previa en vivo antes de guardar.
Log de correosRegistro de los correos enviados (crear / resetear clave) y prueba de envío.

Ordenar Secciones. Reordena de dos formas: arrastrando los módulos, o con los botones ↑ / ↓ de cada fila (más cómodo en celular o tablet). Luego presiona Guardar Orden. Los interruptores activan/desactivan cada sección; Restaurar orden original reordena a la secuencia por defecto sin tocarlos.

Ordenar Secciones ↔ Página Principal. Las secciones que desactives aquí (interruptor en OFF) no aparecerán como bloques editables en Página Principal. Para volver a editarlas, reactívalas.

6 Página Principal: opciones reservadas

En Página Principal, además de los bloques de contenido del cliente, el proveedor administra:

Menu Superior Card Centrales Oficina Virtual Portal Pagos Conoce Tu Boleta

Corresponden a estructura de menús, medios de pago y configuración técnica. Algunos campos sensibles (tokens de pago) están vedados incluso por API para el cliente.

Bloques visibles. Los bloques de contenido desactivados en Ordenar Secciones Principales no se muestran aquí. Los estructurales (Menú Superior, Logo, Imagen Principal, Mensaje de Cortes, Footer) siempre aparecen.

Pago Online. En Portal Pagos, el switch Habilitar / Deshabilitar muestra u oculta el botón de pago en el sitio público (además del token, que es necesario para que el pago funcione).

Conoce Tu Boleta. El botón Personalizar Boleta define los colores de esa tarjeta: degradado (color inicial, color final y ángulo con deslizador), color del texto y colores del botón. Incluye vista previa en vivo que se actualiza mientras eliges, antes de guardar.

Fondo de Idea Fuerza Principal. Dentro de Idea Fuerza Principal, el botón Fondo permite elegir Color o Imagen (1920 × 400 px, con recorte asistido).

7 Administración de contenido

El proveedor también puede realizar todas las tareas del cliente: Configuración del Sitio, Página Principal, Noticias, Galerías, Videos, Preguntas Frecuentes, Biblioteca y Logo. El detalle paso a paso está en el manual del cliente.

Imágenes. Si una imagen no tiene la medida exacta, se abre la ventana de recorte; ajusta y presiona Recortar y usar. Solo se aceptan JPG/PNG reales (y PDF en Biblioteca). Si el archivo elegido no es una imagen (o está dañado), se avisa nombrando el archivo y se descarta la selección, sin abrir el recorte. La validación final la hace igualmente el servidor con finfo.

8 Seguridad y buenas prácticas

  1. Entrega una cuenta por persona; evita compartir el usuario admin.
  2. Al retirar a alguien, elimina o resetea su cuenta.
  3. Nunca uses 111111 como clave definitiva (el sistema la rechaza).
  4. Mantén cargado tu correo de administrador para recibir las evidencias.
  5. Cierra sesión (Salir) en equipos compartidos.

Datos sensibles. No compartas la contraseña de la base de datos ni los tokens de pago. Su rotación y resguardo son responsabilidad del proveedor.

9 Notas técnicas / despliegue

TemaDetalle
PlataformaPHP 8 · MySQL 5.7 · InnoDB + utf8mb4_spanish_ci.
Correo del sistemaRemitente noreply@{dominio} (config $correo_sistema). La casilla debe existir y el dominio coincidir con el del sitio (SPF/DKIM).
Migracionesdebe_cambiar (bloqueo por clave provisoria), correo (reset por correo), fase8 (link del módulo de noticias), fase9 (rutas de imágenes de noticias) y fase10 (fondo de Idea Fuerza Principal). Todas idempotentes.
Estilos de "Conoce tu Boleta"Se guardan en config/json/boleta_css.json (no en la BD). El archivo viene con valores por defecto; se regenera al guardar en Personalizar Boleta.
No mostrar errores.user.ini con display_errors=Off en producción.

Sitios ya instalados. Las migraciones fase 8, 9 y 10 corrigen datos de instalaciones anteriores (noticias que no mostraban imagen, portada con el diseño antiguo de noticias, y fondo de Idea Fuerza Principal). En instalaciones nuevas no hacen falta: el instalador y los datos iniciales ya quedan correctos.

Documentación completa. El detalle de despliegue, migraciones y arquitectura está en GUIA_DESPLIEGUE.md y DOCUMENTO_TECNICO.md del repositorio.