feat: appeal impl

anon/backend/migrations/0005__appeals.sql

@@ -0,0 +1,23 @@
+CREATE TABLE IF NOT EXISTS appeals (
+    id BIGSERIAL PRIMARY KEY,
+
+    actor TEXT NOT NULL UNIQUE,
+
+    review_id BIGSERIAL NOT NULL REFERENCES reviews(id) ON DELETE CASCADE,
+
+    reason TEXT NOT NULL,
+
+    status VARCHAR(20) NOT NULL CHECK (status IN ('open', 'accepted', 'rejected')) DEFAULT 'open',
+
+    resolution_note TEXT,
+
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX idx_appeals_review_id ON appeals (review_id);
+
+CREATE INDEX idx_appeals_actor ON appeals (actor);
+
+CREATE INDEX idx_appeals_status ON appeals (status);
+
+CREATE INDEX idx_appeals_review_status ON appeals (review_id, status);

anon/backend/src/lib.rs

@@ -15,6 +15,7 @@ pub mod middlewares {
 }
 
 pub mod routes {
+    pub mod appeals;
     pub mod generate;
     pub mod health;
     pub mod register;

anon/backend/src/libs/apispec.rs

@@ -28,7 +28,11 @@ impl Modify for SecurityAddon {
         crate::routes::health::healthz,
         crate::routes::generate::generate_contract,
         crate::routes::generate::list_generated_contracts,
-        crate::routes::reviews::list_reviews
+        crate::routes::reviews::list_reviews,
+        crate::routes::appeals::create_appeal,
+        crate::routes::appeals::get_appeal,
+        crate::routes::appeals::get_admin_appeal,
+        crate::routes::appeals::update_admin_appeal,
     ),
     components(
         schemas(
@@ -45,15 +49,22 @@ impl Modify for SecurityAddon {
             crate::routes::generate::GeneratedContractsListRes,
             // Reviews
             crate::routes::reviews::ReviewItem,
-            crate::routes::reviews::ReviewsListRes
+            crate::routes::reviews::ReviewsListRes,
+            // Apeals
+            crate::routes::appeals::CreateAppealRequest,
+            crate::routes::appeals::UpdateAppealRequest,
+            crate::routes::appeals::AdminAppealRequest,
+            crate::routes::appeals::GetAppealItems,
+            crate::routes::appeals::GetAppealRes,
         )
     ),
     modifiers(&SecurityAddon),
     tags(
         (name = "health", description = "Health check endpoints"),
         (name = "auth", description = "Authentication & registration endpoints"),
         (name = "contracts", description = "Generated contracts endpoints"),
-        (name = "reviews", description = "Reviews listing endpoints")
+        (name = "reviews", description = "Reviews listing endpoints"),
+        (name = "appeals", description = "Adding an appeal endpoint")
     )
 )]
 pub struct ApiDoc;

anon/backend/src/main.rs

@@ -7,7 +7,7 @@ use axum::{
         header::{AUTHORIZATION, CONTENT_TYPE, LOCATION},
     },
     response::IntoResponse,
-    routing::{get, post},
+    routing::{get, post, put},
 };
 use tokio::net::TcpListener;
 use tower_http::{
@@ -56,6 +56,13 @@ async fn main() {
             get(routes::generate::list_generated_contracts),
         )
         .route("/reviews", get(routes::reviews::list_reviews))
+        .route("/appeals", post(routes::appeals::create_appeal))
+        .route("/appeals/{id}", get(routes::appeals::get_appeal))
+        .route("/admin/appeals", get(routes::appeals::get_admin_appeal))
+        .route(
+            "/admin/appeals/{id}",
+            put(routes::appeals::update_admin_appeal),
+        )
         // Swagger UI at /docs and OpenAPI JSON at /api-docs/openapi.json
         .merge(SwaggerUi::new("/docs").url(
             "/api-docs/openapi.json",