Feedback to Me - 360° Feedback Platform

A modern web application for collecting and analyzing 360° feedback, built with Python and FastHTML.

Features

• 🧑💻 User authentication with email confirmation
• 🔄 360° feedback collection process management
• 📊 AI-powered feedback analysis & report generation
• 💳 Integrated Stripe payments for credit purchases
• 📧 SMTP email integration for notifications
• 📱 Responsive web interface

Table of Contents

• Architecture
• Quick Start
• Configuration
• Deployment
• Development
• Testing
• API Documentation

Architecture

graph TD
    A[Client] --> B[Nginx]
    B --> C[FastHTML App]
    C --> D[(SQLite Database)]
    D --> H[Litestream]
    H --> I[(GCS Backup)]
    C --> E[Stripe API]
    C --> F[SMTP2GO]
    C --> G[Google Gemini AI]

Loading

Key Components:

• Web Server: FastHTML with Python backend
• Database: SQLite with Litestream replication to Google Cloud Storage
• AI Processing: Google Gemini via LangChain integration
• Payments: Stripe Checkout integration
• Email: SMTP2GO service

Quick Start

Prerequisites

• Python 3.10+
• SQLite3
• Node.js (for optional frontend builds)
• Litestream (for database replication)

# Clone repository
git clone https://github.com/yourusername/feedback-to-me.git
cd feedback-to-me

# Create virtual environment
python -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Install Litestream
wget https://github.com/benbjohnson/litestream/releases/download/v0.3.13/litestream-v0.3.13-linux-amd64.deb
sudo dpkg -i litestream-v0.3.13-linux-amd64.deb

# Set up environment variables
cp .env.example .env

Configuration

Edit .env file:

# Core Configuration
DEV_MODE=true
LOG_LEVEL=DEBUG
BASE_URL=http://localhost:8080

# External Services
STRIPE_SECRET_KEY=sk_test_...
SMTP2GO_API_KEY=your_smtp2go_key
GEMINI_API_KEY=your_google_ai_key

# Google Cloud Storage (for Litestream)
LITESTREAM_GCS_BUCKET=your-bucket-name
LITESTREAM_GCS_PROJECT_ID=your-project-id
GCP_CREDENTIALS_B64=base64-encoded-service-account-json

# Security
SECRET_KEY=your_random_secret_here

Required API Keys:

1. Stripe
2. SMTP2GO
3. Google AI Studio
4. Google Cloud Storage
   • Create a service account with Storage Object Admin permissions
   • Download the JSON key file
   • Base64 encode the key: base64 -w0 your-key.json

Deployment

Production deployment (currently running at https://feedback-to.me):

# Using Docker
docker build -t feedback-app .
docker run -d -p 8080:8080 \
  -e STRIPE_SECRET_KEY=$STRIPE_PROD_KEY \
  -e SMTP2GO_API_KEY=$SMTP_PROD_KEY \
  -e LITESTREAM_GCS_BUCKET=$GCS_BUCKET \
  -e LITESTREAM_GCS_PROJECT_ID=$GCS_PROJECT \
  -e GCP_CREDENTIALS_B64=$GCS_CREDS \
  feedback-app

Production environment features:

• HTTPS via Let's Encrypt
• SQLite database with Litestream replication to Google Cloud Storage
• Gunicorn + Nginx reverse proxy
• Automated backups via Litestream
• Monitoring via Prometheus/Grafana

Development

# Start development server with Litestream replication
litestream replicate -config litestream.yml -exec "make dev"

# Run tests
make test

# Generate database schema diagram
python -m eralchemy2 -i sqlite:///data/feedback.db -o docs/erd.png

# Restore database from backup if needed
litestream restore -config litestream.yml data/feedback.db

File Structure:

├── data/               # Database files
├── static/             # Static assets
├── tests/              # Test suite
├── main.py             # Main application
├── models.py           # Database models
├── pages.py            # UI templates
├── llm_functions.py    # AI processing
├── litestream.yml      # Litestream configuration
└── config.py           # Configuration defaults

Testing

Test payment flow using Stripe test cards:

• Card: 4242 4242 4242 4242
• Exp: Any future date
• CVC: Any 3 digits

# Run full test suite
pytest tests/ --cov=app --cov-report=html

---

Live Alpha Version: https://feedback-to.me
Support: [email protected]
License: MIT