Feature/crud item store

.env.example

@@ -0,0 +1,99 @@
+# ==================================
+# OpenTaberna API - Environment Configuration
+# ==================================
+#
+# Copy this file to .env and customize for your environment
+# Never commit .env files to version control!
+
+# ----------------------------------
+# Application
+# ----------------------------------
+APP_NAME=OpenTaberna API
+APP_VERSION=0.1.0
+ENVIRONMENT=development
+DEBUG=false
+SECRET_KEY=CHANGE_ME_IN_PRODUCTION
+
+# ----------------------------------
+# Server
+# ----------------------------------
+HOST=0.0.0.0
+PORT=8000
+WORKERS=1
+RELOAD=false
+
+# ----------------------------------
+# Database
+# ----------------------------------
+# PostgreSQL connection URL
+# Format: postgresql+asyncpg://user:password@host:port/database
+DATABASE_URL=postgresql+asyncpg://opentaberna:opentaberna@localhost:5432/opentaberna
+
+# Connection pool settings
+DATABASE_POOL_SIZE=20
+DATABASE_MAX_OVERFLOW=40
+DATABASE_POOL_TIMEOUT=30
+DATABASE_ECHO=false
+
+# ----------------------------------
+# Redis
+# ----------------------------------
+REDIS_URL=redis://localhost:6379/0
+# REDIS_PASSWORD=  # Load from Docker/K8s secret in production
+
+# ----------------------------------
+# Keycloak
+# ----------------------------------
+KEYCLOAK_URL=http://localhost:8080
+KEYCLOAK_REALM=opentaberna
+KEYCLOAK_CLIENT_ID=opentaberna-api
+# KEYCLOAK_CLIENT_SECRET=  # Load from Docker/K8s secret in production
+
+# ----------------------------------
+# CORS
+# ----------------------------------
+# Comma-separated list of allowed origins
+# Use ["*"] for development, specific domains in production
+CORS_ORIGINS=["*"]
+CORS_CREDENTIALS=true
+
+# ----------------------------------
+# Logging
+# ----------------------------------
+LOG_LEVEL=INFO
+LOG_FORMAT=console
+# LOG_FILE=/var/log/opentaberna/app.log
+
+# ----------------------------------
+# Cache
+# ----------------------------------
+CACHE_ENABLED=true
+CACHE_TTL=300
+
+# ----------------------------------
+# Rate Limiting
+# ----------------------------------
+RATE_LIMIT_ENABLED=true
+RATE_LIMIT_PER_MINUTE=60
+
+# ----------------------------------
+# Feature Flags
+# ----------------------------------
+FEATURE_WEBHOOKS_ENABLED=false
+
+# ==================================
+# Notes:
+# ==================================
+#
+# Sensitive values (passwords, secrets) should be loaded from:
+# - Docker secrets: /run/secrets/<secret_name>
+# - Kubernetes secrets: /var/run/secrets/<secret_name>
+# - Environment variables (uppercase with underscores)
+#
+# Example production setup:
+# - Store DATABASE_URL in /run/secrets/database_url
+# - Store REDIS_PASSWORD in /run/secrets/redis_password
+# - Store KEYCLOAK_CLIENT_SECRET in /run/secrets/keycloak_client_secret
+#
+# Generate secure SECRET_KEY:
+# python -c "import secrets; print(secrets.token_urlsafe(32))"

.gitignore

@@ -140,3 +140,5 @@ cython_debug/
 
 # PyCharm
 # .idea/
+
+.env.test

conftest.py

@@ -0,0 +1,12 @@
+"""
+Pytest configuration for the fastapi_opentaberna project.
+
+This file configures pytest to properly find and import modules.
+"""
+
+import sys
+from pathlib import Path
+
+# Add src directory to Python path
+src_path = Path(__file__).parent / "src"
+sys.path.insert(0, str(src_path))