Merge branch 'main' into feat/582-dark-light-theme-toggle

Author: Nuel-ship-it

.codex

@@ -0,0 +1,8 @@
+{
+  "words": [
+    "Soroban", "soroban", "UUPS", "contractimpl", "contracterror",
+    "contracttype", "cdylib", "rlib", "testutils", "delegatecall",
+    "timelock", "Timelock", "TIMELOCK", "reentrancy", "Reentrancy",
+    "trsry"
+  ]
+}

.cspell.json

@@ -0,0 +1,145 @@
+# Environment Configuration Template for Redis Caching Layer
+# Copy this to .env and adjust values for your environment
+
+# ============================================
+# Database Configuration
+# ============================================
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/web3-student-lab?schema=public
+
+# ============================================
+# Redis Configuration - Choose one mode
+# ============================================
+
+# Redis Mode: standalone, sentinel, or cluster
+REDIS_MODE=standalone
+
+# ============================================
+# STANDALONE MODE (Development)
+# ============================================
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_PASSWORD=
+
+# ============================================
+# SENTINEL MODE (High Availability)
+# ============================================
+# Uncomment these and set REDIS_MODE=sentinel to use Sentinel
+# REDIS_SENTINELS=localhost:26379,localhost:26380,localhost:26381
+# REDIS_SENTINEL_NAME=mymaster
+# REDIS_SENTINEL_PASSWORD=
+
+# ============================================
+# CLUSTER MODE (Distributed)
+# ============================================
+# Uncomment these and set REDIS_MODE=cluster to use Cluster
+# REDIS_CLUSTER_NODES=localhost:6381,localhost:6382,localhost:6383
+# REDIS_CLUSTER_PASSWORD=
+
+# ============================================
+# Cache Warming Configuration
+# ============================================
+
+# Interval (in milliseconds) for periodic cache warming
+CACHE_WARMING_INTERVAL=300000  # 5 minutes
+
+# Interval (in milliseconds) for polling new blocks
+BLOCK_POLL_INTERVAL=10000  # 10 seconds
+
+# ============================================
+# Instance Configuration
+# ============================================
+
+# Unique identifier for this backend instance (used in clustering)
+INSTANCE_ID=backend-1
+
+# Node environment
+NODE_ENV=development
+
+# ============================================
+# JWT Configuration
+# ============================================
+JWT_SECRET=your-secret-key-change-in-production
+
+# ============================================
+# Application Configuration
+# ============================================
+
+# Stellar Network: testnet, mainnet, or local
+STELLAR_NETWORK=testnet
+
+# Soroban RPC URL
+SOROBAN_RPC_URL=https://soroban-testnet.stellar.org
+
+# Horizon API URL
+HORIZON_URL=https://horizon-testnet.stellar.org
+
+# Certificate Contract ID
+CERTIFICATE_CONTRACT_ID=
+
+# API Base URL
+API_BASE_URL=http://localhost:8080
+
+# Certificate Metadata Base URL
+CERT_METADATA_BASE_URL=http://localhost:8080
+
+# Certificate Image Base Path
+CERT_IMAGE_BASE_PATH=
+
+# Verification URL
+VERIFICATION_URL=http://localhost:8080/api/v1/certificates/verify
+
+# Issuer DID
+ISSUER_DID=did:stellar:GBRPYHIL2CI3FYQMWVUGE62KMGOBQKLCYJ3HLKBUBIW5VZH4S4MNOWT
+
+# Issuer Name
+ISSUER_NAME=Web3 Student Lab
+
+# ============================================
+# Logging Configuration
+# ============================================
+
+# Log level: debug, info, warn, error
+LOG_LEVEL=info
+
+# ============================================
+# Cache Configuration (Advanced)
+# ============================================
+
+# Maximum memory for Redis (used in docker-compose)
+# Examples: 256mb, 512mb, 1gb
+REDIS_MAX_MEMORY=256mb
+
+# Memory eviction policy
+# Options: noeviction, allkeys-lru, allkeys-lfu, volatile-lru, volatile-lfu, volatile-ttl, volatile-random, allkeys-random
+REDIS_MAX_MEMORY_POLICY=allkeys-lru
+
+# Enable Redis persistence
+REDIS_APPEND_ONLY=yes
+
+# ============================================
+# Performance Tuning
+# ============================================
+
+# Database connection pool size
+DB_POOL_MIN=5
+DB_POOL_MAX=20
+
+# Request timeout (milliseconds)
+REQUEST_TIMEOUT=30000
+
+# RPC call timeout (milliseconds)
+RPC_TIMEOUT=10000
+
+# ============================================
+# Development/Debugging
+# ============================================
+
+# Enable debug logging for cache operations
+DEBUG_CACHE=false
+
+# Enable debug logging for RPC calls
+DEBUG_RPC=false
+
+# Enable CORS for development
+CORS_ENABLED=true
+CORS_ORIGIN=http://localhost:3000

.env.example

@@ -0,0 +1,48 @@
+name: Frontend E2E
+
+on:
+  pull_request:
+    paths:
+      - 'frontend/**'
+      - '.github/workflows/frontend-e2e.yml'
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - 'frontend/**'
+      - '.github/workflows/frontend-e2e.yml'
+
+jobs:
+  playwright:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: frontend
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install Playwright browsers
+        run: npx playwright install --with-deps
+
+      - name: Run Playwright tests
+        run: npm run test:e2e
+
+      - name: Upload Playwright report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report
+          path: frontend/playwright-report/
+          retention-days: 7