1b4adfaa0e
Le dépôt du wiki a quitté l'espace de travail org.alpinux.owni pour son propre dossier. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PcZ7hL9aVvMhRuzxXLT2DG
97 lines
3.4 KiB
Markdown
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/alpinux.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/alpinux.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.
|