Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs-chat.die-coaching-akademie.de/llms.txt

Use this file to discover all available pages before exploring further.

The application is intentionally small and modular. app.py owns HTTP routing, while most business logic lives in service modules. 
Browser / Customer Website
        |
        | loads static/chatbot.js
        v
FastAPI app.py
        |
        | selects deterministic answer or model answer
        v
services/chat_service.py
        |
        | reads data/*.json and calls OpenAI if needed
        v
OpenAI API

​
Runtime responsibilities

app.py

FastAPI routes, CORS, static files, templates, rate-limit entrypoint, admin auth dependency, and analytics instrumentation.

services/chat_service.py

Knowledge-base loading, keyword search, deterministic price/payment/workshop handling, funnel hints, cache, and OpenAI calls.

services/analytics_service.py

Privacy-friendly JSONL events and summary functions for admin endpoints.

static/chatbot.js

Self-contained embeddable widget script for the customer website.

​
Public and internal surfaces

  • GET /health
  • GET /
  • POST /chat
  • /static/chatbot.js
  • /static/chatbot.css
/admin/... endpoints require ADMIN_TOKEN. If the token is missing or still set to the placeholder, the app returns 404 for admin routes.