feat: initial commit - Band Management application

README.md

@@ -0,0 +1,73 @@
+# Band Management
+
+Full-stack band/artist operations management platform.
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|------------|
+| Backend | Laravel 12 + PHP 8.3 + Sanctum |
+| Database | MySQL 8.0 |
+| Frontend | Vue 3 + TypeScript + Vuexy |
+| Local Dev | Native PHP/Node + Docker |
+
+## Quick Start
+
+```bash
+# 1. Start Docker services
+make services
+
+# 2. Open in Cursor and start building!
+```
+
+See [docs/SETUP.md](docs/SETUP.md) for detailed instructions.
+
+## Project Structure
+
+```
+band-management/
+├── api/                    # Laravel 12 API
+├── apps/
+│   ├── admin/              # Admin Dashboard
+│   ├── band/               # Band Member Portal
+│   └── customers/          # Customer Portal
+├── docker/                 # Docker configs
+├── docs/                   # Documentation
+├── resources/              # Vuexy template source (reference)
+├── .cursor/rules           # Cursor AI instructions
+└── Makefile                # Development commands
+```
+
+## Frontend Apps (Vuexy v10.11.1)
+
+All frontend apps are built with **Vue 3 + TypeScript** using the [Vuexy Admin Template](https://pixinvent.com/vuexy-vuejs-admin-dashboard-template/).
+
+| App | Template | Description |
+|-----|----------|-------------|
+| **Admin** | TypeScript Full Version | Complete admin dashboard with all Vuexy features |
+| **Band Portal** | TypeScript Starter Kit | Lightweight portal for band members |
+| **Customer Portal** | TypeScript Starter Kit | Lightweight portal for customers |
+
+**Template source:** `resources/vuexy-admin-v10.11.1/vue-version/typescript-version/`
+
+> **Note:** The `@core/` and `@layouts/` folders should not be modified directly. Customize through `themeConfig.ts` and override styles in `assets/styles/`.
+
+## URLs
+
+| App | Development | Production |
+|-----|-------------|------------|
+| API | http://localhost:8000/api/v1 | https://api.bandmanagement.nl |
+| Admin | http://localhost:5173 | https://admin.bandmanagement.nl |
+| Band Portal | http://localhost:5174 | https://band.bandmanagement.nl |
+| Customer Portal | http://localhost:5175 | https://customers.bandmanagement.nl |
+
+## Development Commands
+
+```bash
+make services       # Start MySQL, Redis, Mailpit
+make services-stop  # Stop Docker services
+make api            # Start Laravel API
+make admin          # Start Admin SPA
+make band           # Start Band Portal
+make customers      # Start Customer Portal
+```