Files
heval/README.md
2025-07-15 22:51:37 +02:00

119 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 📱 Heval Light Personal Assistant App
**Heval Light** ist eine persönliche Assistenten-App für iOS/Android, entwickelt mit **React Native + Expo**.
Die App soll langfristig ein smarter Begleiter für Studierende, Arbeitnehmer und Privatpersonen werden mit **Kalender-, Erinnerungs- und KI-Funktionen**.
---
## ✨ Features (aktueller Stand)
**Benutzerregistrierung & Login**
- Vorname, Nachname, E-Mail, Passwort
- Speicherung in **SQLite**
- **Biometrische Anmeldung** via Face ID/Touch ID
**Kalender & Erinnerungen**
- Zugriff auf **iOS Kalender/Erinnerungen** via `expo-calendar`
- Speicherung von Events in **lokaler SQLite-Datenbank**
- **Modal-Formular** für manuelles Hinzufügen von Terminen
**Lokale Speicherung & Sessions**
- Benutzer-Session wird sicher in **AsyncStorage** gehalten
- Passwort & Benutzerdaten lokal in SQLite gespeichert
**Zukunftsorientierte Funktionen (geplant)**
- **GPS-Standort** automatisch übernehmen (Wohnort, Arbeitsplatz/Uni)
- **Sprachbasierte Eingabe** (Speech-to-Text für Erinnerungen)
- **KI-Assistent (ChatGPT)** zur Organisation
- **Push-Notifications** für Erinnerungen
---
## 🗺️ Roadmap
- [ ] **Registrierung erweitern**: Wohnort/Arbeitsort per GPS automatisch erkennen
- [ ] **Speech-to-Text** für neue Erinnerungen/Termine
- [ ] **Push-Notifications** für wichtige Events
- [ ] **AI-Integration** (ChatGPT für intelligente Terminplanung)
- [ ] **Mehrsprachigkeit** (Deutsch/Englisch)
---
## 🛠️ Technologie-Stack
- **React Native + Expo (Managed Workflow)**
- **SQLite** für lokale Benutzer- & Eventdaten
- **AsyncStorage** für Sitzungen
- **expo-local-authentication** für Face ID/Touch ID
- **expo-calendar** für Kalender- und Erinnerungszugriff
- **expo-location** (geplant) für GPS-Standort
- **react-native-voice** (geplant) für Spracheingabe
---
## 📂 Projektstruktur
app/
├─ index.tsx # AuthScreen: Registrierung, Login, FaceID
├─ calendar.tsx # Kalender & Erinnerungen, SQLite-Speicherung
├─ (geplant) reminders.tsx # Sprachbasierte Erinnerungen
└─ ...
yaml
Copy
Edit
---
## 🚀 Installation & Start
### Voraussetzungen
- Node.js (>= 18)
- Expo CLI
- Git
### Setup
```bash
# Repository klonen
git clone <repo-url>
cd heval-light
# Abhängigkeiten installieren
npm install
# App starten
npx expo start
Auf iOS: Expo Go App installieren und QR-Code scannen
Auf Android: ebenfalls Expo Go oder Emulator verwenden
🔐 Sicherheit
Benutzer- und Kalenderdaten bleiben lokal auf dem Gerät
Kein externer Server nötig
Geplant: Verschlüsselte Speicherung (SecureStore)
🧭 Ziel der App
Heval Light soll zu einem intelligenten Assistenten werden, der dir hilft bei:
Kalender- & Erinnerungsverwaltung
Standortbasierten Aufgaben (Wohnort, Arbeitsplatz, Uni)
Sprach- und KI-gestützter Organisation
🤝 Mitwirken
Dieses Projekt ist noch in der aktiven Entwicklung.
Ideen, Feedback oder Pull Requests sind willkommen!
📜 Lizenz
MIT License frei nutzbar für private & kommerzielle Zwecke.
```