HQBase

Acerca de HQBase

HQBase ofrece a los equipos un único lugar para trabajar con buzones compartidos, manteniendo la aplicación, el correo y las credenciales de Cloudflare en la infraestructura del cliente. Incluye:

• Buzones compartidos y controles de acceso del equipo.

• Configuración multidominio, borradores e historial de auditoría.

• Operaciones de instalación, actualización, copia de seguridad y recuperación.

• Un servidor MCP remoto protegido por OAuth.

Consulta la documentación del producto para la instalación, el uso diario, la arquitectura y las operaciones.

Related MCP server: Gmail MCP Connector

Desarrollo local

Iniciar la aplicación

pnpm install
pnpm db:migrate:local
pnpm db:seed:local
pnpm dev

Antes de ejecutar el comando seed opcional, añade estos valores a .dev.vars:

• BETTER_AUTH_SECRET

• HQBASE_LOCAL_SEED_PASSWORD con entre 8 y 128 caracteres

El comando seed escribe solo en D1 local y no contacta con Cloudflare OAuth. Abre http://127.0.0.1:5173/ e inicia sesión como owner@hqbase.test con esa contraseña. Vite sirve el frontend con recarga en vivo en el puerto 5173 y envía las solicitudes de API al Worker de Wrangler en el puerto 8787.

Para usar el flujo de configuración de la primera ejecución, omite el comando seed y abre http://localhost:5173/setup.

Restablecer datos locales

Para descartar todos los datos locales de D1, reconstruir el esquema y recrear el espacio de trabajo de demostración:

pnpm db:reset:local
pnpm db:seed:local

El comando de restablecimiento es destructivo y solo local. No cambia una base de datos desplegada.

Previsualizar la interfaz de configuración

Para trabajo de incorporación solo de presentación:

pnpm dev:setup-ui

Abre http://127.0.0.1:5173/__ui/setup.

Verificar cambios

Ejecuta el control de calidad local completo:

pnpm check
pnpm deploy:dry-run

Ejecuta pnpm cf:typegen después de cambiar wrangler.jsonc.

Los envíos a main ejecutan el mismo control de calidad y la prueba de despliegue en seco. El staging desplegado es manual y también se ejecuta dentro del flujo de trabajo de lanzamiento firmado. Un lanzamiento permanece en borrador hasta que la versión estable anterior se actualice al candidato firmado exacto y pase sus comprobaciones. Las instalaciones y actualizaciones de clientes verifican el manifiesto firmado y el resumen del artefacto antes del despliegue.

Documentación

hqbase.io/docs es la fuente pública de guías de usuario y operador, especificaciones de producto y procedimientos de mantenimiento.

Contribuir

Lee la guía de contribución antes de abrir una pull request.

Seguridad

Para informar de una vulnerabilidad, sigue el proceso privado en la política de seguridad.

Licencia

HQBase está disponible bajo la GNU Affero General Public License v3.0 only.