Desenvolva a disponibilidade de livros em C#

Adicionar uma funcionalidade envolve entrada, recuperação de dados, interpretação do domínio e saída. Uma função auxiliar que nunca é conectada ao menu não é uma funcionalidade concluída.

Resumo do laboratório

[!NOTE] Um empréstimo vencido e não devolvido ainda torna aquela cópia indisponível.

Conceitos · Primeira tarefa · Lista de evidências · Redefinir

Objetivos de aprendizagem

• Transforme uma solicitação de usuário em casos explícitos de aceitação.
• Modele a disponibilidade por exemplar físico, não por título.
• Conecte a funcionalidade pelo fluxo de console existente.
• Preserve o comportamento de devolução e associação sem relação com a tarefa.

Antes de começar

Prepare 03-csharp usando a configuração comum. Use a fixture de funcionalidade da biblioteca incluída. O laboratório de configuração de C# descreve SDK, caches e diretórios de execução.

Conceitos e casos de uso

Book descreve um título; BookItem identifica um exemplar físico; Loan registra o histórico de empréstimos de um exemplar. Um empréstimo devolvido não torna um exemplar indisponível. Um empréstimo vencido, mas não devolvido, permanece ativo.

Cenário do exercício

Uma pessoa bibliotecária precisa de busca por título sem diferenciar maiúsculas e minúsculas e de uma visualização da disponibilidade de cada exemplar físico. Empréstimos, reservas, migração de banco de dados e autenticação não fazem parte desta funcionalidade.

Tarefa 1 - Investigue e execute a linha de base

1. Inspecione CommonActions.cs, ConsoleApp.cs, as entidades do núcleo e JsonData.

2. Execute a partir da raiz do projeto copiado:

   dotnet test tests/UnitTests/UnitTests.csproj -m:1 -p:UseSharedCompilation=false
   

3. Em Ask, rastreie o caminho existente de busca de usuários no menu. Identifique os pontos equivalentes de inserção para busca de livros sem duplicar o ciclo de entrada.

4. Registre a semântica de empréstimo ativo a partir de ReturnDate, não de uma suposição baseada no vencimento.

Tarefa 2 - Defina a aceitação antes do código

Use registros sintéticos recém-criados nos testes em vez de depender de datas desatualizadas em arquivos JSON. Especifique uma ordenação determinística de títulos/exemplares.

Tarefa 3 - Planeje o caminho completo

Plan title search and per-copy availability in the existing C# library.
Map BOOK-1..6 to tests and source files. Reuse existing input handling and JSON
loading. Add a distinct CommonActions flag without renumbering existing flags.
Keep return, extension and membership behavior unchanged. Do not edit yet.

Revise os limites de repositório/serviço. Se usar JsonData diretamente no console para seguir o projeto inicial, explique o acoplamento; não o chame de projeto ideal para produção.

Tarefa 4 - Implemente começando por um teste de regressão que falha

1. Adicione um teste para o caso de dois exemplares e confirme que ele falha pela ausência da funcionalidade.
2. Peça a Agent que implemente somente o recorte revisado da funcionalidade.
3. Inspecione a correspondência, o tratamento de espaços em branco, os empréstimos ativos e a ordenação dos resultados.
4. Conecte a exibição do menu, o mapeamento de entrada e o despacho. Preserve os valores existentes das ações.
5. Adicione os casos de limite restantes e execute os testes existentes e novos juntos.
6. Inicie a aplicação a partir de src/Library.Console e exercite o menu manualmente.
7. Registre a saída real e confirme que a funcionalidade não faz gravações.

Verifique seu trabalho

• Todos os casos BOOK têm evidências executáveis ou manuais claramente identificadas.
• Dois exemplares físicos podem ter disponibilidades diferentes.
• Empréstimos devolvidos e empréstimos ativos vencidos são diferenciados.
• O menu alcança a implementação.
• Os testes existentes continuam passando e a busca não modifica os dados JSON.

Solução de problemas

Se um empréstimo ativo ocultar todos os exemplares, verifique as junções por BookItemId. Se um método passar nos testes unitários, mas o menu nunca o chamar, inspecione o despacho das ações. Se uma data de vencimento for antiga, não altere as datas da fixture apenas para esconder um bug.

Prática independente

Projete reservas como uma funcionalidade separada: estados, solicitações conflitantes, expiração e persistência. Não a adicione de forma oportunista a esta alteração de busca.

Restauração

Preserve a tabela de aceitação e a saída e restaure somente os arquivos da funcionalidade/testes na cópia descartável. Uma branch remota ou um repositório público é opcional, não obrigatório.

Referências oficiais

• Planejamento de agentes
• Suporte a testes C#
• Orientações sobre comparação de strings