Modernize Rails stack and refactor authentication system

[dvd90]

This is a major refactor that modernizes the ReadCoin application from Rails 5.2 with Devise to Rails 8.1 with a custom authentication system, while also updating the frontend stack and database.

Summary

The application has been upgraded from an older Rails version to Rails 8.1, replacing Devise-based authentication with a custom session-based system. The frontend has been migrated from Webpacker/Bootstrap to Tailwind CSS with Importmap. The database has been switched from PostgreSQL to SQLite, and the codebase has been significantly reorganized with new modular controller structures.

Key Changes

Authentication & User Management:

• Removed Devise gem and all related configuration/views
• Implemented custom SessionsController, RegistrationsController, and PasswordsController for authentication
• Added Authentication concern for authorization logic
• Created Current class for managing current user/session context
• Added PasswordsMailer for password reset functionality
• Simplified User model to remove Devise dependencies

Architecture & Controllers:

• Reorganized controllers into namespaced modules: Family:: (parent dashboard) and Play:: (kid reading interface)
• Created base controllers (Family::BaseController, Play::BaseController) for shared logic
• New controllers: Family::BooksController, Family::KidsController, Family::RewardsController, Family::QuizzesController, Family::RedemptionsController, Play::BooksController, Play::SessionsController, Play::ShopController, Play::DashboardsController
• Removed old controllers: KidsController, BooksController, PaymentsController, PrizesController, ReadingsController, Admin::BooksController, Admin::PrizesController

Models:

• Updated Kid model with avatar support and new associations
• Created Quiz model for storing comprehension questions
• Created Reward model (replacing Prize)
• Created Redemption model for tracking reward redemptions
• Created Session model for session management
• Updated Reading model with PASS_SCORE constant and quiz associations
• Removed Order, Purchase, and Prize models

Frontend & Styling:

• Migrated from Webpacker to Importmap for JavaScript bundling
• Replaced Bootstrap/SCSS with Tailwind CSS
• Removed all old SCSS files and component styles
• Added Tailwind CSS configuration and build process
• Created new layout files: layouts/family.html.erb, layouts/play.html.erb
• Removed old Devise views and form-based views
• Added new views for family dashboard, kid management, book management, quizzes, and shop

Database:

• Switched from PostgreSQL to SQLite
• Updated database.yml configuration
• Created new migrations for Rails 8.1 schema
• Added support for Solid Queue, Solid Cache, and Solid Cable
• Removed old Devise migration

Configuration:

• Updated Ruby version from 2.4.4 to 3.3.6
• Updated Gemfile with modern dependencies (removed Devise, Webpacker, Carrierwave, etc.)
• Added new gems: Tailwind CSS, Importmap, Solid Queue, Solid Cache, Solid Cable
• Updated Rails environment configurations
• Added CI/CD workflow (GitHub Actions)
• Added new initializers and removed old ones (Devise, SimpleForm, Webpacker, etc.)

Services & Jobs:

• Added QuizGenerator service for AI-powered quiz generation via Claude API
• Updated ApplicationJob with retry configuration

Other:

• Updated error pages (400, 406 HTML pages)
• Added PWA support (manifest.json, service-worker.js)
• Updated README with new project description
• Added security scanning tools (Brakeman, Bundler Audit)
• Added development tooling (bin/dev, bin/ci, bin/jobs, etc.)
• Updated seed data for demo family and public-domain books

Notable Implementation Details

• The custom authentication system uses session-based approach with password reset via email
• Family and Play modules provide separate interfaces for parents and children
• Quiz generation integrates with Claude

https://claude.ai/code/session_01EuR6A3W2am5iiojTfUJNYr