Archive: System v4 - Estado al 2024-12-24

2025-12-24 17:28:34 +00:00
parent a92d41c846
commit 1b392803fd
81 changed files with 24560 additions and 0 deletions
--- a/v4-archive/packet/README.md
+++ b/v4-archive/packet/README.md
@@ -0,0 +1,171 @@
+# Packet
+
+![Estado](https://img.shields.io/badge/Estado-IMPLEMENTADO-brightgreen)
+
+
+App móvil multiplataforma (iOS/Android) para capturar contenido multimedia, etiquetarlo con hashes y enviarlo a backends configurables.
+
+## Principios
+
+| Principio | Descripción |
+|-----------|-------------|
+| Zero-retention | Los archivos nunca se almacenan en disco, solo en RAM hasta envío |
+| Hash-first | Todo contenedor tiene hash SHA-256 único generado localmente |
+| Contenedor cerrado | Una vez montado, no se inspecciona. Solo enviar o desmontar |
+| App tonta | No valida coherencia de etiquetas, solo formato. El backend decide |
+| Offline-capable | Captura sin conexión, cola de reintentos cuando hay red |
+
+## Stack Tecnológico
+
+| Componente | Tecnología |
+|------------|------------|
+| Framework | Flutter 3.x |
+| Lenguaje | Dart |
+| Estado | flutter_bloc |
+| DB Local | sqflite |
+| HTTP | dio |
+| Crypto | crypto (SHA-256) |
+| Media | image_picker, record |
+| Location | geolocator |
+| Permisos | permission_handler |
+
+## Pantallas
+
+```
+┌─────────────────────────────────────────┐
+│  [Mi DECK ▼] [CORP] [+Ext]              │  ← Destinos (superior)
+├─────────────────────────────────────────┤
+│           CONTENIDO PANTALLA            │
+├─────────────────────────────────────────┤
+│  📷      🏷️      📦      ⏳      ⚙️     │  ← Navegación (inferior)
+│ Captura  Tags   Packs  Pend.  Config   │
+└─────────────────────────────────────────┘
+```
+
+### Captura
+Montar contenedor con contenido multimedia: título, descripción, archivos, GPS, etiquetas.
+
+### Etiquetas
+Seleccionar etiquetas de bibliotecas HST/DECK y añadir hashes externos.
+
+### Packs
+Conjuntos predefinidos de etiquetas para aplicar con 1 tap.
+
+### Pendientes
+Cola de contenedores fallidos (máx 20). App se bloquea si se llena.
+
+### Config
+URLs, llaves de autenticación y bibliotecas de iconos.
+
+Bibliotecas con indicador visual:
+- 🔓 Pública (sin PIN)
+- 🔒 Privada (requiere PIN)
+
+## Estructura del Proyecto
+
+```
+lib/
+├── core/
+│   ├── constants/    # Constantes de la app
+│   ├── errors/       # Excepciones personalizadas
+│   ├── utils/        # Utilidades (hash, retry)
+│   └── theme/        # Tema de la app
+├── data/
+│   ├── datasources/  # APIs y BD local
+│   └── repositories/ # Repositorios
+├── domain/
+│   └── entities/     # Modelos de dominio
+└── presentation/
+    ├── bloc/         # Cubits de estado
+    ├── pages/        # Pantallas
+    └── widgets/      # Widgets reutilizables
+```
+
+## Build
+
+```bash
+# Instalar dependencias
+flutter pub get
+
+# Build APK
+flutter build apk --release
+
+# Build iOS (requiere Xcode)
+flutter build ios --release
+```
+
+## APIs
+
+### Backend (envío)
+```http
+POST {destino.url}/ingest
+X-Auth-Key: {destino.hash}
+Content-Type: application/json
+```
+
+### Bibliotecas (etiquetas)
+```http
+GET {biblioteca.url}/api/biblioteca
+X-HSU-PIN: {pin}  # Solo para bibliotecas privadas
+```
+
+**Respuesta:**
+```json
+{
+  "nombre": "Mi Biblioteca",
+  "requiere_pin": true,
+  "tags": [...]
+}
+```
+
+## Base de Datos Local
+
+SQLite v4 con las siguientes tablas principales:
+
+**bibliotecas:**
+| Campo | Tipo | Descripción |
+|-------|------|-------------|
+| id | INTEGER | PK autoincrement |
+| nombre | TEXT | Nombre de la biblioteca |
+| url | TEXT | URL del servidor |
+| hash | TEXT | Hash de identificación |
+| pin | TEXT | PIN para bibliotecas privadas (nullable) |
+| requiere_pin | INTEGER | 0=pública, 1=privada |
+
+## Lógica de Reintentos
+
+20 intentos en 72 horas con backoff exponencial (1min → 8h).
+
+## Referencias
+
+- Biblioteca HST: https://tzrtech.org
+- Especificación completa: [docs/SPEC.md](docs/SPEC.md)
+
+---
+
+## Changelog
+
+### v1.7.3 (2025-12-22)
+- Fix: Añadido permiso INTERNET en AndroidManifest.xml
+- Fix: Mejor manejo de errores de conexión
+
+### v1.7.2 (2025-12-22)
+- Fix: Diálogo de PIN se cierra correctamente al cancelar
+- Fix: Error de conexión muestra mensaje amigable
+
+### v1.7.1 (2025-12-22)
+- Fix: PIN se guarda correctamente en BD local
+
+### v1.7.0 (2025-12-22)
+- Feat: Sistema de PIN para bibliotecas privadas
+- Feat: Header `X-HSU-PIN` para autenticación
+- Feat: Indicadores visuales 🔒/🔓 para tipo de biblioteca
+- Feat: Diálogo de PIN al conectar biblioteca privada
+- Change: Endpoint de bibliotecas ahora es `/api/biblioteca`
+
+### v1.6.0 (2025-12-22)
+- Feat: Diálogo simplificado para añadir biblioteca (solo URL)
+- Change: Nombre y hash se obtienen automáticamente del servidor
+
+### v1.0.0
+- Release inicial