# GoFiber MVC Boilerplate

Boilerplate riusabile per:

- GoFiber (MVC)
- HTMX
- Svelte Custom Elements (UI kit)
- GORM
- SQLite/Postgres
- Auth + ruolo `admin`
- Email sink
- CORS
- Template directory `public` / `private` / `admin`

In ambiente `develop`, le email vengono salvate in `./data/emails` (sink locale).

## Struttura iniziale

```text
.
├── cmd/
│   └── server/
├── internal/
│   ├── app/
│   ├── auth/
│   ├── config/
│   ├── controllers/
│   ├── db/
│   ├── http/
│   ├── mailer/
│   ├── middleware/
│   ├── models/
│   ├── repo/
│   └── services/
├── web/
│   ├── emails/
│   │   └── templates/
│   ├── static/
│   │   ├── css/
│   │   ├── ui/
│   │   └── vendor/
│   └── templates/
│       ├── admin/
│       ├── private/
│       └── public/
├── ui-kit/
└── data/        # solo sviluppo locale
```

## TODO Checklist

- [ ] Definire bootstrap server in `cmd/server` (entrypoint + lifecycle).
- [ ] Configurare loader config (`env`, `flags`) in `internal/config`.
- [ ] Impostare `internal/db` con supporto SQLite (dev) e Postgres (prod).
- [ ] Definire modelli base GORM in `internal/models` (User, Role, Session, ecc.).
- [ ] Implementare repository layer in `internal/repo`.
- [ ] Implementare service layer in `internal/services`.
- [ ] Implementare controller layer in `internal/controllers`.
- [ ] Configurare router HTTP in `internal/http` (gruppi public/private/admin).
- [ ] Aggiungere middleware comuni in `internal/middleware` (logging, recovery, auth, cors).
- [ ] Implementare auth in `internal/auth` (login/logout/session o token).
- [ ] Implementare RBAC con ruolo `admin`.
- [ ] Configurare mailer + email sink in `internal/mailer`.
- [ ] Definire template rendering per `web/templates/public`, `web/templates/private`, `web/templates/admin`.
- [ ] Preparare template email in `web/emails/templates`.
- [ ] Definire static assets pipeline e convenzioni in `web/static`.
- [ ] Impostare `ui-kit` con Svelte Custom Elements e output in `web/static/ui`.
- [ ] Definire integrazione HTMX lato template/partials.
- [ ] Aggiungere migrazioni DB iniziali e seed minimo.
- [ ] Aggiungere test base (unit + integrazione) per router/auth/repo.
- [ ] Aggiungere script Makefile/task runner per setup e run locale.