Every diagnosis in circleOS is attached to a diagnosis note, not stored as a standalone field on the patient record. That means each diagnosis keeps its author, date, and note context.
Adding a diagnosis
From the patient profile or note editor
On the patient profile, use Add diagnosis in the diagnosis history card.
The same diagnosis picker also appears inside note workflows when you are writing a note that should carry diagnosis codes.
Search by code, title, or description, then select one or more results. On the patient profile, circleOS creates a new diagnosis note for the patient. Inside the note editor, the selected codes are added to the note you are already working on.
When you add the first diagnosis code in the note editor, circleOS switches that note to a diagnosis note automatically. Remove a code with the x button on its chip before saving if it was added by mistake.
From Live Mode
The Diagnoses card in the right-hand visit cart of Live Mode is designed for fast entry during a visit. It shows:
- Today's diagnoses — codes already recorded for the patient today.
- Recent suggestions — if nothing has been added today, circleOS can suggest diagnoses from the patient's last two months.
- Add diagnosis — opens the same code search used elsewhere in the app.
Accepting a suggestion opens a diagnosis note with that code already selected so you can review and publish it. Rejecting a suggestion only hides it for the current Live Mode session.
Where diagnoses appear
Once saved, a diagnosis shows up in several places:
| Location | What you see |
|---|---|
| The note | The diagnosis codes recorded in that specific note |
| Patient diagnosis history | A running history in the patient profile sidebar, with an Add diagnosis action |
| Live Mode | Today's diagnoses and recent suggestions for the current visit |
| Other diagnosis selectors | Existing diagnoses can be reused in workflows that ask you to choose a diagnosis |
Code systems
The diagnosis picker searches the code systems configured for your workspace. Most German practices use ICD-10-GM, but the available systems depend on your workspace configuration.
If a code system has an active catalogue year set, diagnosis search uses that year. Systems without a year setting stay searchable across their available versions.
Administrators can manage code systems and catalogue years in Settings → Workflow → Diagnosis systems. From there they can also open individual codes to manage mappings and code information.
In practice, this means day-to-day staff usually work from the diagnosis picker, while administrators maintain the underlying catalogue in settings.