
# Music Monitor — Backend

Backend API-first per **Music Monitor / The Industry Beyond**: piattaforma per la scoperta, qualificazione e ricerca intelligente di contatti nel settore musicale, eventi, PR, brand e talent.

Il backend è un’applicazione **Laravel API-only**: espone esclusivamente endpoint JSON e non contiene Blade, Vite, Inertia, Vue o Tailwind.

## Architettura

| Componente | Tecnologia | Ruolo |
|---|---|---|
| API | Laravel | Autenticazione, business logic, endpoint REST |
| Database | PostgreSQL + pgvector | Dati relazionali, metadati JSONB, ricerca vettoriale |
| Cache / Code | Redis + phpredis | Sessioni, cache e job asincroni |
| AI locale | Ollama | Embedding e generazione testuale |
| Frontend | Next.js + Bun | Applicazione separata, gestita in altra cartella/repo |

## Funzionalità MVP

- Importazione contatti da file JSON/CSV/Excel.
- Normalizzazione e arricchimento dei dati.
- Generazione embedding tramite `nomic-embed-text`.
- Ricerca semantica con PostgreSQL `pgvector` e cosine similarity.
- Autenticazione API tramite Laravel Sanctum.
- Elaborazione asincrona tramite Redis Queue.

## Requisiti

- PHP 8.2+
- Composer
- PostgreSQL 15+ con estensione `pgvector`
- Redis
- Estensione PHP `phpredis`
- Ollama raggiungibile in rete locale

## Setup

```bash
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan serve --host=0.0.0.0 --port=8000
```

## Variabili principali

```env
DB_CONNECTION=pgsql
DB_DATABASE=contacts_monitor
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
REDIS_CLIENT=phpredis

OLLAMA_BASE_URL=http://192.168.178.186:11434
OLLAMA_EMBEDDING_MODEL=nomic-embed-text:latest
OLLAMA_CHAT_MODEL=phi3:mini
```

## Struttura dati

Il dataset dei contatti non viene versionato in Git.

I file di importazione devono essere inseriti in:

```text
storage/app/import/
```

La modellazione definitiva verrà completata dopo l’analisi del file JSON reale.

## Sicurezza e privacy

- I dataset contenenti dati personali non devono essere caricati su GitHub.
- Le credenziali non vanno mai committate.
- Usare `.env` locale e `.env.example` senza valori sensibili.
