Files

tzzrgit c9d7127ee2 Add documentation and SPEC

- Update README with full project documentation
- Add docs/SPEC.md with complete technical specification

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2025-12-21 18:11:43 +01:00

3.3 KiB

Raw Blame History

Packet

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.

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

# Instalar dependencias
flutter pub get

# Build APK
flutter build apk --release

# Build iOS (requiere Xcode)
flutter build ios --release

APIs

Backend (envío)

POST {destino.url}/ingest
X-Auth-Key: {destino.hash}
Content-Type: application/json

Bibliotecas (etiquetas)

GET {biblioteca.url}/api/tags

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

v1.0.0

3.3 KiB Raw Blame History