PROJ-007 — EdgeOS · Agentesia

Progreso

85%

Prototipo v1.0 · Falta deploy CF

Workers

4 workers

Gateway · Control Plane · Builder · Runtime

Durable Objects

2 DOs

AppManager · DeploymentManager

D1 Tablas

6 tablas

users · apps · deployments · routes · usage · api_keys

API Endpoints

REST completa + auth + rollback

Pricing Tiers

3 planes

Free · Pro $19 · Enterprise $99

Arquitectura — 4 Subsistemas

API Gateway

workers/gateway.js

Punto de entrada único. Auth via KV, rate limiting sliding window, routing a Control Plane o Runtime, CORS, logging a Queue.

WorkersKVQueues

Control Plane

workers/control-plane.js

Cerebro del sistema. REST API para apps, deployments, logs, usage, API keys, registro de usuarios. Orquesta Durable Objects.

WorkersD1KVDO

Deployment Engine

workers/builder.js

Queue consumer. Recibe mensajes de deploy, valida y compila código, sube bundle a R2, activa ruta en KV, marca deployment como active.

QueuesR2D1KV

Edge Runtime

workers/runtime.js

Ejecuta bundles de usuario. Lookup en KV (fast path), fallback a R2, sandbox con globals seguros, tracking de CPU y requests para billing.

WorkersKVR2D1

Pipeline de Deployment

POST /api/deploy

→

Auth + Validate

→

INSERT deployments

→

DEPLOY_QUEUE.send()

→

Builder Worker

→

buildBundle()

→

R2.put(bundle.js)

→

KV route:app → deployId

→

status = active ✅

API Reference

Método	Endpoint	Descripción	Auth
POST	/api/auth/register	Registrar usuario + obtener API key	❌ Pública
GET	/api/me	Info del usuario autenticado	✅ Bearer
POST	/api/apps	Crear nueva app	✅ Bearer
GET	/api/apps	Listar apps del usuario	✅ Bearer
GET	/api/apps/:id	Detalle de app	✅ Bearer
PATCH	/api/apps/:id	Actualizar descripción, status, env_vars	✅ Bearer
DELETE	/api/apps/:id	Eliminar app (soft delete)	✅ Bearer
POST	/api/deploy	Iniciar deployment (encola build)	✅ Bearer
GET	/api/deployments	Historial de deployments	✅ Bearer
GET	/api/deployments/:id	Detalle de deployment + build log	✅ Bearer
POST	/api/deployments/:id/rollback	Rollback al deployment anterior	✅ Bearer
GET	/api/logs	Consultar logs de app (?app_id=&limit=)	✅ Bearer
GET	/api/usage	Métricas de uso (?period=YYYY-MM)	✅ Bearer
GET	/api/keys	Listar API keys (enmascaradas)	✅ Bearer
POST	/api/keys	Generar nueva API key	✅ Bearer
DELETE	/api/keys/:prefix	Revocar API key por prefijo	✅ Bearer

Agentes del Proyecto

🏛️

Nexus

EdgeOS Architect — Diseño de sistemas, ADRs, revisión técnica

edgeos-architect.md

⚡

Sigma

EdgeOS Backend — Workers, Durable Objects, D1, REST API

edgeos-backend.md

🔧

Forge

EdgeOS DevOps — Builder, Queues, R2, wrangler, pipeline

edgeos-devops.md

🎨

Pixel

EdgeOS Frontend — Dashboard (~2300L), Landing (~2600L), UX

edgeos-frontend.md

Pasos para Deploy en Producción (15% restante)

#	Paso	Comando	Estado
1	Crear D1 database	wrangler d1 create edgeos_core	⏳ Pendiente
2	Crear KV namespace	wrangler kv namespace create KV	⏳ Pendiente
3	Crear R2 bucket	wrangler r2 bucket create edgeos-bundles	⏳ Pendiente
4	Crear Queue	wrangler queues create edgeos-deploy-requests	⏳ Pendiente
5	Actualizar wrangler.toml	Reemplazar REPLACE_WITH_* con IDs reales	⏳ Pendiente
6	Ejecutar schema SQL	wrangler d1 execute edgeos_core --file=db/schema.sql	⏳ Pendiente
7	Deploy a Cloudflare	cd edgeos && wrangler deploy	⏳ Pendiente

Quick Start — Primera App en EdgeOS

// 1. Registrar cuenta curl -X POST https://edgeos.workers.dev/api/auth/register \ -H "Content-Type: application/json" \ -d '{"email":"dev@example.com","name":"Dev User"}' // → {"api_key": "eos_xxxx...", "message": "Welcome to EdgeOS!"} // 2. Crear app curl -X POST https://edgeos.workers.dev/api/apps \ -H "Authorization: Bearer eos_xxxx..." \ -d '{"name":"my-api","description":"Mi primera app"}' // → {"app": {"id": "app_abc123", "name": "my-api", "status": "active"}} // 3. Desplegar código curl -X POST https://edgeos.workers.dev/api/deploy \ -H "Authorization: Bearer eos_xxxx..." \ -d '{"app_id":"app_abc123","version":"v1.0","code":"async function handleRequest(req){return new Response(JSON.stringify({hello:\"world\"}),{headers:{\"content-type\":\"application/json\"}})}"}' // → {"deployment": {"id": "dep_xyz789", "status": "queued"}} // 4. Llamar tu app curl https://edgeos.workers.dev/app/my-api // → {"hello": "world"} — ejecutándose en 300+ ubicaciones 🌍