feat(docker): upgrade PostgreSQL and add performance tuning (#37)

- Upgrade PostgreSQL from 14.1 to 16-alpine
- Add performance tuning parameters:
  - max_connections=100
  - shared_buffers=128MB
  - work_mem=4MB
  - maintenance_work_mem=64MB
  - effective_cache_size=512MB
- Configure PGDATA explicitly for data organization
- Improve healthcheck with start_period for slower starts
- Update documentation with PostgreSQL settings

Co-authored-by: rafaelrsantosti <11065120+rafaelrsantosti@users.noreply.github.com>

Author: rafaelrsantosti

docker/README.md

@@ -270,6 +270,20 @@ docker compose -f docker-compose.prod.yaml run --rm certbot certonly --force-ren
   --webroot -w /var/www/certbot -d your-domain.com
 ```
 
+### PostgreSQL Performance
+
+The database is configured with optimized settings for production:
+
+| Parameter | Value | Description |
+|-----------|-------|-------------|
+| `max_connections` | 100 | Maximum concurrent connections |
+| `shared_buffers` | 128MB | Memory for caching data |
+| `work_mem` | 4MB | Memory per query operation |
+| `maintenance_work_mem` | 64MB | Memory for maintenance operations |
+| `effective_cache_size` | 512MB | Planner's assumption about cache |
+
+For high-traffic deployments, consider increasing these values based on available memory.
+
 ### Reset everything
 
 ```bash

docker/docker-compose.prod.yaml

@@ -27,22 +27,30 @@ services:
   # Database Services
   # =============================================================================
   database:
-    image: postgres:14.1-alpine
+    image: postgres:16-alpine
     profiles:
       - db
       - full
     environment:
       POSTGRES_USER: ${DB_USER:-tron}
       POSTGRES_PASSWORD: ${DB_PASSWORD:?DB_PASSWORD is required}
       POSTGRES_DB: api
+      PGDATA: /var/lib/postgresql/data/pgdata
+    command: >
+      postgres
+      -c max_connections=100
+      -c shared_buffers=128MB
+      -c work_mem=4MB
+      -c maintenance_work_mem=64MB
+      -c effective_cache_size=512MB
     volumes:
       - postgres_data:/var/lib/postgresql/data
     healthcheck:
       test: ["CMD-SHELL", "pg_isready -U ${DB_USER:-tron} -d api -h localhost"]
       interval: 10s
       timeout: 5s
-      retries: 5
-      start_period: 10s
+      retries: 10
+      start_period: 30s
     restart: unless-stopped
     networks:
       - tron-network

docker/docker-compose.yaml

@@ -23,21 +23,30 @@ x-env-api: &shared_env_api
 
 services:
   database:
-    image: postgres:14.1
+    image: postgres:16-alpine
     environment:
       - POSTGRES_USER=tron
       - POSTGRES_PASSWORD=tron
       - POSTGRES_MULTIPLE_DATABASES=api,portal
+      - PGDATA=/var/lib/postgresql/data/pgdata
+    command: >
+      postgres
+      -c max_connections=100
+      -c shared_buffers=128MB
+      -c work_mem=4MB
+      -c maintenance_work_mem=64MB
+      -c effective_cache_size=512MB
     ports:
       - "5432:5432"
     volumes:
       - ${PWD}/volumes/postgres:/var/lib/postgresql/data
       - ${PWD}/docker/db-entrypoint:/docker-entrypoint-initdb.d
     healthcheck:
       test: ["CMD-SHELL", "pg_isready -U tron -d api -h localhost"]
-      interval: 3s
-      timeout: 10s
+      interval: 5s
+      timeout: 5s
       retries: 10
+      start_period: 10s
 
   portal:
     build: