# FaPost

> Conversational assistants and flow automation platform.

- [Introduction](https://docs.fapost.in/index.md): What FaPost Core is, and who each part of this documentation is for.
- [Core concepts](https://docs.fapost.in/using/concepts.md): The nine words the rest of the guide assumes you know.
- [Quickstart](https://docs.fapost.in/using/quickstart.md): From a fresh installation to an assistant that answers.
- [The admin panel](https://docs.fapost.in/using/admin-overview.md): What the platform-level panel covers, and what it does not.
- [Assistants](https://docs.fapost.in/using/assistants.md): Creating an assistant, and opening its console.
- [Settings](https://docs.fapost.in/using/tenant-settings.md): Languages, runtime limits, and broadcast behaviour for the whole tenant.
- [Users](https://docs.fapost.in/using/users.md): Inviting people and controlling their access.
- [Roles and permissions](https://docs.fapost.in/using/roles-and-permissions.md): What each permission grants, and which ones deserve a second thought.
- [Media library](https://docs.fapost.in/using/media.md): Files an assistant can send, and what stops one being deleted.
- [The assistant console](https://docs.fapost.in/using/console-overview.md): Where the day-to-day work happens.
- [Channels](https://docs.fapost.in/using/channels.md): Connecting a messaging provider to an assistant.
- [Assistant settings](https://docs.fapost.in/using/assistant-settings.md): How one assistant behaves — its language, its default flow, and what it says when it cannot answer.
- [Translations](https://docs.fapost.in/using/translations.md): The words the assistant uses that no flow author wrote.
- [Flows](https://docs.fapost.in/using/flows.md): The list of flows, what triggers them, and what published means.
- [Flow groups](https://docs.fapost.in/using/flow-groups.md): Organising flows once there are more than a few.
- [The flow builder](https://docs.fapost.in/using/flow-builder.md): Building a conversation from blocks.
- [Node catalogue](https://docs.fapost.in/using/node-catalogue.md): Every block you can put in a flow, and what it does.
- [Publishing a flow](https://docs.fapost.in/using/publishing.md): Taking a draft live, and what happens to conversations already running.
- [Conversations](https://docs.fapost.in/using/conversations.md): Reading what contacts sent, and replying when the flow cannot.
- [Contacts](https://docs.fapost.in/using/contacts.md): The people an assistant talks to, and where their details come from.
- [Contact groups](https://docs.fapost.in/using/contact-groups.md): Lists of contacts you maintain by hand.
- [Segments](https://docs.fapost.in/using/segments.md): Selecting contacts by condition, and why the size needs recounting.
- [Broadcasts](https://docs.fapost.in/using/broadcasts.md): Sending a message to many contacts at once.
- [Sessions](https://docs.fapost.in/using/sessions.md): Conversations currently moving through a flow, and where each one stopped.
- [Flow logs](https://docs.fapost.in/using/flow-logs.md): What a flow actually did, step by step.
- [Glossary](https://docs.fapost.in/using/glossary.md): Terms used throughout FaPost, and the pairs that get confused.
- [Overview](https://docs.fapost.in/self-hosting/overview.md): Choosing an installation method and what an installation contains.
- [Requirements](https://docs.fapost.in/self-hosting/requirements.md): What a host must provide before you begin.
- [Docker Compose](https://docs.fapost.in/self-hosting/docker-compose.md): The container installation path, start to finish.
- [Bare metal](https://docs.fapost.in/self-hosting/bare-metal.md): Installing directly onto a host without containers.
- [Configuration](https://docs.fapost.in/self-hosting/configuration.md): The decisions behind the environment file, and what must change before production.
- [Services](https://docs.fapost.in/self-hosting/services.md): Horizon and the scheduler, without which nothing is processed.
- [Webhook gateway](https://docs.fapost.in/self-hosting/gateway.md): The optional Go ingress in front of webhook traffic.
- [Tenancy operations](https://docs.fapost.in/self-hosting/tenancy.md): Creating tenants and running landlord and tenant migrations.
- [Upgrading and rollback](https://docs.fapost.in/self-hosting/upgrading.md): Release order, migrations, and how to go back.
- [Observability](https://docs.fapost.in/self-hosting/observability.md): What to watch, and which command answers which question.
- [Troubleshooting](https://docs.fapost.in/self-hosting/troubleshooting.md): Symptoms, likely causes, and where to look first.
- [For developers](https://docs.fapost.in/contributing/overview.md): What the platform is made of, and which half of this section promises anything.
- [Local setup](https://docs.fapost.in/contributing/local-setup.md): Getting a Core checkout running on your machine.
- [Receiving webhooks locally](https://docs.fapost.in/contributing/local-webhooks.md): Giving your development machine a public HTTPS address so a provider can reach it.
- [Repository layout](https://docs.fapost.in/contributing/repo-layout.md): Where code lives and which boundaries it must respect.
- [Coding conventions](https://docs.fapost.in/contributing/conventions.md): The style and idioms Core code follows.
- [Extension model](https://docs.fapost.in/extending/extension-model.md): How Features, Solutions, and Plugins differ.
- [Choosing an extension type](https://docs.fapost.in/extending/choosing-an-extension-type.md): A decision guide for where your code belongs.
- [Development setup](https://docs.fapost.in/extending/development-setup.md): Working on packages locally against a Core checkout.
- [Building a Solution](https://docs.fapost.in/extending/solutions.md): Composer-distributed extensions that ship with the application.
- [Building a Plugin](https://docs.fapost.in/extending/plugins.md): Extensions installed and enabled at runtime.
- [Handler contract](https://docs.fapost.in/extending/flow-nodes/handler-contract.md): What a node handler receives and what it must return.
- [Versioning and compatibility](https://docs.fapost.in/extending/flow-nodes/versioning.md): Changing a node without breaking published flows.
- [State namespaces](https://docs.fapost.in/extending/flow-nodes/state-namespaces.md): The system, flow, rag, module, contact, and call key spaces.
- [Idempotency and retries](https://docs.fapost.in/extending/flow-nodes/idempotency.md): Making a handler safe to run more than once.
- [Builder UI extensions](https://docs.fapost.in/extending/builder-ui.md): Schema-driven configuration and when an override is justified.
- [Channel drivers](https://docs.fapost.in/extending/channel-drivers.md): Adding support for a new messaging provider.
- [Data accessors](https://docs.fapost.in/extending/data-accessors.md): Exposing your data to flows through the module namespace.
- [Multilingual extensions](https://docs.fapost.in/extending/multilingual.md): Translating what your extension shows to end users.
- [Testing your extension](https://docs.fapost.in/extending/testing.md): The checks an extension is expected to pass.
- [Stability policy](https://docs.fapost.in/extending/stability-policy.md): What Core promises not to break, and what it does not.
- [Runtime architecture](https://docs.fapost.in/contributing/runtime.md): How a message travels from webhook to reply.
- [Tenant-aware execution](https://docs.fapost.in/contributing/tenant-aware-execution.md): Why tenant context is required and how it is carried.
- [Migration isolation](https://docs.fapost.in/contributing/migration-isolation.md): Why migrations must not depend on runtime state.
- [Long-lived worker safety](https://docs.fapost.in/contributing/worker-safety.md): Why state must not survive between jobs, and how to keep it from doing so.
- [ID strategy](https://docs.fapost.in/contributing/id-strategy.md): ULID primary keys and how they are stored.
- [Dependency direction](https://docs.fapost.in/contributing/dependency-direction.md): What foundation and support may depend on.
- [Testing and architecture checks](https://docs.fapost.in/contributing/testing.md): PHPUnit suites and the PHPat rules that guard boundaries.
- [Pull requests](https://docs.fapost.in/contributing/pull-requests.md): How a change gets reviewed and merged.
- [Licence, CLA and trademark](https://docs.fapost.in/contributing/legal.md): What you grant by contributing, and what you may call the result.
- [Foundation contracts](https://docs.fapost.in/reference/foundation-contracts.md): The interfaces and DTOs extensions are built against.
- [Flow node reference](https://docs.fapost.in/reference/flow-nodes.md): Type, version, and category for each node Core registers.
- [Builder config schema](https://docs.fapost.in/reference/builder-config-schema.md): The schema the Builder renderer understands.
- [State key namespaces](https://docs.fapost.in/reference/state-namespaces.md): Reserved key spaces and their access rules.
- [Queues](https://docs.fapost.in/reference/queues.md): Every queue, what belongs on it, and why they stay separate.
- [Events](https://docs.fapost.in/reference/events.md): Flow-level events, and the state of the platform event surface.
- [Environment variables](https://docs.fapost.in/reference/environment-variables.md): The variables Core reads beyond the Laravel defaults.
- [Artisan commands](https://docs.fapost.in/reference/artisan-commands.md): Commands Core adds, and what they do.