Adminio 🏦

Landing page corporativa para Adminio Perú, enfocada en administración inmobiliaria, captura de leads, envio de mensajes por correo y acceso a modulos internos de asistencia.

Descripcion

Adminio es una landing corporativa con funcionalidades de contacto y un modulo interno de asistencias. El proyecto combina frontend estatico, endpoints PHP para envio de correos y consultas de base de datos para las secciones privadas.

Requisitos

• PHP 8.x o superior
• Composer
• Servidor web compatible con PHP, por ejemplo Nginx, Caddy, PHP built-in server u otro elegido por el usuario
• Acceso SMTP valido para envio de correos
• Base de datos configurada si se usara el modulo de asistencias

Instalacion local

1. Clonar el repositorio

git clone https://github.com/phpeitor/adminio.git
cd adminio

2. Instalar dependencias PHP

composer install

3. Crear el archivo .env en la raiz del proyecto con las credenciales SMTP

Ejemplo:

MAIL_HOST=smtp.tudominio.com
MAIL_PORT=587
MAIL_USERNAME=usuario@tudominio.com
MAIL_PASSWORD=tu_password
MAIL_SECURE=tls
MAIL_FROM_EMAIL=usuario@tudominio.com
MAIL_FROM_NAME=Adminio Web
MAIL_TO=ventas@tudominio.com

4. Configurar la conexion a base de datos si usaras asistencias

• Revisar db/connection.php.
• Validar host, puerto, usuario, contrasena y nombre de base de datos segun el entorno.
• Confirmar que el usuario de base de datos tenga permisos de lectura sobre las tablas requeridas.

5. Publicar o servir el proyecto

• Colocar el proyecto en el directorio publico configurado por el servidor web elegido.
• Configurar el document root o raiz publica apuntando a la carpeta del proyecto.
• Asegurar que el servidor procese archivos .php y permita servir archivos estaticos de css/, js/ y static/.
• Abrir la URL local o de despliegue definida para el proyecto.

Para pruebas rapidas en local tambien se puede usar el servidor integrado de PHP desde la raiz del proyecto:

php -S 127.0.0.1:8000

Luego abrir http://127.0.0.1:8000/ en el navegador.

Flujo de contacto

• El formulario valida campos en frontend.
• Al enviar, la web llama a config/envio_correo.php.
• PHPMailer toma credenciales desde .env usando config/env.php.
• Si el correo se envia correctamente, se muestra confirmacion y se recarga la pagina.
• Si falla el envio, revisar respuesta del endpoint, credenciales SMTP, puerto, cifrado y reglas del proveedor de correo.

Flujo de asistencias

• asistencias.html muestra la interfaz del modulo de asistencias.
• js/asistencias.js controla login, filtros, consulta de registros y cierre de sesion.
• Los endpoints en controller/ validan el acceso, consultan estado de sesion, devuelven asistencias y cierran la sesion.
• model/AsistenciaAdministradoresModel.php contiene la logica de consulta de datos.
• db/connection.php centraliza la conexion a la base de datos.

Variables de entorno

El archivo .env debe crearse localmente y no debe versionarse. Variables esperadas para el envio de correos:

Variable	Descripcion
MAIL_HOST	Servidor SMTP
MAIL_PORT	Puerto SMTP, por ejemplo 587 o 465
MAIL_USERNAME	Usuario de autenticacion SMTP
MAIL_PASSWORD	Contrasena o token de aplicacion SMTP
MAIL_SECURE	Cifrado SMTP, por ejemplo tls o ssl
MAIL_FROM_EMAIL	Correo remitente
MAIL_FROM_NAME	Nombre visible del remitente
MAIL_TO	Correo destino para los leads

Estructura del proyecto

adminio/
├── index.html                         # Landing principal
├── asistencias.html                   # Modulo web de asistencias
├── composer.json                      # Dependencias PHP
├── composer.lock                      # Versiones bloqueadas de dependencias
├── README.md                          # Documentacion del proyecto
├── .env                               # Variables locales, no versionar
├── config/
│   ├── env.php                        # Helper para leer variables de entorno
│   └── envio_correo.php               # Endpoint de envio SMTP con PHPMailer
├── controller/
│   ├── asistencia_administradores.php # Consulta de asistencias
│   ├── cerrar_sesion_asistencias.php  # Cierre de sesion del modulo asistencias
│   ├── estado_acceso_asistencias.php  # Estado de acceso/sesion
│   ├── validar_acceso_asistencias.php # Validacion de acceso
│   └── index.php                      # Proteccion de listado/directorio
├── db/
│   ├── connection.php                 # Conexion a base de datos
│   └── index.php                      # Proteccion de listado/directorio
├── model/
│   ├── AsistenciaAdministradoresModel.php # Modelo de asistencias
│   └── index.php                          # Proteccion de listado/directorio
├── css/
│   ├── app.css                        # Estilos base/compilados
│   ├── asistencias.css                # Estilos del modulo asistencias
│   ├── index.css                      # Estilos principales editables
│   └── *.css                          # Assets CSS compilados/versionados
├── js/
│   ├── adminio.js                     # Navegacion, validaciones y formulario
│   ├── asistencias.js                 # Interaccion del modulo asistencias
│   └── *.js                           # Librerias y bundles compilados
├── static/
│   ├── main.png                       # Imagen principal del hero
│   ├── logo.png                       # Logo del sitio
│   ├── google_play.png                # Badge de Google Play
│   ├── data/distritos.json            # Catalogo de distritos para formulario
│   └── *                              # Imagenes, SVGs y recursos visuales
├── docs/
│   ├── backend-rules.md               # Reglas y lineamientos backend
│   └── frontend-rules.md              # Reglas y lineamientos frontend
└── vendor/                            # Dependencias instaladas por Composer

Archivos principales

• index.html: landing principal con hero, secciones comerciales, video embebido, contacto y recursos visuales.
• css/index.css: estilos editables de la landing, animaciones del hero, responsive y estados de UI.
• js/adminio.js: navegacion, validacion del formulario, carga de distritos y envio de contacto.
• asistencias.html: pantalla del modulo interno de asistencias.
• css/asistencias.css: estilos especificos del modulo de asistencias.
• js/asistencias.js: logica frontend de acceso, filtros, listado y cierre de sesion.
• config/envio_correo.php: envio SMTP usando PHPMailer.
• config/env.php: lectura de variables desde .env.
• db/connection.php: conexion a base de datos para backend.
• model/AsistenciaAdministradoresModel.php: acceso a datos del modulo de asistencias.

Despliegue

• Instalar dependencias con composer install --no-dev --optimize-autoloader si el entorno es productivo.
• Configurar el servidor web elegido para servir la carpeta del proyecto y ejecutar PHP.
• Crear .env en el servidor con credenciales reales de SMTP.
• Configurar db/connection.php con credenciales seguras si se habilita asistencias.
• Verificar permisos de lectura sobre archivos estaticos y permisos de ejecucion para scripts PHP.
• Probar el formulario de contacto y el acceso al modulo de asistencias despues de publicar.

Seguridad

• No subir .env, credenciales SMTP, credenciales de base de datos ni respaldos con informacion sensible.
• Usar HTTPS en entornos publicos.
• Mantener Composer y dependencias actualizadas.
• Restringir acceso a modulos internos segun las reglas del servidor y la logica de autenticacion del proyecto.
• Revisar logs del servidor y del proveedor SMTP ante errores de envio.

Notas

• Si abres solo index.html sin servidor web, el formulario no podra enviar correos porque requiere ejecutar PHP.
• Verifica firewall, puerto SMTP y credenciales si aparece error de envio.
• No versionar .env, credenciales SMTP ni credenciales de base de datos.
• vendor/ se genera con composer install; no editar dependencias directamente.

Licencia

Proyecto de uso privado/comercial segun politicas del propietario del repositorio.