Skip to main content

​
Feature 028: Routing Management System

​
1. Overview

The Routing Management System is the navigation backbone of Fiftyknots. It maps every page and API endpoint in the platform, ensuring you land exactly where you need to be - whether you’re building a business model canvas, reviewing specs with your sherpa, or tracking venture progress. This system powers seamless navigation across 100+ pages and 500+ API routes, so you spend time building instead of hunting for features.

​
2. Step-by-Step Guide

Understanding Your Navigation:
  1. Access the platform - Log in at /login and land on your primary dashboard based on your role (founder, sherpa, or expert).
  2. Navigate core workflows - Use the main navigation to access key areas:
    • Start new ventures with /wizard or /quickstart
    • Build strategy artifacts at /bmc, /cvpdashboard, or /charter
    • Track progress through /journeydashboard or /pipelinedashboard
    • Collaborate with sherpas via /collaborativeworkspace or /sherpadashboard
  3. Follow intelligent routing - The system automatically redirects you based on context. After completing venture setup, you route to the appropriate next stage without manual navigation.
  4. Use specialized views - Access role-specific dashboards:
    • Founders see /dashboard with portfolio overview
    • Sherpas access /sherpacombineddashboard for client work
    • Experts view /expertdashboard for allocations and earnings
  5. Access admin functions - Platform administrators route to /admin/* paths for system configuration, expert metrics, and verification pipelines.
  6. Review legal and settings - Navigate to /legal/* for policies or /privacypreferences to manage data settings.
Key Navigation Patterns:
  • Job-specific routes use /:jobId parameter (example: /bmc/:jobId for a specific business model canvas)
  • Review workflows route through /review/* or /briefreview paths
  • Payment and financial routes live under /invoices, /paymenthistory, or /transactionhistory
  • Team collaboration routes to /venturesquad, /teamprojectlist, or /teamprojectdetail

​
3. Common Questions

Q: How do I get back to my main dashboard if I’m deep in a workflow? A: Click the Fiftyknots logo or home icon in the navigation bar. Your dashboard route is context-aware - founders see portfolio overview, sherpas see client assignments, experts see active jobs. Q: What happens if I try to access a page I don’t have permission for? A: The routing system checks your role and permissions. If you lack access, you route to your primary dashboard with a notification. Admins can grant access overrides through /admin/accessoverridemanagement. Q: Can I bookmark specific pages for quick access? A: Yes. All routes are stable URLs. Bookmark frequently used pages like your journey dashboard (/journeydashboard) or specific job views. Job-specific routes require active job access. Q: How do I navigate between different ventures or jobs? A: Use the job selector in the top navigation bar. This updates your context and routes you to the equivalent page for the selected job. Navigate to /dashboard to see all your active ventures. Q: Where do I go after completing a major milestone? A: The system routes you automatically. After completing wizard setup, you move to /charter generation. After charter approval, you advance to the next journey stage. Check /journeystatus to see your position.

​
4. Troubleshooting

Issue: Page loads but shows “Access Denied” or redirects unexpectedly Solution: Verify you have the required role or permissions. Contact your sherpa or admin to request access. Check /profile to confirm your role status. Some pages require specific journey stage completion before access. Issue: API calls fail with 404 errors in browser console Solution: This typically means the feature isn’t available for your venture stage or role. Check feature availability at /features/accessible. Ensure your venture has progressed through required stages. Contact support if a feature should be available. Issue: Deep links from emails or notifications lead to login page Solution: Your session expired. Log in again - the system preserves the intended destination and routes you there after authentication. Enable “Remember me” at login for longer sessions. Issue: Navigation feels slow or pages take time to load Solution: The routing system is fast, but data-heavy pages load on demand. Check your internet connection. Clear browser cache if pages fail to update. Visit /telemetrydashboard to check system health if issues persist. Feature: Authentication & Session Management - Controls access to all routes through OTP verification and role-based permissions. Connects to routing by determining which pages you can access and where you land after login. Managed through /auth/session endpoints. Feature: Journey Management System - Defines the stage-based progression that determines routing logic. Your current journey stage controls which pages become accessible and where the system routes you after completing tasks. View your journey at /journeyoverview. Feature: Navigation & Intelligent Suggestions - Builds on the routing system to predict your next action and suggest relevant pages. Uses your activity history to surface frequently accessed routes and context-aware recommendations. Access via navigation bar or API.