Skip to main content

Inicialización técnica del proyecto

Objetivo de la fase

Dejar el proyecto listo para iniciar desarrollo técnico, con su registro, repositorio, entorno local y documentación mínima.

Registro del proyecto en hoja de control

Antes de crear el repositorio se debe registrar el proyecto en la hoja de control del año en curso.

Responsable: Líder de Proyecto  
Estado esperado: Desarrollo

Campos mínimos a completar:

  • ID del proyecto
  • Nombre funcional
  • Nombre corto
  • Tipo (Aplicación o Srv)
  • Año
  • Consecutivo
  • Responsable técnico
  • Fecha de registro
  • Estado inicial

La url de la hoja de Google para el registro es: SEGUIMIENTO DE PROYECTOS

Creación del repositorio

El repositorio debe crearse en GitHub del Departamento utilizando como nombre del repositorio el ID del proyecto asignado en el registro administrativo.

Ejemplo: 2026-0002-Srv-PagosCentral

Se deberá establecer en modo Privado el repositorio y contener una Descripción.

Selección y descarga de template base

Dependiendo del tipo de proyecto se debe seleccionar el template base correspondiente (Aplicación o API/Servicio) y utilizarlo como punto de partida del código.digo:

Nota: El template base debe contener al menos:

  • Estructura inicial del proyecto
  • Archivos .env.example
  • docker-compose.yml básico
  • Dependencias mínimas

Configuración inicial del entorno local

Al crear el proyecto se debe:

  • Generar o copiar archivo .env a partir de .env.example
  • Instalar dependencias (composer install, npm install o equivalente)
  • Confirmar que el proyecto levanta en modo local sin errores

Convenciones técnicas para nombres

El nombre del contenedor Docker debe ser igual al ID del proyecto.

Ejemplo:

container_name: 2026-0002-Srv-PagosCentral


Esto asegura trazabilidad entre registro, repositorio y runtime.

Documentación inicial en el repositorio

Cada proyecto debe contar con un README.md inicial que incluya:

  • Nombre del proyecto
  • Descripción funcional corta
  • Tipo (Aplicación o Srv)
  • Stack tecnológico
  • Cómo levantar el entorno local
  • Cómo configurar variables de entorno
  • Dependencias externas si aplica

Este README puede ser ampliado conforme avance el proyecto.

Resultado de la fase

La fase de inicialización técnica se considera completa cuando el proyecto cumple:

  • Proyecto registrado
  • Repositorio creado
  • Template aplicado
  • Local levantando en contenedores
  • README inicial existente

El proyecto está entonces listo para desarrollo.

Back to top