GitHubTry Cloud
book Documentación

Todo lo que necesitas para empezar.

Desde la instalación hasta la configuración avanzada. Referencia completa de la arquitectura, variables de entorno y módulos de la plataforma.

Ver en GitHub
rocket_launch

Primeros pasos

Instala PgStudio con Docker Compose o el instalador automático. Listo en minutos.

arrow_forwarddeployed_code

Opciones de despliegue

Docker Compose, all-in-one, Railway, Fly.io, Vercel y Kubernetes/Helm.

arrow_forward
settings

Configuración

Variables de entorno requeridas: DATABASE_URL, JWT_SECRET, CREDENTIALS_ENCRYPTION_KEY, CORS_ORIGIN y más.

architecture

Arquitectura

El navegador nunca conecta directamente a PostgreSQL. Todo pasa por el gateway NestJS vía HTTPS/WebSocket.

code_blocks

Editor SQL

Monaco Editor con autocompletado, resaltado de sintaxis, múltiples pestañas, historial y análisis de consultas.

account_tree

Explorador de esquemas

Navega tablas, vistas, funciones e índices. Genera DDL automáticamente desde la interfaz visual.

analytics

Analizador de consultas

Visualización de EXPLAIN / EXPLAIN ANALYZE. Planning time, execution time y plan completo de ejecución.

table_chart

Diseñador de tablas

Crea y modifica tablas visualmente. Genera sentencias DDL para CREATE TABLE, ALTER TABLE y más.

admin_panel_settings

Autenticación y permisos

JWT con refresh tokens. RBAC con 4 niveles: OWNER, ADMIN, DEVELOPER, READ_ONLY. Rate limiting incluido.

receipt_long

Auditoría

Log completo de escrituras y operaciones DDL. Cada acción queda registrada con usuario, timestamp y query.

encrypted

Seguridad de credenciales

Las contraseñas de conexión se cifran con AES-GCM en el servidor. La clave es CREDENTIALS_ENCRYPTION_KEY.

share

API Reference

Todos los endpoints NestJS expuestos bajo /api/*. Auth, conexiones, queries, metadata, DDL y sesiones WebSocket.

Stack tecnológico

Frontend (apps/web)

  • Angular 21 Standalone components + Signals
  • Monaco Editor SQL editing engine
  • SCSS Component-scoped + global tokens
  • TypeScript Strict mode

Backend (apps/api)

  • NestJS 11 Gateway modular
  • node-postgres Conexiones TCP a PostgreSQL
  • Socket.IO WebSocket para streaming de resultados
  • JWT Access 1h + Refresh 7d
  • AES-GCM Cifrado de credenciales

Contratos (libs/contracts)

  • DTOs compartidos auth, connections, query
  • Enums Roles, risk levels
  • Interfaces metadata, ddl, explain, sessions

¿Prefieres explorar el código?

El repositorio está completamente abierto en GitHub. PRs y issues bienvenidos.

Ver en GitHub