sqlinsight-pro/docs/community.md

# Community-websted og forum

SQLInsight Pro har to offentlige websteder. Begge drives af SEOSoft:

| Websted | Adresse (eksempel) | Hvad |
|---|---|---|
| Community-webstedet | `https://sqlinsight.seosoft.dk` | Forside, funktioner, download af signerede udgivelser, dokumentation, SQL Server-versioner og supportdatoer, regler og supportaftaler. Projektet `src/SQLInsight.Community`. |
| Forummet | `https://forum.sqlinsight.seosoft.dk` | Discourse på dansk: spørgsmål og svar (med løste svar), installation og drift, performance, regler, idéer og annonceringer. |

Adresserne er eksempler. Ret dem i `deploy/forum/app.yml`, `deploy/community/docker-compose.yml` og i webbrugerfladens `SQLInsight:Web:CommunityUrl` og `SQLInsight:Web:ForumUrl`.

Kør de to på hver sin server (eller VM). Discourse vil selv eje port 80 og 443 og er svær at dele en server med.

## Forummet (Discourse)

Discourse installeres med den officielle `discourse_docker`-launcher. Det er den eneste måde, Discourse understøtter.

1. **Server:** Ubuntu LTS eller Debian, 2 GB RAM (4 GB anbefales), 2 CPU'er og 20 GB disk.
2. **DNS:** Opret en A-post (og evt. AAAA) for forummets navn, der peger på serveren.
3. **Mail:** Discourse kan ikke fungere uden SMTP. Tilmelding, notifikationer og nulstilling af adgangskode sker på mail. Brug en rigtig mailudbyder med SPF og DKIM for afsenderdomænet.
4. **Konfiguration:** Udfyld værdierne markeret `CHANGE` i `deploy/forum/app.yml`: værtsnavn, administratoradresse, SMTP og Let's Encrypt-adresse.
5. **Installation:** Kør `sudo deploy/forum/install.sh`. Scriptet:
   - stopper, hvis der stadig står eksempelværdier;
   - installerer Docker, hvis det mangler;
   - kloner `discourse_docker` til `/var/discourse` og kopierer `app.yml` på plads;
   - kører `./launcher rebuild app`. Det tager 10-15 minutter.
6. **Administrator:** Åbn forummet, og opret en bruger med en af adresserne i `DISCOURSE_DEVELOPER_EMAILS`. Den bliver administrator.
7. **Opsætning som kode:** Lav en midlertidig API-nøgle (scriptet skriver kommandoen), og kør:

   ```
   DISCOURSE_URL=https://forum.sqlinsight.seosoft.dk DISCOURSE_API_KEY=... \
   COMMUNITY_URL=https://sqlinsight.seosoft.dk CONTACT_EMAIL=support@... \
   python3 deploy/forum/configure.py
   ```

   `configure.py` gør følgende:
   - sætter titel, beskrivelser, dansk sprog, tags og løste svar (pluginnet `solved` følger med Discourse);
   - opretter kategorierne med beskrivelser. Kun medarbejdere kan skrive i *Annonceringer*;
   - opretter og fastgør et velkomstemne;
   - skjuler Discourses engelske standardemne.

   Scriptet kan køres igen. Det ændrer kun det, der afviger. Slet API-nøglen bagefter under *Admin → API*.

**Drift:**
- Opdatering: `cd /var/discourse && git pull && ./launcher rebuild app`, eller via */admin/upgrade*.
- Backup: Discourse tager dagligt backup til `/var/discourse/shared/standalone/backups`. Slå upload til S3 eller kopiering væk fra serveren til under *Admin → Backups*.
- Logge: `./launcher logs app`.

**Forslag til moderation:**
- Lad SEOSoft-medarbejdere have rollen *moderator*.
- Markér det bedste svar som løsning, så svaret kan findes igen.
- Kunder med supportaftale skal bruge mail- eller telefonsupport til sager med kundedata. Forummet er offentligt.

## Community-webstedet

Webstedet er en lille ASP.NET Core-applikation uden database. Det viser:

- **Udgivelser:** Kun udgivelser fra det signerede opdateringsfeed med en gyldig SEOSoft-signatur vises. Webstedet viser altså præcis det, agenterne ville installere, med SHA-256 for hver fil.
- **SQL Server-versioner:** Seneste CU'er og supportstatus, fra den nyeste signerede regelpakke i feedet.
- **Dokumentation:** Filerne i `docs/`, bygget ind i programmet. Links mellem dokumenterne bliver til sider, og links til andre filer i repositoriet går til Forgejo. HTML i Markdown vises ikke.
- **Forum:** De seneste emner fra forummets offentlige `/latest.json`. Hvis forummet er nede, virker webstedet stadig.

Kør det med Docker på sin egen server. Caddy henter og fornyr selv TLS-certifikatet:

```
cd deploy/community
COMMUNITY_HOST=sqlinsight.seosoft.dk COMMUNITY_CONTACT=salg@... docker compose up -d
```

| Indstilling (`SQLInsight:Community:…`) | Standard | Betydning |
|---|---|---|
| `Feed` | (ingen) | Det signerede opdateringsfeed. Normalt hubbens `https://<hub>/updates/`, eller en mappe. Uden feed vises ingen udgivelser, og versionssiden bruger den indbyggede regelpakke. |
| `ForumUrl` | (ingen) | Forummets adresse. Bruges til links, `/forum` og de seneste emner. |
| `SourceUrl` | Forgejo-repositoriet | Link til kildekoden og til filer, som dokumentationen henviser til. |
| `ContactEmail` | `salg@example.com` | Adressen på supportsiden. Skal sættes. |
| `TrustedKeys:<id>` | (ingen) | Offentlige nøgler ud over de indbyggede. Brug samme værdi som for agenterne. |
| `CacheFor` | `00:10:00` | Hvor længe feed og forumemner caches. |

Webstedet sender strenge sikkerhedsheadere (CSP uden inline-scripts og -styles, `X-Frame-Options: DENY`). Det har ingen login og gemmer ingen data om besøgende.

Uden Docker: `dotnet publish src/SQLInsight.Community -c Release`. Kør det derefter som en Windows-tjeneste eller en systemd-tjeneste bag IIS, nginx eller Caddy.