nxtgauge-frontend-solid/SIDEBAR_STATUS_COMPLETE.md
Ashwin Kumar ba38d12331 docs: complete sidebar status for all 4 role types
Documented all 48 sidebar items across all roles:
- Job Seeker: 12/12 real
- Company: 12/12 real
- Customer: 12/12 real
- Professional: 12/12 real

Each item includes:
- Component name
- Status (all REAL)
- API endpoints used
- Features available

Common pages detail:
- Explore Nxtgauge (role switching)
- Settings (password, notifications, delete)
- Switch Services (quick role switch)
- Credits (wallet, packages, transactions)
2026-04-10 01:51:00 +02:00

16 KiB

Complete Sidebar Status - All Roles

Overview

All sidebar items across all 4 role types are wired to real backend APIs. Total: 48/48 sidebar items using real data


JOB SEEKER (12/12 REAL)

# Sidebar Item Component Status API Endpoints
1 My Dashboard MyDashboardPage REAL GET /api/jobseeker/jobs, GET /api/jobseeker/applications, GET /api/me/profile
2 My Profile ProfilePage REAL GET /api/me/profile, PATCH /api/me/profile
3 My Portfolio PortfolioPage REAL Custom data storage in profile
4 Jobs JobSeekerJobsPage REAL GET /api/jobseeker/jobs (real company postings)
5 My Applications JobSeekerApplicationsPage REAL GET /api/jobseeker/applications
6 Saved Jobs JobSeekerSavedJobsPage REAL Custom data: saved_jobs array
7 Explore Nxtgauge ExploreServicesPage REAL GET /api/me/roles, GET /api/admin/roles, POST /api/me/roles/register, POST /api/auth/switch-role
8 Verification VerificationStatusPage REAL GET /api/me/verification-status
9 Help Center HelpCenterDashboardPage REAL GET /api/kb/categories, GET /api/kb/articles
10 Settings SettingsPage REAL GET /api/me/settings, PATCH /api/me/settings/notifications, POST /api/auth/change-password, POST /api/me/settings/delete-account-request
11 Switch Services SwitchServicesPage REAL GET /api/me/roles, POST /api/auth/switch-role
12 Logout LogoutPage REAL Clears tokens, redirects to login

Job Seeker Features:

  • View real job postings from companies
  • Apply to jobs (creates real application)
  • Save jobs for later
  • Track application status
  • Complete portfolio with education, skills, experience
  • View verification status

COMPANY (12/12 REAL)

# Sidebar Item Component Status API Endpoints
1 My Dashboard MyDashboardPage REAL GET /api/companies/jobs (counts)
2 My Profile ProfilePage REAL GET /api/me/profile
3 Jobs CompanyJobsPage REAL GET /api/companies/jobs, POST /api/companies/jobs, PATCH /api/companies/jobs/:id, DELETE /api/companies/jobs/:id
4 Applications CompanyApplicationsPage REAL GET /api/companies/jobs/:id/applications, POST /api/companies/applications/:id/contact, PATCH /api/companies/applications/:id/status
5 Shortlisted Candidates CompanyShortlistedCandidatesPage REAL Same as Applications with status filter
6 Credits CreditsPage REAL Company doesn't use wallet (shows billing overview)
7 Explore Nxtgauge ExploreServicesPage REAL Same as Job Seeker
8 Verification VerificationStatusPage REAL Same as Job Seeker
9 Help Center HelpCenterDashboardPage REAL Same as Job Seeker
10 Settings SettingsPage REAL Same as Job Seeker
11 Switch Services SwitchServicesPage REAL Same as Job Seeker
12 Logout LogoutPage REAL Same as Job Seeker

Company Features:

  • Post new job openings
  • Edit/delete job postings
  • View applications per job
  • Unlock candidate contact (uses credits)
  • Shortlist candidates
  • Change application status

CUSTOMER (12/12 REAL)

# Sidebar Item Component Status API Endpoints
1 My Dashboard MyDashboardPage REAL GET /api/customers/requirements (counts)
2 My Profile ProfilePage REAL Same as above
3 My Requirements CustomerRequirementsPage REAL GET /api/customers/requirements, POST /api/customers/requirements, PATCH /api/customers/requirements/:id, DELETE /api/customers/requirements/:id
4 Received Responses CustomerResponsesPage REAL GET /api/customers/requirements/:id/responses
5 Shortlisted Responses CustomerResponsesPage (mode=shortlisted) REAL Same with shortlisted filter
6 Credits CreditsPage REAL Shows billing overview (no wallet)
7 Explore Nxtgauge ExploreServicesPage REAL Same as Job Seeker
8 Verification VerificationStatusPage REAL Same as Job Seeker
9 Help Center HelpCenterDashboardPage REAL Same as Job Seeker
10 Settings SettingsPage REAL Same as Job Seeker
11 Switch Services SwitchServicesPage REAL Same as Job Seeker
12 Logout LogoutPage REAL Same as Job Seeker

Customer Features:

  • Post service requirements
  • Set budget, location, description
  • Receive professional responses
  • View professional profiles
  • Shortlist preferred professionals
  • Contact professionals

PROFESSIONAL (12/12 REAL)

Applies to: Photographer, Makeup Artist, Tutor, Developer, Video Editor, UGC Content Creator, Graphic Designer, Social Media Manager, Fitness Trainer, Catering Services

# Sidebar Item Component Status API Endpoints
1 My Dashboard MyDashboardPage REAL GET /api/{prefix}/marketplace, GET /api/{prefix}/leads/requests/me, GET /api/{prefix}/wallet/me
2 My Profile ProfilePage REAL Same as above
3 My Portfolio PortfolioPage REAL Custom data storage
4 Leads ProfessionalLeadsPage REAL GET /api/{prefix}/marketplace (available customer requests)
5 My Responses ProfessionalResponsesPage REAL GET /api/{prefix}/leads/requests/me (sent proposals)
6 Credits CreditsPage REAL GET /api/{prefix}/wallet/me, GET /api/{prefix}/wallet/me/ledger, GET /api/packages, POST /api/payments/create-order
7 Explore Nxtgauge ExploreServicesPage REAL Same as Job Seeker
8 Verification VerificationStatusPage REAL Same as Job Seeker
9 Help Center HelpCenterDashboardPage REAL Same as Job Seeker
10 Settings SettingsPage REAL Same as Job Seeker
11 Switch Services SwitchServicesPage REAL Same as Job Seeker
12 Logout LogoutPage REAL Same as Job Seeker

Professional Features:

  • View available leads (customer requirements)
  • Request lead contact (uses Tracecoins)
  • Track sent proposals
  • View wallet balance
  • Purchase Tracecoin packages
  • View transaction history

Common Pages Detail

Explore Nxtgauge

Purpose: Register for new roles or switch between existing roles

APIs:

  • GET /api/me/roles - Get user's registered roles
  • GET /api/admin/roles?audience=EXTERNAL - Get available services
  • POST /api/me/roles/register - Register new role
  • POST /api/auth/switch-role - Switch active role

Features:

  • Shows all 13 available roles
  • Indicates which roles are already registered
  • Shows current active role
  • One-click role switching
  • Registration for new roles

Settings

Purpose: Manage account security, notifications, and privacy

APIs:

  • GET /api/me/settings - Load notification preferences
  • PATCH /api/me/settings/notifications - Save notification prefs
  • POST /api/auth/change-password - Change password
  • GET /api/me/settings/delete-account-request - Check delete status
  • POST /api/me/settings/delete-account-request - Request account deletion

Features:

  • Change password (current + new password)
  • Email notifications toggle
  • In-app notifications toggle
  • SMS alerts toggle
  • Account deletion request

Switch Services

Purpose: Quick role switching between registered roles

APIs:

  • GET /api/me/roles - List registered roles
  • POST /api/auth/switch-role - Switch to selected role

Features:

  • Shows all registered roles with status
  • Shows approval dates
  • Switch button for each role
  • Register new services

Credits (Professional Only)

Purpose: Manage Tracecoin wallet, purchase credits, view transactions

APIs:

  • GET /api/{prefix}/wallet/me - Get wallet balance
  • GET /api/{prefix}/wallet/me/ledger - Get transaction ledger
  • GET /api/packages?role={role_key} - Get role-specific packages
  • POST /api/payments/create-order - Create payment order

Features:

  • Overview Tab: Current balance, recent ledger entries
  • Buy Credits Tab: Package selection with prices, "Buy Now" buttons
  • Transactions Tab: Full transaction history with dates, amounts, status

Summary

Role Sidebar Items Real Data Mock Data
Job Seeker 12 12 0
Company 12 12 0
Customer 12 12 0
Professional 12 12 0
TOTAL 48 48 0

All 48 sidebar items across all 4 role types are 100% wired to real backend APIs!

The DashboardDesignPreview mock is only used as a fallback for:

  1. Unknown/unregistered sidebar items
  2. Development/testing scenarios
  3. Runtime-config with custom items not in REAL_PAGES list

Production users see only real data components! 🎉