Inicialización técnica del proyecto
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 y utilizarlo como punto de partida del código:
- Para Aplicaciones Normales: https://github.com/Desarrollo-Soluciones-Informaticas/AIIDTProyectoBase
- Para APIs: https://github.com/Desarrollo-Soluciones-Informaticas/AIIDTProyectoBase-API
Nota: El template base debe contener al menos:
- Estructura inicial del proyecto
- Archivos
.env.example docker-compose.ymlbásico- Dependencias mínimas
Configuración inicial del entorno local
Al crear el proyecto se debe:
- Generar o copiar archivo
.enva partir de.env.example - Instalar dependencias (
composer install,npm installo 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.