Constructive Feedback for Teachers

A supportive platform where students share constructive feedback to help teachers grow - with AI powered moderation to maintain respectful discourse.

Features

• AI Powered Moderation - Automatic filtering of feedback using OpenRouter's advanced language models
• Constructive First Approach - Only truly helpful feedback reaches teachers automatically
• Privacy-Protected Summaries - Teachers receive aggregated themes, never individual comments
• Multi-Layer Safety - Blocks hate speech, personal attacks, and mixed feedback with insults
• 3 Tier AI Fallback - Reliable moderation with Nemotron Super → Nemotron Nano → Free tier
• Modern Tech Stack - Built with Next.js 16, React 19, and Tailwind CSS

How It Works

Student submits feedback → AI evaluates tone & quality
        ↓
[Constructive + Specific + Actionable] → Auto approved to summary
        ↓
[Neutral / Insulting / Mixed] → Flagged for manual review
        ↓
Aggregated Summary → Teacher sees themes, not individuals

Feedback Classification

Tech Stack

Project Structure

constructive-feedback-for-teachers/
├── prisma/
│   ├── schema.prisma      # Database schema
│   └── seed.ts           # Seed data
├── public/                 # Static assets
├── src/
│   ├── app/              # Next.js App Router
│   │   ├── actions/      # Server actions
│   │   ├── api/          # API routes
│   │   ├── contact/      # Contact page
│   │   ├── login/        # Authentication
│   │   ├── register/     # User registration
│   │   └── teachers/     # Teacher dashboard
│   ├── components/
│   │   ├── home/         # Homepage components
│   │   ├── layout/       # Layout components
│   │   ├── providers/    # Context providers
│   │   ├── shared/       # Shared components
│   │   └── ui/           # UI components
│   ├── data/
│   │   └── site.ts       # Site configuration
│   ├── lib/              # Utility functions
│   └── types/            # TypeScript types
├── next.config.ts         # Next.js configuration
├── tailwind.config.ts     # Tailwind configuration
├── tsconfig.json          # TypeScript configuration
└── vitest.config.ts       # Vitest configuration

Getting Started

Prerequisites

• Node.js 20.0.0+
• PostgreSQL database
• npm or pnpm

Installation

# Clone the repository
git clone https://github.com/your-username/ConstructiveFeedbackforTeachers.git
cd ConstructiveFeedbackforTeachers

# Install dependencies
npm install

# Copy environment variables
cp .env.example .env.local

# Set up database
npx prisma db push

# (Optional) Seed with sample data
npm run db:seed

# Start development server
npm run dev

Environment Variables

Create a .env.local file with the following variables:

Available Scripts

Safety Features

The platform implements multiple layers of protection:

• Constructive Threshold - Feedback must be specific AND actionable to auto-approve
• Mixed Feedback Detection - "Good but he's lazy" is flagged as insulting (manual review)
• Individual Privacy - Teachers see only aggregated themes, never individual submissions
• Conservative Auto-Approval - Only clearly constructive feedback reaches summaries
• Graceful AI Fallback - On error, feedback defaults to manual review queue

AI Moderation

The platform uses OpenRouter with intelligent fallback:

1. NVIDIA Nemotron 3 Super 120B - Primary model for nuanced classification
2. NVIDIA Nemotron Nano 9B - Fallback for faster processing
3. openrouter/free - Ultimate fallback ensuring service continuity

License

MIT License - feel free to use this as a template.

Acknowledgments

Built with Next.js, Tailwind CSS, and Vercel.

Built with ❤️ by Joshua Argent