mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-14 23:01:09 +02:00
304897261d
Implement rock-solid automated testing infrastructure for mana-core-auth with daily execution, notifications, and comprehensive monitoring. Test Suite Improvements: - Fix all 36 failing BetterAuthService tests (missing service mocks) - Add 21 JwtAuthGuard tests achieving 100% statement coverage - Create silentError helper to suppress intentional error logs - Fix Todo backend TaskService test structure - Add jose mock for JWT testing - Configure jest collectCoverageFrom for mana-core-auth GitHub Actions Workflow: - Daily automated test execution (2 AM UTC + manual trigger) - Matrix parallelization across 6 backend services - PostgreSQL and Redis service containers - Coverage enforcement (80% threshold) - Multi-channel notifications (Discord, Slack, GitHub Issues) - Support for success notifications (opt-in) Test Infrastructure: - Coverage aggregation across multiple services - Flaky test detection with 30-run history tracking - Performance metrics tracking with regression detection - Test data seeding and cleanup scripts - Comprehensive test reporting with formatted metrics Documentation: - TESTING_GUIDE.md (4000+ words) - Complete testing documentation - AUTOMATED_TESTING_SYSTEM.md - System architecture and workflows - DISCORD_NOTIFICATIONS_SETUP.md - Discord webhook setup guide - TESTING_DEPLOYMENT_CHECKLIST.md - Pre-deployment verification - TESTING_QUICK_REFERENCE.md - Quick command reference Final Result: - 180/180 tests passing (100% pass rate) - Zero console errors in test output - Automated daily testing with rich notifications - Production-ready test infrastructure
94 lines
4.3 KiB
Markdown
94 lines
4.3 KiB
Markdown
# Manacore Monorepo Documentation
|
|
|
|
Welcome to the Manacore monorepo documentation. This guide helps you find exactly what you need.
|
|
|
|
## 🚀 Quick Navigation
|
|
|
|
| I want to... | Go here |
|
|
|-------------|---------|
|
|
| **Start developing locally** | [Local Development](getting-started/local-development.md) |
|
|
| **Set up environment variables** | [Environment Setup](../CLAUDE.md#environment-variables) |
|
|
| **Understand the architecture** | [Deployment Architecture](DEPLOYMENT_ARCHITECTURE.md) |
|
|
| **Work with databases** | [Database Migrations](DATABASE_MIGRATIONS.md) |
|
|
| **Deploy to staging** | [Staging Setup](STAGING_SETUP.md) |
|
|
| **Deploy to production** | [Deployment Runbooks](DEPLOYMENT_RUNBOOKS.md) |
|
|
| **Use Docker locally** | [Docker Guide](DOCKER_GUIDE.md) |
|
|
| **Debug an issue** | [Staging Issues](STAGING_DEPLOYMENT_ISSUES.md) |
|
|
| **Learn code patterns** | [Guidelines](../.claude/GUIDELINES.md) |
|
|
| **Configure CI/CD** | [CI/CD Setup](CI_CD_SETUP.md) |
|
|
| **Work with runtime config** | [Runtime Config](RUNTIME_CONFIG.md) |
|
|
| **Self-host the platform** | [Self-Hosting Guide](SELF-HOSTING-GUIDE.md) |
|
|
| **Run and write tests** | [Testing Guide](TESTING_GUIDE.md) |
|
|
|
|
## 📁 Documentation Structure
|
|
|
|
### Getting Started
|
|
First-time setup, environment configuration, and basic workflows.
|
|
- [Local Development](LOCAL_DEVELOPMENT.md) - Complete local development setup
|
|
- [Setup Templates](SETUP_TEMPLATES.md) - Templates for new projects
|
|
|
|
### Architecture & Design
|
|
System design, technology choices, and architectural patterns.
|
|
- [Deployment Architecture](DEPLOYMENT_ARCHITECTURE.md) - Complete infrastructure overview
|
|
- [Deployment Diagrams](DEPLOYMENT_DIAGRAMS.md) - Visual architecture diagrams
|
|
|
|
### Development Workflows
|
|
Day-to-day development, migrations, and Docker.
|
|
- [Database Migrations](DATABASE_MIGRATIONS.md) - Migration best practices
|
|
- [Docker Guide](DOCKER_GUIDE.md) - Local Docker setup
|
|
- [Git Workflow](GIT_WORKFLOW.md) - Git branching and commit conventions
|
|
- [Development Scripts](DEVELOPMENT_SCRIPTS.md) - Helper scripts
|
|
|
|
### Deployment & Operations
|
|
CI/CD, staging, production deployment, and operational procedures.
|
|
- [Deployment Overview](DEPLOYMENT.md) - Deployment strategy overview
|
|
- [Deployment Runbooks](DEPLOYMENT_RUNBOOKS.md) - Step-by-step deployment procedures
|
|
- [Staging Setup](STAGING_SETUP.md) - Hetzner staging environment
|
|
- [Staging Issues](STAGING_DEPLOYMENT_ISSUES.md) - Known issues and solutions
|
|
- [Hetzner Production Guide](HETZNER_PRODUCTION_GUIDE.md) - Production deployment
|
|
- [CI/CD Setup](CI_CD_SETUP.md) - GitHub Actions configuration
|
|
- [Runtime Config](RUNTIME_CONFIG.md) - Dynamic configuration injection
|
|
|
|
### Specialized Topics
|
|
- [PWA Guide](PWA_GUIDE.md) - Progressive Web App setup
|
|
- [I18N](I18N.md) - Internationalization
|
|
- [User Settings](USER_SETTINGS.md) - User settings architecture
|
|
- [Self-Hosting Guide](SELF-HOSTING-GUIDE.md) - Self-hosting instructions
|
|
- [Testing Guide](TESTING_GUIDE.md) - Comprehensive testing documentation
|
|
- [Testing Quick Reference](TESTING_QUICK_REFERENCE.md) - Common testing commands and patterns
|
|
|
|
### Project-Specific
|
|
- [ManaDeck Postgres Migration](MANADECK_POSTGRES_MIGRATION.md) - ManaDeck database migration
|
|
- [Uload Deployment](ULOAD-DEPLOYMENT.md) - Uload-specific deployment
|
|
|
|
### Archived Documentation
|
|
Historical documentation and analysis reports moved to [archive/](archive/).
|
|
|
|
## 🎯 Documentation Philosophy
|
|
|
|
This documentation follows these principles:
|
|
|
|
1. **Progressive Disclosure** - Start with essentials, link to deep dives
|
|
2. **Single Source of Truth** - Each topic has one authoritative document
|
|
3. **Task-Oriented** - Organized by what you're trying to accomplish
|
|
4. **Keep Current** - Archive or delete outdated docs instead of letting them linger
|
|
|
|
## 📝 For AI Assistants
|
|
|
|
If you're Claude or another AI assistant:
|
|
- Start with [CLAUDE.md](../CLAUDE.md) for essential patterns
|
|
- Reference [Guidelines](../.claude/GUIDELINES.md) for detailed coding patterns
|
|
- Use this README to find specific documentation topics
|
|
- Always check file modification dates to ensure information is current
|
|
|
|
## 🔄 Maintenance
|
|
|
|
When updating documentation:
|
|
- Update this README if you add/move/remove major docs
|
|
- Archive outdated docs to `archive/` rather than deleting
|
|
- Keep cross-references up to date
|
|
- Update the modification date in this file
|
|
|
|
---
|
|
|
|
**Last Updated:** 2025-12-25
|