Comece pelo dinheiro
Preço, custo por minuto e margem é o documento canônico. Se você encontrar outro número em qualquer lugar do repositório, ele está errado.
O tabuleiro
Base de conhecimento interna — produto, arquitetura e engenharia. O conteúdo vive em
docs/live/ no repositório e é publicado daqui.O produto em uma frase
Seção intitulada “O produto em uma frase”Um agente atende o telefone do dono de um negócio de serviço quando ele não pode atender, qualifica quem ligou, agenda na agenda dele e o avisa por e-mail. O cliente não compra um agente: compra saber que entrou trabalho.
Depois pelo mercado
Entrada em DFW explica por que HVAC, por que Dallas–Fort Worth, e o que a tese assume.
A jornada, ponta a ponta
O mapa da jornada mostra todo caminho que uma pessoa pode seguir e o e-mail que sai em cada ponto — com o conteúdo real. É gerado do código e um teste impede que envelheça.
Como está montado
Arquitetura e modelo de dados — os três hosts, o Worker, a voz, o banco.
Onde as coisas quebram
Deploy de produção é o retrato honesto do que está no ar, do que degrada em silêncio e do que ainda não existe.
As três regras que mais rendem defeito
Seção intitulada “As três regras que mais rendem defeito”Estão espalhadas pelos documentos, mas erram tanto que valem repetição na capa.
| Regra | Onde está escrita |
|---|---|
elec só sobre navy, blue só sobre paper. Trocar lava o contraste e denuncia pressa. | Padrão de e-mail |
Link para humano usa chat, link de máquina usa api. api responde 404 em caminho de interface. | Deploy de produção |
| Documentação em português, código em inglês. | Padrão de documentação |
Como esta base não apodrece
Seção intitulada “Como esta base não apodrece”Três decisões, e as três importam mais que o site em si:
- A fonte é o repositório. Todo documento vive em
docs/live/e muda no mesmo PR que o código que ele descreve. Não existe editar aqui: o site é gerado. - A CI recusa documento quebrado. O
docs:lintexige a linha de metadados, um H1 só, hierarquia de títulos correta, e que todo link relativo resolva. - O que pode ser gerado, é gerado. Estado de endpoint, schema do banco e conteúdo de e-mail saem da fonte, não da memória de quem escreveu. Documento que depende de alguém lembrar de atualizar vai desatualizar — é só questão de quanto tempo.