# paulinotech1/jml- architecture

> Architecture diagram of the GitHub repository paulinotech1/jml-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/paulinotech1/jml-
- Repository: https://github.com/paulinotech1/jml-

## Overview

An administrator runs joiner, mover, leaver, or read-only access-review workflows against Microsoft Entra ID. The first three validate configuration and route mutations through a shared dry-run/apply safeguard; that safeguard also records a hash-chained JSONL audit trail. Access review reads tenant data and writes CSV reports. Relationships are based on README statements; source excerpts were not available, so implementation details beyond those statements are omitted.

Main entry points: [`src/modules/IdentityLifecycle.Common.psm1`](https://github.com/paulinotech1/jml-/blob/main/src/modules/IdentityLifecycle.Common.psm1) (Config validation), [`src/Joiner-NewEmployee.ps1`](https://github.com/paulinotech1/jml-/blob/main/src/Joiner-NewEmployee.ps1) (Joiner provisioning), [`src/Mover-UpdateEmployee.ps1`](https://github.com/paulinotech1/jml-/blob/main/src/Mover-UpdateEmployee.ps1) (Mover reconciliation), [`src/Leaver-OffboardEmployee.ps1`](https://github.com/paulinotech1/jml-/blob/main/src/Leaver-OffboardEmployee.ps1) (Leaver offboarding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflows["Lifecycle workflows"]
  node_joiner["Joiner provisioning"]
  node_mover["Mover reconciliation"]
  node_leaver["Leaver offboarding"]
  node_review["Access review"]
end

subgraph group_shared["Shared safeguards"]
  node_validation["Config validation"]
  node_mutation_gate["Mutation gate"]
  node_audit["Audit trail"]
end

subgraph group_configuration["Configuration"]
  node_lifecycle_config["Lifecycle settings"]
  node_role_mappings["Role mappings"]
end

subgraph group_outputs["Tenant and outputs"]
  node_entra[("Microsoft Entra ID")]
  node_logs["JSONL logs"]
  node_reports["CSV reports"]
end

node_admin(("Administrator"))

node_admin -->|"runs"| node_joiner
node_admin -->|"runs"| node_mover
node_admin -->|"runs"| node_leaver
node_admin -->|"runs"| node_review
node_joiner -->|"validates settings"| node_validation
node_mover -->|"validates settings"| node_validation
node_leaver -->|"validates settings"| node_validation
node_validation -->|"checks"| node_lifecycle_config
node_validation -->|"checks"| node_role_mappings
node_joiner -->|"gates mutations"| node_mutation_gate
node_mover -->|"gates mutations"| node_mutation_gate
node_leaver -->|"gates mutations"| node_mutation_gate
node_mutation_gate -->|"applies approved changes"| node_entra
node_mutation_gate -->|"records actions"| node_audit
node_audit -->|"appends entries"| node_logs
node_review -->|"reviews accounts"| node_entra
node_review -->|"writes CSVs"| node_reports

click node_joiner "https://github.com/paulinotech1/jml-/blob/main/src/Joiner-NewEmployee.ps1"
click node_mover "https://github.com/paulinotech1/jml-/blob/main/src/Mover-UpdateEmployee.ps1"
click node_leaver "https://github.com/paulinotech1/jml-/blob/main/src/Leaver-OffboardEmployee.ps1"
click node_review "https://github.com/paulinotech1/jml-/blob/main/src/Review-AccessReview.ps1"
click node_validation "https://github.com/paulinotech1/jml-/blob/main/src/modules/IdentityLifecycle.Common.psm1"
click node_mutation_gate "https://github.com/paulinotech1/jml-/blob/main/src/modules/IdentityLifecycle.Common.psm1"
click node_audit "https://github.com/paulinotech1/jml-/blob/main/src/modules/IdentityLifecycle.Common.psm1"
click node_lifecycle_config "https://github.com/paulinotech1/jml-/blob/main/config/lifecycle-config.json.example"
click node_role_mappings "https://github.com/paulinotech1/jml-/blob/main/config/role-mappings.json.example"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_joiner,node_mover,node_leaver,node_review toneBlue
class node_validation,node_mutation_gate,node_audit toneAmber
class node_lifecycle_config,node_role_mappings toneMint
class node_entra,node_logs,node_reports toneRose
class node_admin toneIndigo
```

## Components

### Lifecycle workflows

- [Joiner provisioning](https://github.com/paulinotech1/jml-/blob/main/src/Joiner-NewEmployee.ps1): `src/Joiner-NewEmployee.ps1`
- [Mover reconciliation](https://github.com/paulinotech1/jml-/blob/main/src/Mover-UpdateEmployee.ps1): `src/Mover-UpdateEmployee.ps1`
- [Leaver offboarding](https://github.com/paulinotech1/jml-/blob/main/src/Leaver-OffboardEmployee.ps1): `src/Leaver-OffboardEmployee.ps1`
- [Access review](https://github.com/paulinotech1/jml-/blob/main/src/Review-AccessReview.ps1): `src/Review-AccessReview.ps1`

### Shared safeguards

- [Config validation](https://github.com/paulinotech1/jml-/blob/main/src/modules/IdentityLifecycle.Common.psm1): `src/modules/IdentityLifecycle.Common.psm1`
- [Mutation gate](https://github.com/paulinotech1/jml-/blob/main/src/modules/IdentityLifecycle.Common.psm1): `src/modules/IdentityLifecycle.Common.psm1`
- [Audit trail](https://github.com/paulinotech1/jml-/blob/main/src/modules/IdentityLifecycle.Common.psm1): `src/modules/IdentityLifecycle.Common.psm1`

### Configuration

- [Lifecycle settings](https://github.com/paulinotech1/jml-/blob/main/config/lifecycle-config.json.example): `config/lifecycle-config.json.example`
- [Role mappings](https://github.com/paulinotech1/jml-/blob/main/config/role-mappings.json.example): `config/role-mappings.json.example`

### Tenant and outputs

- **Microsoft Entra ID**
- **JSONL logs**
- **CSV reports**

### Other components

- **Administrator**

## Connections

- Administrator → Joiner provisioning: runs (evidence: `README.md`)
- Administrator → Mover reconciliation: runs (evidence: `README.md`)
- Administrator → Leaver offboarding: runs (evidence: `README.md`)
- Administrator → Access review: runs (evidence: `README.md`)
- Joiner provisioning → Config validation: validates settings (evidence: `README.md`)
- Mover reconciliation → Config validation: validates settings (evidence: `README.md`)
- Leaver offboarding → Config validation: validates settings (evidence: `README.md`)
- Config validation → Lifecycle settings: checks (evidence: `README.md`)
- Config validation → Role mappings: checks (evidence: `README.md`)
- Joiner provisioning → Mutation gate: gates mutations (evidence: `README.md`)
- Mover reconciliation → Mutation gate: gates mutations (evidence: `README.md`)
- Leaver offboarding → Mutation gate: gates mutations (evidence: `README.md`)
- Mutation gate → Microsoft Entra ID: applies approved changes (evidence: `README.md`)
- Mutation gate → Audit trail: records actions (evidence: `README.md`)
- Audit trail → JSONL logs: appends entries (evidence: `README.md`)
- Access review → Microsoft Entra ID: reviews accounts (evidence: `README.md`)
- Access review → CSV reports: writes CSVs (evidence: `README.md`)
