Tecnofilm

🟢 Producción Web pública Astro Cloudflare Workers Admin de catálogo Criticidad media

Tecnofilm es una web pública desarrollada en Astro y desplegada en Cloudflare Workers, dentro de la cuenta Cloudflare del cliente. Este activo incluye panel administrativo, catálogo persistido en Cloudflare KV, medios en Cloudflare R2 y formularios públicos integrados con Resend y Turnstile.

Resumen del activo

Campo	Valor
Estado	Producción
FQDN	`tecnofilm.pe`
URL producción	https://tecnofilm.pe
URL desarrollo	https://tecnofilm-www.tecnofilm.workers.dev/
Último despliegue	16 de mayo de 2026, 05:06 a. m.
Repositorio	https://github.com/iz-soporte/tecnofilm-www.git
Stack	Astro / TypeScript / Cloudflare Workers
Versión de Astro	Última estable
Plataforma	Cloudflare Workers
Cuenta Cloudflare	Cliente
Publicación	Wrangler CLI
Salida del build	`dist`
Proyecto / Worker	`tecnofilm-www`
Modo Astro	`output: server`
Adapter	`@astrojs/cloudflare`
Catálogo	Cloudflare KV `PRODUCTS_KV`
Medios	Cloudflare R2 `PRODUCTS_BUCKET`
Bucket R2	`tecnofilm-media`
Formularios	`POST /api/forms`
Antispam	Cloudflare Turnstile
Email transaccional	Resend
Criticidad	Media
Clasificación de datos	Público + datos enviados por formularios

Alcance Interzone

Interzone mantiene el código y el despliegue técnico de la web.
La infraestructura Cloudflare pertenece al cliente, por lo que cambios en DNS, Workers, KV, R2, secretos o dominios deben coordinarse con los accesos del cliente.

El alcance operativo incluye:

mantenimiento del código Astro;
despliegue mediante Wrangler CLI;
soporte del panel administrativo;
validación de catálogo y medios;
validación de formularios públicos;
coordinación de secretos y recursos Cloudflare con el cliente.

Arquitectura

Visitante
  ↓
tecnofilm.pe
  ↓
Cloudflare Workers
  ↓
Astro server output + static assets
  ├─ Catálogo desde PRODUCTS_KV
  ├─ Imágenes y archivos desde PRODUCTS_BUCKET / R2
  ├─ Formularios públicos vía POST /api/forms
  └─ Panel admin protegido por sesión

Componentes principales

Componente	Descripción
Sitio público	Páginas comerciales, catálogo, detalle de productos, contacto y trabaja con nosotros.
Panel admin	Administración privada de productos, categorías y medios.
Catálogo	Persistido en Cloudflare KV mediante el binding `PRODUCTS_KV`.
Medios	Imágenes y archivos almacenados en Cloudflare R2 mediante `PRODUCTS_BUCKET`.
Formularios	Endpoint único `POST /api/forms` para contacto, productos y CV.
Email	Envío transaccional mediante Resend.
Antispam	Validación mediante Cloudflare Turnstile.

Rutas relevantes

Ruta	Uso
`/`	Home
`/nosotros`	Información institucional
`/productos`	Catálogo de productos
`/productos/[slug]`	Detalle de producto
`/contacto`	Formulario de contacto
`/trabaja-con-nosotros`	Formulario de envío de CV
`/admin`	Login administrativo
`/admin/dashboard`	Panel privado
`/admin/productos`	Gestión de productos
`/admin/categorias`	Gestión de categorías
`/admin/media`	Subida y listado de medios en R2
`/cdn/<carpeta>/<archivo>`	Acceso público a archivos publicados desde R2

Datos y almacenamiento

Dato	Ubicación
Catálogo de productos	Cloudflare KV `PRODUCTS_KV`
Respaldo local de catálogo	`src/content/products.json`
Imágenes de productos	Cloudflare R2 `PRODUCTS_BUCKET`
Archivos CV	R2, carpeta `cv/`
URLs públicas de medios	`/cdn/<carpeta>/<archivo>`
Sesión admin	Cookie firmada con `ADMIN_SESSION_SECRET`

Formularios

Los formularios públicos usan un único endpoint:

POST /api/forms

El campo oculto type define el destino lógico:

Type	Uso	Destino
`contact`	Contacto general	`CONTACT_TO_EMAIL`
`product`	Consulta o solicitud de producto	`ORDER_TO_EMAIL`
`cv`	Trabaja con nosotros	`CV_TO_EMAIL`

El CV no se adjunta al email. Se guarda en R2 dentro de cv/ y el correo enviado a RRHH incluye el enlace público generado.

Configuración Cloudflare

`astro.config.mjs`

Configuración	Valor
`site`	`https://tecnofilm.pe`
`output`	`server`
Adapter	`@astrojs/cloudflare`
Session KV	`PRODUCTS_KV`
Image service	`passthrough`

`wrangler.jsonc`

Configuración	Valor
Worker	`tecnofilm-www`
Main	`@astrojs/cloudflare/entrypoints/server`
Assets binding	`ASSETS`
Assets directory	`./dist`
KV binding	`PRODUCTS_KV`
R2 binding	`PRODUCTS_BUCKET`
Bucket	`tecnofilm-media`
Observability	Habilitada

Secretos y variables

Secretos administrativos

npx wrangler secret put ADMIN_USER
npx wrangler secret put ADMIN_PASSWORD
npx wrangler secret put ADMIN_SESSION_SECRET

Secretos de formularios

npx wrangler secret put RESEND_API_KEY
npx wrangler secret put EMAIL_FROM
npx wrangler secret put CONTACT_TO_EMAIL
npx wrangler secret put ORDER_TO_EMAIL
npx wrangler secret put CV_TO_EMAIL
npx wrangler secret put TURNSTILE_SECRET_KEY
npx wrangler secret put PUBLIC_SITE_URL

Variable pública Turnstile

PUBLIC_TURNSTILE_SITE_KEY

No se deben versionar .dev.vars, contraseñas, API keys ni secretos de Cloudflare.

Desarrollo local

Astro local

npm install
npm run dev

Abrir:

http://localhost:4321/admin

Worker local con bindings

npx wrangler dev

Abrir:

http://localhost:8787/admin

Usar Wrangler cuando se necesite probar comportamiento cercano al runtime real de Cloudflare Workers, especialmente KV y R2.

Despliegue

El despliegue se realiza con:

npm run deploy

Ese comando ejecuta:

astro build && wrangler deploy

Flujo operativo

Paso	Acción
1	Validar cambios en local.
2	Ejecutar build.
3	Publicar con Wrangler en la cuenta Cloudflare del cliente.
4	Validar home, productos y detalle de producto.
5	Validar login de admin.
6	Validar carga de imágenes en R2 si aplica.
7	Validar publicación de catálogo en KV.
8	Validar formularios públicos.

Seguridad y operación

Riesgo operativo medio. Aunque la web es pública, existe panel administrativo, formularios públicos, almacenamiento R2, KV y secretos en Cloudflare.

Control	Revisión
Admin	Credenciales configuradas como secretos de Cloudflare.
Sesión	Cookie firmada con `ADMIN_SESSION_SECRET`.
Catálogo	KV protegido por acceso del Worker.
R2	Subida de archivos solo desde admin autenticado.
Formularios	Turnstile configurado cuando aplique.
Email	Resend API Key como secreto.
Archivos locales	`.dev.vars` no debe subirse al repositorio.
Cliente	Cloudflare, DNS, KV, R2 y secretos dependen de la cuenta del cliente.

Checklist post-despliegue

Validación	Estado esperado
Home carga correctamente	OK
`/productos` carga catálogo	OK
Detalle de producto carga por slug	OK
`/admin` permite login	OK
Productos se pueden editar	OK
Cambios se publican en KV	OK
Imágenes se suben y listan desde R2	OK
`/cdn/<key>` sirve archivos	OK
Formulario de contacto envía correo	OK
Formulario de producto envía correo	OK
CV se guarda en R2 y se envía enlace	OK
Turnstile valida correctamente si está activo	OK
No hay errores visibles en consola	OK

Pendientes

Pendiente	Prioridad
Confirmar repositorio oficial del proyecto	Alta
Confirmar responsables del acceso Cloudflare del cliente	Alta
Confirmar si Turnstile está activo en producción	Media
Confirmar política de respaldo/exportación de KV	Media
Confirmar política de retención de archivos en R2	Media
Confirmar monitoreo y alertas en Cloudflare	Media
Confirmar límites/tamaño máximo de archivos CV	Media