Ersteinrichtung der Praxis

Läuft TCMSOFT auf dem Server (siehe TCMSOFT einrichten), braucht die Praxis ein erstes Anmeldekonto und die richtige Edition. Kommt die Praxis mit alten Daten, werden diese als Nächstes übernommen. Danach folgen HTTPS, Arbeitsplätze und Drucker. Diese Seite beschreibt die Schritte für Installateur und TCMSOFT-Support. Wie die Praxis danach ihre Stammdaten einrichtet, steht im Benutzerhandbuch › Erste Schritte › Ersteinrichtung.

Überblick

1. Welcher Weg passt? Neue Praxis, Umzug oder Datenübernahme (nächster Abschnitt). Für Salvia Software muss die Zeile Produkt=Salvia schon vor dem ersten Start in tcmsoft.env stehen, siehe „Produkt und Praxisart“.
2. TCMSOFT zum ersten Mal aufrufen.
3. Das erste Konto anlegen, durch die Praxis oder den Support.
4. Die Edition einstellen (Support). Die Praxisart folgt dem Produkt und wird nicht gewählt: TCMSOFT ist eine ärztliche Praxis (GOÄ), Salvia Software eine Heilpraktiker-Praxis (GebüH).
5. HTTPS einrichten: Netzwerk und HTTPS.
6. Arbeitsplätze, Drucker, Geräte und Datensicherung einrichten. Bei einem Umzug oder einer Datenübernahme erst, wenn die Daten übernommen sind.
7. Die Praxis sperrt den Supportzugriff.

Welcher Weg passt?

Achtung: Eine Datenübernahme leert die TCMSOFT-Datenbank vollständig, ebenso ersetzt das Wiederherstellen einer Sicherung die ganze Datenbank. Erfassen Sie vorher nichts, was die Praxis behalten will.

Bei einer Datenübernahme meldet sich der Support mit dem Support-Konto an. Die Konten der Ärzte und Mitarbeiter entstehen bei der Übernahme. Danach ist die Ersteinrichtung dauerhaft gesperrt (siehe „Wenn etwas nicht klappt“).

TCMSOFT zum ersten Mal aufrufen

Wozu: Beim ersten Start richtet TCMSOFT die leere Datenbank selbst ein, beim ersten Aufruf im Browser lädt es die TCM-Bibliothek. Danach zeigt die Anmeldeseite den Weg zum ersten Konto.

Wie:

1. Warten, bis der Update-Dienst fertig ist. In docker logs tcmsoft-updater steht dann „TCMSOFT … eingerichtet: TCMSOFT ist eingerichtet und aktualisiert sich ab jetzt jede Nacht selbst.“
2. An einem Arbeitsplatz im Browser öffnen:
   • NAS: http://<NAS-Adresse>:8085
   • Mikroserver: die Adresse, unter der Caddy TCMSOFT ausliefert. Dort ist Server__SichereCookies=true von Anfang an gesetzt; die Anmeldung hält also nur über HTTPS (siehe Netzwerk und HTTPS).
3. Beim allerersten Aufruf steht einige Minuten „Lade TCM Bibliothek“. Warten.

Was danach schon da ist: Eine leere Datenbank richtet TCMSOFT vollständig selbst ein. Leer heißt: keine Betriebsstätte, kein Leistungserbringer, kein Patient, kein Akteneintrag, keine Rechnung. Eine Datenbank mit Bestand wird dabei nie geleert. Danach sind vorhanden:

• GOÄ- und ICD-Katalog, Krankenkassen, Vertragsarten
• Behandlungsvertrag (ohne Text), Rechnungsvorlage „GOÄ Rechnung“, Dokumentationstypen, Termingruppe „Standard“
• ein leeres E-Mail-Konto „Email“
• die Platzhalter „Praxis Dr. Muster“ (Stammdaten › Betriebsstätte) und „Dr. Hans Muster“ mit Kürzel „HMuster“ (Stammdaten › Leistungserbringer). Die Praxis ersetzt sie durch ihre Daten, bevor sie zum ersten Mal druckt.
• das Support-Konto, aktiv (siehe unten)
• die Edition TCMSOFTsingle
• die Praxisart „Ärztliche Praxis – Abrechnung nach GOÄ“ mit dem Merker „frische Installation“ (Betriebstaette.PraxisartOffen). Gefragt wird nach der Praxisart nicht.

In Salvia Software richtet derselbe Start danach die Heilpraktiker-Praxis ein und ändert dabei einen Teil dieser Liste, zum Beispiel „GebüH Rechnung“ statt „GOÄ Rechnung“ und „Hans Muster“ statt „Dr. Hans Muster“. Was genau, steht unter „Produkt und Praxisart“.

Erfolg: Die Anmeldeseite zeigt die Karte „Noch kein Konto eingerichtet“ mit dem Knopf Zur Ersteinrichtung.

Wenn nicht:

Das erste Konto anlegen

Solange die Praxis kein eigenes Konto hat, kann jeder, der TCMSOFT im Praxisnetz öffnet, das erste Arztkonto anlegen. Legen Sie es deshalb gleich nach der Einrichtung an. Es gibt zwei Wege.

Weg A: Die Praxis legt das Konto selbst an

1. Auf der Anmeldeseite in der Karte „Noch kein Konto eingerichtet“ auf Zur Ersteinrichtung klicken. Die Seite (Adresse /Account/InitialSetup) zeigt „Willkommen!“.

2. Die Felder ausfüllen:

   Feld	Inhalt
   E-Mail	Pflicht, eine gültige E-Mail-Adresse. Damit meldet sich der Arzt künftig an.
   Angezeigter Name	vorbelegt mit dem Namen des vorhandenen Arztes, bei einer neuen Installation „Dr. Hans Muster“, in Salvia Software „Hans Muster“. Gleich den richtigen Namen eintragen.
   Passwort	Pflicht, mindestens 8 Zeichen
   Passwort wiederholen	muss mit dem Passwort übereinstimmen

3. Auf Admin-Account erstellen klicken.

4. TCMSOFT kehrt zur Anmeldeseite zurück. Mit der eben eingetragenen E-Mail-Adresse und dem Passwort anmelden.

Was dabei passiert: Das Konto bekommt die Rolle „Arzt“ mit vollem Zugriff, unabhängig von der Edition. In der Heilpraktiker-Praxis zeigt die Oberfläche diese Rolle als „Behandler“; gespeichert bleibt „Arzt“. TCMSOFT verknüpft es mit dem ersten aktiven Leistungserbringer (gibt es keinen aktiven, mit dem ersten überhaupt), bei einer neuen Installation dem Platzhalter „Dr. Hans Muster“ (in Salvia Software „Hans Muster“). Weitere Konten legt die Praxis später unter Stammdaten › Leistungserbringer (Ärzte) bzw. Stammdaten › MFA-Benutzer (ab TCMSOFTpro) an, siehe Benutzer, Anmeldung und Zugang.

Erfolg: Nach der Anmeldung erscheint TCMSOFT mit der Navigationsleiste. Die Ersteinrichtung wird ab jetzt nicht mehr angeboten.

Wenn nicht:

Weg B: Der Support legt das Konto an

1. Mit dem Support-Konto anmelden (siehe nächster Abschnitt).
2. Stammdaten › Leistungserbringer öffnen und den Arzt öffnen, bei einer neuen Installation „Dr. Hans Muster“ (in Salvia Software „Hans Muster“).
3. In der Karte Login E-Mail, Passwort und Passwort wiederholen ausfüllen. Die Rolle ist mit „Arzt“ vorbelegt.
4. Oben auf Speichern klicken. Beim Speichern legt TCMSOFT das Anmeldekonto an.
5. Der Praxis E-Mail-Adresse und Passwort mitteilen.

Danach bietet die Anmeldeseite die Ersteinrichtung nicht mehr an.

Das Support-Konto

Wozu: Mit dem Support-Konto richtet der TCMSOFT-Support Installationen ein, stellt die Edition ein, startet die Datenübernahme und legt fehlende Konten an. Nur mit diesem Konto öffnet sich das Servermanagement, in dem Edition und Datenübernahme liegen.

Eigenschaften:

• Es existiert immer. TCMSOFT legt es bei jedem Start an, falls es fehlt, und löscht es nie.
• Es zählt nicht als Konto der Praxis. Deshalb bleibt auf einer frischen Installation die Ersteinrichtung möglich.
• Es hat dieselben Rechte wie die Rolle „Arzt“. In den Listen der Benutzer und Rollen erscheint es nicht.
• Anmeldename und Passwort: beim TCMSOFT-Support erfragen. Notieren Sie sie nicht in der Praxis.

Freigeben und sperren: Nach einer neuen Installation, nach „Datenbank neu initialisieren“ und nach einer Datenübernahme ist das Konto aktiv. Solange die Praxis es nicht sperrt, kann sich jeder mit diesen Zugangsdaten anmelden. Die Praxis schaltet es deshalb selbst:

1. Stammdaten › Betriebsstätte, Karte Support.
2. Supportzugriff sperren. Es erscheint „Supportzugriff gesperrt.“
3. Für einen späteren Einsatz des Supports dort Supportzugriff freigeben, danach wieder sperren.

Die Umschaltung wirkt sofort und steht im Änderungsprotokoll. Ein gesperrtes Support-Konto bleibt auch nach Neustarts und Updates gesperrt. Meldet sich der Support bei gesperrtem Zugriff an, scheitert die Anmeldung mit derselben Meldung wie bei einem falschen Passwort.

Die Edition einstellen

Wozu: Was die Praxis nutzen darf, hängt von der gekauften Edition ab. Einen Lizenzschlüssel gibt es nicht; die Edition ist eine Einstellung der Betriebsstätte. Eine neue Installation startet als TCMSOFTsingle. Eine Datenübernahme setzt immer TCMSOFTpro.

Salvia Software hat dieselben drei Editionen unter den Namen Salvia Single, Salvia Single Unlimited und Salvia Pro, mit denselben Funktionen und Grenzen. Eine neue Salvia-Installation startet als Salvia Single; stellen Sie danach wie hier beschrieben die gekaufte Edition ein. Die Karte Produkt davor zeigt nur an, dass die Installation Salvia Software ist (Servermanagement).

Eine Funktion, die die Edition nicht enthält, fehlt in der Navigation. Bestehende Daten bleiben lesbar.

Wie (Support):

1. Mit dem Support-Konto anmelden und https://<Adresse von TCMSOFT>/servermanagement aufrufen (ohne HTTPS http://<NAS-Adresse>:8085/servermanagement). Es öffnet sich das Servermanagement. Zeigt es nur die Karte „Nur für den TCMSOFT-Support“, sind Sie mit einem anderen Konto angemeldet. Einzelheiten unter Servermanagement.
2. Reiter System, Karte Edition: unter Neue Edition die gekaufte Edition wählen.
3. Auf Edition ändern klicken. Die Rückfrage „Edition auf … ändern?“ nennt, welche Funktionen dazukommen oder wegfallen. Bestätigen.

Erfolg: Es erscheint „Edition geändert“ mit „Die Praxis läuft jetzt als …. Andere geöffnete TCMSOFT-Fenster bitte neu laden (F5).“ Zurück in TCMSOFT zeigt die Versionsnummer oben in der Navigationsleiste unter „TCMSOFT“ die Edition: ohne Zusatz TCMSOFTsingle, mit „u“ TCMSOFTsingle Unlimited, mit „pro“ TCMSOFTpro (z. B. „2026.10.9.1 pro“).

Wenn nicht:

• „Die Betriebsstätte konnte nicht gelesen werden - die Edition lässt sich erst nach der Ersteinrichtung ändern.“: Die Betriebsstätte fehlt oder ließ sich nicht lesen. TCMSOFT neu starten (docker restart tcmsoft); die Prüfung beim Start legt eine fehlende Betriebsstätte als Platzhalter an. Hilft das nicht, docker logs tcmsoft an den TCMSOFT-Support geben.
• Während einer Datenübernahme lässt sich die Edition nicht ändern.

Achtung: „Datenbank neu initialisieren“ im Servermanagement setzt die Edition auf TCMSOFTsingle zurück. Danach die gekaufte Edition neu einstellen. In Salvia Software gilt dasselbe (zurück auf Salvia Single).

Produkt und Praxisart

Wozu: Aus demselben Programm entstehen zwei Produkte. Die Praxisart gilt für die ganze Praxis und folgt dem Produkt. Gewählt wird sie nicht, auch nicht nach der ersten Anmeldung.

Die Praxisart bestimmt auch, was die Oberfläche anbietet. In der Heilpraktiker-Praxis fehlen zum Beispiel AU-Bescheinigung, Überweisung und PVS-Export. Was die Praxis sieht, steht im Benutzerhandbuch. Container, Datenordner, tcmsoft.env und Protokolle heißen auch bei Salvia Software „tcmsoft“.

TCMSOFT: Nichts zu tun. Jede neue Installation ist eine ärztliche Praxis; nach der Praxisart wird nicht gefragt.

Salvia Software festlegen (Installateur):

1. Vor dem ersten Start von TCMSOFT in <Datenordner>/tcmsoft.env diese Zeile eintragen:

   Produkt=Salvia
   

   Eine vorhandene tcmsoft.env übernimmt der Update-Dienst unverändert und ergänzt nichts. Legen Sie die Datei selbst an, tragen Sie deshalb auch die übrigen Zeilen des Standardinhalts ein, vor allem ASPNETCORE_URLS=http://+:8085 (ohne diese Zeile gilt Port 8080), siehe Datenordner und tcmsoft.env. Den fertigen Befehl dafür enthält TCMSOFT einrichten im Abschnitt „Nur für Salvia Software: tcmsoft.env vorher anlegen“, für den Mikroserver im Abschnitt zum Mikroserver.

2. TCMSOFT wie gewohnt einrichten und starten (TCMSOFT einrichten). Der erste Start richtet die Heilpraktiker-Praxis ohne Rückfrage ein.

Beim Start wirkt die Zeile nur auf einer frischen Installation: Die Datenbank ist beim Start leer, oder sie stammt aus einer Neuinstallation bzw. aus Datenbank neu initialisieren und es ist noch nichts erfasst – keine Patienten (auch keine gelöschten), keine Rechnungen (auch keine gelöschten) und keine Abrechnungsfälle mit Leistungen. Anmeldekonten zählen nicht. Eine Installation mit Daten bleibt beim Start immer TCMSOFT; die Zeile wird dann nur im Protokoll vermerkt.

Außerdem gilt die Zeile, wenn der Support im Servermanagement Datenbank neu initialisieren oder Demodaten installieren ausführt. Beides löscht alle Daten und legt die Datenbank gleich als das Produkt aus der Zeile neu an (Produkt=Salvia oder Produkt=TCMSOFT); ohne die Zeile bleibt das bisherige Produkt. Siehe Servermanagement.

Was der Start in Salvia Software einrichtet: Er stellt die Grundausstattung (siehe „TCMSOFT zum ersten Mal aufrufen“) so um, ebenso Datenbank neu initialisieren und Demodaten installieren in Salvia Software. Die Einrichtung selbst löscht nichts.

Was die Heilpraktiker-Praxis nicht zeigt (GOÄ-Katalog, Vertragsarten, LANR, BSNR, die Typen AU und Überweisung), bleibt gespeichert. Platzhalter, Vorlagentexte und Typnamen ändert der Start nur, solange sie unverändert sind.

Woran Sie es erkennen:

• Die Anmeldeseite zeigt die Salvia-Bildmarke und „Salvia Software“.
• Nach der Anmeldung steht oben in der Seitenleiste „Salvia“. Die Versionsnummer darunter hat den Zusatz der Edition wie in TCMSOFT (ohne Zusatz Salvia Single, „u“ Salvia Single Unlimited, „pro“ Salvia Pro).
• Im Protokoll (docker logs tcmsoft) stehen beim ersten Start „Neue Installation als Salvia eingerichtet (Parameter Produkt in tcmsoft.env).“, und „Praxisart von Arzt auf Heilpraktiker gestellt von unbekannt: … angepasst.“

Zeile vergessen: Ist TCMSOFT schon ohne die Zeile gestartet, ist die Installation TCMSOFT (Anmeldeseite „TCMSOFT“). Solange sie frisch ist, holen Sie es nach:

1. Produkt=Salvia in tcmsoft.env eintragen.
2. Den Container neu anlegen lassen (docker rm -f tcmsoft), siehe Einstellungen wirksam machen. docker restart tcmsoft genügt nicht, weil Docker tcmsoft.env nur beim Anlegen des Containers liest.
3. Prüfen wie unter „Woran Sie es erkennen“. Ein schon angelegtes erstes Konto bleibt.

Ist schon etwas erfasst, bleibt die Installation beim Start TCMSOFT. Dürfen diese Daten verloren gehen (zum Beispiel nur Probedaten), führt der Support nach Schritt 1 und 2 im Servermanagement Datenbank neu initialisieren aus. Das löscht alles und legt die Datenbank gleich als Salvia Software neu an, siehe Servermanagement.

Technisch:

• Betriebstaette.Produkt (0 = TCMSOFT, Standard für alle bestehenden Praxen; 1 = Salvia) hält das Produkt und kommt mit jeder Sicherung. Ist es einmal Salvia, gilt es bei jedem Start, auch ohne die Zeile. Die Zeile zu entfernen oder Produkt=TCMSOFT einzutragen, stellt beim Start nichts zurück.
• Datenbank neu initialisieren und Demodaten installieren legen die Betriebsstätte gleich mit dem Produkt aus der Zeile an, ohne Zeile mit dem bisherigen. In Salvia Software heilen sie danach die Datenbank wie der Programmstart und richten die Heilpraktiker-Praxis ein, ohne Neustart. Wechselt das Produkt dabei, gelten Name und Bildmarke sofort für die Anmeldeseite und die Mails der Anmeldung.
• Betriebstaette.Praxisart (0 = Arzt). Umgestellt wird sie nur beim Einrichten von Salvia Software, und zwar zuletzt: Bricht die Einrichtung ab, holt der nächste Start sie nach, solange die Installation frisch ist.
• Der Merker Betriebstaette.PraxisartOffen bedeutet nur noch „frische Installation“; gefragt wird nicht. Ihn setzen eine neue Installation und Datenbank neu initialisieren, nie Demodaten installieren und die Datenübernahme. Die Einrichtung der Heilpraktiker-Praxis löscht ihn, in TCMSOFT bleibt er ohne Wirkung stehen.
• Die Systemtypen AU und Überweisung bleiben in der Datenbank aktiv; die Heilpraktiker-Praxis blendet sie nur unter „Neu“ aus (Merkmal im Code, kein Feld). Attest und westliches Rezept speichern die Praxisart am Eintrag (AkteAttest.Praxisart, AkteWestlichesRezept.Praxisart, fehlend = Arzt); die Seite setzt sie beim Öffnen auf die der Praxis.
• Die Startheilung einer Heilpraktiker-Praxis benennt „Attest“ / „Westliches Rezept“ in „Bescheinigung“ / „Arzneimittelempfehlung“ um, solange der Standardtext dasteht, und legt einen fehlenden Katalog „GebüH“ an (den GOÄ-Katalog dort nicht). Gibt es den Katalog „GebüH“, gleicht ihn jeder Start mit der mitgelieferten Datei Resources/gebueh.json im Programmordner ab: fehlende Positionen, Texte, Spannen, Beihilfe-Höchstbeträge und Hinweise, nie den Praxisbetrag; eigene Ziffern der Praxis im Katalog bleiben, wie sie sind. Im Protokoll steht dann „Katalog „GebüH“ abgeglichen: … Positionen ergänzt oder aktualisiert“. Den Behandlungsvertrag füllt nur die Einrichtung, nie die Startheilung.

Wenn nicht:

HTTPS einrichten

Richten Sie HTTPS ein, bevor an den Arbeitsplätzen Print Agents gekoppelt werden. Die Kopplung per Code geht zwar auch über http://, aber ein Print Agent verbindet sich immer mit der Adresse, mit der er gekoppelt wurde; ändert sie sich später, muss er neu gekoppelt werden. Agent suchen geht nur über HTTPS. Wie das geht, steht unter Netzwerk und HTTPS. Nach dem Umstellen meldet sich die Praxis nur noch über die HTTPS-Adresse an.

Danach: Arbeitsplätze, Drucker, Daten

Die Reihenfolge ist eine Empfehlung. Was die Praxis nicht braucht, entfällt. Eine Datenübernahme kommt immer zuerst: Sie leert die TCMSOFT-Datenbank vollständig, auch die Kopplungen der Prismamed Agents und Handys und alles, was in TCMSOFT schon eingetragen wurde.

Wenn etwas nicht klappt

„Ersteinrichtung gerade nicht möglich“ bzw. Karte „Hinweis“ auf der Anmeldeseite. Die Ersteinrichtung ist gesperrt, solange eine Datenübernahme läuft, und dauerhaft, sobald in der Datenbank ein Übernahmelauf steht, auch ein fehlgeschlagener. Sonst könnte sich nach der Übernahme jeder im Praxisnetz ein Arztkonto mit Zugriff auf die übernommenen Patienten anlegen. Die Ärzte melden sich mit ihrem bisherigen Kürzel, die Mitarbeiter mit ihrem bisherigen Benutzernamen an, jeweils mit dem bisherigen Passwort. Fehlt ein Konto, legt es der Support unter Stammdaten › Leistungserbringer an (Weg B). Aufheben lässt sich die Sperre nur mit „Datenbank neu initialisieren“ im Servermanagement, und das löscht alle Daten der Praxis.

Die Praxis hat ihr einziges Passwort vergessen. Der Support meldet sich mit dem Support-Konto an, öffnet unter Stammdaten › Leistungserbringer den Arzt, trägt in der Karte Login unter Neues Passwort und Wiederholen ein neues Passwort ein und klickt auf Speichern. Dafür muss der Supportzugriff freigegeben sein. Ist er gesperrt und kann sich niemand der Praxis anmelden, gibt es in der Oberfläche keinen Weg, auch nicht mit Datenverlust: Auch „Datenbank neu initialisieren“ braucht das Support-Konto. Dann den TCMSOFT-Support einschalten. Siehe Benutzer, Anmeldung und Zugang.

Die Anmeldung springt immer wieder zur Anmeldeseite zurück. Server__SichereCookies=true ist gesetzt, TCMSOFT wird aber über http:// geöffnet. Siehe Netzwerk und HTTPS.

Der Support kann sich nicht anmelden. Meist hat die Praxis den Supportzugriff gesperrt. Sie gibt ihn unter Stammdaten › Betriebsstätte, Karte Support, mit Supportzugriff freigeben frei.