Clean Architecture Demo
Loading...
Searching...
No Matches
TaskItem.cs
Go to the documentation of this file.
3
5
50public class TaskItem
51{
52 public Guid Id {
53 get; private set;
54 }
55
56 public string Title { get; private set; } = string.Empty;
57
58 public string Description { get; private set; } = string.Empty;
59
61 get; private set;
62 }
63
65 get; private set;
66 }
67
68 public DateTime? DueDate {
69 get; private set;
70 }
71
72 public DateTime CreatedAt {
73 get; private set;
74 }
75
76 public DateTime? CompletedAt {
77 get; private set;
78 }
79
80 public Guid CreatedBy {
81 get; private set;
82 }
83
84 public Guid? AssignedTo {
85 get; private set;
86 }
87
88 // Eventos del dominio para desacoplamiento de la infraestructura y facilidad del testing.
89 private readonly List<DomainEvent> _domainEvents = [];
90
91 public IReadOnlyCollection<DomainEvent> DomainEvents => _domainEvents.AsReadOnly();
92
93 private TaskItem()
94 {
95 }
96
97 public static Result<TaskItem> Create(
98 string title,
99 string description,
100 TaskPriority priority,
101 DateTime? dueDate,
102 Guid createdBy)
103 {
104 ArgumentNullException.ThrowIfNull(description);
105
106 var validation = Validate(title, description, dueDate, createdBy);
107 if (validation.IsFailure)
108 return Result.Failure<TaskItem>(validation.Errors);
109 var task = new TaskItem {
110 Id = Guid.NewGuid(),
111 Title = title.Trim(),
112 Description = description.Trim(),
113 Status = TaskStatus.Todo,
114 Priority = priority,
115 DueDate = dueDate,
116 CreatedAt = DateTime.UtcNow,
117 CreatedBy = createdBy
118 };
119 task.AddDomainEvent(new TaskCreatedEvent(task.Id, task.Title, createdBy));
120 return Result.Success(task);
121 }
122
127 public static TaskItem Restore(
128 Guid id,
129 string title,
130 string description,
131 TaskStatus status,
132 TaskPriority priority,
133 DateTime? dueDate,
134 DateTime createdAt,
135 DateTime? completedAt,
136 Guid createdBy,
137 Guid? assignedTo)
138 {
139 return new TaskItem {
140 Id = id,
141 Title = title,
142 Description = description,
143 Status = status,
144 Priority = priority,
145 DueDate = dueDate,
146 CreatedAt = createdAt,
147 CompletedAt = completedAt,
148 CreatedBy = createdBy,
149 AssignedTo = assignedTo
150 };
151 }
152
153 public Result AssignTo(Guid userId)
154 {
155 if (Status == TaskStatus.Completed)
157 var previousAssignee = AssignedTo;
158 AssignedTo = userId;
159 AddDomainEvent(new TaskAssignedEvent(Id, userId, previousAssignee));
160 return Result.Success();
161 }
162
164 {
165 if (Status == TaskStatus.Completed)
167 Status = TaskStatus.Completed;
168 CompletedAt = DateTime.UtcNow;
169 AddDomainEvent(new TaskCompletedEvent(Id, CompletedAt.Value));
170 return Result.Success();
171 }
172
174 {
175 if (Status == TaskStatus.Completed)
177 var oldPriority = Priority;
178 Priority = newPriority;
179 AddDomainEvent(new TaskPriorityChangedEvent(Id, oldPriority, newPriority));
180 return Result.Success();
181 }
182
183 public void ClearDomainEvents() => _domainEvents.Clear();
184
185 private void AddDomainEvent(DomainEvent eventItem) => _domainEvents.Add(eventItem);
186
187 private static Result Validate(string title, string description, DateTime? dueDate, Guid createdBy)
188 {
189 var errors = new List<string>();
190 if (string.IsNullOrWhiteSpace(title))
191 errors.Add("Title is required.");
192 else if (title.Length > 200)
193 errors.Add("Title cannot exceed 200 characters.");
194 if (description.Length > 2000)
195 errors.Add("Description cannot exceed 2000 characters.");
196 if (dueDate.HasValue && dueDate.Value < DateTime.UtcNow.Date)
197 errors.Add("Due date cannot be in the past.");
198 if (createdBy == Guid.Empty)
199 errors.Add("CreatedBy is required.");
200 return errors.Count > 0
201 ? Result.Failure(errors)
202 : Result.Success();
203 }
204}
Result es un tipo de unión discriminada que implementa el patrón Result para manejo de errores.
Definition Result.cs:40
static Result Failure(string error)
Definition Result.cs:54
TaskErrors es un repositorio central para todos los mensajes de error del dominio de tareas.
Definition TaskErrors.cs:37
IReadOnlyCollection< DomainEvent > DomainEvents
Definition TaskItem.cs:91
static Result< TaskItem > Create(string title, string description, TaskPriority priority, DateTime? dueDate, Guid createdBy)
Definition TaskItem.cs:97
Result UpdatePriority(TaskPriority newPriority)
Definition TaskItem.cs:173
static TaskItem Restore(Guid id, string title, string description, TaskStatus status, TaskPriority priority, DateTime? dueDate, DateTime createdAt, DateTime? completedAt, Guid createdBy, Guid? assignedTo)
Reconstruye una tarea existente a partir de su estado guardado, sin aplicar validaciones ni emitir ev...
Definition TaskItem.cs:127
DomainEvent es una clase base abstracta para todos los eventos del dominio en el sistema.
TaskAssignedEvent(Guid taskId, Guid assignedTo, Guid? previousAssignee)
TaskCompletedEvent(Guid taskId, DateTime completedAt)
TaskCreatedEvent(Guid taskId, string title, Guid createdBy)
TaskPriorityChangedEvent(Guid taskId, TaskPriority oldPriority, TaskPriority newPriority)
TaskPriority
TaskPriority es un objeto valor del dominio que representa niveles de prioridad de tarea.
TaskStatus
TaskStatus es un objeto valor del dominio que representa posibles estados de una tarea.
Definition TaskStatus.cs:25