<p>Estimar, implementar e implantar software, rapidamente, é uma característica de programadores poderosos, como diz <a href="https://www.kentbeck.com/">Kent Beck</a> em seu livro <a href="https://www.oreilly.com/library/view/extreme-programming-explained/0201616416/">Extreme Programming Explained</a>. Vou explorar estes três pontos neste artigo, inserindo minhas próprias opiniões em cada ponto.</p>
<h2>Estimativa</h2>
<p>Estimar um projeto software é <a href="https://jacobian.org/2021/may/20/estimation/">difícil</a>, e existem diversas técnicas diferentes de como estimar um projeto de software. Você pode criar um método, pela sua própria experiência, aprender o método utilizado por outras empresas mas, deve se atentar que, o ponto central é que você ter uma boa ideia de quanto tempo o projeto levará. Projetos têm começo, meio e fim. Aprenda a estimar (bem) o seu trabalho.</p>
<h2>Implementação</h2>
<p>Para mim, particularmente, implementar é a parte mais divertida do projeto. E como em todo trabalho, temos que ser pragmáticos na escolha da linguagem e das ferramentas. Ser pragmático na escolha não significa, necessariamente, usar o mesmo que todo mundo utiliza, pois, muitas vezes, algumas ferramentas continuam fortes no mercado por pura inércia. O <a href="https://expressjs.com/">Express</a> é um bom exemplo disso. Além de haverem muitas opções melhores e com um melhor suporte (como o <a href="https://fastify.dev/">Fastify</a>), muitas equipes ainda começam novos projetos com Express, mesmo que ele não esteja sendo mantido regularmente, não trate rejeições de Promises, etc.</p>
<p>Fora a questão da escolha de ferramentas, é preciso que você <strong>domine</strong> a pilha de tecnologias do seu projeto, sendo capaz de implementar as melhores soluções no menor tempo possível. Na ponta da língua, você tem que saber um bom padrão para aplicar no projeto, um bom framework para o backend, um bom framework para o frontend ou mesmo um bom framework full stack. E a experiência do desenvolvimento não pode ficar de fora. Para que a implementação seja rápida, o entendimento do projeto deve ser fácil, sua documentação adequada e seus testes precisam validar os fluxos de <strong>intenção</strong> do usuário que utilizará o sistema.</p>
<h2>Implantação</h2>
<p>Hoje, você consegue construir um projeto inteiro e colocar em produção, sozinho? E não estou falando de subir um o seu projeto em uma plataforma completamente gerenciada, como a Vercel, mas sim, de pegar uma máquina Linux, instalar as ferramentas necessárias e expor a sua aplicação para a web. E não, isso não é nenhum tipo de purismo. Se você não é uma startup que pode queimar alguns milhões de reais por anos, sem se preocupar com o custo da sua infraestrutura, deveria, pelo menos, saber como iniciar a sua aplicação e mantê-la ativa entre as reinicializações do servidor (de preferência, usando <em>containers</em>), colocá-la atrás de um proxy reverso (como o <a href="https://www.nginx.com/">NGINX</a> ou <a href="https://caddyserver.com/">Caddy</a>), configurar um firewall e fazer um backup do banco de dados em três lugares diferentes. Você ainda pode subir várias instâncias da sua aplicação e usar a mesma ferramenta de proxy como load balancer para distribuir os acessos da sua aplicação às diferentes instâncias que estão rodando.</p>


O programador poderoso

<p>No livro <a href="https://en.wikipedia.org/wiki/A_Pattern_Language"><em>A Pattern Language</em></a>, Christopher Alexander e seus colegas definem um padrão como:</p>
<blockquote>
<p>Cada padrão descreve um problema que ocorre repetidamente em nosso ambiente e, em seguida, descreve o núcleo da solução para esse problema, de tal forma que você pode usar essa solução um milhão de vezes, sem nunca fazê-lo da mesma maneira duas vezes.</p>
</blockquote>
<div hidden>
Each pattern describes a problem which occurs over and over again in our environment, and then describes the core of the solution to that problem, in such a way that you can use this solution a million times over, without ever doing it the same way twice
</div>

<p>Cristopher e os outros autores estavam se referindo a padrões de arquitetura de construção, mas, desde muito tempo, a disciplina de engenharia de software adotou este mesmo conceito para o desenvolvimento de software, que foi cristalizado pelo famoso livro <a href="https://engsoftmoderna.info/cap6.html#padr%C3%B5es-de-projeto"><em>Design Patterns: Elements of Reusable Object-Oriented Software</em></a> de Erich Gamma, Richard Helm, Ralph Johnson e John Vlissides (conhecidos como <em>Gang of Four</em> ou <em>GoF</em>). No livro, eles definem padrões de projeto como:</p>
<blockquote>
<p>Padrões de projeto descrevem objetos e classes que se relacionam para resolver um problema de projeto genérico em um contexto particular.</p>
</blockquote>
<p>É preciso entender que os padrões de projeto descritos nestes livros não são soluções que <strong>devem</strong> ser aplicadas em toda e qualquer situação, mas sim, descrições gerais de soluções para problemas comuns de projetos de software. Desse modo, as soluções propostas podem ser entendidas como um catálogo, a partir do qual pode-se estabelecer um vocabulário comum entre todas as pessoas envolvidas no desenvolvimento de um software, facilitando a comunicação e a compreensão do código.</p>
<p>Para ilustrar o que foi dito até aqui, vamos considerar um exemplo. Suponha que você está construindo um sistema de gerenciamento de uma biblioteca pessoal e, no seu banco de dados relacional, há uma tabela para armazenar os dados de um livro. A tabela pode ser criada com o seguinte comando SQL, em um banco de dados SQLite:</p>
<pre><code class="highlited-code-wrapper langsql"><div class="highlited-code" data-language="sql">-- SQLite
CREATE TABLE
  `books` (
    `id` INTEGER NOT NULL PRIMARY KEY autoincrement,
    `author` TEXT NOT NULL,
    `title` TEXT NOT NULL,
    `isbn` TEXT NOT NULL,
    `updated_at` DATETIME NULL,
    `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
  );</div>
</code></pre><p>Vamos escolher o padrão <a href="https://www.martinfowler.com/eaaCatalog/activeRecord.html"><em>Active Record</em></a> para representar os dados de um livro no nosso sistema. Para isso, vamos criar uma classe em JavaScript conforme o diagrama abaixo:</p>
<p><SVG64 
width={250}
content="PHN2ZyB2ZXJzaW9uPSIxLjEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgdmlld0JveD0iMCAwIDE5MS43NTUwNzA0OTM4NjYyNCAyMzUuMTQ1MjI2OTU1Mjc3NTYiIHdpZHRoPSI1NzUuMjY1MjExNDgxNTk4NyIgaGVpZ2h0PSI3MDUuNDM1NjgwODY1ODMyNiI+CiAgPCEtLSBzdmctc291cmNlOmV4Y2FsaWRyYXcgLS0+CiAgCiAgPGRlZnM+CiAgICA8c3R5bGUgY2xhc3M9InN0eWxlLWZvbnRzIj4KICAgICAgQGZvbnQtZmFjZSB7CiAgICAgICAgZm9udC1mYW1pbHk6ICJWaXJnaWwiOwogICAgICAgIHNyYzogdXJsKCJodHRwczovL2V4Y2FsaWRyYXcuY29tL1ZpcmdpbC53b2ZmMiIpOwogICAgICB9CiAgICAgIEBmb250LWZhY2UgewogICAgICAgIGZvbnQtZmFtaWx5OiAiQ2FzY2FkaWEiOwogICAgICAgIHNyYzogdXJsKCJodHRwczovL2V4Y2FsaWRyYXcuY29tL0Nhc2NhZGlhLndvZmYyIik7CiAgICAgIH0KICAgIDwvc3R5bGU+CiAgICAKICA8L2RlZnM+CiAgPHJlY3QgeD0iMCIgeT0iMCIgd2lkdGg9IjE5MS43NTUwNzA0OTM4NjYyNCIgaGVpZ2h0PSIyMzUuMTQ1MjI2OTU1Mjc3NTYiIGZpbGw9IiNmZmZmZmYiPjwvcmVjdD48ZyBzdHJva2UtbGluZWNhcD0icm91bmQiIHRyYW5zZm9ybT0idHJhbnNsYXRlKDEwIDEwKSByb3RhdGUoMCA4NS44Nzc1MzUyNDY5MzMxMiAxMDcuNTcyNjEzNDc3NjM4NzgpIj48cGF0aCBkPSJNMCAwIEM0MS42MSAwLCA4My4yMiAwLCAxNzEuNzYgMCBNMCAwIEM0MC40OSAwLCA4MC45OSAwLCAxNzEuNzYgMCBNMTcxLjc2IDAgQzE3MS43NiA2Ni42NiwgMTcxLjc2IDEzMy4zMSwgMTcxLjc2IDIxNS4xNSBNMTcxLjc2IDAgQzE3MS43NiA2Mi4zOCwgMTcxLjc2IDEyNC43NiwgMTcxLjc2IDIxNS4xNSBNMTcxLjc2IDIxNS4xNSBDMTE5LjM2IDIxNS4xNSwgNjYuOTYgMjE1LjE1LCAwIDIxNS4xNSBNMTcxLjc2IDIxNS4xNSBDMTI4LjQ4IDIxNS4xNSwgODUuMiAyMTUuMTUsIDAgMjE1LjE1IE0wIDIxNS4xNSBDMCAxNDEuNTYsIDAgNjcuOTcsIDAgMCBNMCAyMTUuMTUgQzAgMTU4LjA2LCAwIDEwMC45NywgMCAwIiBzdHJva2U9IiMxZTFlMWUiIHN0cm9rZS13aWR0aD0iMiIgZmlsbD0ibm9uZSI+PC9wYXRoPjwvZz48ZyB0cmFuc2Zvcm09InRyYW5zbGF0ZSg1Ny4yMTA2NjExNjUyNzAwNCAxNy40NDg1Mzc5NDkyNTAyMzcpIHJvdGF0ZSgwIDM0Ljg4OTAxMjQyMzQyODU0IDE4Ljc4MTc4NTYyNjQ3ODQ2NykiPjx0ZXh0IHg9IjAiIHk9IjAiIGZvbnQtZmFtaWx5PSJWaXJnaWwsIFNlZ29lIFVJIEVtb2ppIiBmb250LXNpemU9IjMwLjA1MDg1NzAwMjM2NTU2OHB4IiBmaWxsPSIjMWUxZTFlIiB0ZXh0LWFuY2hvcj0ic3RhcnQiIHN0eWxlPSJ3aGl0ZS1zcGFjZTogcHJlOyIgZGlyZWN0aW9uPSJsdHIiIGRvbWluYW50LWJhc2VsaW5lPSJ0ZXh0LWJlZm9yZS1lZGdlIj5Cb29rPC90ZXh0PjwvZz48ZyB0cmFuc2Zvcm09InRyYW5zbGF0ZSgyMi43MzUwNTM2MTI3MDcxMzQgNzYuNjEyOTk0NTM3NjQxMzgpIHJvdGF0ZSgwIDQwLjUwOTk2Mzk4OTI1NzgxIDYyLjUpIj48dGV4dCB4PSIwIiB5PSIwIiBmb250LWZhbWlseT0iVmlyZ2lsLCBTZWdvZSBVSSBFbW9qaSIgZm9udC1zaXplPSIyMHB4IiBmaWxsPSIjMWUxZTFlIiB0ZXh0LWFuY2hvcj0ic3RhcnQiIHN0eWxlPSJ3aGl0ZS1zcGFjZTogcHJlOyIgZGlyZWN0aW9uPSJsdHIiIGRvbWluYW50LWJhc2VsaW5lPSJ0ZXh0LWJlZm9yZS1lZGdlIj5jcmVhdGU8L3RleHQ+PHRleHQgeD0iMCIgeT0iMjUiIGZvbnQtZmFtaWx5PSJWaXJnaWwsIFNlZ29lIFVJIEVtb2ppIiBmb250LXNpemU9IjIwcHgiIGZpbGw9IiMxZTFlMWUiIHRleHQtYW5jaG9yPSJzdGFydCIgc3R5bGU9IndoaXRlLXNwYWNlOiBwcmU7IiBkaXJlY3Rpb249Imx0ciIgZG9taW5hbnQtYmFzZWxpbmU9InRleHQtYmVmb3JlLWVkZ2UiPnVwZGF0ZTwvdGV4dD48dGV4dCB4PSIwIiB5PSI1MCIgZm9udC1mYW1pbHk9IlZpcmdpbCwgU2Vnb2UgVUkgRW1vamkiIGZvbnQtc2l6ZT0iMjBweCIgZmlsbD0iIzFlMWUxZSIgdGV4dC1hbmNob3I9InN0YXJ0IiBzdHlsZT0id2hpdGUtc3BhY2U6IHByZTsiIGRpcmVjdGlvbj0ibHRyIiBkb21pbmFudC1iYXNlbGluZT0idGV4dC1iZWZvcmUtZWRnZSI+ZGVsZXRlPC90ZXh0Pjx0ZXh0IHg9IjAiIHk9Ijc1IiBmb250LWZhbWlseT0iVmlyZ2lsLCBTZWdvZSBVSSBFbW9qaSIgZm9udC1zaXplPSIyMHB4IiBmaWxsPSIjMWUxZTFlIiB0ZXh0LWFuY2hvcj0ic3RhcnQiIHN0eWxlPSJ3aGl0ZS1zcGFjZTogcHJlOyIgZGlyZWN0aW9uPSJsdHIiIGRvbWluYW50LWJhc2VsaW5lPSJ0ZXh0LWJlZm9yZS1lZGdlIj5maW5kQnlJZDwvdGV4dD48dGV4dCB4PSIwIiB5PSIxMDAiIGZvbnQtZmFtaWx5PSJWaXJnaWwsIFNlZ29lIFVJIEVtb2ppIiBmb250LXNpemU9IjIwcHgiIGZpbGw9IiMxZTFlMWUiIHRleHQtYW5jaG9yPSJzdGFydCIgc3R5bGU9IndoaXRlLXNwYWNlOiBwcmU7IiBkaXJlY3Rpb249Imx0ciIgZG9taW5hbnQtYmFzZWxpbmU9InRleHQtYmVmb3JlLWVkZ2UiPmFsbDwvdGV4dD48L2c+PGcgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIj48ZyB0cmFuc2Zvcm09InRyYW5zbGF0ZSgxMC44MDgzODI2MTc0Njc0ODcgNjEuMzgyNzE3NDY4NTg3MTQ2KSByb3RhdGUoMCA4NS4yNDUzMTg4Njg2NjgxNiAtMC4xOTAyOTE4MTQ2NTcyMjkpIj48cGF0aCBkPSJNMCAwIEMyOC40MiAtMC4wNiwgMTQyLjA4IC0wLjMyLCAxNzAuNDkgLTAuMzggTTAgMCBDMjguNDIgLTAuMDYsIDE0Mi4wOCAtMC4zMiwgMTcwLjQ5IC0wLjM4IiBzdHJva2U9IiMxZTFlMWUiIHN0cm9rZS13aWR0aD0iMiIgZmlsbD0ibm9uZSI+PC9wYXRoPjwvZz48L2c+PG1hc2s+PC9tYXNrPjwvc3ZnPg==" /></p>
<p>E este é o código:</p>
<pre><code class="highlited-code-wrapper langjavascript"><div class="highlited-code" data-language="javascript">import { AsyncDatabase } from 'promised-sqlite3'

const db = await AsyncDatabase.open(
  // caminho para o arquivo do banco de dados SQLite
  process.env.DATABASE_URL,
)

export class ActiveRecord {
  constructor({ database = db, tableName }) {
    this.database = database
    this.tableName = tableName
  }

  all(columns = '*') {
    const cols = Array.isArray(columns) ? columns.join(', ') : columns

    return this.database.all(`SELECT ${cols} FROM ${this.tableName}`)
  }

  async findById(id, columns = '*') {
    const cols = Array.isArray(columns) ? columns.join(', ') : columns
    const statement = await this.database.prepare(
      `SELECT ${cols} FROM ${this.tableName} WHERE id = $id`, { $id: id },
    )

    return statement.get()
  }

  async create(data) {
    const columns = Object.keys(data)
    const values = Object.values(data)
    const statement = await this.database.prepare(
      `INSERT INTO ${this.tableName} (${columns.join(', ')}) VALUES (${columns.map(() =&gt; '?').join(', ')})`,
      values,
    )

    return statement.run()
  }

  async update(id, data) {
    const columns = Object.keys(data)
    const values = Object.values(data)
    const statement = await this.database.prepare(
      `UPDATE ${this.tableName} SET ${columns.map(column =&gt; `${column} = ?`).join(', ')} WHERE id = $id`,
      [...values, id],
    )

    return statement.run()
  }

  async delete(id) {
    const statement = await this.database.prepare(
      `DELETE FROM ${this.tableName} WHERE id = $id`,
      { $id: id },
    )

    return statement.run()
  }
}

export class Book extends ActiveRecord {
  constructor() {
    super({ tableName: 'books' })
  }
}</div>
</code></pre><Alert title="Atenção" mb="md" color="yellow">
A implementação acima é apenas um exemplo didático. Não há preocupações com segurança ou validação de dados antes de inseri-los ou atualizar os dados no banco de dados.
</Alert>

<p>Note que todo o SQL necessário para manipular os dados no nosso banco SQLite está encapsulado na classe <code>ActiveRecord</code>. Além disso, a classe <code>Book</code> herda todos os métodos da classe <code>ActiveRecord</code> e, portanto, não é necessário escrever o mesmo código para cada tabela do banco de dados. Desse modo, é possível criar várias entidades distintas no nosso sistema, como <code>Author</code>, <code>Publisher</code>, <code>Category</code>, <code>BookCategory</code>, <code>BookAuthor</code>, <code>BookPublisher</code>, etc. Todas elas herdam os métodos da classe <code>ActiveRecord</code> e, portanto, não é necessário escrever o mesmo código para cada tabela do banco de dados.</p>
<p>Mais que isso, podemos reimplementar os métodos da classe pai na classe filha, caso haja algum requisito especial para alguma entidade, como transformar o <code>delete</code> em um <em>soft delete</em>. Por exemplo:</p>
<pre><code class="highlited-code-wrapper langjavascript"><div class="highlited-code" data-language="javascript">export class Book extends ActiveRecord {
  constructor() {
    super({ tableName: 'books' })
  }

  async delete(id) {
    const statement = await this.database.prepare(
      // Não se esqueça de adicionar a coluna `deleted` na tabela `books`
      `UPDATE ${this.tableName} SET deleted = true WHERE id = $id`,
      { $id: id },
    )

    return statement.run()
  }
}</div>
</code></pre><p>Este padrão pode resolver o nosso caso de uso, porém, como próprio Martin Fowler alerta, este padrão pode não ser o mais adequado para se aplicar em uma entidade que precisa se relacionar com um repositório (ou repositórios) de dados mais complexos (apesar de que Ruby on Rails <a href="https://guides.rubyonrails.org/active_record_basics.html">utiliza este padrão</a> extensamente).</p>
<p>Se tiver alguma dúvida, comentário ou sugestão, deixe um comentário abaixo ou entre em contato comigo pelo <a href="https://twitter.com/douglasdemoura">Twitter</a>.</p>
<h2>Referências</h2>
<ul>
<li><a href="https://engsoftmoderna.info/cap6.html#padr%C3%B5es-de-projeto">Padrões de Projeto</a></li>
<li><a href="https://dl.acm.org/doi/book/10.5555/186897">Design patterns: elements of reusable object-oriented software</a></li>
<li><a href="https://martinfowler.com/books/eaa.html">Patterns of Enterprise Application Architecture, by Martin Fowler</a></li>
</ul>


Douglas Moura

Douglas Moura

#Padrões de Projeto

O programador poderoso

O que são padrões de projeto na engenharia de software?