tat-optimize/README.md

🧿 Tat Tvam Asi CLI — Chakra Diagnostic, Healing & Optimization Tool powered by Multidimensional Consciousness Coding. Ideal for DevOps mystics, spiritual engineers, and agentic AI orchestration.

# 🌀 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**
   ```bash
   git clone https://github.com/your-org/maca-max.git
   cd maca-max
   ```

2. **Install dependencies**
   ```bash
   yarn install
   ```

3. **Start the local mandala**
   ```bash
   docker-compose -f ops/docker-compose/docker-compose.yml up -d
   ```

4. **Build all packages**
   ```bash
   yarn build
   ```

5. **Start all services in development mode**
   ```bash
   yarn dev
   ```

## 🧪 Test Rituals

Run various test rituals to verify entity integrity:

```bash
# 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](./CONTRIBUTING.md) for development guidelines.

## 🔮 Seeking Wisdom

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