-
-
Notifications
You must be signed in to change notification settings - Fork 15
Open
Description
Problem
Users (e.g., @henry07) have reported a "network error" when trying to use the site's backend features (JJ chatbot, form results) on their local machines. This is primarily caused by a race condition where the backend container attempts to connect to the PostgreSQL database before the pgvector extension has finished building and the database is ready to accept connections.
Additionally, the development environment contains unnecessary Kubernetes/Devbox configuration files and documentation that clutter the project and confuse new contributors.
Proposed Changes
- Fix Backend Connectivity:
- Add a healthcheck to the
dbservice indocker-compose.yml. - Update the
backendservice to depend on thedbservice being healthy. - Add a restart policy to the
backendservice for better resilience.
- Add a healthcheck to the
- Environment Cleanup:
- Remove
devbox.json,devbox.lock, and the.devbox/directory. - Remove the
deploy/directory containing local Kubernetes manifests. - Remove
docker-compose.prod.ymlto simplify local development (keepingDockerfile.prodfor CI).
- Remove
- Documentation Improvements:
- Update
README.mdto clarify the Docker Compose setup and remove deprecated Kubernetes instructions. - Fix environment file typo in documentation (
config/env/env.dev->config/env/dev.env). - Update
CLAUDE.mdanddocs/DATABASE_CONNECTION.mdto reflect the simplified development environment.
- Update
Verification
- Run
docker compose up --buildand verify the backend waits for the database to be healthy. - Verify the frontend can successfully communicate with the backend services.
- Ensure no lingering references to Devbox or Kind remain in the active documentation.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels