# bluebut docs

> Facebook outreach operator dashboard for the Bofrid housing-acquisition funnel.
> Every doc below is served as raw markdown at the given URL. Fetch this file first to
> discover them, then fetch the raw .md you need. Grouped by section.

## Architecture
How the whole system fits together — read this first.

- [System model](https://bluebut-docs.blpk.cc/CLAUDE.md): The full architecture: jobs spine, data planes, cloakbox migration, extraction doctrine, conventions. The source of truth.

## Reference & API
The read API surface and every runnable command.

- [Read API](https://bluebut-docs.blpk.cc/API.md): Bridge + adapter HTTP/JSON API — endpoints, auth, response shapes.
- [Commands](https://bluebut-docs.blpk.cc/COMMANDS.md): Every runnable adapter / job command with its arguments.

## Subsystems
Deep dives into individual subsystems.

- [Acquisition funnel](https://bluebut-docs.blpk.cc/FUNNEL.md): Self-owned funnel design: classify → match → outreach (retires fb-bot).
- [How E2EE works](https://bluebut-docs.blpk.cc/HOW-E2EE-WORKS.md): From-scratch explainer: CAT, PIN, devices, Signal sessions — how Messenger E2EE works and how bluebut reads/sends it.
- [Messenger E2EE alerts](https://bluebut-docs.blpk.cc/MESSENGER-E2EE-ALERTS.md): Messenger E2EE decrypt daemon + Telegram-alert architecture.