Minisource Feedback

Multi-tenant feedback and feature request management platform. Enables users to submit feedback, vote on features, and track product improvements.

Repository Structure

This is a monorepo containing three projects:

feedback/
├── backend/ # Go API server (Fiber + MongoDB)
├── admin/ # Admin dashboard (Planned)
└── user/ # User-facing feedback portal (Next.js)

Projects

Backend (API Server)

The backend service provides REST APIs for feedback management.

• Tech Stack: Go 1.24, Fiber v2, MongoDB
• Port: 5012
• Features: Multi-tenant, OAuth2, voting, subscriptions, moderation

cd backend
cp .env.example .env
make run

See backend/README.md for detailed documentation.

User Portal (Frontend)

User-facing web application for submitting and viewing feedback.

• Tech Stack: Next.js 15, React, TypeScript, Tailwind CSS
• Port: 3002

cd user
cp .env.example .env
npm install
npm run dev

Admin Dashboard (Planned)

Administration dashboard for managing feedback and moderation.

• Status: 🚧 Not yet implemented
• Planned Tech: Next.js, React Admin

Quick Start

With Docker Compose

Images are published to Docker Hub on every successful build to main.

Image	Tags
minisource/feedback-backend	latest, commit SHA
minisource/feedback-user	latest, commit SHA

# Production (pre-built images)export TAG=latest
docker compose -f backend/docker-compose.prod.yml up -d
cd user && docker compose up -d
# Local development (build from source)
docker compose -f backend/docker-compose.yml up -d

GitHub Actions secrets

• DOCKERHUB_USERNAME — Docker Hub username
• DOCKERHUB_TOKEN — Docker Hub access token

Development Setup

# 1. Start backendcd backend
cp .env.example .env
make docker-up
# 2. Start user portalcd ../user
cp .env.example .env
npm install
npm run dev

Architecture

┌─────────────────────────────────────────────────────────┐
│ User Portal (:3002) │
│ (Next.js) │
└─────────────────────────┬───────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ Feedback Backend (:5012) │
│ (Go + Fiber) │
├─────────────────────────────────────────────────────────┤
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │Feedback │ │ Voting │ │Category │ │Moderate │ │
│ │ CRUD │ │ System │ │ Mgmt │ │ Queue │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
└─────────────────────────┬───────────────────────────────┘
│
┌─────────────────┼─────────────────┐
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ MongoDB │ │ Auth │ │ Notifier │
│ │ │ Service │ │ Service │
└───────────┘ └───────────┘ └───────────┘

Features

User Features

• Submit feedback with categories
• Vote on feedback (upvote/downvote)
• Subscribe to feedback updates
• View public roadmap
• Comment on feedback

Admin Features

• Moderate feedback submissions
• Manage categories
• Official responses
• Analytics dashboard
• Export functionality

API Overview

Endpoint	Method	Description
/api/v1/feedback	GET	List feedback
/api/v1/feedback	POST	Create feedback
/api/v1/feedback/:id	GET	Get feedback
/api/v1/feedback/:id/vote	POST	Vote on feedback
/api/v1/feedback/:id/subscribe	POST	Subscribe
/api/v1/categories	GET	List categories
/api/v1/admin/moderate	POST	Moderate feedback

Configuration

Backend Environment Variables

Variable	Description
MONGODB_URI	MongoDB connection string
AUTH_URL	Auth service URL
NOTIFIER_URL	Notifier service URL
SERVER_PORT	API server port (5012)

User Portal Environment Variables

Variable	Description
NEXT_PUBLIC_API_URL	Backend API URL
NEXT_PUBLIC_AUTH_URL	Auth service URL

Development

Prerequisites

• Go 1.24+ (for backend)
• Node.js 20+ (for frontends)
• MongoDB 7+
• Docker & Docker Compose

Running Tests

# Backend testscd backend
make test# User portal testscd user
npm test

License

MIT