Raiz diretórios e porta de entrada

O projeto deve explicar onde começar

A raiz é a pasta que contém o projeto. Um caminho identifica a localização de um arquivo a partir de alguma referência. Em pratica/src/catalogo.mjs, pratica é a raiz do pacote de estudo e src agrupa seu código. Se o terminal já estiver dentro de pratica, o caminho relativo para o mesmo arquivo é src/catalogo.mjs. Confundir essas referências pode fazer um comando procurar dados no lugar errado.

Uma estrutura pequena ajuda o iniciante a localizar responsabilidades. Ela não precisa imitar uma empresa grande nem antecipar todos os recursos possíveis. Crie diretórios para categorias presentes no trabalho e explique as convenções. Um arquivo chamado utilidades que acumula funções sem relação também não resolve a organização: o nome precisa indicar finalidade.

O README é o documento de entrada. Ele informa o que o projeto faz, como iniciar, quais comandos verificar e quais limites não podem ser esquecidos. Não deve exigir que o leitor percorra toda a história da conversa. S07, na seção de registro de alterações, trata do acompanhamento de arquivos; o histórico complementa a entrada, sem substituí-la.

Mapa preenchido da Oficina Caracol

O navegador executa public/app.js; o Node executa os módulos do servidor e dos testes. A extensão não define sozinha o papel: o README e o comando de entrada explicam o ambiente. O diretório public contém arquivos que podem ser entregues ao navegador; isso não autoriza publicar qualquer arquivo da raiz. O servidor usa uma lista fixa de arquivos estáticos, conforme seu contrato.

Ampliar diagrama

Trecho de README utilizável

# Oficina Caracol
Catálogo de serviços fictícios e simulação de reservas.
Sem cadastro, banco externo ou dados pessoais reais.

## Iniciar
Abra o terminal dentro desta pasta pratica.
Confira o runtime com node --version.
Execute npm ci, npm test e npm run validate.
Execute npm start e abra http://127.0.0.1:3000.
Encerre o servidor com Ctrl+C no terminal.

## Limites
Reservas ficam apenas na memória e somem ao reiniciar.
Snapshot e restore usam somente sandbox/recuperacao.
Verificações manuais de teclado devem ser registradas.
A versão testada e os resultados estão no registro de evidência.

Este trecho ensina uma sequência, sem inventar a versão de Node instalada nem afirmar que os comandos já passaram. Na edição entregue, o registro de evidência identifica o ambiente realmente testado. Se a pessoa não sabe em qual pasta está, resolva essa dúvida antes de executar o comando.

Procedimento de organização

• Liste as categorias reais de arquivo e a finalidade de cada uma.
• Mantenha uma porta de entrada e caminhos coerentes entre README, comandos e documentação.
• Ao mover um arquivo, revise importações, carregamento de dados, testes e referências documentais.
• Peça a alguém que localize entrada, dado e teste sem instruções verbais; registre a dificuldade encontrada. Na ausência dessa pessoa, registre o limite da autoinspeção.

Erros e reparos

Exercício resolvido e gate

Dados: um colega quer mudar a regra de seleção de ativos, conferir a entrada e registrar o risco da mudança. Indique três caminhos e explique a ordem de consulta.