# Blinqx Docs

> Partner API guides and internal developer documentation for the Blinqx public API and Basenet rebuild.

## Partner

- [Partner](https://docs.basenet-crm.blinqx.ai/partner): Short integration guides for the Blinqx public API.
- [Getting started with a scoped token](https://docs.basenet-crm.blinqx.ai/partner/getting-started-scoped-token): Authenticate a first API request with an issued partner token.
- [Scopes and permission filtering](https://docs.basenet-crm.blinqx.ai/partner/scopes-and-permission-filtering): Understand the two authorization gates applied to every request.
- [Pagination, filtering, and sorting](https://docs.basenet-crm.blinqx.ai/partner/pagination-filtering-sorting): Page through permission-filtered list endpoints without assuming unsupported queries.
- [Idempotency keys](https://docs.basenet-crm.blinqx.ai/partner/idempotency-keys): Retry mutation requests only when the public contract says it is safe.
- [Rate limits and Retry-After](https://docs.basenet-crm.blinqx.ai/partner/rate-limits-and-retry-after): Back off predictably when a scoped token reaches its request limit.
- [Webhook subscriptions](https://docs.basenet-crm.blinqx.ai/partner/webhooks): Register and list outbound event subscriptions through the public API.
- [OData](https://docs.basenet-crm.blinqx.ai/partner/odata): Connect BI tooling to the permission-filtered OData v4 service.

## Developers

- [Developers](https://docs.basenet-crm.blinqx.ai/developers): Internal engineering map for architecture, setup, ADRs, and the public API stack.
- [Quickstart](https://docs.basenet-crm.blinqx.ai/developers/quickstart): Orient to the monorepo apps, packages, and product rules.
- [Architecture](https://docs.basenet-crm.blinqx.ai/developers/architecture): Monorepo layout, runtime apps, and domain/db/integration layering.
- [Application architecture](https://docs.basenet-crm.blinqx.ai/developers/application-architecture): Transport adapters, command/query handlers, permission gates, transactions, audit, repositories, providers, and failure boundaries.
- [Tenant isolation and fleet lifecycle](https://docs.basenet-crm.blinqx.ai/developers/tenant-isolation): Control-plane routing, database-per-tenant isolation, provisioning, fleet migrations, and failure handling.
- [Workers and integrations](https://docs.basenet-crm.blinqx.ai/developers/workers-integrations): Background-job registry, queue semantics, tenant routing, adapter selection, retries, idempotency, and external failure boundaries.
- [Setup and checks](https://docs.basenet-crm.blinqx.ai/developers/setup): Local boot, operational scripts, and runbooks that matter day to day.
- [Operations and runbooks](https://docs.basenet-crm.blinqx.ai/developers/operations): Purpose-based landing page for every current operational runbook in the repository.
- [Real-tenant dev fixtures](https://docs.basenet-crm.blinqx.ai/developers/tenant-fixtures): Boot local dev on real migrated Basenet tenant data instead of demo fixtures, without MariaDB access.
- [Public API and documentation](https://docs.basenet-crm.blinqx.ai/developers/public-api): One OpenAPI contract feeding Blume Pages, Scalar, and OpenWiki.
- [Scalar API reference](https://docs.basenet-crm.blinqx.ai/developers/scalar): How the interactive Scalar reference at /reference relates to the generated OpenAPI contract, and which surface to use for which job.
- [Decisions and ADRs](https://docs.basenet-crm.blinqx.ai/developers/decisions): Where architectural choices are recorded and how to navigate them.
- [Testing](https://docs.basenet-crm.blinqx.ai/developers/testing): Unit, fleet, and E2E expectations for the monorepo.
- [OpenWiki](https://docs.basenet-crm.blinqx.ai/developers/openwiki): How the generated codebase wiki relates to this Blume site.

## Handleiding

- [Handleiding](https://docs.basenet-crm.blinqx.ai/handleiding): Gebruikershandleiding voor Basenet — de kantoorapp en het cliëntenportaal, stap voor stap.
- [Snelstart voor een nieuw kantoor](https://docs.basenet-crm.blinqx.ai/handleiding/snelstart): Van lege omgeving naar je eerste dossier, urenboeking en conceptfactuur — stap voor stap.
- [Aan de slag](https://docs.basenet-crm.blinqx.ai/handleiding/aan-de-slag): Inloggen, navigeren, zoeken en het dashboard begrijpen in de Basenet-kantoorapp.
- [Dossiers](https://docs.basenet-crm.blinqx.ai/handleiding/dossiers): Een dossier aanmaken (met conflictcontrole), de tabbladen van het dossieroverzicht, en een dossier sluiten.
- [Relaties](https://docs.basenet-crm.blinqx.ai/handleiding/relaties): Cliënten, wederpartijen en contactpersonen vastleggen, KvK-import, Wwft-gegevens en duplicaten samenvoegen.
- [Documenten & e-mail](https://docs.basenet-crm.blinqx.ai/handleiding/documenten-en-email): Documenten in het dossier beheren, versies, delen en ondertekenen, e-mail archiveren en inkomende post verwerken.
- [Office-invoegtoepassingen](https://docs.basenet-crm.blinqx.ai/handleiding/office-invoegtoepassingen): Werk vanuit Outlook en Word met dossiers, documenten, sjablonen en clausules in Basenet.
- [Nog te koppelen](https://docs.basenet-crm.blinqx.ai/handleiding/nog-te-koppelen): Koppel documenten, taken en uren zonder dossier aan het juiste dossier.
- [Agenda & taken](https://docs.basenet-crm.blinqx.ai/handleiding/agenda-en-taken): Afspraken plannen (ook zichtbaar voor de cliënt), beschikbaarheid van collega's zien en taken opvolgen.
- [Termijnen](https://docs.basenet-crm.blinqx.ai/handleiding/termijnen): Fatale datums bewaken met het vierogenprincipe — termijnen aanmaken, bevestigen en opvolgen.
- [Tijd & facturatie](https://docs.basenet-crm.blinqx.ai/handleiding/tijd-en-facturatie): Uren schrijven (stopwatch, snelinvoer, handmatig), afboeken, en van factureerwachtrij naar verzonden factuur.
- [Rapportages](https://docs.basenet-crm.blinqx.ai/handleiding/rapporten): Onderhanden werk (OHW) inzien — wat is er gewerkt, afgeboekt, gefactureerd en geïnd.
- [Cliëntacceptatie & onboarding](https://docs.basenet-crm.blinqx.ai/handleiding/client-onboarding): Wwft-cliëntacceptatie vastleggen en de cliënt toegang geven tot het cliëntenportaal.
- [Portaalbeheer](https://docs.basenet-crm.blinqx.ai/handleiding/portaalbeheer): Beheer cliënttoegang, toegangslinks en begeleide onboarding per dossier.
- [Cliëntenportaal](https://docs.basenet-crm.blinqx.ai/handleiding/portaal): Voor cliënten van het kantoor — inloggen zonder wachtwoord, uw dossier volgen, documenten, berichten en betalen.
- [Kantoorconfiguratie](https://docs.basenet-crm.blinqx.ai/handleiding/kantoorconfiguratie): Richt kantoorstandaarden, dossiervarianten, uurtarieven, sjablonen en beheerfuncties in.
- [Instellingen](https://docs.basenet-crm.blinqx.ai/handleiding/instellingen): Voor beheerders — gebruikers, toegangsniveaus, standaarden, koppelingen, AI-functies en het auditlog.
- [Dossierassistent](https://docs.basenet-crm.blinqx.ai/handleiding/dossierassistent): De AI-functies van Basenet — vragen stellen over een dossier, een samenvatting, een tijdlijn, termijnen voorstellen, concepten en het AI-gebruiksrapport.
- [Begrippenlijst](https://docs.basenet-crm.blinqx.ai/handleiding/begrippenlijst): De belangrijkste termen uit Basenet en de juridische praktijk, uitgelegd in gewone taal.

## User guide

- [User guide](https://docs.basenet-crm.blinqx.ai/guides): User guide for the Basenet staff app and the client portal.
- [Getting started: office setup](https://docs.basenet-crm.blinqx.ai/guides/getting-started-office-setup): From empty environment to your first matter, time entry, and draft invoice — step by step.
- [Getting started](https://docs.basenet-crm.blinqx.ai/guides/getting-started): Logging in, navigating, searching, and understanding the dashboard in the Basenet staff app.
- [Matters](https://docs.basenet-crm.blinqx.ai/guides/matters): Creating a matter (with conflict check), finding a matter, the matter tabs, and closing a matter.
- [Relations](https://docs.basenet-crm.blinqx.ai/guides/relations): Recording clients, opposing parties, and contacts, KvK import, Wwft data, and merging duplicates.
- [Documents & email](https://docs.basenet-crm.blinqx.ai/guides/documents-and-email): Managing matter documents, versions, sharing and e-signing, filing email, and processing incoming post.
- [Office add-ins](https://docs.basenet-crm.blinqx.ai/guides/office-add-ins): Work with Basenet matters, documents, templates, and clauses from Outlook and Word.
- [To be filed](https://docs.basenet-crm.blinqx.ai/guides/to-be-filed): File documents, tasks, and time entries without a matter to the correct matter.
- [Calendar & tasks](https://docs.basenet-crm.blinqx.ai/guides/calendar-and-tasks): Scheduling appointments (also visible to the client), seeing colleagues' availability, and following up on tasks.
- [Deadlines](https://docs.basenet-crm.blinqx.ai/guides/deadlines): Guarding fatal dates with the four-eyes principle — creating, confirming, and following up on deadlines.
- [Time & billing](https://docs.basenet-crm.blinqx.ai/guides/time-and-billing): Writing time (stopwatch, quick entry, manual), write-offs, and from billing queue to sent invoice.
- [Reports](https://docs.basenet-crm.blinqx.ai/guides/reports): Reviewing work in progress (WIP) — what's been worked, written off, invoiced, and collected.
- [Client onboarding](https://docs.basenet-crm.blinqx.ai/guides/client-onboarding): Recording Wwft client acceptance and giving the client access to the portal.
- [Portal administration](https://docs.basenet-crm.blinqx.ai/guides/portal-administration): Manage client access, access links, and guided onboarding per matter.
- [Client portal](https://docs.basenet-crm.blinqx.ai/guides/portal): For the firm's clients — passwordless login, following your matter, documents, messages, and payments.
- [Office configuration](https://docs.basenet-crm.blinqx.ai/guides/office-configuration): Configure office defaults, matter variants, hourly rates, templates, and administration features.
- [Settings](https://docs.basenet-crm.blinqx.ai/guides/settings): For administrators — users, access levels, defaults, integrations, and the audit log.
- [Matter assistant](https://docs.basenet-crm.blinqx.ai/guides/matter-assistant): Basenet's AI features — asking questions about a matter, a summary, a case timeline, extracting deadlines, drafts, an invoice narrative, and the AI usage report.
- [Glossary](https://docs.basenet-crm.blinqx.ai/guides/glossary): The key terms from Basenet and legal practice, explained in plain language.