Sign in Join

Live chat for Free Pascal, Lazarus, Delphi and every Pascal programmer.

Catalog · How the catalog works

Random project

sdd-em-delphi-exemplos

Exemplos oficiais do livro SDD em Delphi

View on GitHub

Anyone may press Interesting, signed in or not. It helps others find this project.

Member rating

No ratings yet.

Sign in to rate this project.

README

SDD em Delphi - Exemplos

Material complementar oficial do livro SDD em Delphi: Como especificar, projetar e desenvolver software Delphi com apoio de IA, de Régys Borges da Silveira.

Os exemplos mostram como transformar especificações, regras de negócio e critérios de aceitação em código Delphi verificável. O objetivo não é oferecer uma arquitetura universal, mas tornar visível o percurso entre intenção, especificação, implementação e evidência.

O repositório também publica os 72 prompts da primeira edição, organizados por capítulo, e um guia que mostra como evoluir de um pedido isolado para um prompt ancorado em especificação.

Ambiente de referência

  • Delphi 13 Florence / RAD Studio 13 Florence;
  • Windows e compilação Win32 nos scripts fornecidos;
  • FireDAC e SQLite, incluídos no RAD Studio, no laboratório de persistência;
  • DEXT na revisão registrada em 06-dext-api-cliente-inativo/dext-revision.txt.

Exemplos

Pasta Conteúdo Capítulos relacionados
common/ Regras puras compartilhadas. 8, 24 e 25
01-dunitx-cliente-inativo/ Teste DUnitX derivado de uma regra. 25
02-firedac-transacao/ Fronteira transacional com FireDAC. 21 e 24
03-dext-api-contrato/ Contrato didático para uma API DEXT. 9, 20 e 33
04-percurso-sdd-cliente-inativo/ Especificação, domínio, serviço, repositório em memória, auditoria e cenários executáveis. 8, 23, 24, 25 e 32
05-firedac-sqlite-cliente-inativo/ Persistência SQLite, commit e rollback com FireDAC. 21, 24 e 32
06-dext-api-cliente-inativo/ API executável em DEXT para o mesmo domínio. 20, 24 e 33
prompts/ Catálogo de prompts e guia de montagem progressiva. 1, 3 a 36 e estudo comparativo

O mapa detalhado está em MAPA-DO-LIVRO.md.

O catálogo completo está em prompts/README.md. Para começar pela estrutura de um bom pedido, consulte o Guia de montagem.

Validação rápida

Em um terminal PowerShell, na raiz do repositório:

powershell
.\validate.ps1

O script compila e executa os percursos 04 e 05. A API DEXT é compilada quando a opção -IncludeDext é informada:

powershell
.\validate.ps1 -IncludeDext

O primeiro build do DEXT baixa o repositório oficial para uma pasta local ignorada pelo Git.

Como estudar

  1. Leia a especificação ou o trecho correspondente no livro.
  2. Antes de executar, identifique regras, restrições e critérios de aceitação.
  3. Compare a especificação com as decisões presentes no código.
  4. Execute os cenários e observe as evidências.
  5. Altere uma regra primeiro na especificação e depois adapte implementação e testes.

Os exemplos são deliberadamente pequenos. Autenticação, autorização, segurança, observabilidade, migrations, deploy e tratamento completo de falhas devem ser especificados conforme o contexto de cada projeto real.

Versões do livro

As releases deste repositório preservam o código correspondente a cada edição publicada. Para acompanhar a primeira edição impressa, use a release livro-1.0 quando ela estiver disponível. A branch main pode receber correções e melhorias posteriores.

Licença

O código deste repositório é disponibilizado sob a Apache License 2.0. Consulte LICENSE e NOTICE.