Erste Schritte
Überblick
Nach der Installation führt ein Assistent in höchstens sieben Schritten zum ersten versendeten Angebot. Er startet beim ersten Anmelden des Administrators von selbst. Jeder Schritt lässt sich überspringen, der Fortschritt bleibt auf dem Server gespeichert — auch über Abmelden und Gerätewechsel hinweg.
Wer den Assistenten verlässt („Später weitermachen“ oder ein Klick ins Menü), sieht oben über dem Inhalt ein Band mit dem Fortschritt und „Fortsetzen“. Ist alles erledigt, schließt „Fertig“ den Assistenten; unter Plugins öffnet „Erste Schritte“ ihn jederzeit wieder — Erledigtes bleibt erledigt.
Bestehende Installationen sehen den Assistenten nicht von selbst: nach einem Update gilt er als abgeschlossen. Dasselbe gilt für eine Installation mit Beispieldaten (Vorführ- oder Prüfstand, Häkchen „Beispiel-/Demo-Datenset“ im Installer bzw. app:install --with-demo): sie startet in der Übersicht mit allen Funktionen (Profi), ohne Assistent und ohne Band.
Kernaufgaben
- Firma und Marke — Name, Anschrift, USt-IdNr. und Logo. So erscheinen sie auf Angeboten, Rechnungen
und Mails. Gibt es noch keine Marke, legt der Schritt sie an; das Logo lässt sich nach dem ersten Speichern hochladen.
- Starter-Paket — Agentur, Dienstleister, Handel, Support oder Alles. Nur die Module des Pakets sind
danach an; alles andere bleibt installiert und lässt sich unter „Mehr freischalten“ mit einem Klick einschalten. Die Module, die zum Paket passen, stehen dort zuerst. Die Wahl im Assistenten legt außerdem fest, dass neue Kollegen in der Stufe Basis starten, Administratoren in Profi.
- Team einladen — je Person E-Mail und Rolle; die Rolle ist passend zum Paket vorgeschlagen. Die
Einladung kommt per Mail.
- Postfach verbinden — führt auf die Einrichtung des persönlichen Postfachs bzw. des
Versand-Postfachs der Firma. Danach bringt das Band zurück in den Assistenten.
- Nummern und Zahlungsbedingungen — zeigt die Nummernkreise mit der nächsten Nummer (bzw. die
Vorlage, solange noch kein Beleg entstanden ist) und die Zahlungsbedingungen mit der Vorgabe. „Weiter“ bestätigt, „Ändern“ öffnet die Pflege-Seite.
- Erstes Angebot — einen Kunden anlegen (Name genügt; mit E-Mail und Anschrift geht der Versand mit einem Klick),
dann eine Position mit Preis. Senden schickt das Angebot an die E-Mail des Kunden; alternativ als PDF herunterladen. Sind Angebote im gewählten Paket aus, nennt der Schritt den Weg über „Mehr freischalten“.
- Beispieldaten oder eigene Daten — Beispieldaten füllen jede Ansicht mit einer fiktiven Agentur.
Daneben stehen alle Wege, eigene Daten zu übernehmen.
Beispieldaten laden und wieder entfernen
„Beispieldaten laden“ legt das Beispiel-Set über alle Module an (etwa eine Minute). Das System merkt sich dabei genau, welche Datensätze dazugehören.
„Beispieldaten entfernen“ löscht diese Datensätze wieder — rückstandsfrei: auch den Verlauf, die Suchtreffer und die Dateien der Beispiele. Vorhandene Datensätze, die das Laden ergänzt hatte, stehen danach wieder auf dem alten Stand. Das geht nur, solange seit dem Laden keine eigenen Daten entstanden sind (z. B. ein eigener Kunde oder ein eigenes Angebot). Sonst bleibt der Knopf gesperrt und nennt den Grund — so geht nichts Eigenes verloren. Was vor dem Laden schon da war, fasst das Entfernen nie an.
Eigene Daten übernehmen
- CSV-Import (Kunden, Kontakte, Produkte und weitere Ziele) unter Einstellungen → Datenimport
- awork über die awork-Übernahme in den Einstellungen (Modul „awork-Import“)
- HubSpot über das Modul HubSpot-Import — siehe HubSpot-Import
Felder im Detail
| Feld | Bedeutung |
|---|---|
| Name (Firma) | Pflicht. Erscheint im Briefkopf und als Absender. |
| Anschrift, Land | Briefkopf und Zahlungsempfänger. Land als ISO-Code, z. B. DE. |
| USt-IdNr. | Steht auf Rechnungen; nötig für innergemeinschaftliche Lieferungen. |
| E-Mail / Rolle (Team) | Leere Zeilen zählen nicht; ohne Eintrag gilt der Schritt als übersprungen. |
| Kunde: Name, E-Mail, Anschrift | Name ist Pflicht. Zum Versenden braucht der Kunde eine E-Mail und eine Rechnungsanschrift (Straße, Ort; Land wie die Firma) — dann geht das Angebot mit einem Klick hinaus. |
| Leistung, Preis | Eine Angebotsposition; der Steuersatz kommt aus dem Steuerkatalog. |
Einstellungen & Rechte
- Assistent, Band und Beispieldaten verlangen das Recht
platform.setup.manage(Rolle GF/Admin). - Die einzelnen Schritte schreiben über die gewohnten Wege und brauchen deren Rechte: Marken pflegen,
Nutzer verwalten, Kunden anlegen, Angebote anlegen und senden.
- Schnittstelle:
GET/POST /api/v1/setup/erste-schritte(Stand, Schritt markieren, pausieren,
fortsetzen, abschließen, neu starten); GET /api/v1/setup/beispieldaten, POST /api/v1/setup/beispieldaten (laden), POST /api/v1/setup/beispieldaten/entfernen. Laden und Entfernen stehen im Audit-Protokoll.
- Konsole (Betrieb):
bin/console app:seed:demo-datalädt,bin/console app:seed:demo-data --entfernenentfernt —
mit denselben Regeln.
FAQ & Fehlerbilder
Der Assistent startet nicht. Er startet nur bei einer neuen Installation ohne Beispieldaten von selbst. Unter Plugins öffnet „Erste Schritte“ ihn jederzeit.
„Beispieldaten lassen sich nicht entfernen: Seit dem Laden sind eigene Daten entstanden“. Das ist Absicht: Beispiele zwischen echten Daten zu löschen könnte Eigenes beschädigen. Die genannten Bereiche zeigen, wo Eigenes entstanden ist; Beispiel-Datensätze lassen sich dort einzeln löschen.
„… vor dieser Version geladen“. Beispieldaten, die vor dieser Version geladen wurden, tragen kein Lade-Protokoll; welche Datensätze dazugehören, ist nicht bekannt. Sie bleiben stehen.
„Zum Versand braucht der Kunde eine Rechnungsanschrift …“. Straße, Ort und Land gehören auf jedes Angebot. Im Kundenstamm ergänzen oder das Angebot als PDF herunterladen.
Das Band stört. „Ausblenden“ blendet es für die laufende Sitzung aus; „Fertig“ im Assistenten beendet ihn ganz.