File size: 1,842 Bytes
1f52113
 
 
 
 
 
 
 
 
 
cef7600
1f52113
cef7600
1f52113
 
 
 
 
 
 
 
 
 
 
 
 
 
6efc10f
d4289ee
 
 
 
 
6efc10f
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
---
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
```