# Relay:// — første fungerende kjerne

En liten, selvhostet PHP/MariaDB-plattform med privat innlogging, administratorkontrollerte kontoer, kronologisk feed og profiler. Ingen offentlig registrering. Dark terminal-stil med diskré blå/grå aksent.

## Innhold
- Innlogging/utlogging med CSRF, passordhashing og regenerering av sesjons-ID.
- Admin kan opprette vanlige brukere. Superadmin kan også opprette admin/superadmin og aktivere/deaktivere kontoer.
- Feed: publiser innlegg (maks. 500 tegn), vis siste 100 kronologisk, slett egne innlegg.
- Profil: rediger visningsnavn, bio, nettsted og sted. Brukernavn er permanent.
- Aktivitetshendelser logges i `activity_events`.
- Grunnleggende sikkerhetsheadere, PDO prepared statements, escaping og strammere PHP-sesjoner.
- Innlegg får seks måneders utløpstid. Automatisk sletting via cron er ikke aktivert i denne pakken; se TODO.

## Krav
Debian 12, Nginx, PHP 8.2+ med `pdo_mysql` og `mbstring`, MariaDB 10.11+.

## Installasjon (ny database)
1. Pakk ut arkivet. Legg prosjektet for eksempel i `/var/www/relay`.
2. Opprett database og bruker i MariaDB. Kjør dette i `sudo mariadb` og erstatt passordet:

```sql
CREATE DATABASE relay CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'relay'@'127.0.0.1' IDENTIFIED BY 'VELG_ET_LANGT_UNIKT_PASSORD';
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, REFERENCES ON relay.* TO 'relay'@'127.0.0.1';
FLUSH PRIVILEGES;
EXIT;
```

3. Importer skjemaet. Hvis du allerede har en Relay-database, ta backup først; skjemaet er laget for en ny database.

```bash
mariadb -u relay -p -h 127.0.0.1 relay < /var/www/relay/database.sql
```

4. Rediger `/var/www/relay/config.php` og sett samme DB-passord som over. Filen skal ikke ligge i webroot; Nginx skal peke til `/var/www/relay/public`.
5. Sett eierskap/tilganger. Juster bruker/grupper etter hvordan PHP-FPM er satt opp:

```bash
sudo chown -R root:www-data /var/www/relay
sudo find /var/www/relay -type d -exec chmod 750 {} \;
sudo find /var/www/relay -type f -exec chmod 640 {} \;
```

6. Opprett første superadmin fra serverens PHP CLI (fra prosjektmappen):

```bash
cd /var/www/relay
php scripts/create_user.php
```

Følg spørsmålene i terminalen. Passordet hashes før det lagres. Ikke kjør skriptet via nettleser.

## Nginx-eksempel
Tilpass sertifikatstier til ditt eksisterende HTTPS-oppsett. Ikke erstatt eksisterende vhost uten backup.

```nginx
server {
    listen 80;
    server_name relay.mu.rdero.us;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl http2;
    server_name relay.mu.rdero.us;
    root /var/www/relay/public;
    index index.php;
    # ssl_certificate /path/to/fullchain.pem;
    # ssl_certificate_key /path/to/privkey.pem;
    server_tokens off;
    client_max_body_size 2m;
    location / { try_files $uri $uri/ /index.php?$query_string; }
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }
    location ~ /\. { deny all; }
    location ~* \.(sql|md|example)$ { deny all; }
}
```

Hvis du bruker denne konfigurasjonen, kontroller PHP-FPM-socket og TLS-sertifikatstier før `nginx -t`. Sørg for at HTTPS fungerer før du setter HSTS.

## Før produksjon
- Ta backup av eksisterende webroot, database og Nginx-konfig før endringer.
- Kjør `php -l` på PHP-filer og `sudo nginx -t` før reload.
- Konfigurer serverens logger og databasebackup.
- Legg på rate limiting for innlogging på Nginx-nivå eller i applikasjonen.
- Legg til endepunkt-/integrasjonstester og prøv backup/gjenoppretting.
- Sett opp cron for å slette utløpte innlegg etter at retention-reglene er bekreftet.

## Begrensninger i denne versjonen
Dette er en første MVP, ikke en ferdig sikkerhetsrevidert produksjonsplattform. Den har ikke opplasting/avatarer, følger/blokkering, reaksjoner, domeneverifisering/badges, API, IRC-integrasjon, passordbytteflyt eller automatisk retention-jobb. PHP-koden er syntakskontrollert, men må testes mot din faktiske PHP/MariaDB/Nginx-konfigurasjon før offentlig bruk.
