--- title: Talos Access emoji: 🎟️ colorFrom: blue colorTo: indigo sdk: docker app_port: 8000 pinned: false --- # talos-access Talos Access es un SaaS de control de acceso a colegios a través de implementación de hardware y biométrica. ## Despliegue en Hugging Face Spaces Se despliega como un único contenedor Docker (FastAPI + SPA React + MariaDB embebida). El contenedor corre como UID 1000 con disco efímero: la base de datos se re-siembra en cada arranque (`SEED_DEMO=1`), por lo que es una demo, no producción persistente. **Secret obligatorio** (Settings → Variables and secrets → New secret): - `JWT_SECRET_KEY` — clave aleatoria, p.ej. `openssl rand -hex 32`. El valor por defecto es inseguro y este repositorio es público. El resto de variables (`EMBED_DB`, `MYSQL_*`, `SEED_DEMO`, `CORS_ORIGINS`) ya vienen con valores por defecto en el `Dockerfile`. ## Documentación - [Runbook: Homologación dev/prod](docs/runbook-homologacion.md) — Levanta el proyecto desde cero (local + Supabase + HF Space). - [Template de prompt reusable](docs/template-homologacion-prompt.md) — Aplica el patrón de homologación a otro proyecto Python. ## Desarrollo ### Push a todos los ambientes (GitHub + Hugging Face Space) El remote `origin` está configurado para empujar simultáneamente a GitHub y al Hugging Face Space: ```bash git push origin main ``` Esto publica el cambio en GitHub (`https://github.com/Yisus32/talos-access.git`) y dispara un rebuild en el Space (`https://huggingface.co/spaces/Talosware/talos-access`) en una sola operación. Si necesitas configurar este patrón desde cero en otro clon del repo: ```bash git remote set-url --add --push origin https://github.com/Yisus32/talos-access.git git remote set-url --add --push origin https://huggingface.co/spaces/Talosware/talos-access ```