convez.ai
Skill
investorthm-ops

Grundsteuer-app

investorthm-ops/Grundsteuer-app

Ver no GitHub
InicialPluginScore · de 0 a 100

Bundesweite Transparenz für kommunale Hebesätze (Grundsteuer A/B, Gewerbesteuer). Next.js 16 + Supabase + Claude Skill Pipeline.

Instalação

$npx convez-ai investorthm-ops/Grundsteuer-app

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 semanas
Versão
—
Issues abertas
0
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

Grundsteuer-Monitor

Bundesweite Transparenz für kommunale Hebesätze (Grundsteuer A, Grundsteuer B, Gewerbesteuer) — Datenbank, Vergleich, Import-Pipeline und Export. Next.js 16 + Supabase.

Live-Demo: https://grundsteuer-app.vercel.app

Hebesatz-Datenbank — Übersicht mit Suche, Bundesland-Filter und Vergleich Vorjahr/Aktuell


Worum es geht

Hebesätze deutscher Kommunen sind öffentlich, aber zersplittert: Amtsblätter, Statistikämter, Kommunal-Webseiten. Wer Standortentscheidungen trifft, Mandanten berät oder Bestände bewertet, sucht heute manuell zusammen, was eigentlich eine Datenbank-Abfrage sein sollte.

Der Grundsteuer-Monitor zentralisiert das: gepflegte Hebesatz-Datenbank für alle 16 Bundesländer, Vergleich, Watchlist mit Änderungs-Alerts, CSV/Excel-Export.

Zielgruppen: Steuerberater, Immobilieninvestoren, Kommunen, Mittelstand.

USP: Änderungen bei Grundsteuer- und Gewerbesteuer-Hebesätzen automatisch überwachen, vergleichen und als Excel-Auswertung für Mandanten oder Immobilienportfolios nutzen.


Tech-Stack

LayerTool
FrameworkNext.js 16 (App Router), TypeScript
StylingTailwind CSS + shadcn/ui
BackendSupabase (PostgreSQL, Auth, Row Level Security)
ValidierungZod + react-hook-form
DeploymentVercel
WorkflowClaude Code Skill Pipeline

Features (Stand)

IDFeatureStatus
PROJ-1Bundesweite Hebesatz-Datenbank — suchbar, filterbar, paginiert✅ MVP
PROJ-4Import-Pipeline — Admin-CSV-Upload mit Staging, Row-Validierung, Approval-Workflow, Audit-Trail✅ MVP
PROJ-5CSV/Excel-Export der Municipality-Daten✅ MVP
PROJ-2Watchlist + Änderungs-Alerts✅ MVP
PROJ-3SEO-Stadtseiten✅ MVP
PROJ-6Renditeauswirkungs-Rechner✅ MVP
PROJ-7Vergleich und Benchmarking✅ MVP
PROJ-8Mandantenfähige Nutzerverwaltung✅ MVP
PROJ-9Datenvertrauen und Demo-Daten✅ MVP
PROJ-10Differenzierte Grundsteuer-B-Hebesätze✅ MVP
PROJ-11Homepage- und Legal-Seiten-Redesign✅ MVP
PROJ-12Self-Service-Auth und Audit-Log✅ MVP
PROJ-13Mein Zugang✅ MVP

Detaillierte Specs pro Feature unter features/. Übersicht: features/INDEX.md.

Stakeholder-Zusammenfassung mit Problem, Nutzenversprechen, Geschäftsmodell und Haftungshinweis: docs/stakeholder-summary.md.

Datenschutz- und DSGVO-Arbeitsnotizen: docs/privacy-dsgvo-notes.md.

Erste Datenschutzerklaerung in der App: src/app/datenschutz/page.tsx.

Legal-Checkliste vor zahlenden Kunden: docs/legal-checklist.md.

Technische Voraussetzungen und Betriebsmodell: docs/technical-requirements.md.

Production-Readiness vor Pilotkunden: docs/production-readiness.md.


Lokales Setup

Voraussetzungen: Node.js 20+, ein Supabase-Projekt (kostenloser Free-Tier reicht).

git clone https://github.com/investorthm-ops/Grundsteuer-app.git
cd Grundsteuer-app
npm install

# Env-Vars setzen
cp .env.local.example .env.local
# .env.local mit Supabase-URL und Anon-Key füllen

# Migrationen anwenden (Supabase CLI)
supabase db push

# Optional: Seed-Daten für Demo-Municipalities
psql <connection-string> -f supabase/seed_demo_municipalities.sql

npm run dev

App läuft auf http://localhost:3000.


Architektur-Highlights

  • Row Level Security als Standard. Server-side-Zugriffe gehen im Normalfall über die User-Session via @supabase/ssr. Autorisierung wird durch RLS + user_roles-Tabelle erzwungen.
  • Service-Role-Key nur serverseitig. Für PROJ-12 wird SUPABASE_SERVICE_ROLE_KEY ausschließlich serverseitig für Nutzer-Einladungen und Audit-Log-Schreibvorgänge genutzt. Der Key darf nie im Client-Bundle oder mit NEXT_PUBLIC_ auftauchen.
  • Import-Staging. CSV-Uploads landen zuerst in import_runs + import_rows, werden validiert (Pflichtfelder, Bundesland-Whitelist, Hebesatz 0–2000, Delta-Flagging), und müssen pro Run vom Admin approved werden, bevor sie in die Live-Tabelle wandern.
  • Audit-Trail. Jeder Import-Run trägt Quelle, Datum, ausführender User, Resultat-Counts.

Architektur-Diagramm: diagrams/grundsteuer-monitor-projektueberblick.png.


Über das Projekt

Das ist ein Lern- und Portfolio-Projekt eines Solo-Entwicklers (Markus, SAP-Berater, Selbstständigkeit nebenher). Ziel ist nicht primär kommerzielle Skalierung, sondern:

  1. Eine reale Domäne mit Tiefe (Steuerrecht, Datenpflege) ernsthaft durcharbeiten.
  2. Den Claude-Code-Skill-Pipeline-Workflow (/requirements → /architecture → /backend → /frontend → /qa → /deploy) an einem nicht-trivialen Beispiel testen.
  3. Einen sauberen Next.js + Supabase Tech-Stack tief verstehen.

Pull Requests, Feedback und Diskussionen sind willkommen.


Legacy-Artefakte

Im Repo-Root finden sich noch ältere HTML-MVPs und Pitch-Unterlagen aus der Vor-Phase (Grundsteuer-Monitor-MVP.html, Grundsteuer-Monitor-Pitch.pdf, ...). Diese sind historisch und werden nicht mehr gepflegt. Die aktuelle Implementation ist die Next.js-App unter src/.


Lizenz

MIT — siehe LICENSE.

Ver o original no GitHub

Bom para

Relacionados