Initial project setup with Rapina 0.5

Author: arferreira

.env.example

@@ -0,0 +1,3 @@
+DATABASE_URL=postgres://reeverb:secret@localhost:5432/reeverb
+JWT_SECRET=change-me-in-production
+RUST_LOG=info

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,22 @@
+---
+name: Bug Report
+about: Report a bug to help improve Reeverb
+title: ""
+labels: bug
+assignees: ""
+---
+
+**Describe the bug**
+A clear description of what the bug is.
+
+**To reproduce**
+Steps to reproduce the behavior.
+
+**Expected behavior**
+What you expected to happen.
+
+**Environment**
+- Reeverb version:
+- Rust version:
+- OS:
+- Database:

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,16 @@
+---
+name: Feature Request
+about: Suggest a feature for Reeverb
+title: ""
+labels: enhancement
+assignees: ""
+---
+
+**Problem**
+What problem does this solve?
+
+**Proposed solution**
+How should it work?
+
+**Alternatives considered**
+Any other approaches you've thought about.

.github/workflows/ci.yml

@@ -0,0 +1,68 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+  RUST_BACKTRACE: 1
+
+jobs:
+  check:
+    name: Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo check
+
+  fmt:
+    name: Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+      - run: cargo fmt --all -- --check
+
+  clippy:
+    name: Clippy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo clippy -- -D warnings
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres:16-alpine
+        env:
+          POSTGRES_USER: reeverb
+          POSTGRES_PASSWORD: secret
+          POSTGRES_DB: reeverb_test
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+    env:
+      DATABASE_URL: postgres://reeverb:secret@localhost:5432/reeverb_test
+      JWT_SECRET: test-secret
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo test

.gitignore

@@ -0,0 +1,4 @@
+/target
+.env
+*.db
+*.db-journal

CONTRIBUTING.md

@@ -0,0 +1,38 @@
+# Contributing to Reeverb
+
+Thanks for your interest in contributing. Here's how to get started.
+
+## Setup
+
+1. Fork the repo and clone your fork
+2. Install Rust 1.85+ via [rustup](https://rustup.rs)
+3. Install PostgreSQL 16+ (or use Docker: `docker compose up db -d`)
+4. Copy `.env.example` to `.env` and configure your database
+5. Run `cargo run` to start the server
+6. Run `cargo test` to run the test suite
+
+## Pull Requests
+
+- Keep PRs focused on a single change
+- Write tests for new functionality
+- Run `cargo clippy` and `cargo fmt` before submitting
+- Write clear commit messages (single line, imperative mood)
+
+## Code Style
+
+- Follow existing patterns in the codebase
+- Feature-first module structure (group by domain, not by layer)
+- Use Rapina conventions: `#[get]`, `#[post]`, `Validated<T>`, typed errors
+- Handlers: `list_users`, `create_user`, `get_user`
+- DTOs: `CreateUserRequest`, `UserResponse`
+- Routes: plural, versioned (`/v1/users/:id`)
+
+## Issues
+
+- Use GitHub Issues for bugs and feature requests
+- Include reproduction steps for bugs
+- Check existing issues before opening a new one
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.