Files
band-management/README.md
bert.hausmans 1cb7674d52 refactor: align codebase with EventCrew domain and trim legacy band stack
- Update API: events, users, policies, routes, resources, migrations
- Remove deprecated models/resources (customers, setlists, invitations, etc.)
- Refresh admin app and docs; remove apps/band

Made-with: Cursor
2026-03-29 23:19:06 +02:00

74 lines
2.4 KiB
Markdown

# Event Crew
Full-stack event crew 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
```
event-crew/
├── 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.eventcrew.nl |
| Admin | http://localhost:5173 | https://admin.eventcrew.nl |
| Band Portal | http://localhost:5174 | https://band.eventcrew.nl |
| Customer Portal | http://localhost:5175 | https://customers.eventcrew.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
```