Adapta os exemplos do guia e dos fluxos para Angular + BaaS - #2
Merged
Conversation
O guia era do projeto full-cycle; num template de Angular, exemplo de NestJS ensina a coisa errada. Trocas principais: - §3.3 'O que decidir no backend NestJS' -> 'As cinco decisoes que o documento precisa responder': camada de dados (componente nao injeta HttpClient), estado (signal/computed), fronteira assincrona (toSignal), autenticacao (interceptor + guard funcionais) e erro. Com a nota de que a decisao da camada de dados e a que paga a migracao json-server -> BaaS - Exemplo canonico do §4: 'pagar o pedido' -> 'solicitar uma vaga na carona', incluindo Issue, spec, branch, caminhos de specs/, criterios de aceite, abandono, fatiamento vertical, substituto temporario e o indice de specs - Glossario, diagrama de contexto e anti-padroes em termos de Angular/BaaS - setup e workflow de architecture: monorepo/apps -> projeto/src, ng new e ng add, contrato de dados (db.json -> schema do BaaS) no lugar do Swagger - cascas .claude/.cursor/.opencode do utf-setup atualizadas Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Estrutura volta a apps/web (app Angular) + apps/api reservada e VAZIA: custa nada agora e evita mover o projeto inteiro no dia em que uma API propria fizer sentido. O setup cria a pasta com um README de uma linha e nao gera backend nenhum — scaffold morto o agente le como se existisse - Versao: o /utf-architecture agora manda registrar a LINHA (Angular 20+), nunca o numero exato (vive no package.json) — fecha a contradicao com o anti-padrao do guia §3.3 - Item 1 do /utf-architecture deixa de oferecer React/Vue (a ficha fixa Angular); item 2 troca 'banco via Docker / provedor em nuvem' pela fonte de dados por fase (json-server -> BaaS) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
O que este PR faz e por quê
O guia foi herdado do template full-cycle: ele ensinava as decisões de arquitetura com exemplos de NestJS (Controller/Service/DTO/ValidationPipe) e usava "pagar o pedido" como história canônica. Num template de Angular isso ensina a coisa errada — e é o tipo de exemplo que o agente copia. Este PR troca o conteúdo, mantendo o método intacto.
A seção que motivou a revisão (§3.3, "O que decidir no backend NestJS") virou "As cinco decisões que o documento precisa responder", com as perguntas que a IA mais inventa sozinha em Angular:
HttpClient?toSignal())?Com a nota que amarra a disciplina: a decisão da camada de dados é a que se sente — o MVP consome json-server e a E3 migra para o BaaS; com os Services isolados, a migração não toca nenhuma tela.
Também adaptado: a história canônica do §4 passou de "pagar o pedido" para "solicitar uma vaga na carona" (Issue, spec, branch, caminhos em
specs/, critérios de aceite, caso de abandono, fatiamento vertical, substituto temporário e índice de specs); glossário, diagrama de contexto e anti-padrões em termos de Angular/BaaS;monorepo/apps/→ projeto/src/no setup e no workflow de architecture (comng new/ng adde o contrato de dadosdb.json→ schema do BaaS no lugar do Swagger); cascas do/utf-setupnas quatro IDEs.Varredura final não encontrou nenhuma menção a NestJS, Prisma, DTO, ValidationPipe, Swagger, webhook, gateway, monorepo ou pagamento.
Apontamentos da revisão
Aceitos: —
Recusados (com o motivo): —
🤖 Generated with Claude Code