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.

---

## 2.1

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:** `Registrado`  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

    • ---

##

2.2

Creación del repositorio

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

Ejemplo: 2026-0002-Srv-PagosCentral

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.

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