rust

Rust (Backend) PUDO Checklist

1. PLAN (Architecture & Strategy)

• Framework Selection: Choose web framework (Axum, Actix-web) based on performance vs. ecosystem needs.
• Crate Ecosystem: Plan dependencies (e.g., tokio for async runtime, serde for serialization, sqlx or sea-query for DB).
• Error Handling: Define a centralized application error type using crates like thiserror or anyhow.
• State Management: Plan how application state (DB pools, config) will be shared across thread workers.

2. UNDERSTAND (Context & Auditing)

• Borrow Checker & Lifetimes: Audit data structures to minimize clones; rely on references where safe across async boundaries.
• Async Context: Ensure types crossing .await points implement Send and Sync.
• Safety: Review unsafe blocks if any exist. Justify their existence.

3. DEVELOP (Implementation)

• Structs & Traits: Define core domain models. Use #[derive(Serialize, Deserialize)] for data transfer objects.
• Routes: Implement handlers with strongly typed extractors (Json, Path, Query).
• Database: Use compile-time checked SQL queries (e.g., sqlx::query!) for type safety.
• Testing: Write inline unit tests (#[test]) and asynchronous integration tests (#[tokio::test]).

4. OPTIMIZE (Performance & Review)

• Binary Size & Speed: Review Cargo.toml profiles (e.g., strictly opt-level = 3, LTO enabled for release).
• Memory Allocation: Profile long-lived objects. Consider Arc for shared read-only state instead of cloning.
• Compilation Time: Use cargo clippy and cargo fmt to enforce idiomatic code and avoid macro bloat where unnecessary.
• Logging: Configure structured async logging using tracing and tracing-subscriber.