PulseGov is an AI-powered civic tech platform designed to streamline public feedback, intelligently prioritize municipal issues, and engage only the relevant communities through hyperlocal decision-making and dynamic mapping. Built for transparency, efficiency, and smarter governance.

• 🚀 Features
• 🧠 Architecture
  • How this works
• 🗃️ Data Models
• 🔄 Civic Referendum System
• 🧠 AI Capabilities
• 🗺️ Feedback Map & Population Scaling
• 🧩 Departmental Dataset
• ⏱️ Rate Limiting & Abuse Prevention
• 🛠️ Installation
• ⚙️ Tech Stack
• 📸 Screenshots

• AI-Powered Feedback Prioritization based on season, location, and urgency
• User-Specific Referendum Links for hyperlocal decisions
• Smart Text Analysis that mimics Reddit’s hot ranking
• Geospatial Feedback Map with pin-based issue clustering
• Spam & Toxicity Detection
• Sentiment Analysis & Department Assignment
• Duplicate Detection (StackOverflow-style suggestion system)
• Threaded Comments & Status Tracking
• Population Density Awareness for scalable impact
• Structured Departmental Routing System
• AI BOT Assistance for real-time feedback and engagement
• Nice looking UI

🔄 PulseGov Feedback Lifecycle – How It Works This process illustrates how a piece of feedback from a citizen travels through the PulseGov system, from submission to resolution and continuous improvement:

• A user submits a complaint, suggestion, or question.

• Optional fields: title, photo, and location (can be auto-detected or manually selected).

• 📍 Location Identification: Detects the citizen’s location.

• 🧠 AI Analysis:

  • Performs sentiment detection (positive, neutral, negative).
  • Spam and toxicity filtering to prevent abuse.
  • Assigns priority level and routes the issue to the appropriate municipal department.
  • 🔁 Feedback Grouping: Detects and suggests similar feedback to avoid duplication.

• Citizens can upvote/downvote the feedback.

• Allows comments and reports for moderation.

• A rate limit ensures each user can only submit up to 3 feedbacks per hour.

• Government dashboards receive structured feedback with maps and analytics.

• Officials assign status: Open, Working, Resolved, or Closed.

• May publicly respond or take direct action.

• The system triggers reminders/updates to citizens.

• A changelog may be added for transparency.

• Citizens are notified of changes or updates to their feedback.

• The system remains active for follow-up feedback or new submissions, keeping the loop alive and dynamic.

[ Citizen ]
     │
     ▼
📝 Submits Feedback (complaint/suggestion/question)
     │
     ▼
[ PulseGov Platform ]
     ├─ 📍 Identifies location (auto/manual)
     ├─ 🧠 AI tags & analyzes feedback
     │     ├─ Sentiment detection
     │     ├─ Spam/toxic filtering
     │     └─ Priority & department assignment
     └─ Groups with similar issues (avoid duplicates)
     │
     ▼
[ Community Engagement ]
     ├─ Citizens vote up/down
     ├─ Comment and report
     └─ Rate-limited to avoid abuse
     │
     ▼
[ Government ]
     ├─ Receives structured insights + maps
     ├─ Assigns status (Open, Working, Resolved)
     ├─ Replies publicly or takes action
     └─ System sends citizen reminders & updates
  └─ Add a Changelog
     │
     ▼
📬 [ Citizen Receives Update ]
     │
     ▼
🔁 Loop Continues with New or Follow-up Feedback

PulseGov enables hyperlocal referendums by generating:

• User-specific, time-limited links
• Delivered only to citizens in affected areas
• Valid for short durations to ensure relevance
• Ensures decisions are voted only by those impacted

• Keyword Learning: Identifies which complaints are resolved quickly or satisfy citizens.
• Dynamic Priority Score: Ranks feedback like Reddit’s “Hot” section.
• Feedback Grouping: Suggests similar complaints to avoid duplicates.
• Language & Toxicity Filters: Auto-flags harmful feedback.
• Geographic + Seasonal Prioritization: Example – higher priority for fire-related issues during summer.

• Each complaint is pinned on a dynamic map
• Uses population density radius to scale priority
• Helps focus on areas with greater public impact

• Max 3 Feedbacks/User/Hour
• Spam filtering with user reputation check
• Only one valid report is required to flag feedback
• Community moderation for transparency

1. Clone the repo:

git clone https://github.com/alpetgexha/pulsegov.git
cd pulsegov

composer install
npm install && npm run dev

cp .env.example .env

php artisan migrate --seed
php artisan key:generate

composer run dev

Start the queue worker in another terminal (ssl is required for OpenAI):

php artisan queue:work --queue=analytics 

• Laravel 12 (Backend)
• React (Frontend)
• Tailwind CSS (Styling)
• OpenAI (AI for language/sentiment/keywords)

PulseGov – Capturing the “pulse” of the people for government services.

PulseGov – Modern and intuitive; reflects real-time citizen sentiment.