Tecnically working,

- Tasks server working from multi-client POV
- Improvide documentation on starting the system

Author: alexrecuenco

.dockerignore

@@ -34,4 +34,4 @@
 **/build-*
 **/dist
 LICENSE
-README.md
+README*.md

README.md

@@ -2,36 +2,46 @@
 
 In order do as follows
 
-## Build
+## Setup
+
+### Docker
+
+1. Copy `dbpass.txt.example` to `dbpass.txt` and set a password
+2. Copy `password-file.txt.example` to `password-file.txt` and set the same password
+
+
+### Local
+
+1. Install **node 22**
+2. Run `npm install`
+
+
+## Local Development
+
+### Build
+
+Only required for local development
 
 ```bash
 npm run build -ws
 ```
 
-## Test
+### Test
 
 ```bash
 npm run test -ws
 ```
 
-## Prepare database
+### Prepare database
 
 ```bash
 # at a separate terminal run this and keep running
 docker compose -f compose.yaml -f compose.debug.yaml up db
-# In a separate terminal
+# In a separate terminal, (I believe postgresql does this automatically)
 npm run db:prepare -w backend
 ```
 
-## Launch
-
-### *production mode*
-
-```bash
-docker compose up
-```
-
-App will be accessible on port 8080
+### Launch
 
 ### Hot-reload mode
 
@@ -51,7 +61,15 @@ docker compose -f compose.yaml -f compose.debug.yaml down -v db
 npm run clean -ws --if-present
 ```
 
-Access `http://localhost:3000/tasks/debug/populate` to populate a few tasks
+Access `http://localhost:3000/tasks/debug/populate` to populate a few tasks (or click the populate button)
+
+## Docker *deployment*
+
+```bash
+docker compose up
+```
+
+App will be accessible on port 8080
 
 ### Launch in debug mode
 

compose.yaml

@@ -8,7 +8,6 @@
 # database or a cache. For examples, see the Awesome Compose repository:
 # https://github.com/docker/awesome-compose
 services:
-
   frontend:
     build:
       context: .
@@ -17,7 +16,8 @@ services:
       BACKEND_URL: http://backend:3000
       PORT: 8080
     depends_on:
-      - backend
+      backend:
+        condition: service_healthy
     ports:
       - 8080:8080
   backend:
@@ -27,6 +27,11 @@ services:
     environment:
       NODE_ENV: production
       PORT: 3000
+      PGPASSWORDFILE: /run/secrets/db-password
+      PGHOST: db
+      PGUSER: postgres
+      PGPORT: 5432
+      PGDATABASE: taskdb
     ports:
       - 3000:3000
     depends_on:
@@ -35,10 +40,16 @@ services:
     secrets:
       - db-password
     healthcheck:
-      test: ["CMD", "curl --fail http://localhost:3000/health"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
+      test:
+        # node
+        [
+          'CMD',
+          'wget --no-verbose --server-response --tries=1
+          --spider  http://localhost:3000/v1/health',
+        ]
+      interval: 5s
+      timeout: 1s
+      retries: 3
   db:
     image: postgres:17-alpine
     restart: always
@@ -47,18 +58,25 @@ services:
       - db-password
     volumes:
       - db-data:/var/lib/postgresql/data
+      - ./packages/backend/db:/docker-entrypoint-initdb.d:ro
     environment:
       POSTGRES_DB: taskdb
       POSTGRES_PASSWORD_FILE: /run/secrets/db-password
     expose:
       - 5432
+    ports:
+      - 5432:5432
+
     healthcheck:
-      test: [ "CMD", "pg_isready" ]
-      interval: 10s
-      timeout: 5s
-      retries: 5
+      test: ['CMD', 'pg_isready']
+      interval: 5s
+      timeout: 1s
+      retries: 3
+
 volumes:
   db-data:
 secrets:
   db-password:
-    file: db/password.txt
+    file: db/dbpass.txt
+  db-passwordfile:
+    file: db/password-file.txt

db/dbpass.example

@@ -0,0 +1 @@
+YOUR_PGPASSWORD_HERE

db/password-file.txt.example

@@ -0,0 +1,4 @@
+# https://www.postgresql.org/docs/current/libpq-pgpass.html
+# hostname:port:database:username:password
+# copy this file to password.txt in this same folder
+*:*:*:postgres:YOUR_PGPASSWORD_HERE