From 8cc3ddb89dc8ff39e36ee664ef0a96b3053ce20a Mon Sep 17 00:00:00 2001 From: elpatron Date: Thu, 5 Mar 2026 20:01:48 +0100 Subject: [PATCH] =?UTF-8?q?README.md=20hinzugef=C3=BCgt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Made-with: Cursor --- README.md | 69 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..5aa0d3d --- /dev/null +++ b/README.md @@ -0,0 +1,69 @@ +# Offene Innovation SH – Projektplattform + +Prototyp einer Webplattform für das [Landesprogramm Offene Innovation](https://digitalhub.sh/de/call-for-concept-zum-landesprogramm-offene-innovation) in Schleswig-Holstein. Verwaltungen können hier Projekte einreichen, Anwender können Projekte suchen und sich als Mitarbeitende bewerben. + +## Funktionen + +- **Projekte durchsuchen** – Suche nach Titel/Beschreibung, Filter nach Kategorie +- **Projekt einreichen** – Formular für Behörden und Organisationen +- **Bewerben** – Anwender können sich für Projekte als Mitarbeitende bewerben +- **Demo-Daten** – 6 vorkonfigurierte Beispielprojekte + +## Voraussetzungen + +- Python 3.11+ +- Optional: Docker & Docker Compose + +## Lokale Installation + +```bash +# Virtual Environment aktivieren +.\.venv\Scripts\Activate.ps1 # Windows PowerShell + +# Abhängigkeiten installieren +pip install -r requirements.txt + +# Demo-Projekte laden (beim ersten Start) +python seed_demo_data.py + +# Server starten +flask run +``` + +Die Anwendung läuft unter **http://127.0.0.1:5000**. + +## Docker + +```bash +# Bauen und starten +docker compose up --build + +# Im Hintergrund +docker compose up -d --build +``` + +Die Anwendung ist unter **http://localhost:5000** erreichbar. Die SQLite-Datenbank wird in einem Volume persistiert. + +## Projektstruktur + +``` +├── app.py # Flask-App und Routes +├── models.py # SQLAlchemy-Modelle (Projekt, Bewerbung) +├── seed_demo_data.py # Demo-Projekte +├── requirements.txt +├── Dockerfile +├── docker-compose.yml +├── templates/ # Jinja2-Templates +├── static/ # CSS +└── instance/ # SQLite-Datenbank (wird automatisch erstellt) +``` + +## Technologie-Stack + +- **Backend:** Flask, SQLAlchemy +- **Datenbank:** SQLite +- **Frontend:** Jinja2, Bootstrap 5 + +## Lizenz + +Open Source – siehe Projekt-Lizenz.