Created
February 23, 2026 16:22
-
-
Save vickybiswas/a95518ad99ac813ae1958652899e412f to your computer and use it in GitHub Desktop.
Full Stack & DevOps
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| INCLUDE: | |
| - 1. PRD document | |
| - 2. OpenAPI.json file | |
| - 3. DB as SQL file | |
| - 4. A mapping JSON file mapping openapi and sql | |
| - 5. Frontend and Backend code | |
| OUTPUT: | |
| - 1. docker compose and other files to ensure "docker compose up" is enough to run an integrated backend and frontend connected to Supabase. | |
| - 2. fixes for any issues in frontend or backend code | |
| SPEC: | |
| - Outcomes | |
| - - Using the existing code (`/backend` OpenAPI server, `/frontend` V0 UI) and the existing Supabase DB, produce Docker file(s) and a "docker compose" setup that runs frontend on 3003 and backend on 8003 with hot reload, and prove all 3 are connected and wired for Auth, CORS, and access (frontend → backend; backend → DB) | |
| - - fixes to any issues found. in frontend or backend, keeping OpenAPI and SQL as sources of truth. | |
| - Constraints | |
| - - Read and Deeply Understand/relate to the files to identify FastAPI backend and React frontend structure in light of the files in the docs folder | |
| - - Create Dockercompose and other files to ensure working app with frontend(on 3003) and backend(on 8003) that can be run using a single docker compose up command, which persist data to Supabase (add shared creds to .env file) use docker container name to connect to the backend like http:/backend:8003 so it doesnot need a seprate tunnel an can directly allows the frontend and backend connection | |
| - - Validate and ensure backend code exposes API with Verbatim adherence to OpenAPI (endpoints, schemas, status/error codes) guided by mappings to integrate with db.sql. That CoRS and authentication /login, etc is properly handled, and hot reloading is happening | |
| - - Validate and ensure frontend code exposes all the desired user and admin functionalities based on access level/role of the user using hooks in data component as the only layer between frontend and backend. Also, the data layer can easily switch between mock (Faker driven) and api (backend fastapi driven) based on localstorage setting and that hot reloading is active on the frontend/backend. | |
| - - Validate robust UUID Handling across all backend (routes and services) and all frontend code (including mock & api) and that we use/convert IDs to valid consistent UUID formats. | |
| - - Error handling in backend must be explicit and high-quality, including DB/RLS/constraint failures, and must be translated into the OpenAPI-defined error responses (no raw 500s). The frontend should be able to respectively show them. | |
| - Validations | |
| - - docker compose up should get React and Fastapi running and connected with each other and Supabase | |
| - - ui can sign in to the backend using the login API | |
| - - data component defaults to api instead of mock, and using UI is connected to backend and can create/view data in events, etc., persisted to Supabase DB | |
| - - creation of Event leads to creating the relevant tasks in the Kanban |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment