alpinux.site.2026/README.md
Cédrix f64135a44d Retirer le wiki : il est passé dans le dépôt alpinux-wiki
Le contenu de wiki.alpinux.org a été rapatrié dans alpinux-wiki, qui est
désormais la source du site publié : le serveur en tire par webhook, plus rien
ici n'est construit ni déployé. Garder une copie ici ne pouvait que produire des
contributions perdues, ce qui est précisément arrivé entre mai et septembre.

wiki/ ne conserve qu'un README de renvoi, pour que quelqu'un qui arrive par un
vieux lien ou un vieux clone sache où aller. Le coffre Obsidian est déménagé en
même temps : ouvrir ~/Projects/org.alpinux.owni/wiki.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PcZ7hL9aVvMhRuzxXLT2DG
2026-09-19 22:08:49 +02:00

97 lines
3.4 KiB
Markdown

# org.alpinux.owni — Monorepo Alpinux
Dépôt unique de l'association **Alpinux** (LUG de Savoie).
Gitea : https://gitea.alpinux.org/alpinux.cedrica5l/alpinux.site.2026
> **Le wiki n'est plus ici.** Depuis le 2026-09-19, `wiki.alpinux.org` est publié depuis
> le dépôt [alpinux-wiki](https://gitea.alpinux.org/alpinux.cedrica5l/alpinux-wiki) —
> voir [`wiki/README.md`](wiki/README.md). Un push dans ce dépôt-ci ne publie plus rien.
---
## Structure
Chaque sous-dossier correspond à un sous-domaine indépendant de `alpinux.org`.
```
org.alpinux.owni/
├── wiki/ → déménagé dans le dépôt alpinux-wiki (voir wiki/README.md)
├── home/ → alpinux.org Page d'accueil statique
├── dynamic/ → dynamic.alpinux.org Flask — quiz et jeux (public + membres)
├── admin/ → admin.alpinux.org Flask — interface d'administration
├── static/ → static.alpinux.org CDN assets : logos, favicons, images OG
├── portail/ → portail.alpinux.org Portail membres (ISPConfig, Nextcloud…)
└── feedback/ → feedback.alpinux.org Formulaire de retours (à construire)
```
Les configurations serveur (Apache, systemd) sont gérées, par ISPConfig à l'adresse https://owni.alpinux.org:8080, séparément et ne sont **pas versionnées**.
---
## Projets indépendants, liés par l'infrastructure
Chaque projet :
- utilise **AlpID** (SSO Keycloak) pour l'authentification quand nécessaire
- a son propre environnement Python (`venv/`) et son fichier `.env` (non versionés)
Les projets sont liés par le SSO partagé, le serveur commun, et l'identité visuelle définie dans https://wiki.alpinux.org/communication/.
---
## Convention git et Claude
> **Travailler dans le sous-dossier du projet concerné**, pas à la racine du dépôt.
```bash
# le wiki se modifie dans ~/Projects/org.alpinux.owni/wiki (dépôt alpinux-wiki)
cd dynamic/ # pour modifier l'appli quiz
cd admin/ # pour modifier l'interface admin
cd static/ # pour modifier les CDN assets
cd portail/ # pour modifier le portail membres
cd feedback/ # pour modifier le formulaire de retour
```
De même, lorsqu'on utilise **Claude Code** (ou tout autre outil IA) :
lancer Claude depuis le sous-dossier du projet pour que le contexte soit limité à ce projet.
```bash
cd ~/Projects/org.alpinux.owni/wiki && claude
cd ~/Projects/org.alpinux.owni/admin && claude
cd ~/Projects/org.alpinux.owni/dynamic && claude
cd ~/Projects/org.alpinux.owni/static && claude
cd ~/Projects/org.alpinux.owni/portail && claude
cd ~/Projects/org.alpinux.owni/feedback && claude
```
---
## Démarrage rapide par projet
### wiki (wiki.alpinux.org)
Déménagé : voir le dépôt [alpinux-wiki](https://gitea.alpinux.org/alpinux.cedrica5l/alpinux-wiki)
et son README.
### dynamic (dynamic.alpinux.org)
```bash
cd dynamic
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env && nano .env # renseigner les clés AlpID
flask run
```
### admin (admin.alpinux.org)
```bash
cd admin
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env && nano .env # renseigner les clés AlpID
flask run
```
---
## Déploiement serveur
Voir https://wiki.alpinux.org/technique/ pour la documentation.
Les fichiers de configuration serveur sont conservés localement hors dépôt.