<h2>SurveyPulse — AI-Powered Survey & Multi-Tenant Organization Platform</h2>

<p>

<strong>SurveyPulse</strong> is a production-ready, multi-role survey management platform

built for organizations that need field surveys, AI-generated questionnaires, real-time

analytics, and multi-role team collaboration — all in one place. It ships with a full

<strong>Laravel 12 backend</strong>, a <strong>React + Inertia.js web admin panel</strong>

with six distinct role dashboards, a <strong>versioned REST API</strong> for a companion

Flutter mobile app, and an optional <strong>AI microservice</strong> for intelligent survey

automation — all behind a guided installation wizard so you can go live within minutes.

</p>

<hr />

<h3>✨ Why SurveyPulse?</h3>

<ul>

<li>One platform for your entire team — from organization owner down to field surveyor</li>

<li>Geo-scoped access control keeps each member focused on only their assigned area</li>

<li>AI turns live trends and news into ready-to-publish surveys automatically</li>

<li>Reach respondents via SMS, WhatsApp, and voice calls from a single interface</li>

<li>Built-in install wizard — no manual config files or artisan commands needed</li>

<li>Supports MySQL, PostgreSQL, and SQLite out of the box</li>

</ul>

<hr />

<h3>🔑 Six-Role Dashboard System</h3>

<p>Every role gets its own purpose-built dashboard, navigation, and scoped data:</p>

<ul>

<li><strong>Owner</strong> — full platform control, billing, subscription, org settings</li>

<li><strong>Admin</strong> — member management, survey management, communications, AI trends</li>

<li><strong>Leader</strong> — surveys, invitations, communications, reports, AI trends</li>

<li><strong>Worker</strong> — assigned surveys, responses, complaints</li>

<li><strong>Surveyor</strong> — field survey execution, complaint submission</li>

<li><strong>Voter</strong> — self-service survey participation, wallet, complaints</li>

</ul>

<hr />

<h3>📋 Survey Engine</h3>

<ul>

<li>8+ rich question types: text, single/multiple choice, rating, scale, date picker, file upload, location</li>

<li>Full lifecycle management: <strong>Draft → Published → Paused → Archived</strong></li>

<li>Target-area filtering — a survey assigned to a specific region is only visible to members of that area</li>

<li>Assign surveys to specific surveyors with area scope, deadline, and per-surveyor response cap</li>

<li>Shareable public survey links for self-service responses (no login required)</li>

<li>GPS-tagged field responses with device metadata and partial response tracking</li>

<li>Survey duplication for quick template reuse</li>

<li>Response analytics dashboard per survey</li>

<li>Export responses to CSV and PDF</li>

<li>Reward incentives: points, cashback, or voucher on completion</li>

</ul>

<hr />

<h3>🗺️ Geo-Hierarchy & Cluster Management</h3>

<ul>

<li>Full 6-level hierarchy: <strong>State → District → Parliamentary Constituency → Assembly Constituency → Mandal/Ward → Village/Area</strong></li>

<li>Platform owner assigns geographic privileges to each organization</li>

<li>Org admins further scope leaders and workers to specific assembly constituencies</li>

<li>Cluster-based grouping — bundle multiple assembly constituencies and assign a leader to all of them at once</li>

<li>Constituency-scope middleware automatically filters all surveys, members, and clusters to each member's allowed areas</li>

<li>Reverse geocoding — detect which area a GPS coordinate belongs to</li>

<li>Geo boundaries (JSON) and centroid lat/lng stored for map rendering</li>

</ul>

<hr />

<h3>📊 Analytics & Reporting</h3>

<ul>

<li>Real-time response dashboards with interactive charts (ApexCharts)</li>

<li>Demographic breakdowns and filtering</li>

<li>Export to CSV and PDF</li>

<li>AI-powered trend analysis</li>

</ul>

<hr />

<h3>🤖 AI & Trends Module</h3>

<ul>

<li>External FastAPI AI microservice integration (URL configurable via <code>.env</code>)</li>

<li>News feed and social media feed ingestion for trend detection</li>

<li>AI-generated surveys based on current trends — queue-based, non-blocking</li>

<li>Auto-survey scheduling: daily, weekly, or monthly per organization</li>

<li>Trend detail view with source attribution</li>

<li>Google Cloud Translate + Stichoza fallback for multi-language survey delivery</li>

</ul>

<hr />

<h3>💬 AI Chatbot Assistant</h3>

<ul>

<li>Per-organization AI chatbot with configurable knowledge datasources</li>

<li>Powered by FastLab AI agents</li>

<li>Guided survey delivery through conversational interface</li>

<li>Embeddable chat widget</li>

<li>Conversation history with automated insight extraction</li>

<li>Member-specific AI instruction injection for personalized responses</li>

</ul>

<hr />

<h3>📣 Multi-Channel Communications</h3>

<ul>

<li><strong>SMS blast</strong> to organization members via MSG91</li>

<li><strong>WhatsApp broadcast</strong> with template messaging</li>

<li><strong>Voice broadcast</strong> with IVR via Exotel/Kaleyra (queued, fully async)</li>

<li>Per-message delivery logging for SMS, WhatsApp, and voice</li>

<li>Firebase FCM push notifications with device token management</li>

<li>Communication access available to Owner, Admin, and Leader roles</li>

</ul>

<hr />

<h3>👥 Member & Team Management</h3>

<ul>

<li>6-tier role hierarchy enforced at middleware level on every request</li>

<li>30+ granular permissions managed via Spatie Laravel Permission</li>

<li>Single and bulk CSV member invitations with expiry controls and usage limits</li>

<li>Member status: active, inactive, suspended</li>

<li>Member profile view with area assignments and cluster memberships</li>

<li>Custom AI instructions per member for chatbot personalization</li>

<li>User search within organization for quick member onboarding</li>

</ul>

<hr />

<h3>💳 Payments, Subscriptions & Wallet</h3>

<ul>

<li>Razorpay integration — order creation, signature verification, and webhook processing</li>

<li>Subscription plans with feature-level entitlements</li>

<li>In-app purchase support via Google Play Billing (for Flutter mobile app)</li>

<li>Organization subscription lifecycle with active-plan tracking</li>

<li>Organization wallet with transaction history and survey-completion reward crediting</li>

<li>Payment history dashboard for owners</li>

</ul>

<hr />

<h3>📝 Complaints & Feedback</h3>

<ul>

<li>Complaint submission with category and area tagging</li>

<li>Threaded comments on complaints</li>

<li>Status tracking: open, in-progress, resolved, closed</li>

<li>Complaint access available across all roles (submit, view, manage)</li>

</ul>

<hr />

<h3>🔐 Authentication & Security</h3>

<ul>

<li>Email/password registration with email verification</li>

<li>Google OAuth 2.0 social login via Laravel Socialite</li>

<li>Mobile OTP login — SMS (MSG91) and voice OTP (Exotel)</li>

<li>Laravel Sanctum token-based API authentication</li>

<li>Spatie Laravel Permission for fine-grained role/permission management</li>

<li>Terms & conditions acceptance tracking with versioned consent records</li>

</ul>

<hr />

<h3>📱 REST API — Flutter Mobile App Ready</h3>

<ul>

<li>Versioned API under <code>/api/v1</code> — all features fully exposed</li>

<li>Auto-generated Swagger / OpenAPI documentation at <code>/api/documentation</code></li>

<li>Endpoints for auth, geo, surveys, wallet, communications, chatbot, AI, and more</li>

<li>GPS-aware survey response submission for field surveyors</li>

<li>Sanctum token auth with device-aware session management</li>

<li>Consistent JSON response format with pagination throughout</li>

</ul>

<hr />

<h3>🔧 Web Admin Panel — React + Inertia.js</h3>

<ul>

<li>Six dedicated role panels — each with tailored navigation and scoped data</li>

<li>Survey creation wizard with cascading geo-area selector (State → Village)</li>

<li>Cluster management: create clusters, add areas, assign leaders</li>

<li>Member management: grid and profile view modes, bulk actions</li>

<li>Communications hub: SMS, WhatsApp, and voice from one page per role</li>

<li>AI trends feed with trend detail and one-click survey generation</li>

<li>Analytics pages for survey responses with charts and filters</li>

<li>Dark mode support, responsive layout, built with React 19 + Tailwind CSS 4 + Vite</li>

</ul>

<hr />

<h3>🚀 Installation Wizard</h3>

<ul>

<li>Guided step-by-step installer at <code>/install</code> — no terminal required</li>

<li><code>CheckInstalled</code> middleware redirects to installer if setup is incomplete</li>

<li>Covers system requirements check, directory permissions, database configuration & connection test, admin account creation, and seeding</li>

</ul>

<hr />

<h3>🧱 Developer-Friendly Architecture</h3>

<ul>

<li>Laravel 12 with service classes, form requests, and API resources</li>

<li>Redis-backed queues for all async jobs — voice calls, AI generation, notifications</li>

<li>Polymorphic area assignments for flexible geographic access</li>

<li>Soft deletes and UUID primary keys on all critical models</li>

<li>Ziggy for type-safe named route generation inside React components</li>

<li>Clean separation: backend API, Inertia web panel, and mobile API are fully decoupled</li>

</ul>

<hr />

<h3>⚙️ Requirements</h3>

<ul>

<li>MySQL 8.0+ / PostgreSQL 14+ / SQLite 3</li>

<li>Redis (queues & caching — recommended)</li>

<li>Node.js 18+ (frontend asset compilation)</li>

<li>Composer 2.x</li>

<li>Optional: FastAPI AI microservice (configured via <code>AI_SERVICE_URL</code>)</li>

</ul>

<hr />

<h3>🔗 Third-Party Integrations (all optional, configurable)</h3>

<table>

<tr><th>Service</th><th>Purpose</th></tr>

<tr><td>Razorpay</td><td>Payments & order management</td></tr>

<tr><td>MSG91</td><td>SMS OTP & blast</td></tr>

<tr><td>Exotel / Kaleyra</td><td>Voice OTP & IVR broadcast</td></tr>

<tr><td>WhatsApp Business API</td><td>Template broadcast messaging</td></tr>

<tr><td>Firebase / FCM</td><td>Push notifications</td></tr>

<tr><td>Google OAuth 2.0</td><td>Social login</td></tr>

<tr><td>Google Cloud Translate</td><td>Survey translation</td></tr>

<tr><td>Google Maps API</td><td>Reverse geocoding</td></tr>

<tr><td>Google Play Billing</td><td>Mobile in-app purchases</td></tr>

<tr><td>FastAPI (custom)</td><td>AI survey generation & chatbot microservice</td></tr>

</table>

<hr />

<h3>📦 What's Included</h3>

<ul>

<li>Full Laravel 12 source code — backend, web admin panel, and REST API</li>

<li>Database migrations and seeders (geo hierarchy, roles, plans, demo accounts)</li>

<li>Step-by-step installation wizard</li>

<li><code>.env.example</code> with all configurable variables documented</li>

<li>Auto-generated Swagger API documentation</li>

<li>6 months of free support</li>

</ul>

Key Features

Details

Author