diff --git a/backend/README.md b/backend/README.md index b71a08d..8619de6 100644 --- a/backend/README.md +++ b/backend/README.md @@ -8,3 +8,19 @@ DB_CONNECTION=postgresql://postgres:password@database:5432/haystack_db?sslmode=d 2. Use `docker-compose up` to spin up the containers. You should be able to access the backend through port `3040` + +# Methods + +For now, we cheat and add a `userId` header which if os type `UUID`. Use the auto generated test one (fcc22dbb-7792-4595-be8e-d0439e13990a). + +- `GET /image` | Returns all of the users image, including tags, links and text any image contains. +- `GET /image/{imageId}` | Returns the actual image, use this to display images in the UI. +- `POST /image/{imageNameWithExtension}` | Sends an image to the backend, saves it and sents it to open ai to later process. + +# Architecture + +1. The user posts an image, which gets saved on our database (all data, including images are saved on DB). +2. We listen for table event creation, and we can process this image by sending it to OpenAI. +3. After OpenAI responds, we write to the database. + +This means that for now, we don't have a notification system to tell the user when their image is done processing. But will do in the future.