74 lines
2.4 KiB
Markdown
74 lines
2.4 KiB
Markdown
# 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
|
|
```
|