Merge pull request #1 from szeyu/feat/alan-1

Feat/alan-1

Author: szeyu

.env.example

@@ -15,7 +15,16 @@ PORT=3000
 # Higher values = fewer detections but higher accuracy
 FACE_DETECTION_CONFIDENCE_THRESHOLD=0.8
 
-# Project Data Directory (where uploaded images are stored)
-# This mimics S3/OSS bucket behavior - images are stored as files
-# and only their paths are stored in the database
-PROJECT_DATA_DIR=project_data
+# MinIO S3 Configuration
+# MinIO root credentials (for Docker Compose)
+MINIO_ROOT_USER=minioadmin
+MINIO_ROOT_PASSWORD=minioadmin123
+
+# S3 Client Configuration
+# Endpoint: Use http://minio:9000 inside Docker, http://localhost:9000 for local testing
+S3_ENDPOINT=http://localhost:9000
+S3_BUCKET=facevector-engine
+S3_ACCESS_KEY=minioadmin
+S3_SECRET_KEY=minioadmin123
+S3_REGION=us-east-1
+S3_FORCE_PATH_STYLE=true

CLAUDE.md

@@ -1,7 +1,7 @@
 include .env
 export
 
-.PHONY: install install-dev models dev db up down logs clean chmod-scripts reset run lint lint-fix test
+.PHONY: install install-dev models dev db up-db up-minio up down logs clean chmod-scripts reset run lint lint-fix test test-integration test-management
 
 # Install production Node dependencies only (for Docker/production)
 install:
@@ -19,9 +19,13 @@ lint: install-dev
 lint-fix: install-dev
 	npm run lint:fix
 
-# Run all tests (unit tests + integration tests)
-test: install-dev
-	npm test
+# Run integration test only
+test-integration: install-dev models up-db up-minio
+	S3_ENDPOINT=http://localhost:9000 npm test -- src/__tests__/integration.test.ts
+
+# Run management test only
+test-management: install-dev models up-db up-minio
+	S3_ENDPOINT=http://localhost:9000 npm test -- src/__tests__/management.test.ts
 
 # Download ONNX models locally into models/ (only if they don't exist)
 models:
@@ -42,12 +46,17 @@ models:
 	fi
 	@echo "✓ All models ready"
 
+
 # Launch only the Postgres service via Docker Compose
-db:
+up-db:
 	docker compose -f docker-compose.yml up -d db
 
-# Run the API locally
-run: install-dev models db
+# Launch only the MinIO service via Docker Compose
+up-minio:
+	docker compose -f docker-compose.yml up -d minio
+
+# Run the API locally (requires db and minio running)
+run: install-dev models up-db up-minio
 	npm run dev
 
 # Build and start the full stack (API + Postgres) with Docker Compose