ROUTE_PLANNING.md

MapleBids Route Planning & Page Architecture

MVP Routes (Launch Essential)

🏠 Public/Marketing Pages

• / - Landing Page ✅ DONE

  • Hero section with search
  • Value propositions
  • Call-to-actions

• /sign-in - Sign In ✅ DONE

  • Simple authentication form
  • Password recovery link

• /sign-up - Sign Up ✅ DONE

  • Registration form with company details
  • Email verification

🔍 Core Search & Discovery

• /search - Tender Search ✅ EXISTS (currently /tenderdata)

  • Advanced search filters
  • Real-time results
  • Sorting & pagination

• /search/results - Search Results 🚧 TODO

  • Refined search results
  • Filter sidebar
  • Save/bookmark functionality

• /tender/:id - Tender Details 🚧 TODO

  • Full tender information
  • Documents & attachments
  • Contact details
  • Similar tenders
  • Save/bookmark button

🤖 AI-Powered Features

• /ai-chat - AI Lead Generation Chat ✅ EXISTS (currently /leadgenchatv2)

  • Conversational tender discovery
  • Smart recommendations
  • Query refinement

• /rfp-generator - RFP Generator ✅ EXISTS (currently /rfp)

  • AI-powered proposal generation
  • Template library
  • Export functionality

👤 User home & Management

• /home - User home 🚧 TODO

  • Recent searches
  • Saved tenders
  • Quick actions
  • Activity overview

• /saved - Saved Tenders 🚧 TODO

  • Bookmarked opportunities
  • Notes & tags
  • Deadline tracking

• /profile - User Profile 🚧 TODO

  • Account settings
  • Company information
  • Notification preferences

---

Phase 2: Growth Features

💼 Business Intelligence

• /analytics - Analytics home

  • Tender trends
  • Success metrics
  • Market insights
  • Custom reports

• /alerts - Smart Alerts

  • Custom alert setup
  • Email/SMS notifications
  • Keyword monitoring
  • Deadline reminders

👥 Team & Collaboration

• /team - Team Management

  • User roles & permissions
  • Team member invites
  • Shared workspaces
  • Activity logs

• /company - Company Profile

  • Public company page
  • Past performance
  • Certifications
  • Portfolio showcase

📊 Advanced Features

• /insights - Market Insights

  • Industry analysis
  • Competitor tracking
  • Success predictions
  • Trend forecasting

• /proposals - Proposal Management

  • Active proposals
  • Template library
  • Collaboration tools
  • Submission tracking

---

Phase 3: Platform Expansion

🛒 Monetization

• /pricing - Pricing Plans

  • Plan comparison
  • Feature matrix
  • Billing management
  • Upgrade/downgrade

• /billing - Billing & Invoices

  • Payment history
  • Invoice downloads
  • Subscription management

🔧 Platform Management

• /admin - Admin home

  • User management
  • System monitoring
  • Content moderation
  • Platform analytics

• /api-docs - API Documentation

  • Developer resources
  • API endpoints
  • Code examples
  • Rate limiting info

📚 Support & Resources

• /about - About Us

  • Company story
  • Team information
  • Mission & values

• /contact - Contact

  • Support form
  • Live chat integration
  • Office locations

• /help - Help Center

  • FAQs
  • Video tutorials
  • User guides
  • Troubleshooting

• /legal/terms - Terms of Service

• /legal/privacy - Privacy Policy

• /legal/cookies - Cookie Policy

---

Phase 4: Advanced Enterprise

🏢 Enterprise Features

• /enterprise - Enterprise Solutions

  • Custom integrations
  • White-label options
  • Dedicated support

• /integrations - Third-party Integrations

  • CRM connections
  • Project management tools
  • Accounting software

📱 Mobile & API

• /mobile - Mobile App Landing

  • App download links
  • Feature highlights
  • QR code access

• /api - API Portal

  • Developer home
  • API key management
  • Usage analytics

---

URL Structure Best Practices

Current URLs (need updating):

• ❌ /tenderdata → ✅ /search
• ❌ /leadgenchatv2 → ✅ /ai-chat
• ❌ /rfp → ✅ /rfp-generator

SEO-Friendly URLs:

• /tender/government-it-services-2024-rfp-12345
• /search/technology-services/ontario
• /insights/construction-trends-2024

Dynamic Routes:

• /tender/:id - Individual tender pages
• /search/:category - Category-specific searches
• /user/:userId - Public user profiles
• /company/:companyId - Company profile pages

---

Implementation Priority

Week 1-2: MVP Core

1. ✅ Landing Page (DONE)
2. ✅ Authentication (DONE)
3. 🚧 Search Results page
4. 🚧 Tender Details page
5. 🚧 Basic home

Week 3-4: User Features

1. Saved Tenders functionality
2. User Profile management
3. Basic notifications
4. Search history

Month 2: Growth Features

1. Analytics home
2. Smart alerts
3. Team collaboration
4. Advanced search filters

Month 3+: Platform Expansion

1. Billing & pricing
2. Admin tools
3. API development
4. Mobile optimization

---

Technical Considerations

Protected Routes

• All /home/*, /saved/*, /profile/* routes need authentication
• Admin routes need role-based access control
• API routes need rate limiting

SEO Strategy

• /search/* and /tender/* should be publicly accessible
• Server-side rendering for tender detail pages
• Structured data for tender information

Performance

• Lazy loading for admin/analytics pages
• Code splitting by feature areas
• Caching strategy for search results

Mobile-First

• All routes should be responsive
• Touch-friendly interfaces
• Fast loading on mobile networks