pablinux/app_compartir
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: actualizar memoria, errores, ideas, infraestructura y readme detallado

Browse Source
This commit is contained in:
pablinux
2026-10-13 22:53:34 -05:00
parent 8519590cc7
commit 9cdc6f702c
5 changed files with 204 additions and 56 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.agente/infraestructura.md
+60 -8
View File
@@ -1328,6 +1328,55 @@ Plataforma de lealtad desarrollada para gestionar clientes y acumulación de pun
---
### app_compartir — Plataforma de Transferencia y Visor Rápido de Archivos
**Descripción:**
Aplicación web en Go para transferencia inmediata de archivos, fotos, documentos y texto/código entre dispositivos (PC y móvil) sin depender de WhatsApp. Incluye un visor universal integrado con reproductores multimedia, lector de PDF y visualizador de código, además de generación instantánea de código QR para escaneo móvil.
| Parámetro | Valor |
|-----------|-------|
| Repositorio Git | [pendiente — crear repo en git.telcotronics.net] |
| Tecnología principal | Go 1.22+ / 1.27 (`net/http` nativo) + SQLite + Tailwind CSS |
| Responsable | pablinux |
| Estado actual | ✅ Operativo / En pruebas |
| Ubicación local | `siax-amd` — `/home/pablinux/Projects/GO/app_compartir` |
| Servidor de producción | `server-webapps` CT 132 (`192.168.10.160`) — pendiente deploy |
| Dominio público | `compartir.sigmac.app` (o `compartir.telcotronics.net`) |
| Puerto | `8085` |
| Servicio systemd | `app-compartir.service` |
**Bases de Datos:**
* **SQLite** (`data/compartir.db` local en modo WAL): Almacena metadatos de archivos compartidos (`shares`), usuarios vinculados (`users`) y tokens de sesión (`sessions`).
**Política de Retención y Almacenamiento:**
* **Sesiones Invitado (Guest):** No requieren login. Los archivos y notas tienen caducidad estricta de **24 horas**. Un worker en segundo plano (`cleaner`) purga periódicamente el archivo físico en disco y su registro en la base de datos.
* **Cuentas Registradas (WebControl / Google OAuth):** Almacenamiento **permanente**. No se eliminan a las 24 horas y disponen de panel de gestión en `/mis-archivos`.
**Servicios que Consume y Expone:**
* **Expone:**
* **GET** `/`: Portal web de subida (drag & drop, pegar con `Ctrl+V`, compartir notas/código).
* **POST** `/api/upload`: Subida multipart de archivos (hasta 500 MB). Retorna JSON con `viewer_url` y `download_url`.
* **POST** `/api/share-text`: Subida rápida de fragmentos de texto o código.
* **GET** `/v/{id}`: Visor universal (imágenes con zoom, video/audio HTML5, PDF embebido, texto/código con botón de copia, y QR móvil).
* **GET** `/d/{id}`: Descarga directa forzada (`attachment`).
* **GET** `/raw/{id}`: Visualización directa en el navegador (`inline`).
* **GET** `/qr/{id}`: Código QR dinámico en PNG (256x256).
* **DELETE** `/api/shares/{id}`: Eliminación manual de archivos por su propietario.
* **Consume:**
* **WebControl (Auth):** `https://api.siax-system.net/api/auth/login` para autenticación de cuentas internas Telcotronics.
* **Google OAuth2:** Flujo de login con cuentas Google (`/auth/google`).
**Módulos Disponibles:**
* **Módulo de Subida y Streaming:** Recepción de multipart y almacenamiento local con generación de slug corto. (✅ Operativo)
* **Visor Universal:** Interfaz interactiva adaptativa según el MIME type. (✅ Operativo)
* **Purga Automática 24h:** Goroutine en segundo plano que limpia archivos y sesiones guest expiradas. (✅ Operativo)
* **Gestor de Cuentas y Mis Archivos:** Panel para usuarios registrados con métricas de visitas y descarga. (✅ Operativo)
**Dónde buscar más información:**
* Documentación técnica del proyecto: `siax-amd:/home/pablinux/Projects/GO/app_compartir/agents.md`.
---
### sistema-gimnasio — Sistema de Administración para Gimnasio (SOCIOS)
Panel web de administración de gimnasios en el ecosistema SIGMA (frente 3 — Panel Admin SOCIOS). Staff del gimnasio gestiona miembros, membresías, pagos, visitas, cajas, inventario de items y ventas. SPA Vue 2 + Vuetify 2 con tema oscuro. Consume dos APIs del ecosistema: `API-SIGMA-WEBCONTROL` para autenticación y `API-SIGMA-CLOUD` para todos los datos de negocio.
@@ -1402,16 +1451,16 @@ Backend de la app **SoundWave**. Permite controlar la reproducción de audio de
| Parámetro | Valor |
|---|---|
| Repositorio Git | `https://git.telcotronics.net/pablinux/audio_control.git` |
| Tecnología principal | Node.js (Express 4) + MariaDB + DLNA/UPnP + ffplay + EJS |
| Tecnología principal | Node.js (Express 4) + Socket.IO + MariaDB + DLNA/UPnP + ffplay + EJS |
| Responsable | pablinux |
| Estado actual | ✅ Activo / Desplegado en producción |
| Equipo / ubicación local | `siax-amd` (`192.168.10.100`) — `/home/pablinux/Projects/Node/audio_control` |
| Servidor de producción | `server-webaps` CT 132 (`192.168.10.160`) — `/home/user_apps/apps/audio_control` |
| Dominio público | `audiocontrol.sigmac.app` (pendiente virtualhost/SSL en .160) |
| Dominio público | `audiocontrol.sigmac.app` (vhost activo en .160; enrutamiento WAN sujeto a proxy en .109 / NAT) |
| Puerto | `4005` (dev: `4000`) |
| Servicio systemd | `siax-app-AUDIO_CONTROL.service` (activo) |
| Registro MCP | Servicio ID `15` en `http://192.168.10.160:3006` |
| Última actualización | 2026-09-23 |
| Última actualización | 2026-09-24 |
**BD que usa:**
@@ -1423,25 +1472,28 @@ Backend de la app **SoundWave**. Permite controlar la reproducción de audio de
| Método | Endpoint | Auth | Descripción |
|--------|----------|------|-------------|
| POST | `/control/audio/play` | — (pendiente JWT) | Reproduce archivo MP3 local con `ffplay`. Body: `{ file: "ruta/relativa" }` |
| POST | `/control/audio/stop` | — (pendiente JWT) | Detiene `ffplay` activo |
| POST | `/control/youtube/download` | — | Descarga audio de YouTube como MP3. Body: `{ url: "..." }` |
| POST | `/control/audio/play` | `verificarJWT` | Reproduce archivo MP3 local con `ffplay` y emite `player:status`. Body: `{ file: "ruta/relativa" }` |
| POST | `/control/audio/stop` | `verificarJWT` | Detiene `ffplay` activo y emite `player:status` |
| POST | `/control/youtube/download` | `verificarJWT` | Descarga audio de YouTube como MP3 con validación regex anti-SSRF. Body: `{ url: "..." }` |
| GET | `/api/youtube-playlist` | — | Lista playlist YouTube (últimas 50 de MySQL) |
| POST | `/api/youtube-playlist/add` | — | Agrega video a playlist |
| GET | `/api/mp3-files` | — | Lista archivos MP3 en `public/files/mp3/` |
| POST | `/api/auth/google` | — | Auth Google OAuth 2.0 → JWT propio |
| GET | `/api-docs` | — | Swagger UI |
| WS | Socket.IO | — | Eventos `player:status` y ajuste de `player:volume` bidireccional |
**Servicios que consume:**
| Servicio | Uso |
|---------|-----|
| `ffplay` (sistema — parte de `ffmpeg`) | Reproducción de audio local |
| `ffplay` / `amixer` (sistema Linux) | Reproducción de audio local y control de volumen hardware |
| YouTube (internet) vía `@distube/ytdl-core` | Descarga de audio |
| Google OAuth 2.0 API | Verificación de tokens de usuario |
| Bitácora Centralizada de Errores | `POST https://api.siax-system.net/api/errores` (`app_origen: audio_control`) |
**Integración con el ecosistema:**
- Independiente actualmente — no consume APIs internas del ecosistema
- Conectado a la bitácora centralizada de errores (`siax-system.net`)
- Sincronizado en tiempo real vía WebSockets para pantallas y controles múltiples
- Potencial: integrar con `sigma-robot` para notificaciones de estado vía WhatsApp
**Dónde buscar más información:** `siax-amd:/home/pablinux/Projects/Node/audio_control/agents.md`