# 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
```gherkin
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
```gherkin
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
```gherkin
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
```gherkin
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](../00-vision-general/ARQUITECTURA-TECNICA.md)
- [CONTEXT-MAP.yml](../../orchestration/CONTEXT-MAP.yml)
- [SIMCO v4.0.0](../../orchestration/00-guidelines/HERENCIA-SIMCO.md)

---

**Ultima Actualizacion:** 2026-01-10