Saltar a contenido

Proyecto integral

El repositorio ahora incluye un ejemplo separado en:

examples/full-project/

Que cubre

El proyecto demuestra en una sola base:

  • App, rutas view, api y ws.
  • documentacion runtime con enable_docs().
  • metricas, logs NDJSON y tareas en background.
  • ORM SQLite con modelos persistentes.
  • cache clave-valor y cache HTTP de vistas.
  • SecurityPolicy.
  • ProxyI con upstream separado.
  • LocalDNSServer opcional.
  • Predictor y NeuralNetwork para una capa simple de IA.

Archivos principales

examples/full-project/
├── README.md
├── pyproject.toml
├── app.py
└── upstream.py

Como correrlo

  1. Instala wsbuilder desde este repo o desde la wheel local.
  2. Levanta el upstream:
cd examples/full-project
python upstream.py --port 8780
  1. En otra terminal, levanta la app principal:
cd examples/full-project
python app.py --port 8765 --upstream-port 8780
  1. Abre:

  2. /

  3. /docs
  4. /api/metrics
  5. /proxy
  6. /api/notes
  7. /api/cache/demo
  8. /api/ml/predict?x=5
  9. /api/tasks/train
  10. /api/tasks/status
  11. /api/proxy/upstream
  12. /api/dns/status
  13. /ws/echo

Que demuestra cada endpoint

Endpoint Demuestra
/ vista HTML simple
/docs y /docs.json documentacion runtime
/pages/overview vista con worker pool y cache HTTP
/api/health API JSON y snapshot de estado
/api/notes CRUD SQLite con Model y QuerySet
/api/cache/demo cache KV, namespaces, tags y stats
/api/ml/predict Predictor
/api/ml/dataset datos de ejemplo para IA
/api/tasks/train entrenamiento en background con TaskManager
/api/tasks/status snapshot de una tarea
/api/proxy/upstream forwarding con ProxyI
/proxy dashboard del proxy
/api/dns/status estado del DNS opcional
/ws/echo WebSocket de eco

DNS opcional

El ejemplo no inicia el servidor DNS por defecto para no ocupar puertos ni introducir ruido en demos simples. Para activarlo:

WSB_FULL_DEMO_ENABLE_DNS=1 python app.py

El ejemplo usa 127.0.0.1:5533 como valor por defecto para evitar privilegios de root.

Tambien puedes activarlo por argumento:

python app.py --enable-dns --dns-port 5533

Archivos generados

El ejemplo crea:

  • examples/full-project/data/demo.sqlite3
  • examples/full-project/logs/app.ndjson

Ambos son datos locales de ejecucion y no forman parte del paquete publicado.