## Projektbeschreibung

Ein modernes Social-Bookmark-System zum Speichern, Verwalten und Teilen von Web-Links. Benutzer können ihre Lieblingswebsites organisieren, kategorisieren und optional mit anderen teilen. Ideal für persönliche Link-Sammlungen oder Community-Bookmark-Portale.

## Hauptfunktionen

### Öffentlicher Bereich
- **Bookmark-Browser** - Öffentliche Lesezeichen durchsuchen
- **Suchfunktion** - Nach Titel und Beschreibung suchen
- **Kategorie-Filter** - Nach Themen filtern
- **Link-Preview** - Beschreibung und Metadaten sehen
- **Direkt-Links** - Ein-Klick-Zugriff auf gespeicherte Websites

### Benutzer-Dashboard
- **Eigene Lesezeichen** - Persönliche Link-Sammlung
- **Schnell-Hinzufügen** - Neue Bookmarks speichern
- **Kategorisierung** - Links in Kategorien organisieren
- **Privatsphäre** - Bookmarks öffentlich oder privat
- **Verwaltung** - Bearbeiten und Löschen eigener Links

### Admin-Panel
- **Alle Lesezeichen** - Übersicht aller Bookmarks
- **Benutzer-Verwaltung** - Registrierte User verwalten
- **Moderation** - Unangemessene Inhalte entfernen
- **Statistiken** - Anzahl Bookmarks und User

## Technische Details

**Programmiersprache:** PHP 8.4
**Datenbank:** MySQL mit 3 Tabellen
**Sicherheit:** CSRF-Schutz, Bcrypt-Passwörter, PDO prepared statements
**Design:** Modernes lila/blau Design

### Datenbankstruktur
- `bookmarks` - Link-Daten mit Kategorie und Status
- `users` - Benutzerkonten mit E-Mail
- `admin` - Admin-Zugangsdaten

## Installation

1. Alle Dateien auf Webserver hochladen
2. `install.php` im Browser aufrufen
3. Datenbank-Zugangsdaten eingeben
4. Admin-Account erstellen
5. Installation abschließen

**Standard-Admin:**
Benutzername: `admin`
Passwort: *(beim Setup festgelegt)*

## Verwendung

### Bookmark hinzufügen
1. Registrieren oder anmelden
2. Dashboard aufrufen
3. Titel eingeben (z.B. "GitHub")
4. URL angeben (https://github.com)
5. Optional: Beschreibung und Kategorie
6. Checkbox: Öffentlich oder privat
7. "Lesezeichen hinzufügen" klicken

### Bookmarks durchsuchen
1. Hauptseite besuchen
2. Nach Kategorien filtern
3. Suchbegriff eingeben
4. Interessante Links finden
5. Auf Link klicken → Website öffnet sich

### Kategorien nutzen
- Eigene Kategorien erstellen
- Tags frei wählbar (z.B. "Entwicklung", "News", "Shopping")
- Filter auf Hauptseite nutzen
- Übersichtliche Organisation

## Features im Detail

### Social-Bookmark-System
- **Öffentlich/Privat** - User entscheiden über Sichtbarkeit
- **Kategorien** - Flexible Verschlagwortung
- **Beschreibungen** - Was ist auf der Seite zu finden?
- **Suchfunktion** - Schnelles Finden von Links
- **Community-Aspekt** - Entdecke Bookmarks anderer

### Privatsphäre
- **Private Bookmarks** - Nur für eigene Nutzung
- **Öffentliche Bookmarks** - Mit Community teilen
- **Benutzer-Isolation** - Jeder sieht nur eigene private Links
- **Sichere Authentifizierung** - Bcrypt-Passwörter

### Benutzerfreundlichkeit
- **Einfaches Interface** - Klare Navigation
- **Schnelles Hinzufügen** - Minimales Formular
- **Übersichtliche Tabelle** - Alle eigenen Bookmarks
- **Status-Badges** - Öffentlich/Privat erkennbar
- **Direkte Links** - Kein Umweg zum Ziel

## Einsatzgebiete

- **Persönlich** - Eigene Link-Bibliothek
- **Teams** - Gemeinsame Ressourcen-Sammlung
- **Communities** - Themen-basierte Bookmark-Portale
- **Bildung** - Lernressourcen organisieren
- **Forschung** - Quellen sammeln und teilen
- **Entwickler** - Code-Snippets und Dokumentation
- **Marketing** - Konkurrenz-Monitoring

## Beispiel-Kategorien

- **Entwicklung** - GitHub, Stack Overflow, Docs
- **News** - Nachrichtenseiten, Blogs
- **Shopping** - Online-Shops, Deals
- **Social Media** - Twitter, LinkedIn, Reddit
- **Lernen** - Tutorials, Kurse, Videos
- **Tools** - Online-Dienste, SaaS
- **Inspiration** - Design, Fotografie, Kunst

## Systemanforderungen

- **Webserver** - Apache/Nginx mit PHP
- **PHP** - Version 8.0 oder höher
- **MySQL** - Version 5.7 oder höher
- **Speicherplatz** - 5 MB Webspace
- **Extensions** - PDO, session

## Dateien

- `index.php` - Öffentliche Bookmark-Übersicht
- `login.php` - Login und Registrierung
- `user.php` - Benutzer-Dashboard
- `admin.php` - Admin-Panel
- `install.php` - Installations-Wizard
- `style.css` - Design-Stylesheet

## Sicherheitsmerkmale

### Authentifizierung
- **Bcrypt-Hashing** - Sichere Passwortspeicherung
- **Session-Management** - HttpOnly, Secure Cookies
- **CSRF-Protection** - Token-Validierung
- **SQL-Injection-Schutz** - PDO prepared statements

### Datenschutz
- **Private Bookmarks** - Nicht öffentlich einsehbar
- **User-Isolation** - Strikte Trennung der Daten
- **Minimal Data** - Nur notwendige Infos speichern
- **DSGVO-Ready** - Grundlage für Compliance

## Best Practices

### Für Benutzer
- Aussagekräftige Titel wählen
- Beschreibungen hinzufügen
- Kategorien konsistent nutzen
- Regelmäßig aufräumen (tote Links löschen)

### Für Admins
- Regelmäßige Backups
- Spam-Bookmarks entfernen
- Inaktive User löschen
- Datenbank optimieren

### Link-Qualität
- Valide URLs verwenden (mit https://)
- Funktionierende Links prüfen
- Aussagekräftige Beschreibungen
- Passende Kategorien wählen

## Erweiterungsideen

### Basis-Features
- **Import/Export** - Bookmarks als JSON/HTML
- **Browser-Extensions** - Chrome/Firefox Add-ons
- **Tags** - Zusätzlich zu Kategorien
- **Bewertungen** - User können Links bewerten
- **Kommentare** - Diskussion zu Bookmarks

### Social Features
- **Follow-System** - Anderen Usern folgen
- **Collections** - Öffentliche Listen erstellen
- **Sharing** - Social-Media-Integration
- **Empfehlungen** - "Das könnte dich interessieren"
- **Trending** - Beliebteste Bookmarks

### Erweiterte Funktionen
- **Duplicate-Check** - URL bereits gespeichert?
- **Broken-Link-Check** - Tote Links finden
- **Automatische Kategorisierung** - KI-gestützt
- **Screenshot-Preview** - Website-Vorschau
- **Full-Text-Search** - Durchsuchbare Archive
- **OCR** - Text aus Bildern extrahieren

### Integration
- **API** - REST-Schnittstelle
- **RSS-Feed** - Neue Bookmarks abonnieren
- **Webhook** - Bei neuen Links benachrichtigen
- **Browser-Bookmarks** - Import aus Browser
- **Pocket/Instapaper** - Integration mit Read-Later-Diensten

### Analytics
- **Klick-Tracking** - Welche Links werden genutzt?
- **Statistiken** - Meistgespeicherte Domains
- **Heatmap** - Kategorien-Verteilung
- **User-Activity** - Wer ist am aktivsten?

## Wartung

### Regelmäßig
- Tote Links finden und entfernen
- Spam-Bookmarks löschen
- Kategorien aufräumen
- Datenbank-Backups

### Optimierung
- Indizes auf URL und Kategorie
- Full-Text-Index für Suche
- Query-Cache aktivieren
- Alte Sessions aufräumen

## Anpassungsmöglichkeiten

### Design
- CSS vollständig anpassbar
- Farben ändern (Standard: Lila/Blau)
- Layout-Varianten (Grid/List)
- Dark Mode hinzufügen

### Funktionalität
- Kategorien vorbelegen
- Tags statt/zusätzlich Kategorien
- Mindest-/Maximal-Längen
- URL-Whitelist/-Blacklist
- Moderation-Queue

### Privatsphäre-Stufen
- Öffentlich (alle sehen)
- Freunde (nur Follower)
- Privat (nur eigene Ansicht)
- Unlisted (nur mit Link)

## Browser-Integration

Bookmarklet für schnelles Speichern:

```javascript
javascript:(function(){
var url = encodeURIComponent(window.location.href);
var title = encodeURIComponent(document.title);
window.open('https://ihre-domain.de/user.php?url='+url+'&title='+title,'_blank');
})();
```

## Performance-Tipps

### Für viele Bookmarks
- Pagination aktivieren (bereits vorhanden)
- Caching für öffentliche Ansicht
- CDN für statische Assets
- Lazy Loading für Bilder

### Für viele User
- Connection-Pooling
- Redis für Sessions
- Read-Replicas für MySQL
- Load-Balancing

## Rechtliche Hinweise

⚠️ **Wichtig:**
- Keine urheberrechtlich geschützten Inhalte speichern
- Links zu legalen Websites
- Impressumspflicht beachten
- Datenschutzerklärung bereitstellen
- AGB erstellen (bei öffentlichem Betrieb)
- Moderations-Richtlinien definieren

## Vergleich zu anderen Diensten

**Wie Pinboard/Delicious:**
- Social Bookmarking
- Öffentlich/Privat
- Kategorisierung

**Vorteile dieser Lösung:**
- Selbst gehostet (Datenkontrolle)
- Keine monatlichen Kosten
- Vollständig anpassbar
- Kein Vendor-Lock-in

## Troubleshooting

**Problem:** Login funktioniert nicht
**Lösung:** Passwort-Hash und Session prüfen

**Problem:** Kategorien werden nicht angezeigt
**Lösung:** Mindestens ein öffentliches Bookmark mit Kategorie nötig

**Problem:** Suche findet nichts
**Lösung:** SQL LIKE ist case-sensitive, Full-Text-Index empfohlen

**Problem:** Zu langsam bei vielen Bookmarks
**Lösung:** Pagination reduzieren, Indizes hinzufügen

## Community-Features (Optional)

- **Leaderboard** - Meiste Bookmarks
- **Badges** - Für aktive User
- **Following** - Anderen folgen
- **Collections** - Kuratierte Listen
- **Duplicate-Meldung** - Community-Moderation

## Import-Funktionen

Bookmark-Import aus:
- **Browser** - HTML-Export
- **Andere Dienste** - JSON-API
- **CSV** - Bulk-Import
- **OPML** - Feed-Listen

## Lizenz

Verwendung für private und kommerzielle Zwecke.

---

**Version:** 1.0
**Entwickelt:** 2025
**Sprache:** Deutsch
**PHP:** 8.4+
**Kategorie:** Social Bookmarking / Link Management