Technology Stack Details

Backend

| Technology | Version | Purpose | Rationale | |-----------|---------|---------|-----------| | Rails | 8.1 | Web framework | Opinionated, productive, battle-tested | | PostgreSQL | 14+ | Database | Reliable, multitenancy-friendly | | Devise | ~4.9 | Authentication | Rich feature set, trusted | | Pundit | ~2.3 | Authorization | Flexible policy-based system | | actsastenant | ~0.5 | Multitenancy | Transparent scoping | | Sidekiq | ~7.0 | Background jobs | Reliable, easy to use | | Redis | ~5.0 | Cache + job queue | Fast, simple |

Frontend

| Technology | Version | Purpose | Rationale | |-----------|---------|---------|-----------| | Hotwire Turbo | Latest | Reactive UI | Modern without JavaScript complexity | | Stimulus | Latest | Interactivity | Lightweight, focused | | Tailwind CSS | Latest | Styling | Utility-first, responsive |

Deployment

| Technology | Purpose | |-----------|---------| | Docker | Containerization | | Docker Compose | Local development | | DigitalOcean App Platform | Managed hosting (v1) | | Cloudflare | DNS + CDN | | GitHub | Source control |

Quality & Testing

| Tool | Purpose | |------|---------| | RSpec | Unit & integration tests | | Capybara | Feature tests | | Faker | Test data generation | | Factory Bot | Test fixture factory | | Rubocop | Code linting |

[See [Architecture Overview](./index.mdx) for architectural context]