rckrdmrd
1a53b5c4d3
- Backend NestJS con módulos de autenticación, inventario, créditos - Frontend React con dashboard y componentes UI - Base de datos PostgreSQL con migraciones - Tests E2E configurados - Configuración de Docker y deployment Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
163 lines
4.0 KiB
Markdown
163 lines
4.0 KiB
Markdown
# MII-001: Infraestructura Base
|
|
|
|
---
|
|
id: MII-001
|
|
type: Epic
|
|
status: Pendiente
|
|
priority: P0
|
|
phase: 1
|
|
story_points: 8
|
|
created_date: 2026-01-10
|
|
updated_date: 2026-01-10
|
|
simco_version: "4.0.0"
|
|
---
|
|
|
|
## Metadata
|
|
|
|
| Campo | Valor |
|
|
|-------|-------|
|
|
| **ID** | MII-001 |
|
|
| **Nombre** | Infraestructura Base |
|
|
| **Fase** | 1 - MVP Core |
|
|
| **Prioridad** | P0 |
|
|
| **Story Points** | 8 |
|
|
| **Estado** | Pendiente |
|
|
|
|
---
|
|
|
|
## 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 | Pendiente |
|
|
| T-002 | Crear docker-compose.yml con servicios | 2 SP | Pendiente |
|
|
| T-003 | Configurar .env.example completo | 1 SP | Pendiente |
|
|
| T-004 | Crear estructura de carpetas backend | 1 SP | Pendiente |
|
|
| T-005 | Crear estructura de carpetas mobile | 1 SP | Pendiente |
|
|
| T-006 | Configurar ESLint y Prettier | 1 SP | Pendiente |
|
|
| T-007 | Crear scripts de desarrollo | 1 SP | Pendiente |
|
|
|
|
---
|
|
|
|
## 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
|