R
rust-backend
Rust coding guidelines for the Windmill backend. MUST use when writing or modifying Rust code in the backend directory.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Rust coding guidelines for the Windmill backend. MUST use when writing or modifying Rust code in the backend directory.
How to use
- Zainstaluj skill rust-backend w swoim środowisku Windmill – będzie dostępny jako referencja przy edycji kodu backendu.
- Przy pisaniu nowego kodu w katalogu backend/ importuj Error i Result z windmill_common::error zamiast panikowania – zawsze zwracaj Result<T, Error> lub JsonResult
. - Pisząc zapytania SQLx, zawsze wymieniaj kolumny jawnie (SELECT id, workspace_id, path) zamiast SELECT * – zapobiega to błędom kompatybilności gdy API wyprzedza wersję workerów.
- Dla operacji wieloetapowych używaj transakcji i parametryzowanych zapytań; unikaj N+1 poprzez batch operations z klauzulą IN.
- Przy obsłudze JSON preferuj Box<serde_json::value::RawValue> do przechowywania danych bez inspekcji; serde_json::Value używaj tylko gdy musisz modyfikować zawartość.
- W strukturach Serde dodawaj atrybuty #[serde(skip_serializing_if)] dla Option i Vec, aby zmniejszyć rozmiar serializowanych danych.