> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# GR Module Navigation Worksheet

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

> **Supporting documentation.** This file documents GR module navigation structure. Parent spec: GR-01 (Policy Management). Formal specs live in `specs/gr/`. See [Navigation Standard](/architecture/standards/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)

```typescript theme={null}
{
  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](/development/ICON_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

### Breadcrumb Labels

* **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

***

## Navigation Visual Hierarchy

```text theme={null}
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
```

***

## Related Documentation

* [Icon Usage Guide](/development/ICON_GUIDE)
* [Navigation Standard](/architecture/standards/NAVIGATION_STANDARD)
* [Navigation Audit Checklist](https://github.com/Encore-OS/encoreos/blob/development/docs/architecture/reviews/NAVIGATION_AUDIT.md)
* [Module Registry](https://github.com/Encore-OS/encoreos/blob/development/src/platform/modules/module-registry.ts)

***

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