Encore OS — Documentation

Supporting documentation. This file documents GR module navigation structure. Parent spec: GR-01 (Policy Management). Formal specs live in specs/gr/. See Navigation Standard.

Version: 4.0.0
Module: Governance & Learning (GR) Date: 2026-02-04 Phase: 5 - Section Headers & Personal Group Complete

Current State Inventory

Registry Entry (module-registry.ts)

{
  id: "gr",
  route: "/gr/dashboard",
  settingsRoute: "/gr/settings"
}

NavItems (4 total)

Label	Route	Icon	Has Label	Permission	Standard
Overview	/gr/dashboard	`LayoutDashboard`	✅	-	✅
Forms	/gr/forms	`FileText`	✅	-	✅
Reports	/gr/reports	`BarChart3`	✅	-	✅
Settings	/gr/settings	`Settings`	✅	gr.admin	✅

Quick Actions (4 total - aligned with platform standard)

Label	Route	Icon	Section
My Acknowledgments	/gr/my-acknowledgments	`CheckCircle2`	Self-Service
My Training	/gr/my-training	`BookOpen`	Self-Service
Compliance Dashboard	/gr/compliance	`ShieldCheck`	Operations
AI Suggestions	/gr/ai/suggestions	`Sparkles`	AI Features

NavGroups (6 total with section headers)

PERSONAL Section

1. My Governance (section: “personal”)

Label	Route	Icon	Has Label	Permission	Standard
My Acknowledgments	/gr/my-acknowledgments	`CheckCircle2`	✅	-	✅
My Training	/gr/my-training	`BookOpen`	✅	-	✅
CEU Transcript	/gr/ceu-transcript	`Award`	✅	-	✅

OPERATIONS Section

2. Policies & Training (section: “operations”)

Label	Route	Icon	Has Label	Permission	Standard
Policy Library	/gr/policies	`FileText`	✅	-	✅
Training Library	/gr/training	`GraduationCap`	✅	-	✅
Acknowledgment Tracker	/gr/acknowledgments	`ClipboardList`	✅	gr.policies.admin	✅
Policy Reviews	/gr/reviews	`Clock`	✅	gr.policies.admin	✅

3. Compliance & Accreditations (section: “operations”)

Label	Route	Icon	Has Label	Permission	Standard
Compliance Dashboard	/gr/compliance	`LayoutDashboard`	✅	-	✅
Requirements	/gr/compliance/requirements	`ClipboardList`	✅	-	✅
Remediation Tracker	/gr/compliance/remediation	`CircleAlert`	✅	-	✅
Contract Dashboard	/gr/contracts/dashboard	`LayoutDashboard`	✅	gr.contracts.view	✅
All Contracts	/gr/contracts	`FileText`	✅	gr.contracts.view	✅
Accreditations	/gr/accreditations	`Award`	✅	gr.accreditations.view	✅
Accreditation Reports	/gr/accreditations/reports	`FileText`	✅	gr.accreditations.view	✅

4. Audit & Risk (section: “operations”)

Label	Route	Icon	Has Label	Permission	Standard
Audits	/gr/audits	`ClipboardList`	✅	-	✅
Audit Findings	/gr/audits/findings	`CircleAlert`	✅	gr.audits.admin	✅
Audit Readiness	/gr/audits/readiness	`ShieldCheck`	✅	-	✅
Corrective Actions	/gr/audits/corrective-actions	`CheckCircle2`	✅	gr.audits.admin	✅
Risk Register	/gr/risks	`ShieldAlert`	✅	-	✅

5. Quality Improvement (section: “operations”)

Label	Route	Icon	Has Label	Permission	Standard
QI Overview	/gr/quality-improvement	`LayoutDashboard`	✅	-	✅
My QI Dashboard	/gr/my-quality-improvement	`Users`	✅	-	✅
QI Dashboard	/gr/quality-improvement/dashboard	`BarChart3`	✅	-	✅
QI Reports	/gr/quality-improvement/reports	`FileText`	✅	-	✅
QI Templates	/gr/quality-improvement/templates	`Layers`	✅	gr.qi.admin	✅

ADMIN Section

6. AI Compliance Advisor (isSubModule: true, section: “admin”)

Label	Route	Icon	Has Label	Standard
AI Suggestions	/gr/ai/suggestions	`Sparkles`	✅	✅
Gap Analysis	/gr/ai/gap-analysis	`Search`	✅	✅
Audit Prep	/gr/ai/audit-prep	`ShieldCheck`	✅	✅
Risk Assessment	/gr/ai/risk-assessment	`ShieldAlert`	✅	✅

Icon Compliance Summary

Category	Count	Compliant	Rate
navItems	4	4	100%
navGroup headers	6	6	100%
navGroup items	28	28	100%
Total	38	38	100%

Standard Icon Usage

All icons follow ICON_GUIDE.md standards:

✅ LayoutDashboard for Overview/Dashboard pages
✅ Settings for Settings pages
✅ FileText for Forms/Documents
✅ BarChart3 for Reports/Analytics
✅ CircleAlert for Findings/Remediation (not AlertTriangle)
✅ ShieldAlert for Risk Register/Risk Assessment
✅ GraduationCap for Training Library
✅ Sparkles for AI features
✅ Users for My/Self-Service dashboards

Reference: Icon Usage Guide

Phase 5 Changes Summary

Change	Before	After
Section Headers	None	PERSONAL, OPERATIONS, ADMIN
Personal Group	None	My Governance (3 items)
Policies + Learning	2 separate groups (7 items total)	1 merged group (4 items)
Self-service items	Scattered across groups	Consolidated in My Governance
Quick Actions	5 items	4 items (platform standard)
“Overview” collision	Yes (QI group)	Fixed → “QI Overview”

Gap Analysis

Total routes: 32
Labeled routes: 32
Coverage: 100% ✅

Sub-Module Assessment

GR has 1 sub-module (AI Compliance Advisor), properly configured:

isSubModule: true
overviewRoute: /gr/ai/suggestions
description: “AI-powered compliance insights and guidance”
section: “admin”

Structure Compliance

navGroups: 6 (within guideline of 4-8) ✅
Max items per group: 7 (within guideline of ≤8) ✅
V2 Permissions: ✅ All admin items have permission keys
Section Headers: ✅ All groups have section property

Route Coverage in KNOWN_ROUTES

All 32 GR routes are covered in route-integrity.test.ts.

Completion Status

Check	Status
All routes have breadcrumb labels	✅
All navGroups have ≤8 items	✅
Section headers implemented	✅
V2 permission keys added	✅
KNOWN_ROUTES updated	✅
Structure within guidelines	✅
Icon column documented	✅
Icons follow ICON_GUIDE.md	✅
Quick Actions ≤4 items	✅
My Governance personal group	✅
Label collisions resolved	✅

Phase 5 Status: ✅ Complete

PERSONAL
├── My Governance
│   ├── My Acknowledgments
│   ├── My Training
│   └── CEU Transcript

OPERATIONS
├── Policies & Training
│   ├── Policy Library
│   ├── Training Library
│   ├── Acknowledgment Tracker (admin)
│   └── Policy Reviews (admin)
├── Compliance & Accreditations
│   ├── Compliance Dashboard
│   ├── Requirements
│   ├── Remediation Tracker
│   ├── Contract Dashboard (view)
│   ├── All Contracts (view)
│   ├── Accreditations (view)
│   └── Accreditation Reports (view)
├── Audit & Risk
│   ├── Audits
│   ├── Audit Findings (admin)
│   ├── Audit Readiness
│   ├── Corrective Actions (admin)
│   └── Risk Register
└── Quality Improvement
    ├── QI Overview
    ├── My QI Dashboard
    ├── QI Dashboard
    ├── QI Reports
    └── QI Templates (admin)

ADMIN
└── AI Compliance Advisor (sub-module)
    ├── AI Suggestions
    ├── Gap Analysis
    ├── Audit Prep
    └── Risk Assessment

Reviewed By: Navigation Consolidation AI
Date: 2026-02-04 Updated: Phase 5 - Section headers, My Governance group, merged Policies & Training, Quick Actions optimization

Start Here

Module Engineering Snapshots

Canonical AI Governance

Architecture

Integrations

Development

Decision Guides

Database

Module Reference

Testing

Migration

Operations

Governance & Security

Platform Internals

GR Module Navigation Worksheet

Current State Inventory

Registry Entry (module-registry.ts)

NavItems (4 total)

Quick Actions (4 total - aligned with platform standard)

NavGroups (6 total with section headers)

PERSONAL Section

1. My Governance (section: “personal”)

OPERATIONS Section

2. Policies & Training (section: “operations”)

3. Compliance & Accreditations (section: “operations”)

4. Audit & Risk (section: “operations”)

5. Quality Improvement (section: “operations”)

ADMIN Section

6. AI Compliance Advisor (isSubModule: true, section: “admin”)

Icon Compliance Summary

Standard Icon Usage

Phase 5 Changes Summary

Gap Analysis

Sub-Module Assessment

Structure Compliance

Route Coverage in KNOWN_ROUTES

Completion Status

Navigation Visual Hierarchy

​Current State Inventory

​Registry Entry (module-registry.ts)

​NavItems (4 total)

​Quick Actions (4 total - aligned with platform standard)

​NavGroups (6 total with section headers)

​PERSONAL Section

1. My Governance (section: “personal”)

​OPERATIONS Section

2. Policies & Training (section: “operations”)

3. Compliance & Accreditations (section: “operations”)

4. Audit & Risk (section: “operations”)

5. Quality Improvement (section: “operations”)

​ADMIN Section

6. AI Compliance Advisor (isSubModule: true, section: “admin”)

​Icon Compliance Summary

​Standard Icon Usage

​Phase 5 Changes Summary

​Gap Analysis

​Breadcrumb Labels

​Sub-Module Assessment

​Structure Compliance

​Route Coverage in KNOWN_ROUTES

​Completion Status

​Navigation Visual Hierarchy

​Related Documentation

Current State Inventory

Registry Entry (module-registry.ts)

NavItems (4 total)

Quick Actions (4 total - aligned with platform standard)

NavGroups (6 total with section headers)

PERSONAL Section

OPERATIONS Section

ADMIN Section

Icon Compliance Summary

Standard Icon Usage

Phase 5 Changes Summary

Gap Analysis

Breadcrumb Labels

Sub-Module Assessment

Structure Compliance

Route Coverage in KNOWN_ROUTES

Completion Status

Navigation Visual Hierarchy

Related Documentation