https://github.com/mr-ndi/somagov
SomaGov is a citizen engagement platform that enables the public to submit feedback or complaints to government agencies. It categorizes, routes, and tracks tickets while allowing administrators to respond effectively — tailored specifically for use in Rwanda.
https://github.com/mr-ndi/somagov
gin go gorm gorm-migration hackthonproject mvc-architecture onrender openai-api postgresql restful-api swagger-ui
Last synced: 8 months ago
JSON representation
SomaGov is a citizen engagement platform that enables the public to submit feedback or complaints to government agencies. It categorizes, routes, and tracks tickets while allowing administrators to respond effectively — tailored specifically for use in Rwanda.
- Host: GitHub
- URL: https://github.com/mr-ndi/somagov
- Owner: Mr-Ndi
- Created: 2025-04-20T21:04:35.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-06-05T19:30:13.000Z (10 months ago)
- Last Synced: 2025-06-15T05:02:10.280Z (9 months ago)
- Topics: gin, go, gorm, gorm-migration, hackthonproject, mvc-architecture, onrender, openai-api, postgresql, restful-api, swagger-ui
- Language: Go
- Homepage: https://soma-gov.vercel.app
- Size: 111 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🏛️ SomaGov – Citizen Engagement System
**SomaGov** is a digital platform designed to modernize how **Rwandan citizens** engage with public services. Currently, complaints are often handled through fragmented channels — leading to slow responses and low citizen satisfaction.
This platform aims to centralize and streamline communication between the public and government agencies.
---
## 🎯 MVP Goal
Build a **Minimum Viable Product** (MVP) that allows citizens to:
- 📝 Submit complaints or feedback on public services
- 🧭 Have them categorized and routed to the correct agency
- 📊 Track status updates (pending, reviewed, resolved)
- 🏢 Enable government admins and agencies to respond to feedback
### ✅ Key Features Demonstrated
- Citizen & admin login
- Complaint submission with file attachments
- Real-time routing to agencies
- Complaint review and response by government staff
- Clean, mobile-friendly interface
Optional ideas include dashboards, analytics, and AI features (some in progress).
---
## 🚀 Try the Live Demo (MVP)
🌐 **[soma-gov.vercel.app](https://soma-gov.vercel.app)**
### 🔐 Admin Login
- **Email**: `admin@somagov.gov.rw`
- **Password**: `admin123`
### 🧪 Demo Flow
1. Login as **Admin**
2. Add a new **Agency**
3. Log out
4. Register as a **Citizen**
5. Submit a **complaint** to a specific **agency** with a chosen **category**
6. Admin/Agency logs in and **responds** to the complaint
---
## 📁 Project Structure
```
SomaGov/
├── SomaBackend/ # Backend: Go + Gin + PostgreSQL
└── somagov-frontend/ # Frontend: Next.js + Tailwind CSS
```
> 📂 For developer setup or API deep technical info, check:
> - [`SomaBackend/README.md`](./SomaBackend/README.md)
> - [`somagov-frontend/README.md`](./somagov-frontend/README.md)
---
## 🚧 In Progress
- 🌍 **AI Translation**: Support both English and Kinyarwanda speakers
- 🧠 **Fake Account Detection**
- 🧾 **AI Assistant** to help users reclaim public services
- 💬 **AI Chatbot** for live support
- 📱 **Mobile App** via Flutter
---
## 🤝 Contributions
This is a community-driven project. Suggestions, feedback, and contributions are always welcome.
---
## 👤 Author
**Mr-Ndi**
🔗 [LinkedIn](https://www.linkedin.com/in/mr-ndi/)
💻 [GitHub](https://github.com/Mr-Ndi/)