Appearance

Workflows ​

Parcours dev - mise en place locale ​

  1. nvm use 22.12.0, puis cd src/Web et npm install.
  2. Base de donnees : par defaut Server=localhost\sqlexpress;Database=UmbracoBaseTemplate;User Id=dev;Password=dev. Override via appsettings.local.json (git-ignore) ou variable d'env. UpgradeUnattended=true cree/migre la base au boot.
  3. (Optionnel) SMTP local : docker run --rm -it -p 5000:80 -p 2525:25 rnwood/smtp4dev (UI sur http://localhost:5000).
  4. Backend : dotnet run --project src/Web/Web.csproj.
  5. Frontend en parallele : npm run dev (build + watch SCSS/JS, live-reload ; proxy / -> https://localhost:44360).
  6. Login backoffice rapide en DEBUG : GET /l connecte le premier utilisateur @spektrummedia.com.

Parcours dev - demarrer un projet aval depuis le template ​

upstream = ce repo template, origin = le repo du projet aval.

  1. Creer le repo GitLab (branche master, sans .gitignore).
  2. Cloner, creer develop et staging, les pousser.
  3. Lier et merger le template :
    bash
    git checkout develop
git remote add upstream git@gitlab.internal.spektrum-suisse.ch:spektrum/umbraco-base-project.git
git fetch upstream
git merge upstream/v17 --allow-unrelated-histories
# resoudre les conflits (garder la version du template)
git commit -m "Merge upstream v17 into develop"
git push origin develop
  4. Renommer UmbracoBaseTemplate.sln en <MonProjet>.sln.
  5. Configurer la base et renseigner UmbracoApplicationUrl.
  6. Merger develop -> staging -> master. Adapter le README aux specificites du projet.

Parcours dev - mise a jour depuis le template ​

bash
git checkout develop
git fetch upstream
git merge upstream/v17
git push origin develop

Parcours dev - ajouter une fonctionnalite ​

  • Service / composer / content finder / controller : voir ../architecture/patterns.md.
  • Document type : backoffice + uSync, voir ../modules/content-model.md.
  • Theme ou module JS : voir ../architecture/frontend-build.md.
  • Outil marketing : voir ../modules/cookies-marketing.md (consentement obligatoire).
  • Penser a mettre a jour la doc concernee (protocole dans le CLAUDE.md racine).

Parcours dev - release / deploiement ​

  1. CI : pipeline sur merge request vers master et commits sur master (build backend + frontend).
  2. Image Docker : docker build -t columbia-registry.spektrum.media/umb_<site>:<env> -f hosting/Dockerfile . puis docker push ; deploiement via docker-compose.yml adapte. Voir ../architecture/build-deploy.md.

Parcours editeur (backoffice Umbraco) ​

  • Backoffice en fr-FR par defaut. Contenu multilingue (langues fr, en-us livrees).
  • Pages : creer sous l'arbre de contenu (homePage en racine de site). Les pages portent la composition pageSettings (SEO, masquage sitemap).
  • Composer le contenu via les sections/elements de blocs (BlockGrid).
  • Reglages transverses : cookiesSettings (textes du popup cookies), marketingSettings (ID GA4).
  • Pages techniques : notFoundPage (404 par site), internalServerErrorPage (500).

Contributors

No contributors

Changelog

No recent changes