From 9a9d5c5880095adeb43a045dca638243c8f946e4 Mon Sep 17 00:00:00 2001 From: Benedikt Peetz Date: Sat, 6 Sep 2025 10:31:40 +0200 Subject: feat: Provide basic API frame --- crates/rocie-server/src/api/get.rs | 48 ++++++++++++++++++ crates/rocie-server/src/api/mod.rs | 2 + crates/rocie-server/src/api/set.rs | 99 ++++++++++++++++++++++++++++++++++++++ 3 files changed, 149 insertions(+) create mode 100644 crates/rocie-server/src/api/get.rs create mode 100644 crates/rocie-server/src/api/mod.rs create mode 100644 crates/rocie-server/src/api/set.rs (limited to 'crates/rocie-server/src/api') diff --git a/crates/rocie-server/src/api/get.rs b/crates/rocie-server/src/api/get.rs new file mode 100644 index 0000000..94015cf --- /dev/null +++ b/crates/rocie-server/src/api/get.rs @@ -0,0 +1,48 @@ +use actix_web::{HttpResponse, Responder, Result, get, web}; + +use crate::{ + app::App, + storage::sql::product::{Product, ProductId}, +}; + +pub(crate) fn register_paths(cfg: &mut web::ServiceConfig) { + cfg.service(product_by_id).service(products); +} + +/// Get Product by id +#[utoipa::path( + responses( + (status = OK, description = "Product found from database", body = Product), + (status = NOT_FOUND, description = "Product not found in database"), + (status = INTERNAL_SERVER_ERROR, description = "Server encountered error", body = String) + ), + params( + ("id" = ProductId, description = "Product id" ), + ) +)] +#[get("/product/{id}")] +pub(crate) async fn product_by_id( + app: web::Data, + id: web::Path, +) -> Result { + let id = id.into_inner(); + + match Product::from_id(&app, id).await? { + Some(product) => Ok(HttpResponse::Ok().json(product)), + None => Ok(HttpResponse::NotFound().finish()), + } +} + +/// Return all registered products +#[utoipa::path( + responses( + (status = OK, description = "All products founds", body = Vec), + (status = INTERNAL_SERVER_ERROR, description = "Server encountered error", body = String) + ), +)] +#[get("/products/")] +pub(crate) async fn products(app: web::Data) -> Result { + let all = Product::get_all(&app).await?; + + Ok(HttpResponse::Ok().json(all)) +} diff --git a/crates/rocie-server/src/api/mod.rs b/crates/rocie-server/src/api/mod.rs new file mode 100644 index 0000000..c573122 --- /dev/null +++ b/crates/rocie-server/src/api/mod.rs @@ -0,0 +1,2 @@ +pub(crate) mod get; +pub(crate) mod set; diff --git a/crates/rocie-server/src/api/set.rs b/crates/rocie-server/src/api/set.rs new file mode 100644 index 0000000..0a6af1b --- /dev/null +++ b/crates/rocie-server/src/api/set.rs @@ -0,0 +1,99 @@ +use actix_web::{HttpResponse, Responder, Result, post, web}; +use serde::Deserialize; +use utoipa::ToSchema; + +use crate::{ + app::App, + storage::sql::{ + insert::Operations, + product::{Barcode, Product, ProductId}, + }, +}; + +#[derive(Deserialize, ToSchema)] +struct ProductStub { + name: String, + description: Option, + parent: Option, +} + +pub(crate) fn register_paths(cfg: &mut web::ServiceConfig) { + cfg.service(register_product).service(associate_barcode); +} + +/// Register a product +#[utoipa::path( + responses( + ( + status = 200, + description = "Product successfully registered in database", + body = ProductId, + ), + ( + status = INTERNAL_SERVER_ERROR, + description = "Server encountered error", + body = String, + ) + ), + request_body = ProductStub, +)] +#[post("/product/new")] +pub(crate) async fn register_product( + app: web::Data, + product_stub: web::Json, +) -> Result { + let mut ops = Operations::new("register product"); + + let product = Product::register( + product_stub.name.clone(), + product_stub.description.clone(), + product_stub.parent, + &mut ops, + ); + + ops.apply(&app).await?; + + Ok(HttpResponse::Ok().json(product.id)) +} + +/// Associate a barcode with a product +#[utoipa::path( + responses( + ( + status = OK, + description = "Barcode successfully associated with product", + ), + ( + status = NOT_FOUND, + description = "Product id not found in database", + ), + ( + status = INTERNAL_SERVER_ERROR, + description = "Server encountered error", + body = String, + ) + ), + params ( + ("id" = ProductId, description = "The id of the product to associated the barcode with"), + ), + request_body = Barcode, +)] +#[post("/product/{id}/associate")] +pub(crate) async fn associate_barcode( + app: web::Data, + id: web::Path, + barcode: web::Json, +) -> Result { + let mut ops = Operations::new("associated barcode with product"); + + match Product::from_id(&app, id.into_inner()).await? { + Some(product) => { + product.associate_barcode(barcode.into_inner(), &mut ops); + + ops.apply(&app).await?; + + Ok(HttpResponse::Ok().finish()) + } + None => Ok(HttpResponse::NotFound().finish()), + } +} -- cgit 1.4.1