# Architecture Overview

## Eventify Ecosystem

Eventify is a multi-project event management platform with **4 frontends**, a **Django backend**, and **Docker-based infrastructure** on AWS EC2.

```
┌─────────────────────────────────────────────────────┐
│                    Users / Partners                  │
├──────────┬──────────┬───────────┬───────────────────┤
│ app.*    │ admin.*  │ partner.* │ Mobile App        │
│ React    │ React    │ Next.js   │ Flutter           │
│ Vite+TS  │ Shadcn   │ Prisma    │ iOS/Android/Web   │
├──────────┴──────────┴───────────┴───────────────────┤
│              Django REST API (Python)                │
│     uat.eventifyplus.com / prod.eventifyplus.com    │
├─────────────────────────────────────────────────────┤
│           AWS EC2 · Docker · eventify-net           │
│           Database · Server Monitor                 │
└─────────────────────────────────────────────────────┘
```

## Projects at a Glance

| Project | Domain | Stack | Local Path |
|---------|--------|-------|------------|
| Web App | `app.eventifyplus.com` | React 18 + Vite + TS + Tailwind | `mvnew.eventifyplus.com new/` |
| Admin | `admin.eventifyplus.com` | React 18 + Vite + Shadcn/UI | `eventify-command-center/` |
| Partner | `partner.eventifyplus.com` | Next.js 16 + Prisma + Tailwind | `eventify-partner/` |
| Mobile | iOS / Android / Desktop | Flutter + Dart + Provider | `Eventify-frontend/` |
| Backend | `uat.eventifyplus.com/api/` | Django 4.2+ (Python) | `eventify_backend/` |
| Monitor | `status.eventifyplus.com` | Node.js + Docker | `eventify-server-monitor/` |

All local projects live under `/Users/bshtechnologies/Documents/`.

## Backend Modules

| Module | Purpose |
|--------|---------|
| `accounts` | Users & auth |
| `events` | Event CRUD, types, images |
| `bookings` | Reservations |
| `reviews` | User reviews |
| `ledger` | Financial ledger |
| `banking_operations` | Payments |
| `gamification` | EP, RP, achievements, leaderboard |
| `eventify_logger` | Logging |

## Flutter App Architecture (Mobile)

Feature-first modular structure:
```
lib/
├── core/          # API, auth, storage, utils, constants, theme
├── features/      # auth, events, gamification, reviews
├── screens/       # Mobile + desktop screen variants
└── widgets/       # Reusable UI components
```

State Management: Provider (`^6.1.2`) — see [[State Management]]

## Detailed Notes

- **Per-project details:** [[09 - Projects/App - Web Frontend]] · [[09 - Projects/Admin - Command Center]] · [[09 - Projects/Partner Portal]] · [[09 - Projects/Mobile - Flutter]] · [[09 - Projects/Backend - Django]]
- **Infrastructure:** [[10 - Infrastructure/Server & Docker]] · [[10 - Infrastructure/Server Monitor]]
- **Flutter specifics:** [[Folder Structure]] · [[State Management]]