mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-08 19:56:53 +00:00
Introduce docs/contributing/design/iam/ with a docs README, common.md for cross-cutting principles, and per-provider pages oidc.md and ldap.md. The OIDC page documents the OIDC.* variable tree, claim attribute SPOT (preferred_username), and the rule that app-specific Keycloak protocol mappers belong in per-client scopes, not the shared default.json.j2. The LDAP page documents the LDAP.* variable tree, attribute SPOT, and the paired-identifier rule with OIDC. Move services.md from docs/contributing/code/ to docs/contributing/design/ so the design/ folder is the SPOT for cross-cutting platform conventions. Update the two architecture.md cross-links and the requirement doc. Cross-link the new guides from 13_oidc.yml, 14_ldap.yml, and the web-app-keycloak and svc-db-openldap role READMEs. Fix nearby README compliance issues per readme_md.md (svc-db-openldap H1, missing Credits section in web-app-jira, Credits formatting drift). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Design 🎨
This directory contains contributor guidance for code design and implementation. Its scope is architecture, service wiring, coding principles, exceptions, and the boundaries that shape maintainable changes.