ARCH-01 Límites y contexto técnico

ARCH-01 — Límites y contexto técnico

Alcance técnico

Este documento registra límites conocidos del MVP; no inventa componentes. El detalle de fronteras internas vive en ARCH-02 y cada decisión estructural en su ADR. La capacidad (1.000 / 10.000 usuarios, pool, caché, multi-instancia) no se dimensiona aquí: ver ARCH-06.

Restricciones conocidas

• Entorno de desarrollo Windows (sin builds iOS ni toolchains de macOS)
• Desarrollador único, proyecto educativo sin fines de lucro
• Despliegue solo local con docker compose durante el MVP
• Versiones de dependencias verificadas contra fuentes oficiales al inicio de cada fase (RES-01)
• Build de Angular sobre TypeScript 6.x; TS 7 no soporta aún el template checking de Angular
• Sin acceso a credenciales de producción: Mercado Pago solo en sandbox (ADR-05)
• Runtime JVM: JDK 25 LTS (toolchain Gradle). Java 26 queda fuera como runtime aunque Kotlin 2.4 pueda emitir ese bytecode (RES-01, ADR-02)
• El backend/Dockerfile usa Eclipse Temurin 25 alineado al toolchain Gradle (corregido 2026-09-20).

Stack tecnológico delimitado

• Frontend: Angular v22 standalone y zoneless, Signals, Tailwind CSS, Angular Aria / Spartan para primitivas headless, Playwright para E2E.
• Backend: Spring Boot 4.1.1 (MVC + virtual threads) sobre Kotlin 2.4 y JDK 25 LTS, Spring Security, ProblemDetail (RFC 9457).
• Persistencia: PostgreSQL 17 + Exposed 1.x + Flyway.
• Contrato: OpenAPI 3.1 como fuente única; cliente TypeScript generado.
• Integraciones externas: Mercado Pago (preferencia y webhooks) en sandbox, detrás del puerto PaymentGateway (ADR-05).

Actores y sistemas externos mencionados

• Visitante, Cliente registrado, Administrador
• Sistema de pagos externo Mercado Pago en sandbox

Frontera con la visión

El resultado esperado por negocio se define en RF-01; este documento no duplica requisitos (fuente única, ADR-01).