feat: enhance face-lock service with improved upload handling and response structure

- Updated README.md to reflect new features and API changes.
- Introduced versioning in app initialization.
- Enhanced configuration management in app/config.py with new validation functions.
- Refactored main.py to improve request handling and response generation.
- Added new models in app/models.py for structured API responses.
- Implemented a dedicated UI rendering function in app/ui.py.
- Improved Docker configuration for better security and health checks.
- Updated tests to cover new validation rules and response formats.
- Added CLAUDE.md for project guidelines and working rules.

docker-compose.yml

@@ -1,8 +1,28 @@
 services:
   face-lock:
-    build: .
+    build:
+      context: .
+    image: face-lock:local
     ports:
-      - "8100:8000"
+      - "${FACE_LOCK_PUBLISHED_PORT:-8100}:8000"
     env_file:
-      - .env
+      - path: .env
+        required: false
+    environment:
+      PORT: 8000
+      FACE_LOCK_HOST: 0.0.0.0
+    healthcheck:
+      test: ["CMD", "python", "-c", "from urllib.request import urlopen; raise SystemExit(0 if urlopen('http://127.0.0.1:8000/health', timeout=3).getcode() == 200 else 1)"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+      start_period: 20s
+    init: true
     restart: unless-stopped
+    read_only: true
+    tmpfs:
+      - /tmp
+    security_opt:
+      - no-new-privileges:true
+    cap_drop:
+      - ALL