v1.24: Anleitungsseite (Mieter/Verwaltung), Stand wird vor jedem Build automatisch aktualisiert

This commit is contained in:
2026-10-04 15:07:01 +02:00
parent f15f816871
commit 29d32deef5
9 changed files with 390 additions and 4 deletions
+2
View File
@@ -13,6 +13,7 @@ import Kosten from './pages/Kosten'
import Bestand from './pages/Bestand'
import BenutzerVerwaltung from './pages/BenutzerVerwaltung'
import Profil from './pages/Profil'
import Anleitung from './pages/Anleitung'
/** Fängt Render-Fehler ab – statt schwarzem Bildschirm: Hinweis + Reload. */
class FehlerGrenze extends Component<{ children: ReactNode }, { fehler: boolean }> {
@@ -89,6 +90,7 @@ export default function App() {
<Route path="/bestand" element={<Bestand />} />
<Route path="/dokumente" element={<Documents />} />
<Route path="/nachrichten" element={<Messages />} />
<Route path="/anleitung" element={<Anleitung />} />
<Route path="/profil" element={<Profil />} />
<Route path="/benutzer" element={<BenutzerVerwaltung />} />
</Route>
+2
View File
@@ -11,6 +11,7 @@ import {
Gauge,
Calculator,
UserRound,
CircleHelp,
} from 'lucide-react'
import { useStore } from '../store/store'
import ThemeToggle from './ThemeToggle'
@@ -24,6 +25,7 @@ const navItems = [
{ to: '/kosten', label: 'Steuer & Kosten', icon: Calculator },
{ to: '/dokumente', label: 'Dokumente', icon: FileText },
{ to: '/nachrichten', label: 'Nachrichten', icon: MessagesSquare },
{ to: '/anleitung', label: 'Anleitung', icon: CircleHelp },
{ to: '/profil', label: 'Mein Profil', icon: UserRound },
]
+224
View File
@@ -0,0 +1,224 @@
// Inhalt der Anleitungsseite (/anleitung).
// Pro Abschnitt: Zielgruppe, Titel, kurze Punkte. Wird auf der Seite
// rollenbasiert gefiltert (Mieter sehen nur Mieter-Inhalte).
export type AnleitungGruppe = 'mieter' | 'verwaltung'
export interface AnleitungPunkt {
titel: string
text: string
}
export interface AnleitungAbschnitt {
gruppe: AnleitungGruppe
titel: string
punkte: AnleitungPunkt[]
}
export const anleitungIntro: Record<AnleitungGruppe, string> = {
mieter:
'Willkommen im Mieterportal der Hinterstein Immobilien. Hier finden Sie eine Kurzanleitung ' +
'zu allen Funktionen, die Ihnen als Mieter zur Verfügung stehen.',
verwaltung:
'Arbeitshilfe für die Verwaltung: Aufbau und Bedienung aller Verwaltungsfunktionen im Portal. ' +
'Der Reiter „Mieter-Ansicht“ zeigt, was Mieter sehen.',
}
export const anleitungAbschnitte: AnleitungAbschnitt[] = [
{
gruppe: 'mieter',
titel: 'Anmeldung & Zugang',
punkte: [
{
titel: 'Einloggen',
text: 'Auf der Startseite Benutzername und Passwort eingeben. Die Anmeldung bleibt im Browser erhalten; über „Abmelden“ in der Seitenleiste wird die Sitzung beendet.',
},
{
titel: 'Passwort',
text: 'Das Passwort erhalten Sie von der Verwaltung. Ändern Sie es nach dem ersten Login in „Mein Profil“.',
},
{
titel: 'Passwort vergessen',
text: 'Bitte die Verwaltung kontaktieren (joseph@hinterstein-immo.de) – sie setzt ein neues Passwort.',
},
],
},
{
gruppe: 'mieter',
titel: 'Dashboard',
punkte: [
{
titel: 'Alles auf einen Blick',
text: 'Ankündigungen der Verwaltung, offene Beträge und ungelesene Nachrichten finden Sie auf der Startseite nach dem Login.',
},
],
},
{
gruppe: 'mieter',
titel: 'Mietkonto & Zahlungen',
punkte: [
{
titel: 'Saldo prüfen',
text: 'Aktueller Kontostand, offene und erledigte Buchungen Ihrer Wohnung sind unter „Mietkonto & Zahlungen“ einsehbar.',
},
{
titel: 'Überweisen',
text: 'Überweisen Sie offene Beträge an die Bankverbindung der Verwaltung. Eingehende Zahlungen werden von der Verwaltung gebucht.',
},
],
},
{
gruppe: 'mieter',
titel: 'Schäden melden',
punkte: [
{
titel: 'Schaden erfassen',
text: 'Unter „Schadensmeldungen“ einen neuen Schaden mit Wohnung, Kategorie, Beschreibung und Foto melden.',
},
{
titel: 'Automatische Benachrichtigung',
text: 'Zu jeder Meldung wird automatisch eine Nachricht eröffnet und die Verwaltung per E-Mail informiert – Sie erhalten eine Bestätigungsmail.',
},
{
titel: 'Verlauf verfolgen',
text: 'Antworten und Status der Verarbeitung finden Sie im Nachrichten-Modul. Neue Antworten kommen zusätzlich per E-Mail.',
},
{
titel: 'Erstantwort',
text: 'Die erste Rückmeldung kann automatisch von einer KI kommen und wird anschließend von der Verwaltung geprüft.',
},
],
},
{
gruppe: 'mieter',
titel: 'Zählerstände',
punkte: [
{
titel: 'Stände eintragen',
text: 'Unter „Zählerstände“ sehen Sie die Strom-, Wasser- und Gaszähler Ihrer Wohnung und tragen neue Stände mit Datum ein.',
},
],
},
{
gruppe: 'mieter',
titel: 'Dokumente',
punkte: [
{
titel: 'Unterlagen abrufen',
text: 'Mietvertrag, Nebenkostenabrechnungen und weitere Dokumente Ihrer Wohnung können Sie hier ansehen und herunterladen.',
},
],
},
{
gruppe: 'mieter',
titel: 'Nachrichten',
punkte: [
{
titel: 'Mit der Verwaltung schreiben',
text: 'Alle Unterhaltungen mit der Verwaltung laufen gebündelt hier. Ungelesene Antworten sind im Menü mit einer Zahl gekennzeichnet.',
},
],
},
{
gruppe: 'mieter',
titel: 'Mein Profil',
punkte: [
{
titel: 'Stammdaten pflegen',
text: 'Halten Sie Telefonnummer, E-Mail-Adresse und Bankverbindung (Kontoinhaber, IBAN, Bankname) aktuell – die Verwaltung nutzt diese Daten für Abrechnung und Kontakt.',
},
],
},
{
gruppe: 'verwaltung',
titel: 'Benutzerverwaltung',
punkte: [
{
titel: 'Mieter anlegen & pflegen',
text: 'Neue Mieter mit Benutzername, Name und E-Mail-Adresse anlegen, bearbeiten oder deaktivieren. Jedem Mieter ist seine Wohneinheit zugeordnet.',
},
{
titel: 'Passwort zurücksetzen',
text: 'Bei „Passwort vergessen“ vergeben Sie ein neues Erst-Passwort (z. B. 0815) – der Mieter sollte es danach in „Mein Profil“ ändern.',
},
{
titel: 'Registrierungen prüfen',
text: 'Neue Registrierungen von Mietern werden automatisch per E-Mail an die Verwaltung gemeldet und hier geprüft.',
},
],
},
{
gruppe: 'verwaltung',
titel: 'Häuser & Wohnungen',
punkte: [
{
titel: 'Haus anlegen',
text: 'Pflichtangaben: Baujahr, Adresse, Etagenhöhe, Stockwerke, Anzahl Wohneinheiten und Quadratmeter.',
},
{
titel: 'Wohnungen zuordnen',
text: 'Jede Wohnung gehört zu einem Haus: Etage, Wohnfläche, Kalt-/Warmmiete, Mieter und Status (vermietet/frei) je Einheit pflegen. Der Bestand erscheint anschließend im Dashboard.',
},
],
},
{
gruppe: 'verwaltung',
titel: 'Steuer & Kosten',
punkte: [
{
titel: 'Kosten erfassen',
text: 'Kostenpositionen je Haus oder Wohnung anlegen und als umlegbar/nicht umlegbar markieren – Grundlage der Nebenkostenabrechnung.',
},
{
titel: 'Belege aus Spark Receipt',
text: 'Gescannte Belege werden per OCR analysiert und primär über die Stromzählernummer, sekundär über die Adresse der Wohnung zugeordnet.',
},
{
titel: 'Abrechnung erzeugen',
text: 'Im Tab „Kosten“ über „Abrechnung erzeugen“ Wohnung und Jahr wählen: Das Portal erstellt eine druckfertige Nebenkostenabrechnung als PDF und legt sie im Dokumentenmodul ab.',
},
],
},
{
gruppe: 'verwaltung',
titel: 'Schadensmeldungen & Kommunikation',
punkte: [
{
titel: 'Meldungen bearbeiten',
text: 'Jede Schadensmeldung startet automatisch eine Nachricht. Ihre Antworten werden per E-Mail an den Mieter versendet.',
},
{
titel: 'KI-Unterstützung (n8n)',
text: 'Das Automatisierungssystem erzeugt zu Schadensmeldungen automatisch eine Antwort, die ins Portal übernommen und von Ihnen geprüft bzw. ergänzt wird.',
},
{
titel: 'Direkt-E-Mail an Mieter',
text: 'Im Nachrichten-Modul können Sie E-Mails direkt an Mieter senden; die Verwaltung erhält automatisch eine Kopie (CC).',
},
],
},
{
gruppe: 'verwaltung',
titel: 'Dokumente & Zählerstände',
punkte: [
{
titel: 'Dokumente hochladen',
text: 'PDFs (z. B. Mietverträge, Abrechnungen) hochladen und Kategorie sowie Wohnung zuordnen. Mieter sehen nur Dokumente ihrer eigenen Wohnung.',
},
{
titel: 'Zähler pflegen',
text: 'Zähler je Wohnung mit Zählernummer und Zählerart anlegen und die von Mietern erfassten Stände prüfen.',
},
],
},
{
gruppe: 'verwaltung',
titel: 'Darstellung',
punkte: [
{
titel: 'Hell / Dunkel',
text: 'Das Design lässt sich über den Schalter in der Seitenleiste (Desktop) bzw. oben rechts (Mobil) zwischen hellem und dunklem Modus wechseln.',
},
],
},
]
+119
View File
@@ -0,0 +1,119 @@
import { useMemo, useState } from 'react'
import {
Building2,
Calculator,
CircleHelp,
FileText,
Gauge,
Info,
KeyRound,
LayoutDashboard,
MessagesSquare,
Paintbrush,
UserRound,
Users,
Wallet,
Wrench,
} from 'lucide-react'
import { useStore } from '../store/store'
import {
anleitungAbschnitte,
anleitungIntro,
type AnleitungAbschnitt,
type AnleitungGruppe,
} from '../data/anleitung'
import { anleitungMeta } from '../data/anleitung-meta'
const Icons: Record<string, typeof Info> = {
'Anmeldung & Zugang': KeyRound,
Dashboard: LayoutDashboard,
'Mietkonto & Zahlungen': Wallet,
'Schäden melden': Wrench,
Zählerstände: Gauge,
Dokumente: FileText,
Nachrichten: MessagesSquare,
'Mein Profil': UserRound,
Benutzerverwaltung: Users,
'Häuser & Wohnungen': Building2,
'Steuer & Kosten': Calculator,
'Schadensmeldungen & Kommunikation': MessagesSquare,
'Dokumente & Zählerstände': FileText,
Darstellung: Paintbrush,
}
function AbschnittKarte({ abschnitt }: { abschnitt: AnleitungAbschnitt }) {
const Icon = Icons[abschnitt.titel] ?? Info
return (
<section className="rounded-2xl border bg-white p-5 shadow-sm dark:bg-slate-900">
<h2 className="flex items-center gap-2 font-semibold">
<span className="rounded-xl bg-teal-50 p-2 dark:bg-teal-950">
<Icon className="h-4.5 w-4.5 text-teal-700 dark:text-teal-300" />
</span>
{abschnitt.titel}
</h2>
<ul className="mt-4 space-y-3">
{abschnitt.punkte.map((p) => (
<li key={p.titel} className="text-sm">
<div className="font-medium text-slate-800 dark:text-slate-100">{p.titel}</div>
<p className="mt-0.5 leading-relaxed text-slate-500 dark:text-slate-400">{p.text}</p>
</li>
))}
</ul>
</section>
)
}
export default function Anleitung() {
const { role } = useStore()
const istVerwaltung = role === 'admin'
const [tab, setTab] = useState<AnleitungGruppe>('verwaltung')
// Mieter sehen nur Mieter-Inhalte; die Verwaltung wählt zwischen beiden Ansichten.
const gruppe: AnleitungGruppe = istVerwaltung ? tab : 'mieter'
const abschnitte = useMemo(
() => anleitungAbschnitte.filter((a) => a.gruppe === gruppe),
[gruppe],
)
return (
<div className="space-y-6">
<div className="flex flex-wrap items-end justify-between gap-3">
<div>
<h1 className="flex items-center gap-2 text-2xl font-bold tracking-tight">
<CircleHelp className="h-6 w-6 text-teal-700 dark:text-teal-300" />
Anleitung
</h1>
<p className="mt-1 text-sm text-slate-500 dark:text-slate-400">{anleitungIntro[gruppe]}</p>
</div>
<div className="rounded-full border bg-white px-4 py-1.5 text-xs text-slate-500 shadow-sm dark:bg-slate-900 dark:text-slate-400">
Stand {anleitungMeta.datum} · Build {anleitungMeta.hash}
</div>
</div>
{istVerwaltung && (
<div className="flex gap-2 border-b border-slate-200 dark:border-slate-800">
{([['verwaltung', 'Für die Verwaltung'], ['mieter', 'Mieter-Ansicht']] as const).map(([wert, label]) => (
<button
key={wert}
onClick={() => setTab(wert)}
className={`-mb-px border-b-2 px-4 py-2 text-sm font-medium transition ${
tab === wert
? 'border-teal-600 text-teal-700 dark:text-teal-300'
: 'border-transparent text-slate-500 hover:text-slate-700 dark:text-slate-400 dark:hover:text-slate-200'
}`}
>
{label}
</button>
))}
</div>
)}
<div className="grid gap-4 lg:grid-cols-2">
{abschnitte.map((a) => (
<AbschnittKarte key={a.titel} abschnitt={a} />
))}
</div>
</div>
)
}