cargo-gears-lints 0.0.4

Dylint lint collection for cargo-gears architectural rules
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

# DE0101: No Serde in Contract

### What it does

Checks that structs and enums in contract modules do not derive `Serialize` or `Deserialize` from serde.

### Why is this bad?

Contract models should remain independent of serialization concerns. They represent pure domain logic and should not be coupled to any specific serialization format or library. Use DTOs (Data Transfer Objects) in the API layer for serialization instead.

This separation provides:
- **Clear separation of concerns**: Domain logic vs. API representation
- **Flexibility**: Different API endpoints can use different serialization strategies
- **Protection**: Contract models stay stable when API format changes

### Example

```rust
// ❌ Bad - contract model derives serde traits
mod contract {
    use serde::Serialize;
    
    #[derive(Serialize)]
    pub struct User { 
        pub id: String 
    }
}
```

Use instead:

```rust
// ✅ Good - contract model without serde
mod contract {
    pub struct User { 
        pub id: String 
    }
}

// Separate DTO in API layer
mod api {
    use serde::Serialize;
    
    #[derive(Serialize)]
    pub struct UserDto { 
        pub id: String 
    }
}
```

### Configuration

This lint is configured to **deny** by default.

### See Also

- [DE0102](../de0102_no_toschema_in_domain) - No ToSchema in Domain
- [DE0308](../../de03_domain_layer/de0308_no_http_in_domain) - No HTTP in Domain