Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,21 @@
# Journal des changements

## 0.2.1

### Changé : charte générique v2.1

- **Interface à la charte v2.1** (`Aliquanto3/charte-generique`) : jetons de `tokens.css` pris par usage
dans les rôles de la charte, sombre d'abord (`:root`), clair selon le système ou `data-theme="light"`,
`data-theme="dark"` force le sombre. Aucune couleur en dur hors de `tokens.css`.
- **Bouton principal neutre** (`--color-button`, `--color-on-button`), bouton secondaire en contour
`--color-line-strong`, anneau de focus `--color-focus`, filet or sous le titre de page, ombres dures
remplacées par le halo doux.
- **Polices** : Sora 600 pour les titres (à la place de Fredoka, retirée), Atkinson Hyperlegible pour le
texte, JetBrains Mono pour le code. Le rapport HTML exporté suit la même palette et embarque Sora.
- **Favicon et pictogramme** de la charte. Captures dans `docs/media/charte-v2/`.
- Tests : contraste WCAG dans les deux thèmes sur une liste explicite de couples (`tests/test_charte.py`),
aucun hex hors des jetons, aucun aplat bleu de bouton.

## 0.2.0

### Changé : nouveau nom, nouvelle charte
Expand Down
9 changes: 7 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# DevSecOps Dojo

> 🟢 **Version 0.2.0** : le socle git de la v0.1.0, plus les stations 1 à 3 de la chaîne DevSecOps (poste local, PR et CI, sécurité et qualité), dans les deux parcours, hors ligne. Notes de version : [docs/releases/v0.2.0.md](docs/releases/v0.2.0.md).
> 🟢 **Version 0.2.1** : les fonctions de la v0.2 (socle git et stations 1 à 3 de la chaîne DevSecOps, dans les deux parcours, hors ligne) avec l'interface à la charte graphique générique v2.1 (thèmes sombre et clair). Notes de version : [docs/releases/v0.2.1.md](docs/releases/v0.2.1.md).

Application pédagogique locale pour apprendre git et GitHub, puis la chaîne CI/CD et les
concepts DevSecOps, pensée pour les personnes qui codent avec des agents (vibe coding) et
Expand All @@ -9,7 +9,7 @@ doivent comprendre ce que l'agent fait sur leur dépôt. Pédagogie inspirée de

## Ce que l'application propose

La version 0.2.0 couvre le socle git et les stations 1 à 3 de la chaîne DevSecOps. La station 4 (livraison) arrive ensuite (voir [Jalons](#jalons)).
La version 0.2.1 couvre le socle git et les stations 1 à 3 de la chaîne DevSecOps. La station 4 (livraison) arrive ensuite (voir [Jalons](#jalons)).

- **Du vrai git, hors ligne** : un dépôt bac à sable, un dépôt distant local et un GitHub
simulé (PR, revue, merge, commits d'un collègue), dans des vues synchronisées.
Expand All @@ -26,6 +26,11 @@ La version 0.2.0 couvre le socle git et les stations 1 à 3 de la chaîne DevSec
(dépendance vulnérable), `uv lock --check`, quality gate de 80 % de couverture du nouveau code.
- **Savoir en parler à un RSSI** : scénario d'entretien et fiche barrière → risque → preuve. (v0.3)

<picture>
<source media="(prefers-color-scheme: light)" srcset="docs/media/charte-v2/catalogue-clair.png">
<img src="docs/media/charte-v2/catalogue-sombre.png" alt="Catalogue de DevSecOps Dojo : deux parcours, en-tête avec pictogramme et filet or sous le titre">
</picture>

## Installer sous Windows (sans droits administrateur)

Dans PowerShell (Windows 10 ou 11), un compte standard suffit :
Expand Down
Binary file added docs/media/charte-v2/catalogue-clair.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/media/charte-v2/catalogue-sombre.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/media/charte-v2/diagnostic-sombre.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
36 changes: 36 additions & 0 deletions docs/releases/v0.2.1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# DevSecOps Dojo v0.2.1 : charte graphique générique v2.1

Cette version ne change aucune fonction : elle habille l'interface de la v0.2 avec la charte graphique
générique v2.1 (dépôt `Aliquanto3/charte-generique`). Toujours hors ligne, sans télémétrie.

## Contenu

- **Jetons** : `tokens.css` porte les valeurs de la charte, choisies par usage (texte, aplat, trait,
statut). Sombre d'abord ; le clair suit le système (`prefers-color-scheme: light`) ou
`data-theme="light"` ; `data-theme="dark"` force le sombre. Le terminal reste sombre dans les deux thèmes.
- **Boutons** : principal neutre (`bouton`, `sur-bouton`, `bouton-survol`), jamais un aplat bleu, y
compris les boutons à bascule ; secondaire en contour `trait-fort` ; focus `focus`.
- **Catégories** : les quatre couleurs de disciplines passent sur les séries `cat-1`, `cat-3`, `cat-4` ;
les fonds doux de catégorie sont `primaire-doux`, `succes-doux` ou `surface-alt`.
- **Signature** : filet or sous le titre de la page, pictogramme et favicon de la charte.
- **Polices** : Sora 600 (titres), Atkinson Hyperlegible (texte), JetBrains Mono (code), avec les piles de
repli de la charte. Fredoka et sa licence sont retirées ; la licence OFL de Sora est jointe.
- **Rapport HTML exporté** : même palette (sombre, clair, impression), titres en Sora, filet or.
- **Tests** : `tests/test_charte.py` (contrastes 4,5:1 du texte et 3:1 des marques dans les deux
thèmes, aucun hex hors `tokens.css`, aucun aplat bleu de bouton, polices, favicon) ; tests de
jetons et de contraste existants réalignés.
- **Captures** : `docs/media/charte-v2/` (catalogue clair et sombre, diagnostic sombre).

## Limites

- **Pas de sélecteur de thème** dans l'interface : le thème suit le système. À reprendre dans une story.
- **Historique non migré** : `docs/recette/*.html`, `docs/forge/*.html`, `_bmad-output/` (dont les
maquettes et `DESIGN.md`), `.claude/`, et les notes des versions précédentes gardent l'ancienne charte.
- **Captures partielles** : seules les pages Catalogue (deux thèmes) et Diagnostic (sombre) sont
captées ; l'accès exige le jeton de session, ce qui a empêché les autres pages en navigateur sans tête.
- **Numérotation** : le jalon « v0.3 » (station 4, livraison) annoncé dans le README n'est pas livré par
cette version, qui ne porte que la charte.
- **Graisses** : Sora n'est fournie qu'en 600 et Atkinson en 400 et 700 ; les graisses intermédiaires
sont approchées par le navigateur.
- **Pas de liens soulignés dans la navigation** (liens de navigation, repérés par la ligne sous la page
courante) ; les liens du texte courant restent soulignés.
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "devsecops-dojo"
version = "0.2.0"
version = "0.2.1"
description = "Application pédagogique locale pour apprendre git, GitHub, la CI/CD et le DevSecOps, hors ligne."
readme = "README.md"
license = "Apache-2.0"
Expand Down
16 changes: 11 additions & 5 deletions src/devsecops_dojo/progress/report.py
Original file line number Diff line number Diff line change
Expand Up @@ -149,14 +149,20 @@ def build_report(
<title>{{ r.title }}</title>
<style>
{{ font_css|safe }}
:root { color-scheme: light dark; --ink: #1d2433; --bg: #fff; --line: #9aa3b5; --soft: #eef1f7; }
@media (prefers-color-scheme: dark) {
:root { --ink: #eef1f7; --bg: #161b27; --line: #5b6579; --soft: #232a3a; }
:root { color-scheme: light dark; --ink: #E8ECF2; --bg: #0F1318; --line: #67717E; --soft: #1E242C; }
@media (prefers-color-scheme: light) {
:root { --ink: #121821; --bg: #F6F8FB; --line: #808A97; --soft: #ECF0F5; }
}
@media print { :root { --ink: #1d2433; --bg: #fff; --line: #9aa3b5; --soft: #eef1f7; } }
@media print { :root { --ink: #121821; --bg: #FFFFFF; --line: #808A97; --soft: #ECF0F5; } }
body { margin: 0 auto; max-width: 60rem; padding: 1.5rem 1rem; color: var(--ink);
background: var(--bg); font: 1rem/1.5 "Atkinson Hyperlegible", system-ui, sans-serif; }
background: var(--bg);
font: 1rem/1.5 "Atkinson Hyperlegible", system-ui, 'Segoe UI', Roboto, sans-serif; }
h1, h2 { font-family: Sora, system-ui, 'Segoe UI', Roboto, sans-serif; font-weight: 600; }
h1 { font-size: 1.6rem; margin: 0 0 .25rem; }
h1::after { content: ""; display: block; width: 96px; height: 4px; margin-top: .5rem;
border-radius: 999px; background: #E3C26B; }
@media (prefers-color-scheme: light) { h1::after { background: #8F6300; } }
@media print { h1::after { background: #8F6300; } }
h2 { font-size: 1.2rem; margin: 2rem 0 .5rem; }
table { width: 100%; border-collapse: collapse; }
th, td { text-align: left; padding: .4rem .6rem; border: 1px solid var(--line); }
Expand Down
9 changes: 5 additions & 4 deletions src/devsecops_dojo/web/catalogue.py
Original file line number Diff line number Diff line change
Expand Up @@ -272,8 +272,9 @@ def tool_labels(settings: Settings) -> dict[str, str]:


REPORT_FONTS = (
("atkinson-hyperlegible-400.woff2", "normal", 400),
("atkinson-hyperlegible-700.woff2", "normal", 700),
("atkinson-hyperlegible-400.woff2", "Atkinson Hyperlegible", "normal", 400),
("atkinson-hyperlegible-700.woff2", "Atkinson Hyperlegible", "normal", 700),
("sora-600.woff2", "Sora", "normal", 600),
)
"""Polices jointes au rapport HTML, en data URI : le fichier s'affiche hors ligne (AD-13)."""

Expand All @@ -283,10 +284,10 @@ def report_font_css() -> str:
fonts = Path(__file__).resolve().parent / "static" / "fonts"
rules = []
try:
for name, style, weight in REPORT_FONTS:
for name, family, style, weight in REPORT_FONTS:
data = base64.b64encode((fonts / name).read_bytes()).decode("ascii")
rules.append(
'@font-face { font-family: "Atkinson Hyperlegible"; '
f'@font-face {{ font-family: "{family}"; '
f"font-style: {style}; font-weight: {weight}; "
f'src: url("data:font/woff2;base64,{data}") format("woff2"); }}'
)
Expand Down
18 changes: 9 additions & 9 deletions src/devsecops_dojo/web/static/css/catalogue.css
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
font: var(--font-weight-label) var(--font-size-label) / 1 var(--font-family-label);
color: var(--color-ink);
background: var(--color-surface-raised);
border: 2px solid var(--color-muted);
border: 2px solid var(--color-line-strong);
border-radius: var(--radius-md);
cursor: pointer;
}
Expand Down Expand Up @@ -42,15 +42,15 @@
font: var(--font-weight-label) var(--font-size-label) / 1 var(--font-family-label);
color: var(--color-ink);
background: var(--color-surface);
border: 2px solid var(--color-muted);
border: 2px solid var(--color-line-strong);
border-radius: var(--radius-full);
cursor: pointer;
}

.path-pill[aria-checked="true"] {
color: var(--color-on-primary);
background: var(--color-primary);
border-color: var(--color-primary);
color: var(--color-on-button);
background: var(--color-button);
border-color: var(--color-button);
}

.path-picker-text {
Expand All @@ -70,8 +70,8 @@
place-items: center;
width: 2rem;
height: 2rem;
color: var(--color-on-primary);
background: var(--color-primary);
color: var(--color-on-ink);
background: var(--color-ink-fill);
border-radius: var(--radius-full);
font-weight: 700;
}
Expand Down Expand Up @@ -130,7 +130,7 @@
.report-entry {
margin-top: var(--space-6);
padding-top: var(--space-4);
border-top: var(--stroke-min) solid var(--color-muted);
border-top: var(--stroke-min) solid var(--color-line-strong);
}

.report-privacy {
Expand All @@ -141,7 +141,7 @@
margin-top: var(--space-4);
padding: var(--space-3) var(--space-4);
background: var(--color-surface-raised);
border: var(--stroke-min) solid var(--color-muted);
border: var(--stroke-min) solid var(--color-line-strong);
border-radius: var(--radius-md);
}

Expand Down
12 changes: 6 additions & 6 deletions src/devsecops_dojo/web/static/css/code.css
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@
font: var(--font-weight-label) var(--font-size-label) / 1 var(--font-family-label);
color: var(--color-ink);
background: var(--color-surface-raised);
border: var(--stroke-min) solid var(--color-muted);
border: var(--stroke-min) solid var(--color-line-strong);
border-radius: var(--radius-full);
cursor: pointer;
}
Expand Down Expand Up @@ -143,7 +143,7 @@
height: 16em;
min-height: 8em;
background: var(--color-surface-raised);
border: var(--stroke-min) solid var(--color-muted);
border: var(--stroke-min) solid var(--color-line-strong);
border-radius: var(--radius-sm);
overflow: hidden;
}
Expand Down Expand Up @@ -269,7 +269,7 @@
.diff-file-header:focus-visible,
.diff-line:focus-visible,
.code-file:focus-visible {
outline: calc(var(--stroke-min) * 2) solid var(--color-primary);
outline: calc(var(--stroke-min) * 2) solid var(--color-focus);
outline-offset: -2px;
}

Expand Down Expand Up @@ -315,7 +315,7 @@
font: var(--font-weight-label) var(--font-size-label) / 1.4 var(--font-family-label);
color: var(--color-ink);
background: var(--color-surface-raised);
border: var(--stroke-min) solid var(--color-muted);
border: var(--stroke-min) solid var(--color-line-strong);
border-radius: var(--radius-full);
}

Expand All @@ -342,7 +342,7 @@
font: var(--font-weight-label) var(--font-size-label) / 1 var(--font-family-label);
color: var(--color-ink);
background: var(--color-surface-raised);
border: var(--stroke-min) solid var(--color-muted);
border: var(--stroke-min) solid var(--color-line-strong);
border-radius: var(--radius-full);
cursor: pointer;
}
Expand All @@ -360,7 +360,7 @@
.pipeline-job:focus-visible,
.pipeline-tab:focus-visible,
.pipeline-lines:focus-visible {
outline: calc(var(--stroke-min) * 2) solid var(--color-primary);
outline: calc(var(--stroke-min) * 2) solid var(--color-focus);
outline-offset: 2px;
}

Expand Down
2 changes: 1 addition & 1 deletion src/devsecops_dojo/web/static/css/diagnostic.css
Original file line number Diff line number Diff line change
Expand Up @@ -141,7 +141,7 @@
margin: 0 0 var(--space-4);
padding: var(--space-3) var(--space-4);
background: var(--color-surface-raised);
border: var(--stroke-min) solid var(--color-muted);
border: var(--stroke-min) solid var(--color-line-strong);
border-left-width: 4px;
border-radius: var(--radius-md);
}
Expand Down
6 changes: 3 additions & 3 deletions src/devsecops_dojo/web/static/css/fonts.css
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
/* Polices servies par l'application (WOFF2, licence OFL jointe dans ../fonts). Aucun CDN. */
@font-face {
font-family: "Fredoka";
font-family: "Sora";
font-style: normal;
font-weight: 300 700;
font-weight: 600;
font-display: swap;
src: url("../fonts/fredoka-variable.woff2") format("woff2");
src: url("../fonts/sora-600.woff2") format("woff2");
}

@font-face {
Expand Down
6 changes: 3 additions & 3 deletions src/devsecops_dojo/web/static/css/linking.css
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@

/* --- élément mis en évidence après le réaffichage de sa vue -------------------------------- */
.is-revealed {
outline: 3px solid var(--color-primary);
outline: 3px solid var(--color-focus);
outline-offset: 2px;
}

Expand Down Expand Up @@ -101,8 +101,8 @@

.explain-trigger:hover,
.explain-trigger[aria-expanded="true"] {
color: var(--color-on-primary);
background: var(--color-primary);
color: var(--color-on-button);
background: var(--color-button);
}

/* « i » d'une étiquette de ref : à sa suite, dans la rangée, hors du bouton du commit. */
Expand Down
6 changes: 3 additions & 3 deletions src/devsecops_dojo/web/static/css/remote.css
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,7 @@
gap: var(--space-2);
padding: var(--space-3);
background: var(--color-surface-raised);
border: 2px solid var(--color-muted);
border: 2px solid var(--color-line-strong);
border-radius: var(--radius-md);
}

Expand Down Expand Up @@ -182,7 +182,7 @@
}

.pr-check.is-stale {
border: var(--stroke-min) dashed var(--color-muted);
border: var(--stroke-min) dashed var(--color-line-strong);
}

.check-glyph {
Expand Down Expand Up @@ -421,7 +421,7 @@

.remote-view .check-output.is-selected,
.remote-view .check-output:focus-visible {
outline: var(--stroke-min) solid var(--color-primary);
outline: var(--stroke-min) solid var(--color-focus);
outline-offset: 2px;
background: var(--color-produced-soft);
}
Expand Down
6 changes: 3 additions & 3 deletions src/devsecops_dojo/web/static/css/repo.css
Original file line number Diff line number Diff line change
Expand Up @@ -112,7 +112,7 @@
}

.graph-edge.is-lost {
stroke: var(--color-muted);
stroke: var(--color-line-strong);
stroke-dasharray: 4 3;
}

Expand All @@ -124,7 +124,7 @@

.graph-commit.is-lost {
fill: var(--color-surface);
stroke: var(--color-muted);
stroke: var(--color-line-strong);
stroke-dasharray: 3 2;
}

Expand Down Expand Up @@ -286,7 +286,7 @@
.staging-group {
padding: var(--space-2);
background: var(--color-surface-raised);
border: var(--stroke-min) solid var(--color-muted);
border: var(--stroke-min) solid var(--color-line-strong);
border-radius: var(--radius-md);
}

Expand Down
Loading
Loading