86 lines
2.0 KiB
Markdown
86 lines
2.0 KiB
Markdown
# TicketAssistant (Laravel 13 + pgvector + external Ollama)
|
|
|
|
AI-powered customer support ticket system using semantic retrieval + LLM re-ranking.
|
|
|
|
## Requirements
|
|
|
|
- Docker Desktop
|
|
- Docker Compose v2
|
|
- Ollama running on a reachable network server
|
|
|
|
## Quick Start (Docker)
|
|
|
|
1. Create environment file
|
|
```bash
|
|
cp .env.docker.example .env
|
|
```
|
|
|
|
2. Set the external Ollama URL in `.env`
|
|
```env
|
|
OLLAMA_BASE_URL=http://<OLLAMA_SERVER_IP_OR_HOSTNAME>:11434
|
|
```
|
|
|
|
3. Build and start containers
|
|
```bash
|
|
docker compose up -d --build
|
|
```
|
|
|
|
4. Install PHP dependencies in app container
|
|
```bash
|
|
docker compose exec app composer install
|
|
```
|
|
|
|
5. Generate app key and run database setup
|
|
```bash
|
|
docker compose exec app php artisan key:generate
|
|
docker compose exec app php artisan migrate --seed
|
|
```
|
|
|
|
API base URL: `http://localhost:8090/api`
|
|
Admin dashboard: `http://localhost:8090/admin/dashboard`
|
|
|
|
## Admin Dashboard (Blade + Livewire)
|
|
|
|
- `/admin/dashboard`: KPI cards + recente tickets + recente AI decisions
|
|
- `/admin/articles`: artikel aanmaken + artikeloverzicht
|
|
- `/admin/tickets`: tickets met AI-classificatie-overzicht
|
|
|
|
Business logic is isolated in service classes:
|
|
- `App\Services\AdminDashboardService`
|
|
- `App\Services\AdminArticleService`
|
|
- `App\Services\AdminTicketService`
|
|
|
|
## Services
|
|
|
|
- `web`: Nginx (public endpoint)
|
|
- `app`: PHP-FPM Laravel runtime
|
|
- `worker`: queue worker for async jobs
|
|
- `postgres`: PostgreSQL 17 + pgvector
|
|
|
|
## Notes
|
|
|
|
- No external AI APIs are used.
|
|
- Ollama runs outside Docker on your network.
|
|
- Set `QUEUE_EMBEDDINGS=true` for async article embedding generation.
|
|
|
|
## Helpdesk Scraper Command
|
|
|
|
Importeer artikelen vanaf InternetToday Helpdesk (categorieen + subcategorieen):
|
|
|
|
```bash
|
|
docker compose exec app php artisan helpdesk:import
|
|
```
|
|
|
|
Opties:
|
|
|
|
```bash
|
|
# test zonder schrijven
|
|
docker compose exec app php artisan helpdesk:import --dry-run
|
|
|
|
# verwerk alleen eerste N artikelen
|
|
docker compose exec app php artisan helpdesk:import --limit=25
|
|
|
|
# custom base-url
|
|
docker compose exec app php artisan helpdesk:import --base-url=https://www.internettoday.nl/helpdesk
|
|
```
|