1 line
4.8 KiB
JSON
1 line
4.8 KiB
JSON
{"path":"NexusReader.Application/Commands/Quiz/SubmitAnswerCommandHandler.cs","purpose":"Handles quiz answer submission: verifies the selected answer against the correct index, triggers a platform vibration on correct answers, and returns a success/failure Result.","classification":{"role":"handler","layer":"application","confidence":0.9,"evidence":["Command pattern","namespace NexusReader.Application.Commands.Quiz","implements ICommandHandler<SubmitAnswerCommand>","contains Handle(request, CancellationToken) that returns Task<Result>"]},"className":"SubmitAnswerCommandHandler","methods":[{"name":"Handle","line":16,"endLine":25,"signature":"(request: SubmitAnswerCommand, cancellationToken: CancellationToken) -> Task<Result>","purpose":"Checks the submitted answer; vibrates the device and returns success if correct, otherwise returns a failure Result.","calls":[{"targetFile":"NexusReader.Application.Abstractions.Services/IPlatformService.cs","targetMethod":"VibrateAsync","callLine":20,"paramSummary":"50 (int milliseconds)"}],"actions":[{"id":"guard-clause_18","kind":"guard-clause","label":"correct-answer-check","line":18,"detail":"if selected equals correct index then vibrate and return Result.Ok(); else return Result.Fail(\"Incorrect answer.\")","conditionSummary":"request.SelectedIndex == request.CorrectIndex","outcomeLabels":["correct -> vibrate and return success","incorrect -> return failure"],"visibility":"detail-only","confidence":0.7},{"id":"handle_branch_18_0","kind":"branch","label":"Evaluates branch condition","line":18,"detail":"if (request.SelectedIndex == request.CorrectIndex)","conditionSummary":"request.SelectedIndex == request.CorrectIndex","outcomeLabels":["true","false"],"visibility":"secondary-visible","confidence":0.78},{"id":"external-call_20","kind":"external-call","label":"platform vibrate","line":20,"detail":"_platformService.VibrateAsync(50) invoked to provide haptic feedback on correct answer","visibility":"detail-only","confidence":0.7},{"id":"handle_await_20_1","kind":"await","label":"Waits for async work","line":20,"detail":"await _platformService.VibrateAsync(50);","visibility":"secondary-visible","confidence":0.81},{"id":"handle_return_21_2","kind":"return","label":"Returns result","line":21,"detail":"return Result.Ok();","visibility":"detail-only","confidence":0.7},{"id":"return_21","kind":"return","label":"success-return","line":21,"detail":"returns Result.Ok() on correct answer","visibility":"detail-only","confidence":0.7},{"id":"return_24","kind":"return","label":"failure-return","line":24,"detail":"returns Result.Fail(\"Incorrect answer.\") on incorrect answer","visibility":"detail-only","confidence":0.7},{"id":"handle_return_24_3","kind":"return","label":"Returns result","line":24,"detail":"return Result.Fail(\"Incorrect answer.\");","visibility":"detail-only","confidence":0.7}]}],"types":[],"serviceRegistrations":[],"startupActions":[],"dependencies":["NexusReader.Application.Abstractions.Services/IPlatformService.cs","NexusReader.Application.Commands.Quiz/SubmitAnswerCommand.cs"],"patterns":["Command Handler","Mediator-style handler"],"domainConcepts":["Quiz","Answer"],"keyDetails":"Uses FluentResults.Result for success/failure; relies on IPlatformService for haptic feedback; trivial constructor injects dependency (_platformService at line 9).","orchestrationMethods":[{"name":"Handle","line":16,"confidence":0.77,"reason":"Contains 2 architectural actions relevant to business execution.","actionKinds":["guard-clause","branch","external-call","await","return"],"evidencePaths":["NexusReader.Application/Commands/Quiz/SubmitAnswerCommandHandler.cs","NexusReader.Application.Abstractions.Services/IPlatformService.cs"]}],"typedContracts":[],"persistenceInteractions":[],"externalInteractions":[{"methodName":"Handle","line":20,"kind":"external-call","detail":"_platformService.VibrateAsync(50) invoked to provide haptic feedback on correct answer","evidencePaths":["NexusReader.Application/Commands/Quiz/SubmitAnswerCommandHandler.cs"]}],"evidenceAnchors":[{"kind":"orchestration-method","label":"Handle","line":16,"summary":"Contains 2 architectural actions relevant to business execution.","confidence":0.77,"evidencePaths":["NexusReader.Application/Commands/Quiz/SubmitAnswerCommandHandler.cs","NexusReader.Application.Abstractions.Services/IPlatformService.cs"]},{"kind":"external-call","label":"Handle","line":20,"summary":"_platformService.VibrateAsync(50) invoked to provide haptic feedback on correct answer","confidence":0.8,"evidencePaths":["NexusReader.Application/Commands/Quiz/SubmitAnswerCommandHandler.cs"]}],"cacheMetadata":{"schemaVersion":2,"analysisVersion":"2026-05-23.cache-v1","contentChecksum":"713d16e9d277b0ad0f650a7847a8d6eac2080e1f4e677316a565502850462841","sourceByteSize":820,"analyzedAt":"2026-05-23T16:16:59.147Z","technology":"dotnet"}} |