Placeholdr backend

Signed-off-by: anuunchin <88698977+anuunchin@users.noreply.github.com>

Author: anuunchin

CONTRIBUTING.md

@@ -99,24 +99,20 @@ brew install node@20
 brew install python@3.11
 ```
 
-**Go 1.21+** (for WebRTC)
-```bash
-brew install go@1.21
-```
-
-
 **uv** (Python package manager)
 ```bash
 curl -LsSf https://astral.sh/uv/install.sh | sh
 # or on mac
 brew install uv
 ```
 
-**golangci-lint** (Go linter)
+**Docker** (for containerization)
 ```bash
-brew install golangci-lint
+brew install --cask docker
 ```
 
+## Development
+
 #### Install dependencies
 
 After installing the tools above, run:
@@ -128,15 +124,50 @@ make dev
 This will:
 - Install frontend dependencies (npm packages)
 - Create Python virtual environment and install backend dependencies
-- Download Go modules
 
-#### Running Linters
+#### Formatting
+
+Format your code before committing to maintain consistent style:
+
+```bash
+make format                # Format all code (frontend and backend)
+make format-frontend       # Format frontend with Prettier
+make format-backend        # Format backend with Ruff
+```
+
+#### Running linters
+
+Linting catches code issues and enforces style guidelines. Always run before pushing:
 
 ```bash
-make lint # Lint all components
-make lint-frontend # Lint frontend only
-make lint-backend # Lint backend only
-make lint-go # Lint Go code only
+make lint                  # Lint all components (includes type checking)
+make lint-frontend         # Lint frontend with ESLint
+make lint-backend          # Lint backend with Ruff
+make type-check-backend    # Type check backend with mypy
 ```
 
-Before you push your changes, run the linters above and address lint errors if any.
+Before you push your changes, run `make lint` and address any errors.
+
+#### Running tests
+
+```bash
+make test                  # Run all tests (frontend and backend)
+make test-frontend         # Run frontend tests with Vitest
+make test-backend          # Run backend tests with pytest
+```
+
+#### Docker commands
+
+Build and run Docker containers locally:
+
+```bash
+make docker-build          # Build all Docker images
+make docker-build-frontend # Build frontend image
+make docker-build-backend  # Build backend image
+
+make docker-run-frontend   # Run frontend container (opens browser)
+make docker-run-backend    # Run backend container (also opens browser)
+
+make docker-stop           # Stop all running containers
+make docker-clean          # Stop containers and remove images
+```

Makefile

@@ -1,4 +1,4 @@
-.PHONY: help lint lint-frontend lint-backend type-check-backend test test-frontend test-backend format format-frontend format-backend docker-build docker-build-frontend docker-build-backend docker-run-frontend docker-run-backend docker-clean
+.PHONY: help lint lint-frontend lint-backend type-check-backend test test-frontend test-backend format format-frontend format-backend docker-build docker-build-frontend docker-build-backend docker-run-frontend docker-run-backend docker-stop docker-clean
 
 help:
 	@echo "make"
@@ -38,12 +38,14 @@ help:
 	@echo "			runs frontend container on port 8080"
 	@echo "		docker-run-backend"
 	@echo "			runs backend container on port 8000"
+	@echo "		docker-stop"
+	@echo "			stops running containers"
 	@echo "		docker-clean"
-	@echo "			removes built Docker images"
+	@echo "			stops containers and removes Docker images"
 
 dev: install
 
-install: install-frontend install-backend install-go
+install: install-frontend install-backend
 
 install-frontend:
 	cd src/frontend && npm install
@@ -97,8 +99,16 @@ docker-run-frontend:
 	@echo "To stop: docker stop robot-frontend-dev"
 
 docker-run-backend:
-	docker run --rm -p 8000:8000 robot-backend:latest
+	@echo "Starting backend container..."
+	@docker run -d --rm -p 8000:8000 --name robot-backend-dev robot-backend:latest
+	@sleep 1
+	@echo "Opening browser at http://localhost:8000"
+	@open http://localhost:8000 || echo "Please open http://localhost:8000 in your browser"
+	@echo "To stop: docker stop robot-backend-dev"
+
+docker-stop:
+	@docker stop robot-frontend-dev robot-backend-dev 2>/dev/null || true
 
-docker-clean:
-	docker rmi robot-frontend:latest robot-backend:latest || true
+docker-clean: docker-stop
+	@docker rmi robot-frontend:latest robot-backend:latest || true
 

src/backend/main.py

@@ -1,11 +1,21 @@
-"""
-Minimal placeholder file for CI
-"""
+"""PLACEHOLDER"""
+
+from http.server import HTTPServer, BaseHTTPRequestHandler
+import json
 
 
 def hello() -> str:
     return "Hello from backend"
 
 
+class Handler(BaseHTTPRequestHandler):
+    def do_GET(self) -> None:
+        self.send_response(200)
+        self.send_header("Content-type", "application/json")
+        self.end_headers()
+        response = {"status": "ok", "message": hello()}
+        self.wfile.write(json.dumps(response).encode())
+
+
 if __name__ == "__main__":
-    print(hello())
+    HTTPServer(("0.0.0.0", 8000), Handler).serve_forever()

src/frontend/eslint.config.js

@@ -16,4 +16,3 @@ export default [
     },
   },
 ];
-