cinnabarflower/mnemo_cards
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
mnemo_cards/PROGRESS.md
Dmitry a92cade04f
Some checks failed
Backend CI / test (push) Waiting to run
Details
Backend CI / build (push) Blocked by required conditions
Details
Deploy Mnemo Cards / Deploy Backend (push) Waiting to run
Details
Deploy Mnemo Cards / Deploy Web App (push) Blocked by required conditions
Details
Deploy Mnemo Cards / Final Verification (push) Blocked by required conditions
Details
Deploy Telegram Bot / Deploy Telegram Bot (push) Has been cancelled
Details
Return debug info in API response for admin auth errors 
This will show the exact reason for token verification failure
2025-12-12 01:05:05 +03:00

7.3 KiB
Raw Blame History

2025-12-07

  • Добавлена подробная инструкция по миграции в Coolify (Docker backend, статический web/admin, внешняя БД) — docs/coolify-migration.md.

Mnemo Cards Project Progress

Infrastructure & Deployment

✅ Completed Tasks

  • nginx Configuration System: Implemented robust nginx configuration generation and deployment

    • Created generate-nginx-configs.sh for generating all nginx configurations
    • Created deploy-nginx-configs.sh for safe deployment with validation
    • Updated check-nginx.sh with port conflict detection and cleanup
    • Integrated into CI/CD pipeline

  • Reverse Proxy Architecture: Properly configured nginx as reverse proxy for all services

    • mnemo-cards.online → Flutter web app (static files)
    • code.mnemo-cards.online → Forgejo (port 3000)
    • vscode.mnemo-cards.online → VSCode Server (port 8443)

  • Automated Version Management: Implemented pre-deploy version bumping

    • Created bump-version.sh script for automatic version increment
    • Integrated as pre-hook in CI/CD pipeline
    • Updates both pubspec.yaml and API configuration
    • Automatic git commit with version changes

  • SSL/TLS Configuration: Secure HTTPS setup with Let's Encrypt certificates

    • Multi-domain certificates for all subdomains
    • Proper certificate permissions and renewal

  • Admin API Configuration: Fixed admin authentication routing

    • Admin panel now correctly routes authentication requests to production backend
    • Prevents localhost:8000 routing issues during development
    • Separate API client for admin endpoints ensures proper server targeting

  • Service Reliability: Enhanced service management and monitoring

    • Port conflict detection and resolution
    • Orphaned process cleanup
    • Configuration validation before deployment
    • Emergency fallback configurations
    • Coolify container orchestration platform deployed

🔄 In Progress

  • Coolify Migration: Container orchestration platform for services
    • Coolify installed and configured on coolify.mnemo-cards.online
    • Automatic startup configured via cron @reboot
    • Ready for service migration (backend, web, admin)
  • Monitoring & Alerting: Implement comprehensive service monitoring
  • Backup Automation: Automated backup procedures for all services

📋 Planned Tasks

  • Load Balancing: Implement load balancing for high availability
  • CDN Integration: Content delivery network for static assets
  • Security Hardening: Additional security measures and hardening

Development Status

Web Application (mnemo_cards_web_v2)

  • Framework: Flutter Web
  • Status: Active development
  • Key Features: Vocabulary learning, testing, statistics
  • Recent Updates:
    • Added card voice support (metadata, API, web playback with error UI)
      • New voices collection linked to cards and public endpoints for list/mp3
      • Web CardViewer now fetches voices and plays audio via audioplayers
      • Added unit tests for API config and voice fetching
    • Added app version display on authentication page
    • UI Components Refactoring: Extracted authentication components
      • Created SignInWithGoogleButton component for Google authentication
      • Created SignInWithTelegram component for Telegram authentication
      • Improved code maintainability and reusability
    • Profile Page UI/UX Improvements: Enhanced profile page design and functionality
      • Removed guest view - profile now only accessible for authenticated users
      • Removed account statistics (packs/purchases) from profile
      • Removed language toggle from settings
      • Created custom ThemeToggleWidget with sun/moon icons and animations
      • Enhanced subscription section with premium badge and upgrade button for free users
      • Added staggered animations for card appearances
      • Improved logout flow with confirmation dialog
      • Added comprehensive unit tests for new components
  • Game/Test Flow Cleanup: Simplified testing UX and fixed theme visuals
    • Removed legacy traditional test entry from test_page.dart (interactive mode only)
    • Added SafeArea wrapping and themed question cards on game_page.dart
    • Added widget tests for themed question cards, exit control, and interactive-only notice
    • Timer/progress now sourced from live session state on game_page.dart
  • Game Tests Package: Started shared package games/packages/game_tests
    • Added configurable GameTestSettings (sounds/haptics/delay)
    • Integrated into mnemo_cards_web_v2 via TestsModule/TestsStateManager
    • Test Page Code Quality Fix: Fixed critical code duplication and compilation issues
      • Removed 700+ lines of duplicate code in test_page.dart
      • Added missing state variables for test functionality
      • Created TestResult class for proper result handling
      • Fixed deprecated withOpacity method calls
      • Restored full test functionality with interactive game and traditional test modes
    • PackDetailsHeader Code Fix: Fixed critical structural issues in pack details header widget
      • Resolved broken method structure with hanging code blocks
      • Created missing _buildTitleSection method
      • Removed undefined cachedImage variable usage
      • Cleaned up unused imports
      • Fixed all linter errors and compilation issues

Mobile Application (mnemo_cards)

  • Framework: Flutter
  • Status: Active development
  • Key Features: Cross-platform mobile app

Backend (mnemo_cards_backend)

  • Framework: Dart with Shelf
  • Status: Production ready
  • Key Features: API, authentication, data management

Common Libraries

  • mnemo_cards_common: Shared models and utilities
  • mnemo_cards_common_backend: Backend-specific common code
  • mnemo_cards_frontend_common: Frontend-specific common code

Testing

Unit Tests

  • Coverage: Basic test coverage implemented
  • Status: Ongoing - needs expansion

Integration Tests

  • Status: Minimal - needs implementation

E2E Tests

  • Status: Not implemented

Deployment Pipeline

CI/CD Status

  • Platform: Forgejo Actions (self-hosted)

  • Triggers: Push to master branch

  • Jobs:

    • Backend deployment
    • Web application deployment
    • Admin panel deployment (improved portability)
    • Telegram bot deployment
    • Nginx configuration deployment
    • Service verification

  • Deployment Script Improvements:

    • Enhanced admin panel deployment script portability
    • Script can now be run from any directory within the project
    • Automatic project root detection and navigation
    • Improved error handling and user feedback

Environments

  • Production: 147.45.152.129 (mnemo-cards.online)
  • Development: Local development environments

Performance Metrics

Target Metrics

  • Page Load Time: < 3 seconds
  • API Response Time: < 500ms
  • Uptime: 99.9%

Current Status

  • Basic monitoring in place
  • Performance optimization ongoing

Security

Implemented

  • HTTPS enforcement
  • SSL/TLS certificates (Let's Encrypt for all domains including admin.mnemo-cards.online)
  • Automated SSL certificate renewal
  • Basic firewall rules
  • Service isolation

Planned

  • Advanced security headers
  • Rate limiting
  • Intrusion detection
  • Regular security audits

Last updated: December 10, 2025