feat: Migrate to ultrathin monolith architecture
Consolidate 3 separate applications (reports-app, data-entry-app, telegram-bot) into a unified
architecture with single backend and frontend:
Backend Changes:
- Unified FastAPI backend at backend/ with modular structure
- Modules: reports, data_entry, telegram in backend/modules/
- Centralized config.py and main.py with all routers registered
- Single worker mode (--workers 1) for Telegram bot compatibility
- Shared Oracle connection pool and JWT authentication
- Unified requirements.txt and environment configuration
Frontend Changes:
- Single Vue.js SPA with module-based routing
- Unified frontend at src/ with modules in src/modules/{reports,data-entry}/
- Shared components and stores in src/shared/
- Error boundaries for module isolation
- Dual API proxy in Vite for module communication
Infrastructure:
- New unified startup scripts: start-prod.sh, start-test.sh, start-backend.sh
- Environment templates: .env.dev.example, .env.test.example, .env.prod.example
- Updated deployment scripts for Windows IIS
- Simplified SSH tunnel management
Documentation:
- Comprehensive CLAUDE.md with architecture overview
- Module-specific docs in docs/{data-entry,telegram}/
- Architecture decision records in docs/ARCHITECTURE-DECISIONS.md
- Deployment guides consolidated in deployment/windows/docs/
This migration reduces complexity, improves maintainability, and enables easier
deployment while maintaining all existing functionality.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
147
backend/.env.test.example
Normal file
147
backend/.env.test.example
Normal file
@@ -0,0 +1,147 @@
|
||||
# ============================================================================
|
||||
# ROA2WEB Unified Backend - Environment Configuration (TEST)
|
||||
# ============================================================================
|
||||
# TEST environment using Oracle TEST server (10.0.20.121)
|
||||
# Single backend process serving Reports, Data Entry, and Telegram modules
|
||||
# IMPORTANT: Never commit this file to git!
|
||||
|
||||
# ============================================================================
|
||||
# ORACLE DATABASE CONFIGURATION (REQUIRED - Shared by all modules)
|
||||
# ============================================================================
|
||||
# Connection to CONTAFIN_ORACLE schema for authentication and user management
|
||||
# TEST: Through SSH tunnel to 10.0.20.121 (localhost:1526)
|
||||
|
||||
ORACLE_USER=CONTAFIN_ORACLE
|
||||
ORACLE_PASSWORD=your_oracle_password_here
|
||||
ORACLE_HOST=localhost
|
||||
ORACLE_PORT=1526
|
||||
ORACLE_SID=roa
|
||||
|
||||
# TEST: Start SSH tunnel before running backend
|
||||
# ./ssh-tunnel-test.sh start
|
||||
|
||||
# ============================================================================
|
||||
# JWT AUTHENTICATION (REQUIRED - Shared by all modules)
|
||||
# ============================================================================
|
||||
# Used for JWT token generation and validation (shared/auth/jwt_handler.py)
|
||||
|
||||
JWT_SECRET_KEY=generate_with_secrets_token_urlsafe_32
|
||||
JWT_ALGORITHM=HS256
|
||||
|
||||
# Token expiration settings (used by shared/auth/jwt_handler.py)
|
||||
ACCESS_TOKEN_EXPIRE_MINUTES=480
|
||||
REFRESH_TOKEN_EXPIRE_DAYS=7
|
||||
|
||||
# ============================================================================
|
||||
# SESSION SECURITY - EMAIL 2FA (REQUIRED for Telegram email login)
|
||||
# ============================================================================
|
||||
# Used by Telegram module for session token validation
|
||||
# Must match between backend and Telegram bot
|
||||
|
||||
AUTH_SESSION_SECRET=generate_with_secrets_token_urlsafe_32
|
||||
|
||||
# ============================================================================
|
||||
# SERVER CONFIGURATION
|
||||
# ============================================================================
|
||||
# Unified backend server settings
|
||||
|
||||
API_HOST=0.0.0.0
|
||||
API_PORT=8000
|
||||
DEBUG=true
|
||||
|
||||
# CORS Origins (comma-separated, includes both old and new frontend ports)
|
||||
CORS_ORIGINS=http://localhost:3000,http://localhost:3010,http://localhost:5173
|
||||
|
||||
# ============================================================================
|
||||
# REPORTS MODULE - CACHE CONFIGURATION (OPTIONAL - defaults provided)
|
||||
# ============================================================================
|
||||
# Two-tier hybrid cache system (L1: in-memory LRU, L2: SQLite persistent)
|
||||
# Used by backend/modules/reports/cache/config.py
|
||||
|
||||
# Core Settings
|
||||
CACHE_ENABLED=True
|
||||
CACHE_TYPE=hybrid
|
||||
CACHE_SQLITE_PATH=./data/cache/roa2web_cache_test.db
|
||||
CACHE_MEMORY_MAX_SIZE=1000
|
||||
CACHE_DEFAULT_TTL=900
|
||||
|
||||
# TTL per Cache Type (seconds)
|
||||
CACHE_TTL_SCHEMA=86400
|
||||
CACHE_TTL_COMPANIES=1800
|
||||
CACHE_TTL_DASHBOARD_SUMMARY=1800
|
||||
CACHE_TTL_DASHBOARD_TRENDS=1800
|
||||
CACHE_TTL_INVOICES=600
|
||||
CACHE_TTL_INVOICES_SUMMARY=900
|
||||
CACHE_TTL_TREASURY=600
|
||||
|
||||
# Maintenance
|
||||
CACHE_CLEANUP_INTERVAL=3600
|
||||
|
||||
# Event-Based Invalidation (experimental)
|
||||
CACHE_AUTO_INVALIDATE=False
|
||||
CACHE_CHECK_INTERVAL=300
|
||||
|
||||
# Performance Tracking
|
||||
CACHE_TRACK_PERFORMANCE=True
|
||||
CACHE_BENCHMARK_ON_STARTUP=False
|
||||
|
||||
# ============================================================================
|
||||
# DATA ENTRY MODULE - CONFIGURATION
|
||||
# ============================================================================
|
||||
# Data Entry module settings (receipts, OCR, etc.)
|
||||
|
||||
# Environment identifier (dev/test/prod)
|
||||
ORACLE_ENV=test
|
||||
|
||||
# SQLite Database (test)
|
||||
SQLITE_DATABASE_PATH=data/receipts/receipts_test.db
|
||||
|
||||
# File uploads
|
||||
UPLOAD_PATH=data/receipts/uploads
|
||||
MAX_UPLOAD_SIZE_MB=10
|
||||
|
||||
# Test company (for testing)
|
||||
TEST_COMPANY_ID=110
|
||||
TEST_COMPANY_SCHEMA=MARIUSM_AUTO
|
||||
|
||||
# ============================================================================
|
||||
# TELEGRAM MODULE - BOT CONFIGURATION (REQUIRED for Telegram features)
|
||||
# ============================================================================
|
||||
# Obtain bot token from @BotFather on Telegram
|
||||
|
||||
TELEGRAM_BOT_TOKEN=your_bot_token_from_botfather
|
||||
|
||||
# Backend URL for bot to communicate with API
|
||||
BACKEND_URL=http://localhost:8000
|
||||
|
||||
# Internal API port (bot's internal API for backend callbacks)
|
||||
INTERNAL_API_PORT=8002
|
||||
|
||||
# Enable internal API documentation (development only)
|
||||
ENABLE_DOCS=false
|
||||
|
||||
# ============================================================================
|
||||
# TELEGRAM MODULE - EMAIL AUTHENTICATION (SMTP) (REQUIRED for email 2FA)
|
||||
# ============================================================================
|
||||
# Required for email-based 2FA authentication flow
|
||||
# Users can login with email + password instead of web app linking
|
||||
|
||||
# SMTP Server Configuration
|
||||
SMTP_HOST=mail.romfast.ro
|
||||
SMTP_PORT=587
|
||||
SMTP_USER=ups@romfast.ro
|
||||
SMTP_PASSWORD=your_smtp_password_here
|
||||
SMTP_FROM_EMAIL=ups@romfast.ro
|
||||
SMTP_FROM_NAME=ROA2WEB
|
||||
SMTP_USE_TLS=true
|
||||
|
||||
# Email Retry Settings
|
||||
EMAIL_MAX_RETRIES=3
|
||||
EMAIL_RETRY_DELAY=2.0
|
||||
|
||||
# ============================================================================
|
||||
# TELEGRAM MODULE - DATABASE (SQLite for bot data)
|
||||
# ============================================================================
|
||||
# Separate SQLite database for Telegram bot auth codes and sessions
|
||||
|
||||
TELEGRAM_SQLITE_DATABASE_PATH=data/telegram/telegram_test.db
|
||||
Reference in New Issue
Block a user