Arquitectura

El proyecto sigue una separacion estricta entre frontend y backend, comunicandose unicamente via HTTP sobre endpoints REST documentados.

cliente (navegador)
       |
       | HTTP (fetch)
       v
  [frontend — Astro SSG]        →   archivos estaticos en CDN / Hostinger
       |
       | /api/*
       v
  [backend — Express API]       →   Node.js en servidor de Hostinger
       |
       | fs / SMTP
       v
  [datos locales / email]

Estructura de carpetas

backend-cybersecurity-portfolio/
├── frontend/                   # Aplicacion Astro
│   ├── src/
│   │   ├── components/         # Hero, Skills, Projects, Contact, StarWidget...
│   │   ├── layouts/
│   │   └── pages/
│   └── astro.config.mjs
│
├── backend/                    # API Express
│   ├── src/
│   │   ├── controllers/
│   │   ├── routes/
│   │   ├── services/           # contact, visits, stars
│   │   ├── middleware/         # error, rate-limit, sanitize
│   │   └── server.js
│   └── .env.example
│
├── public/                     # Archivos estaticos compartidos
│   ├── certificates/           # PDFs de certificados
│   └── images/                 # Fotos del desarrollador
│
└── pnpm-workspace.yaml

Caracteristicas principales

• Sistema de contacto real: formulario con validacion en servidor, envio via SMTP Hostinger, reenvio a correo personal.
• Valoraciones por IP unica: los visitantes pueden dar una estrella al portfolio. El backend rechaza votos duplicados por IP.
• Contador de visitas unicas: persistencia en archivo JSON, deduplicacion por IP.
• Certificados dinamicos: los PDFs en /public/certificates se cargan y renderizan automaticamente sin configuracion adicional.
• Seguridad aplicada: headers HTTP con Helmet, CORS configurado por entorno, rate limiting por ruta, validacion y sanitizacion de inputs.
• Proyectos reales de GitHub: la seccion de proyectos carga informacion curada directamente desde los repositorios publicos del desarrollador.

Instalacion y uso

Requisitos previos

• Node.js >= 22.12
• pnpm >= 10

Clonar e instalar

git clone https://github.com/Luis000923/backend-cybersecurity-portfolio.git
cd backend-cybersecurity-portfolio
pnpm install

Variables de entorno

Copia el archivo de ejemplo y completa con tus credenciales:

cp backend/.env.example backend/.env

Variables requeridas:

NODE_ENV=development

MAIL_HOST=smtp.tuproveedor.com
MAIL_PORT=465
MAIL_SECURE=true
MAIL_USER=tu@dominio.com
MAIL_PASS="tu-contrasena"
MAIL_FROM=tu@dominio.com
MAIL_TO=tu-correo-destino@gmail.com

CORS_ORIGIN=http://localhost:4321

Nota: si la contrasena contiene caracteres especiales como #, encierra el valor entre comillas dobles en el .env.

Ejecutar en desarrollo

pnpm run dev

Esto levanta en paralelo:

• Frontend en http://localhost:4321
• Backend en http://localhost:3000

Seguridad

Despliegue

El proyecto esta desplegado en Hostinger con la siguiente separacion:

Para construir el frontend:

pnpm --filter frontend run build

El directorio frontend/dist/ contiene los archivos listos para subir al servidor web.

Certificados

Los certificados se sirven como archivos estaticos desde /public/certificates/. Para agregar un nuevo certificado, basta con colocar el archivo PDF en esa carpeta. El componente CertificateCard.astro lo detecta y renderiza automaticamente en la pagina /certificates.

No requiere autenticacion ni base de datos.

Contacto

• Sitio: portafolio.pdsx.org
• GitHub: github.com/Luis000923
• LinkedIn: Luis Ernesto Galdámez Vides
• WhatsApp: (+503) 7041 4649

Licencia

MIT — uso libre con atribucion.