switch to using port 3000 between backend and frontend

Author: yangm2

README.md

@@ -173,7 +173,7 @@ As an alternative to the local development setup above, you can use containers f
    container run \
      --name frontend \
      --remove \
-     --env VITE_API_URL=http://localhost:5000 \
+     --env VITE_API_URL=http://localhost:3000 \
      -v ./frontend/src:/app/src:ro \
      -v ./frontend/public:/app/public:ro \
      -v ./frontend/index.html:/app/index.html:ro \
@@ -204,7 +204,7 @@ As an alternative to the local development setup above, you can use containers f
      -v ./backend/tests:/app/tests:ro \
      -v ./backend/scripts:/app/scripts:ro \
      -v ${GOOGLE_APPLICATION_CREDENTIALS_HOST}:/app/secrets/google-creds.json \
-     --publish 5000:5000 \
+     --publish 3000:5000 \
      backend-dev:latest &
    # execute interactive shell in backend container
    container exec -it backend /bin/sh
@@ -226,6 +226,7 @@ As an alternative to the local development setup above, you can use containers f
 
   on MacOS with `apple/container`
   ```bash
+  cd backend && make clean  # __pycache__ dirs are bind'd-in to containers as read-only so delete them
   container exec backend make lint
   container exec backend make typecheck
   container exec backend make test
@@ -258,6 +259,7 @@ docker compose down
 On MacOS with [`apple/container`](https://github.com/apple/container) (>= 0.9.0):
    ```bash
    container stop --all
+   container system stop
    ```
 
 ### Troubleshooting

docker-compose.yml

@@ -7,7 +7,8 @@ services:
         TYPE: dev
     container_name: tenantfirstaid-backend-dev
     ports:
-      - "5000:5000"
+      # we map port 3000 on the host to avoid MacOS conflict with ControlCenter
+      - "3000:5000"
     volumes:
       # Mount source for hot reload
       - ./backend/tenantfirstaid:/app/tenantfirstaid:ro
@@ -39,6 +40,7 @@ services:
         TYPE: dev
     container_name: tenantfirstaid-frontend-dev
     ports:
+      # Map port 5173 in the container to port 5173 on the host for Vite dev server
       - "5173:5173"
     volumes:
       # Mount source for hot reload
@@ -47,7 +49,7 @@ services:
       - ./frontend/index.html:/app/index.html:ro
       - ./frontend/vite.config.ts:/app/vite.config.ts:ro
     environment:
-      - VITE_API_URL=http://localhost:5000
+      - VITE_API_URL=http://localhost:3000
     depends_on:
       - backend
     networks: