Mike (@mikerb95) CodeByMike
Contáctame

Introducción

Esta sección reúne la documentación de ingeniería del proyecto dev-portfolio (codebymike.tech): requerimientos, casos de uso, diagramas UML y el tablero kanban del propio proyecto. Todo el contenido vive como datos tipados en src/data/documentacion.ts y src/data/iteraciones-portfolio.ts — un cambio de requerimiento es un commit revisable, no un documento que se desincroniza del código.

Ir a la presentación

Deck de sustentación con el resumen de esta documentación. Requiere iniciar sesión.

Propósito

El propósito de esta documentación es dejar trazabilidad formal del ciclo de vida del proyecto — desde el requerimiento hasta la historia de usuario y su estado en el kanban — usando un formato reconocido de ingeniería de software (requerimientos funcionales y no funcionales, casos de uso con flujo extendido, diagramas UML de secuencia, componentes, clases y objetos). Sirve como evidencia para sustentación académica y como referencia técnica real para el mantenimiento del sistema en producción.

Req. funcionales
47
41 implementados
Req. no funcionales
18
ISO/IEC 25010
Casos de uso
18
6 actores
Historias (kanban)
54
18 iteraciones

Mapa de la documentación

Requerimientos funcionales
47 requerimientos en 7 módulos (41 implementados).
Requerimientos no funcionales
18 requerimientos por categoría ISO/IEC 25010.
Casos de uso
6 actores, 18 casos de uso con diagrama.
Casos de uso extendidos
Flujo principal, alternos, excepciones y postcondiciones de los CU críticos.
Historias de usuario
54 historias en formato XP, agrupadas por actor, con su DoD.
Diagrama de secuencia
Login OAuth, chequeo de monitor, enforcement de seguridad y webhook de pagos.
Diagrama de componentes
Despliegue: navegador → Vercel (Astro SSR + middleware) → Turso/Blob/GitHub/ntfy/cron.
Diagrama de clases
Entidades del dominio derivadas de src/db/schema.ts, agrupadas por módulo.
Diagrama de objetos
Instantáneas concretas: proyecto con sus servicios, pago con evento duplicado, IP bloqueada.
Tablero kanban
54 historias en 18 iteraciones del propio proyecto.

Stack técnico

Framework
  • Astro 6 (SSR, adapter Vercel)
  • Tailwind CSS 4
Datos
  • Drizzle ORM
  • libSQL / Turso
Auth
  • Auth.js (auth-astro)
  • Proveedor GitHub OAuth
Almacenamiento
  • Vercel Blob (backups, screenshots)
Observabilidad
  • Cron externo (cron-job.org)
  • ntfy.sh (push)
  • Web Vitals (RUM)
Testing
  • Vitest + coverage v8

Alcance del proyecto

Dentro de alcance: sitio público de portafolio, CRM interno (proyectos/clientes/seguimiento/briefings), finanzas y P&L por proyecto, observabilidad (monitoreo, SLO, notificaciones), un LAB de ingeniería (CI/CD con rollback, pagos idempotentes, chaos engineering) y un micro-SIEM propio (sensor, blocklist, rate limiting durable, detección de anomalías).

Fuera de alcance (por ahora): multiusuario/roles (el panel es de un único administrador), pasarela de pagos en producción real (el LAB usa un proveedor mock además de Wompi), y SAST/mutation testing automatizados (planeados en el LAB, ver Fases 5–7 del plan).