miinventario-v2/docs/01-epicas/MII-001-infraestructura-base.md

MII-001: Infraestructura Base

---

id: MII-001 type: Epic status: Completado priority: P0 phase: 1 story_points: 8 created_date: 2026-01-10 updated_date: 2026-01-13 simco_version: "4.0.0"

Metadata

Campo	Valor
ID	MII-001
Nombre	Infraestructura Base
Fase	1 - MVP Core
Prioridad	P0
Story Points	8
Estado	Completado

---

1. Descripcion

Configurar la infraestructura base del proyecto incluyendo el monorepo, configuraciones de desarrollo, Docker, y estructura de carpetas siguiendo los estandares SIMCO v4.0.0.

Objetivo

Tener un ambiente de desarrollo funcional donde el equipo pueda comenzar a implementar las funcionalidades del sistema.

---

2. Requerimientos Relacionados

RF	Descripcion	Prioridad
-	Infraestructura (no RF directo)	P0

---

3. Criterios de Aceptacion

AC-001: Monorepo Configurado

DADO que el proyecto ha sido clonado
CUANDO ejecuto npm install
ENTONCES todas las dependencias se instalan correctamente
Y los workspaces estan configurados (apps/backend, apps/mobile)

AC-002: Docker Compose Funcional

DADO que tengo Docker instalado
CUANDO ejecuto docker-compose up -d
ENTONCES PostgreSQL inicia en puerto 5433
Y Redis inicia en puerto 6380
Y MinIO inicia en puertos 9002/9003

AC-003: Base de Datos Inicializada

DADO que los contenedores estan corriendo
CUANDO me conecto a PostgreSQL
ENTONCES la base de datos miinventario_db existe
Y puedo ejecutar queries basicas

AC-004: Variables de Entorno

DADO que copio .env.example a .env
CUANDO configuro las variables requeridas
ENTONCES la aplicacion puede leer todas las variables
Y no hay errores de configuracion faltante

---

4. Tareas Tecnicas

ID	Tarea	Estimacion	Estado
T-001	Configurar package.json con workspaces	1 SP	Completado
T-002	Crear docker-compose.yml con servicios	2 SP	Completado
T-003	Configurar .env.example completo	1 SP	Completado
T-004	Crear estructura de carpetas backend	1 SP	Completado
T-005	Crear estructura de carpetas mobile	1 SP	Completado
T-006	Configurar ESLint y Prettier	1 SP	Completado
T-007	Crear scripts de desarrollo	1 SP	Completado

---

5. Dependencias

Entrada (Requiere)

• Ninguna (epica inicial)

Salida (Bloquea)

• MII-002: Autenticacion
• MII-003: Gestion de Tiendas
• Todas las demas epicas

---

6. Riesgos

Riesgo	Probabilidad	Impacto	Mitigacion
Conflicto de puertos	Baja	Bajo	Usar puertos diferentes a otros proyectos
Incompatibilidad versiones	Media	Medio	Fijar versiones en package.json

---

7. Entregables

1. Monorepo funcional con npm workspaces
2. docker-compose.yml con todos los servicios
3. .env.example documentado
4. Estructura de carpetas backend (NestJS)
5. Estructura de carpetas mobile (Expo)
6. Configuracion de linting
7. Scripts de desarrollo (dev, build, test)

---

8. Notas de Implementacion

Puertos Asignados

Servicio	Puerto	Notas
PostgreSQL	5433	Evita conflicto con michangarrito (5432)
Redis	6380	Evita conflicto con michangarrito (6379)
MinIO API	9002	Evita conflicto con michangarrito (9000)
MinIO Console	9003	Evita conflicto con michangarrito (9001)
Backend	3142	Evita conflicto con michangarrito (3141)
Mobile Expo	8082	Evita conflicto con michangarrito (8081)

Stack Versions

Tecnologia	Version
Node.js	20.x LTS
PostgreSQL	15+
Redis	7.x
MinIO	Latest

---

9. Referencias

• ARQUITECTURA-TECNICA.md
• CONTEXT-MAP.yml
• SIMCO v4.0.0

---

Ultima Actualizacion: 2026-01-10