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

# Feature 028: Routing Management System

> The Routing Management System forms the navigation backbone of Fiftyknots, mapping over 200 pages and 800+ API endpoints across your venture building 

# Feature Guide: Routing Management System

## 1. Overview

The Routing Management System forms the navigation backbone of Fiftyknots, mapping over 200 pages and 800+ API endpoints across your venture building journey. This system ensures you land on the right page at the right time - whether you're reviewing a brief, checking your Data Room, or managing your venture squad. It powers intelligent navigation suggestions, tracks your activity patterns, and connects every feature into a cohesive platform experience that adapts to your current stage and role.

## 2. Step-by-Step Guide

### Accessing Core Platform Pages

1. **Navigate to any primary workflow** - The system automatically routes you based on your current job context. For example, `/aistudio` takes you to AI-powered brief generation, while `/dataroomlist` shows your document repositories.

2. **Use intelligent navigation suggestions** - The platform tracks your activity and surfaces relevant next steps. Click suggested pages to jump directly to high-priority tasks or frequently accessed features.

3. **Switch between role-specific dashboards** - Access your founder dashboard at `/dashboard`, expert workspace at `/expertdashboard`, or Sherpa control center at `/sherpadashboard`. The routing system maintains your context across role switches.

4. **Follow journey-based workflows** - The system guides you through sequential stages. After completing ICP selection at `/icpselection`, you'll route to `/icptesting` for validation, then to `/journeyoverview` for execution tracking.

5. **Access specialized tools** - Navigate to feature-specific pages like `/playbookide` for playbook development, `/prdashboard` for product requirements, or `/cvpvalidationdashboard` for customer validation campaigns.

6. **Review legal and compliance pages** - Access terms, privacy policy, and data deletion options through the `/legal` namespace - essential checkpoints as your venture scales.

### Working with API Integrations

7. **Connect external services** - Route to integration pages like `/admin/xeroconnection` for accounting sync or use the developer analytics endpoints to track platform usage and performance.

8. **Monitor system health** - Access analytics dashboards at `/analyticsdashboard` and `/telemetrydashboard` to track feature adoption, error rates, and platform performance across your venture portfolio.

## 3. Common Questions

**Q: How does the routing system know which page to show me next?**

The system analyzes your current job stage, role permissions, and recent activity patterns. It uses this context to surface relevant pages through navigation suggestions (accessible via `/api/v1/navigation/suggestions`) and automatically redirects you to the next logical step in your workflow.

**Q: Can I bookmark specific pages or save frequently used routes?**

Yes. The routing system tracks your frequent pages automatically (via `/api/v1/navigation/frequent-pages`) and maintains your recent navigation history. You can directly bookmark any page URL - the system preserves your job context across sessions.

**Q: What happens if I try to access a page before completing prerequisite steps?**

The system enforces feature access gates based on your venture stage and journey progress. If you attempt premature access, you'll route to an appropriate intermediate step. For example, accessing `/confidencereport` before generating an assessment redirects you to complete the required confidence evaluation first.

**Q: How do I switch between different jobs or ventures I'm working on?**

Navigate to your portfolio overview at `/intake/portfolio` or use the job selector in your main dashboard. The routing system maintains separate contexts for each job, ensuring URLs like `/brief/:jobId/briefs` always load the correct venture's data.

**Q: Can I share specific page URLs with my Sherpa or team members?**

Yes. Most workflow pages support direct URL sharing with embedded job identifiers. Team members with appropriate permissions can access shared routes. For sensitive data like Data Rooms, use the invitation system at `/inviteredemption` rather than direct URL sharing.

## 4. Troubleshooting

**Issue: Page loads but shows "Access Denied" or redirects unexpectedly**

The routing system enforces role-based permissions and stage gates. Verify your profile completion at `/profile` and confirm your current lifecycle position at `/lifecycle/position`. If working on a team project, check your invitation status at `/team-member/invitations`.

**Issue: Navigation suggestions show outdated or irrelevant pages**

The system learns from your activity patterns over time. Clear stale suggestions by dismissing them at `/api/v1/navigation/suggestions/:suggestionId/dismiss`. The algorithm recalibrates based on your recent actions and current job stage. Force a refresh by completing a major milestone or advancing your journey stage.

**Issue: Deep links from emails or external sources don't work**

Verify your authentication session at `/api/v1/auth/session`. The routing system requires valid credentials for most pages. If you're accessing from a new device or after session expiration, route through `/login` first, then navigate to your target page. For public upload links, use the tokenized URLs at `/publicupload` which bypass authentication.

**Issue: Can't find a specific feature or page mentioned in documentation**

Use the navigation search at `/api/v1/navigation/search` to locate features by name or keyword. The routing system indexes all accessible pages and provides direct links with your current job context. If search returns no results, the feature may require higher permissions or a different venture stage - check your journey position and feature access status.

## 5. Related Features

**Navigation Tracking and Activity Monitoring** - The system logs your page visits and interaction patterns through `/api/v1/navigation/track-activity`, powering personalized routing suggestions and workflow optimization. This connects to your lifecycle progression by identifying bottlenecks and frequently abandoned workflows.

**Journey Management and Stage Progression** - Your routing experience adapts as you advance through venture stages. The Journey Builder at `/admin/journeybuilder` defines available routes per stage, while your personal journey at `/journeyoverview` shows your current position and unlocks new pages as you progress.

**Access Override and Permission Management** - Administrators can grant temporary access to restricted routes via `/admin/accessoverridemanagement`. This connects to the routing system by allowing founders to preview upcoming features or access specialized tools before meeting standard graduation criteria.
