Add manual setup checks for self hosted deployments

Abierto
#153 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
docker, node.js, postgresql, typescript

Línea de trabajo

Start with the linked work in #157 and #158 to trace dependency checks and the dashboard flow, then identify the backend entry points for Cloudflare Workers and Node/Docker. Read the setup and operations documentation and inspect existing tests for both runtimes. Done means operators can run checks manually, understand passed, failed, or unavailable results, and PostgreSQL checks never keep a serverless database awake.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

enhancement good first issue help wanted

Goal

Give self hosted Codra operators a simple way to find setup and service problems without requiring any service, especially a serverless PostgreSQL database, to stay awake all the time.

What the check should cover

Check GitHub App setup, webhook delivery information, model provider credentials, the configured queue or worker, and PostgreSQL when the current runtime can check them. A result should say whether a check passed, failed, or could not be checked, and give a useful next step.

Serverless PostgreSQL requirement

Run a PostgreSQL check only when an operator asks for it or when Codra already needs a database connection for normal work. Let an ordinary connection attempt wake a suspended database. Do not poll it on a timer, keep a connection open to prevent suspension, or call it unhealthy only because it was idle. Explain cold start delays or timeouts when they can be identified.

Work breakdown

Done when

  • Operators can run checks manually and understand each result.
  • Checks are available in both Cloudflare Workers and Node/Docker where the runtime can support them.
  • A service the runtime cannot check is shown as unavailable, not failed.
  • PostgreSQL is never kept awake by health checks.
  • Setup and operations documentation explains the checks and their on demand behavior.

Before closing

  • npm run typecheck, npm test, and npm run lint all pass.
  • Backend checks work in both Cloudflare Workers and Node/Docker.
  • Tests cover the changed behavior in each affected runtime.
Lenguaje dominante
TypeScript
Estrellas
125
Forks
23
Merge medio
2 d 13 h
PR fusionados (30 d)
12

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de devarshishimpi/codra

Todos los issues de devarshishimpi/codra

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.