init commit

.env.example

@@ -0,0 +1,82 @@
+# Finance Bot - Environment Configuration Template
+# Copy this file to .env and fill in your actual values
+# IMPORTANT: Never commit .env file to version control!
+
+# ============================================================================
+# TELEGRAM BOT CONFIGURATION
+# ============================================================================
+
+# Telegram Bot Token obtained from BotFather
+# Get your token from: https://t.me/BotFather
+BOT_TOKEN=your_telegram_bot_token_here
+
+# Your Telegram User ID (for admin commands)
+# Get your ID from: https://t.me/userinfobot
+BOT_ADMIN_ID=123456789
+
+
+# ============================================================================
+# DATABASE CONFIGURATION
+# ============================================================================
+
+# Full PostgreSQL Connection URL
+# For local development: postgresql+psycopg2://username:password@localhost:5432/database
+# For Docker: postgresql+psycopg2://username:password@postgres:5432/database
+DATABASE_URL=postgresql+psycopg2://finance_user:your_password@localhost:5432/finance_db
+
+# Enable SQL echo (debug mode)
+DATABASE_ECHO=false
+
+# Database credentials (used by Docker Compose)
+DB_USER=finance_user
+DB_PASSWORD=your_database_password_here
+DB_NAME=finance_db
+
+
+# ============================================================================
+# REDIS CONFIGURATION (Cache)
+# ============================================================================
+
+# Redis connection URL
+# For local development: redis://localhost:6379/0
+# For Docker: redis://redis:6379/0
+REDIS_URL=redis://localhost:6379/0
+
+
+# ============================================================================
+# APPLICATION CONFIGURATION
+# ============================================================================
+
+# Application environment (development|production|staging)
+APP_ENV=development
+
+# Enable debug mode (disable in production)
+APP_DEBUG=false
+
+# Logging level (DEBUG|INFO|WARNING|ERROR|CRITICAL)
+LOG_LEVEL=INFO
+
+# Timezone (IANA timezone identifier)
+TZ=Europe/Moscow
+
+
+# ============================================================================
+# API CONFIGURATION
+# ============================================================================
+
+# API server host (0.0.0.0 for Docker, localhost for local)
+API_HOST=0.0.0.0
+
+# API server port
+API_PORT=8000
+
+
+# ============================================================================
+# OPTIONAL: ADDITIONAL SERVICES
+# ============================================================================
+
+# Add any additional configuration here as needed
+# Examples:
+# - SENTRY_DSN=https://...  (error tracking)
+# - SLACK_WEBHOOK=https://...  (notifications)
+# - AWS_ACCESS_KEY_ID=...  (cloud storage)