ARCH-01 Límites y contexto técnico

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

Alcance técnico

Aplicación Flutter de usuario único, offline-first, con almacenamiento local y una capa de IA opcional. Este documento fija los límites conocidos y no inventa componentes: toda decisión estructural pendiente queda como TBD y se resuelve en ADRs posteriores (ADR-02…ADR-09).

Contexto del sistema

        ┌─────────────── Tablet Android ──────────────────────┐
        │                                                     │
        │   UI Flutter (material_ui / cupertino_ui)           │
        │        │                                            │
        │   Dominio: Conceptos · Notas · Proyectos ·          │
        │            Decisiones · Experimentos                │
        │        │                                            │
        │   Grafo de conocimiento (ontología ARCH-02)         │
        │        │                                            │
        │   Persistencia local (TBD: ARCH-04)                 │
        │        │                                            │
        │   Export Markdown + frontmatter                     │
        └────────┼────────────────────────────────────────────┘
                 │ (opcional, solo con proveedor configurado)
                 ▼
        IA contextual (ARCH-05) — API HTTP directa, sin GMS

Restricciones conocidas

• Plataforma objetivo: Android, API 24+ — decidido en ADR-09. Windows es solo entorno de desarrollo local.
• GMS-agnóstico: se prohíben en el núcleo dependencias que exijan Google Play Services (Firebase, FCM, Google Sign-In, Google Maps, Play Billing, Play Integrity, AdMob). Así la app funciona en cualquier Android, con o sin Play Store.
• Stack: Flutter 3.47.1 + Dart 3.13.1. material_ui 1.4.0 y cupertino_ui 1.1.1 (paquetes desacoplados). Verificado 2026-09-22.
• Offline-first: la app funciona sin red; la IA es la única función que puede requerir conexión.
• Usuario único: sin autenticación, sin multiusuario, sin backend propio en 0.1.
• Datos locales: propiedad total del usuario; exportables a Markdown + YAML frontmatter.
• Lápiz: el soporte de stylus depende de Android (Android 14+), no de la API M-Pencil de Huawei.

Actores y sistemas externos

• El propio desarrollador (usuario único).
• Proveedor de IA por API HTTP (externo, opcional, TBD) — recibe únicamente la vecindad del grafo solicitada explícitamente.
• Sistema de archivos local / export Markdown (interop con DocuGraph).

Frontera con la visión

El resultado esperado se define en RF-01 y VISION-00; este documento no duplica requisitos (fuente única).

Decisiones estructurales

Tema	Documento	Estado
Fuente de verdad documental	ADR-01	REGISTRADA
Ontología y aristas tipadas	ARCH-02 / ADR-02	PROPUESTO
Stack y toolchain exactos	ARCH-03 / ADR-04	PROPUESTO
Persistencia local	ARCH-04 / ADR-03	PROPUESTO
Capa de IA contextual	ARCH-05 / ADR-05	PROPUESTO
Sistema visual y tokens	ARCH-06 / DS-01	PROPUESTO
Escritorio y sincronización	ARCH-07	DIFERIDO
Plataforma objetivo	ADR-09	DECIDIDA (Android)

Trazabilidad

• Upstream: RF-01, VISION-00.
• Downstream: ARCH-02…ARCH-07, ADR-02…ADR-09, DEPLOY-01, OPS-01.