# 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](https://docs.google.com/spreadsheets/d/1i-ZMWTEUYulwdugDoEFvzcEIMzGs5dy4pI_3Sxf7vPY/edit?pli=1&gid=621112453#gid=621112453)

---

### Creación del repositorio

El repositorio debe crearse en [GitHub del Departamento](https://github.com/Desarrollo-Soluciones-Informaticas) 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](https://github.com/Desarrollo-Soluciones-Informaticas/AIIDTProyectoBase)
- [Para APIs: https://github.com/Desarrollo-Soluciones-Informaticas/AIIDTProyectoBase-API](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.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.**