✅ Developer Brief: Feedback Collection System
🔹 1. Online Feedback System (via Email)
● Customer places order on a website (external B2C platform)
● API/Webhook receives order details:
○ Order ID
○ Customer Email & Name
○ Product/Service Name
○ Purchase Date
● System triggers personalized email using SendGrid/Mailgun
● Email includes:
○ Customer name
○ Product/Order details
○ Unique feedback link:
[Link]
🔹 2. Feedback Form Functionality (Web App)
● Form loads using order_id & customer_id
● Primary Question: “Would you recommend us?” (Yes/No)
● If YES:
○ Optional: Show rating questions (auto-fill with 5 stars if skipped)
● If NO:
○ Force show rating questions
○ Comment field is mandatory
● Rating Fields (customizable by admin):
○ Reliability
○ Delivery Speed
○ Product Availability
○ Communication Quality
○ Website Usability
● Feedback saved to DB with:
○ Order ID, Customer ID
○ Ratings, Comment
○ IP address, Timestamp
🔹 3. Admin Dashboard (Personal Cabinet)
● Login/Logout via OAuth2
● Dashboard Sections:
○ Control Panel: Overview + ratings summary
○ Manual Email: Send review invites
○ Statistics: Pie charts, trends, avg ratings
○ Archive: Deleted or expired reviews
○ Settings: Notification, filters, widget settings
Feedback Management:
● Filter by rating/date/status
● Search by email, order number
● View Review: Ratings + comment
● Admin Actions:
○ Respond
○ Appeal
○ Archive
○ Export (CSV, Excel)
🔹 4. Website Widget Integration
● Widget script:
<script src="[Link] data-company-id="xyz123"></script>
● Widget shows:
○ Company Logo
○ Overall Rating (e.g., 4.5★)
○ “Read Reviews” button
○ % of users recommending
○ Trust Badge (Bronze/Silver/Gold)
● Hover popup with reviews
● Click redirects to:
[Link]
🔹 5. QR-Based Offline Feedback System
● Generate QR for each location/branch
● QR links to:
[Link]
● PWA Mobile page:
○ 1-5 Star Rating
○ Optional comment
○ If rating <2 → comment mandatory
● Review saved with:
○ QR ID, IP, Timestamp
🔹 6. Plans & Limits (Basic / Standard / Premium)
Plan Review Limit Features
Basic 50/month Manual email, basic widget
Standard 150/month Monthly mailing, stats, more filt
Premium 400/month widget, branding, analytics
Limit review count by plan
● On limit exceed → disable submissions & notify admin
● Certificate Badges:
○ 90%+ → Bronze
○ 95%+ → Silver
○ 98%+ → Gold
🔹 7. Tech Stack to Use
Layer Tech
● Frontend ● [Link] or [Link]
● ●
● Mobile PWA ● Tailwind CSS + HTML
● ●
● Backend ● Python (Django/FastAPI) / [Link] (NestJS)
● ●
● DB ● PostgreSQL /MySQL
● ●
● API ● REST or GraphQL
● ●
● Email ● SendGrid / Mailgun
● ●
● QR Code ● [Link]
● ●
● Auth ● OAuth2
● ●
● Notify ● Telegram Bot, Email SMTP
🔒 8. Security & Compliance
● GDPR Compliance (user data encryption)
● reCAPTCHA or Bot Filtering
● Cookie + IP-based repeat submission protection
● HTTPS SSL enforced
📦 9. Deployment Notes
● Mobile Responsive Design (Web + Admin)
● Database optimized with indexing
● Scalable architecture (for SaaS growth)
● Well-documented codebase
● Admin can edit survey questions dynamically
✅ Conclusion
The goal of this project is to develop a scalable and modular SaaS-based feedback collection
system that supports both online (email-triggered) and offline (QR-based) feedback from
customers. The system should allow businesses to easily integrate a feedback widget on their
website, collect and manage customer reviews through a dedicated admin panel, and gain
insights through detailed analytics.
As a developer, your responsibility is to ensure:
● Seamless integration for external businesses via script and API/webhook.
● Secure and verified collection of feedback tied to real orders.
● Customizable review parameters and rating logic.
● A responsive and intuitive admin dashboard for managing reviews, statistics, and QR
codes.
● Tiered feature limitations and certification badges based on subscription plans.
This system will serve multiple companies, so maintain a multi-tenant structure with unique IDs
per company, enforce data isolation, and ensure a clean and well-documented codebase for
future scalability.