till/managarten
1
0
Fork 0
mirror of https://github.com/Memo-2023/mana-monorepo.git synced 2026-05-15 01:21:09 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
managarten/docs/README.md
Wuesteon 304897261d ✅ test: implement comprehensive automated testing system with daily CI/CD 
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
2025-12-25 19:12:27 +01:00

4.3 KiB
Raw Blame History

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
Set up environment variables Environment Setup
Understand the architecture Deployment Architecture
Work with databases Database Migrations
Deploy to staging Staging Setup
Deploy to production Deployment Runbooks
Use Docker locally Docker Guide
Debug an issue Staging Issues
Learn code patterns Guidelines
Configure CI/CD CI/CD Setup
Work with runtime config Runtime Config
Self-host the platform Self-Hosting Guide
Run and write tests Testing Guide

📁 Documentation Structure

Getting Started

First-time setup, environment configuration, and basic workflows.

Architecture & Design

System design, technology choices, and architectural patterns.

Development Workflows

Day-to-day development, migrations, and Docker.

Deployment & Operations

CI/CD, staging, production deployment, and operational procedures.

Specialized Topics

Project-Specific

Archived Documentation

Historical documentation and analysis reports moved to 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 for essential patterns
  • Reference Guidelines 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