Zum Hauptinhalt springen

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository purpose​

Pure-markdown documentation for apollonia® (a dental practice management system by Procedia GmbH), served by a Docusaurus instance on the Procedia server. There is no local build toolchain — the repository contains only .md files and _category_.json files.

Deployment​

Changes go live by pushing to the remote:

git push

The remote is a bare Git repository on 159.195.33.117 that triggers Docusaurus to rebuild automatically. There is no CI, no test suite, and no npm/yarn in this repo.

File and folder conventions​

Frontmatter (every .md file)​

---
sidebar_position: 3
title: Seitentitel
---

sidebar_position controls the order within the category. Numbering starts at 1.

Category folders​

Each subfolder has a _category_.json:

{
  "label": "Anzeigename",
  "position": 4,
  "link": {
    "type": "generated-index",
    "description": "Kurzbeschreibung der Kategorie."
  }
}

position controls the order in the sidebar relative to other categories (and to intro.md which is position 1).

File naming​

Lowercase, hyphen-separated German words: erste-schritte.md, kzv-abrechnung.md. No umlauts in filenames.

Content language and style​

All content is in German. Follow the style of the sibling repos ../docs-apolloniazpa/ and ../docs-apolloniapix/ — concise, imperative instructions, present tense.

Docusaurus admonitions in use​

:::info[Titel]
Hinweistext
:::

:::tip[Titel]
Tipp-Text
:::

:::warning[Titel]
Warntext
:::

:::note
Anmerkung ohne Titel
:::

Use relative paths from the current file:

[Einführung](../grundlagen/einfuehrung.md)
[Datenpflege](grundlagen/einfuehrung.md)

Architecture overview​

The repo root maps directly to the Docusaurus docs/ folder for the apollonia® product. Two sibling repos follow the same pattern:

RepoProductStructure
docs-apolloniaapollonia® (PVS)Subdirectories per topic area
docs-apolloniazpaapolloniaZPA (KZV-Prüfung)Flat — all .md in root
docs-apolloniapixapolloniaPix (Bildgebung)Flat — all .md in root

This repo intentionally uses subdirectories because apollonia® is the full PVS with many more pages than the two helper tools. Category folders and their position values in _category_.json define the sidebar order on the website.

Source material and content mapping​

The authoritative content source is the original Word/PDF manual (apollonia®6, ~2200 pages) under Claude/Alte Doku/ (gitignored — the Claude/ folder is never committed). The 20 numbered chapters of that manual are the real software structure. They are grouped into 7 category folders here:

Category folderSource chapters
grundlagen/01 Einführung, 02 Funktionen allgemein, 12 Globale Funktionen, 15 Ablage & Bearbeiten
termine/03 Praxisstatus & Termine
patienten/04 Stammdaten, 05 Behandlungsdaten, 07 Patientenliste
hkp/06 HKP & EBZ
abrechnung/08 Abrechnung, 10 Rechnungswesen & Labor, 09 Statistik
verwaltung/14 Datenpflege, 13 Menü Listen, 19 Mitarbeiter, 11 QM
module/17 Briefmodul, 18 apollonia®-pad, 20 xMedia, 16 Hilfe & Analyse

The PDFs are not directly readable by the Read tool (no poppler/pdftoppm in this environment). Extracted plain text lives in Claude/Alte Doku/txt/*.txt (one file per PDF, page markers ===== SEITE N =====), produced with pypdf:

pip3 install pypdf   # python 3.8; pymupdf does NOT build here
# then iterate p.pages[i].extract_text() into txt/<name>.txt

A parsed table of contents for all chapters is in Claude/Alte Doku/txt/_TOC.txt. Use these .txt files (Grep/Read) to pull real content when filling in a chapter — do not invent feature names.

Conventions specific to this manual​

  • * after a feature name marks an optional / paid module (Freischaltung). Preserve this meaning.
  • Each chapter page currently holds a real intro plus a ## Inhalt dieses Kapitels outline of the real subsections, with *(folgt)* placeholders where detailed content is still to be written.