🌀 MACA MAX - Aghoritantric Full-Stack Entity

A powerful, enterprise-grade application framework designed with Holistic Multivectoral Integration principles.

🔄 Elemental Tech Stack

• Frontend: React - Powerful component-based UI library
• Backend: Node.js/Express - High-performance async runtime
• Database: PostgreSQL with TypeORM - Robust relational database
• Messaging: NATS - Lightweight, high-throughput event bus
• Containerization: Docker - Predictable application packaging
• Orchestration: Kubernetes/Docker Compose - Container management
• Authentication: Firebase Auth - Robust identity management
• CI/CD: GitHub Actions - Automated build, test, and deployment

🧠 Consciousness Architecture

Our application follows a fractal, symbiotic architecture with the following core components:

.
├── apps/                   # Executable Applications
│   ├── api-gateway/        # API Gateway (External/Internal Harmonizer)
│   ├── frontend/           # User Interface (Experience Realm)
│   ├── notification-service/ # Notification Microservice
│   └── worker-service/     # Asynchronous Worker Service
│
├── packages/               # Shareable Code Modules
│   ├── @app/types/         # Core Type Definitions
│   ├── @app/api-client/    # Shared API Interaction Logic
│   ├── @app/domain/        # Domain Logic Primitives & Types
│   ├── @app/utils/         # General Utility Functions
│   └── @app/event-bus/     # NATS Event Bus Interaction Library
│
├── infra/                  # Infrastructure Configuration
│   ├── terraform/          # Cloud Infrastructure
│   └── kubernetes/         # Orchestration Configuration
│
├── ops/                    # Operational Scripts
│   ├── docker-compose/     # Local Environment
│   └── scripts/            # Utility Scripts
│
└── docs/                   # Documentation

🚀 Invoking the Entity (Setup)

Prerequisites

• Node.js 18+
• Yarn
• Docker & Docker Compose
• PostgreSQL
• NATS server

Local Manifestation

1. Clone the repository

   git clone https://github.com/your-org/maca-max.git
   cd maca-max

2. Install dependencies

   yarn install

3. Start the local mandala

   docker-compose -f ops/docker-compose/docker-compose.yml up -d

4. Build all packages

   yarn build

5. Start all services in development mode

   yarn dev

🧪 Test Rituals

Run various test rituals to verify entity integrity:

# Run all tests
yarn test

# Run unit tests only
yarn test:unit

# Run integration tests
yarn test:integration

# Run E2E tests
yarn test:e2e

📊 Observability

• API Documentation: http://localhost:3000/api-docs
• Metrics: http://localhost:3000/metrics
• Health Check: http://localhost:3000/healthz

🔐 Secure Passage (Authentication)

This application uses Firebase Authentication. Set up your Firebase project and update the configuration in the environment variables.

🌱 Evolutionary Cycle (Contributing)

Please see CONTRIBUTING.md for development guidelines.

🔮 Seeking Wisdom

For more detailed information, consult the documentation in the docs/ directory.