172 lines
4.8 KiB
Markdown
172 lines
4.8 KiB
Markdown
# 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.
|
|
|
|
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
|