filter

Generate Filter Command

Generate a Filter DTO for an existing ABP entity to enable advanced list querying.

Arguments: $ARGUMENTS

Pre-flight

Project: !basename $(pwd) Application.Contracts: !find api/src -maxdepth 1 -type d -name "*Application.Contracts" 2>/dev/null | head -1

Required context:

• Read CLAUDE.md for project conventions
• Read existing entity DTOs to understand property types

Workflow

┌──────────────┐   ┌──────────────┐   ┌──────────────┐
│ 1. Read      │ → │ 2. Generate  │ → │ 3. Update    │
│ Entity DTOs  │   │ Filter DTO   │   │ AppService   │
└──────────────┘   └──────────────┘   └──────────────┘

Filter DTO Template

// Application.Contracts/{EntityPlural}/{Entity}Filter.cs
namespace {ProjectName}.{EntityPlural};

/// <summary>
/// Filter criteria for {Entity} list queries.
/// </summary>
public class {Entity}Filter
{
    // String properties: contains/like search
    public string? Name { get; set; }

    // Guid properties: exact match
    public Guid? CategoryId { get; set; }

    // Bool properties: exact match
    public bool? IsActive { get; set; }

    // DateTime properties: range filters
    public DateTime? CreatedAfter { get; set; }
    public DateTime? CreatedBefore { get; set; }

    // Numeric properties: range filters
    public decimal? PriceMin { get; set; }
    public decimal? PriceMax { get; set; }

    // Enum properties: exact match
    public OrderStatus? Status { get; set; }
}

Property Type Mapping

Entity Property Type	Filter Properties	WhereIf Pattern
string	string? {Prop}	.WhereIf(!filter.{Prop}.IsNullOrWhiteSpace(), x => x.{Prop}.ToLower().Contains(filter.{Prop}.ToLower()))
Guid	Guid? {Prop}	.WhereIf(filter.{Prop}.HasValue, x => x.{Prop} == filter.{Prop})
Guid?	Guid? {Prop}	.WhereIf(filter.{Prop}.HasValue, x => x.{Prop} == filter.{Prop})
bool	bool? {Prop}	.WhereIf(filter.{Prop}.HasValue, x => x.{Prop} == filter.{Prop})
DateTime	DateTime? {Prop}From, DateTime? {Prop}To	.WhereIf(filter.{Prop}From.HasValue, x => x.{Prop} >= filter.{Prop}From)
int, decimal	{Type}? {Prop}Min, {Type}? {Prop}Max	.WhereIf(filter.{Prop}Min.HasValue, x => x.{Prop} >= filter.{Prop}Min)
enum	{EnumType}? {Prop}	.WhereIf(filter.{Prop}.HasValue, x => x.{Prop} == filter.{Prop})