Detailed Route & Page Map

The app shell is organized into “Tactical Zones.” This map details every major route in the plugzero-analytics repository and the business logic it serves.

🏗️ The Dashboard Core `(dashboard)`

All routes within this group share the DashboardLayout, which provides the sidebar, top navigation, and global Project Context.

1. Project Management

/projects: The master list of all research workspaces.
/projects/[id]: The “Command Center” for a specific project. It shows a summary of recent file uploads, survey responses, and AI activity.

2. Analysis & AI Workspace

/analysis: The entry point for all math calculations.
/analysis/workbench: The “Heavy” interface for running Crosstabs, Means, and Driver Analysis.
/analysis/insights: A focused view for AI-generated reports and SWOT matrices.
/agent: The full-page AI Chat interface for deep conversation with the intelligence engine.

3. Intelligence Modules

/seo: Technical website health scanning (/seo/audit) and keyword keyword benchmarking (/seo/trends).
/media-intelligence: Dashboard for brand listening and social mention monitoring.
/reporting: Management of generated PDF and HTML reports.

4. Data Collection

/data-collection: The overview of all ingestion sources.
/data-collection/files: The “Files Library” for managing CSV, Excel, and PDF assets.
/surveys: The full survey lifecycle management suite.
/surveys/builder: The specialized visual canvas for survey design.
/surveys/responses: The analysis view for raw respondent data.

5. Community & Collaboration

/panel: Management of respondent pools and “Smart Communities.”
/team: interface for inviting members and managing role-based permissions.
/settings: Personal profile, notification preferences, and API key management.

📢 Marketing & Public Discovery `(marketing)`

Statically optimized (ISR/SSG) pages designed for 100/100 Lighthouse performance.

/: The landing page with high-performance animations and demo widgets.
/solutions/[slug]: Narrative pages for specific industries (e.g., Finance, SaaS, Retail).
/pricing: The subscription tier selector integrated with Stripe.
/security: Details on our “Zero Training” AI policy and encryption standards.

🔓 The Public Perimeter

High-speed, stateless routes designed for the lowest possible bounce rate.

/survey/[uuid]: The “Clean” respondent experience. It uses a minimal bundle to ensure fast loads on mobile devices.
/login / /register: The centralized authentication gateway.
/forgot-password: Secure recovery flow.

🛣️ Path Conventions

Dynamic Routes

We use [id] or [uuid] for data-bound pages.

src/app/(dashboard)/analysis/[id]/page.tsx -> Displays a specifically saved calculation result.

Query Parameters

The UI uses URL search parameters to maintain state.

?project=123: Sets the active project for the entire dashboard.
?view=chart: Toggles between the table and chart view in the Workbench.

Developer Rule: When adding a new page to the dashboard, always wrap your content in the <PageContainer> component to ensure consistent spacing and sidebar alignment.