# Nexus Core App

Nexus Core ist eine lokale Filament-, Lager-, Community- und Label-Verwaltung auf Basis von Flask und SQLite.

## Lokale Installation unter Windows

Diese App wird aktuell lokal installiert und gestartet, nicht per Docker.

### Voraussetzungen

- Windows-PC
- Python 3.11 oder neuer
- Internetverbindung für den ersten Paket-Download
- Schreibrechte im App-Ordner

### Wichtiger Hinweis zu Python

Bei der Python-Installation bitte die Option `Add Python to PATH` aktivieren.

## ZIP entpacken

1. Die Nexus-Core-ZIP vollständig entpacken.
2. Den entpackten Ordner an einen festen lokalen Pfad legen.
3. Die App nicht direkt aus der ZIP heraus starten.

Beispiel:

```text
D:\Nexus Core\Nexus-Core-App
```

## Schnellstart

### Empfohlener Start

Unter Windows einfach:

```text
start_nexus_core_windows.bat
```

Das Skript übernimmt automatisch:

1. Update-Prüfung vor dem Start
2. Erstellen der virtuellen Umgebung
3. Installation der benötigten Python-Pakete
4. Start der App

## Manueller Start

Wenn du die App manuell starten willst:

```powershell
py -3 -m venv .venv
.venv\Scripts\activate
python -m pip install --upgrade pip
python -m pip install -r requirements.txt
python run.py
```

## Datenbank

Beim ersten Start wird die lokale Datenbank automatisch erstellt, wenn noch keine vorhanden ist.

Typische Datei:

```text
instance/filament_manager.sqlite3
```

Beim Start werden außerdem Migrationen und Standardwerte vorbereitet.

## Lokale Adresse

Nach dem erfolgreichen Start ist die App in der Regel hier erreichbar:

```text
http://127.0.0.1:5000
```

## Typische Startprobleme

### Python wird nicht gefunden

- Python ist nicht installiert
- Python ist nicht im PATH

### Die App startet nicht sauber

- virtuelle Umgebung fehlt oder ist defekt
- Pakete wurden noch nicht installiert
- der App-Ordner liegt in einem ungünstigen oder gesperrten Pfad

### Die Datenbank wird nicht angelegt

- der Start wurde vorzeitig abgebrochen
- der App-Ordner ist nicht beschreibbar

## Projektstruktur

- `app/db.py` - Datenbank, Initialisierung und Migrationen
- `app/repositories/` - SQL-Zugriffe
- `app/services/` - Business-Logik
- `app/routes/` - Web- und API-Endpunkte
- `app/templates/` - Jinja-Templates
- `app/static/` - CSS, JavaScript, Bilder und lokale Assets

## Dokumentation

- App-Wiki-Quellen: `../Nexus-Core-Dokumentation/wiki/`
- Release-/App-Bundle der Wiki-Quellen: `app/static/wiki-source/`
- In-App-Wiki: `/wiki`
- Roadmap: `Dokumentation/ROADMAP.json`
- Changelog: `../Nexus-Core-Dokumentation/Dokumentation/CHANGELOG.md`
