miinventario-v2/docs/01-epicas/MII-001-infraestructura-base.md
rckrdmrd c24f889f70
Some checks failed
Build / Build Backend (push) Has been cancelled
Build / Build Mobile (TypeScript Check) (push) Has been cancelled
Lint / Lint Backend (push) Has been cancelled
Lint / Lint Mobile (push) Has been cancelled
Test / Backend E2E Tests (push) Has been cancelled
Test / Mobile Unit Tests (push) Has been cancelled
Build / Build Docker Image (push) Has been cancelled
[MIINVENTARIO] feat: Add exports, reports, integrations modules and CI/CD pipeline
- Add exports module with PDF/CSV/Excel generation
- Add reports module for inventory analytics
- Add POS integrations module
- Add database migrations for exports, movements and integrations
- Add GitHub Actions CI/CD workflow with Docker support
- Add mobile export and reports screens with tests
- Update epic documentation with traceability
- Add deployment and security guides

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 06:06:34 -06:00

163 lines
4.0 KiB
Markdown

# 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