> ## Documentation Index
> Fetch the complete documentation index at: https://docs.klantel.be/llms.txt
> Use this file to discover all available pages before exploring further.

# Welkom bij Klantel

> Mini-CRM en wettelijke tijdregistratie voor Belgische KMO's

# Welkom bij Klantel

Klantel is een eenvoudig **mini-CRM met geïntegreerde tijdregistratie** voor Belgische KMO's en freelancers. Het combineert klantenbeheer, projectopvolging en wettelijk conforme urenstaten in één overzichtelijke PWA.

## Kernfuncties

<CardGroup cols={2}>
  <Card title="Tijdregistratie" icon="clock" href="/handleiding/timer">
    Start en stop een timer per project. Wettelijk compliant voor de Belgische Sociale Inspectie (deadline 2027).
  </Card>

  <Card title="Klanten & Projecten" icon="folder" href="/handleiding/klanten">
    Beheer klanten, contactpersonen en projecten. Koppel tijdregistraties en taken aan projecten.
  </Card>

  <Card title="Facturatie" icon="file-invoice" href="/handleiding/facturen">
    Maak facturen aan in UBL 2.1-formaat. Verstuur via Peppol voor Belgische B2B-e-facturatie.
  </Card>

  <Card title="Billit-koppeling" icon="plug" href="/integraties/billit">
    Koppel een bestaand Billit-account voor professioneel factuurbeheer en automatische Peppol-verzending.
  </Card>
</CardGroup>

## Architectuur in één oogopslag

Klantel is een **multi-tenant SaaS**: elk bedrijf dat zich registreert krijgt een volledig geïsoleerde omgeving. Gegevens van de ene tenant zijn nooit zichtbaar voor een andere.

| Laag     | Technologie                                         |
| -------- | --------------------------------------------------- |
| Frontend | Next.js 16 (App Router) + React 19 + Tailwind CSS 4 |
| Backend  | Next.js Server Actions + API Routes                 |
| Database | PostgreSQL via Prisma 7                             |
| Auth     | JWT-cookie (httpOnly, HS256, 8 uur)                 |
| PWA      | Offline-first met service worker                    |
| Hosting  | OVH VPS + Coolify (zelfgehost)                      |

## Beveiliging

* Alle API-endpoints zijn beveiligd met sessieverificatie.
* Wachtwoorden worden gehasht met **bcrypt** (cost 12).
* Optionele **twee-factor-authenticatie** (TOTP) per gebruiker.
* Volledige **audit-log** van alle mutaties (append-only, hashketen).
* Multi-tenant isolatie: elke databasequery is gefilterd op `tenantId`.

## Aan de slag

<Steps>
  <Step title="Account aanmaken">
    Registreer op [app.klantel.be/registreer](https://app.klantel.be/registreer) met je bedrijfsnaam en BTW-nummer.
  </Step>

  <Step title="Eerste klant toevoegen">
    Ga naar **Klanten** en klik op **Nieuwe klant**. Vul naam, adres en BTW-nummer in.
  </Step>

  <Step title="Timer starten">
    Open een project en klik op **Start timer**. De timer loopt door, ook als je de browser sluit (offline-modus).
  </Step>

  <Step title="Factuur aanmaken">
    Ga naar **Facturen** → **Nieuwe factuur**, kies je klant en de geregistreerde uren. Exporteer als UBL of PDF.
  </Step>
</Steps>