Implementação¶

O que a arquitetura define, o que já foi construído e o que falta, elemento por elemento. O feito de Web, API, Infra e Testes é gerado no build a partir do catálogo; o falta e a dívida técnica são escritos à mão — são decisão, não dado. O olhar de negócio (o que o produto faz e o que ainda não faz) está no roadmap.

Web — apps/web¶

Feito¶

• SPEC-0001 — Recuperação de senha por e-mail
• SPEC-0002 — Onboarding: usuário conectado, cancelamento e logo
• SPEC-0003 — Análise completa: taxa setup pelo analista, cláusula obrigatória e corresponsável
• SPEC-0004 — Implementação mobile (PWA responsivo) conforme o Figma
• SPEC-0005 — Aviso de atualização do PWA (banner com botão "Atualizar")
• SPEC-0006 — Pacote Locatício como base de cálculo + limpeza das configurações padrão
• SPEC-0007 — Análise de Crédito: rename completo (Proposal → CreditAnalysis) + visão mobile
• SPEC-0008 — Documentos obrigatórios da Análise de Crédito
• SPEC-0009 — Remoção do i18n
• SPEC-0010 — Parametrização de documentos por área: botões e seleção do tipo
• SPEC-0011 — Gaveta de navegação do mobile conforme o design system 1.5.0
• SPEC-0012 — Iconografia Phosphor, conforme o design system 2.3.0
• SPEC-0013 — Inquilinos e Imóveis conforme o design system
• SPEC-0014 — MUI 9 e design system 2.10.0
• SPEC-0015 — Telas de Análise de Crédito no design system
• SPEC-0016 — Topo e espaçamento no mobile: listas e formulários
• SPEC-0017 — Internalizar o design system e aposentar o pacote
• SPEC-0018 — Respiro do label dos campos de formulário
• SPEC-0019 — Contraste dos neutros e adoção da paleta de marca
• SPEC-0020 — Padronizar o topo de página
• SPEC-0021 — Borda do topo e tom das linhas, iguais nos dois viewports
• SPEC-0022 — Paginação no mobile: Inquilinos, Imóveis e Análise de Crédito
• SPEC-0023 — Padronizar os filtros das listas
• SPEC-0024 — Ações do formulário no topo
• SPEC-0025 — Organização da visualização da análise de crédito
• SPEC-0027 — Contrato vira Garantia
• SPEC-0028 — Ambiente de produção (app.garantora.com.br na box srv01)
• SPEC-0030 — Skill ship: deploy do main em produção
• SPEC-0031 — Convite de garantidora por link
• SPEC-0032 — Templates de e-mail no design system
• SPEC-0033 — Interface do SaaS admin no design system
• SPEC-0034 — Isolamento de tenant e de imobiliária, e login sem credencial pré-preenchida
• SPEC-0035 — Autorização: fechar os portões, sanear as permissões, e o menu obedecer a elas
• SPEC-0036 — O passo de analisar, e o caminho de volta para a imobiliária
• SPEC-0037 — Pendências tipificadas na análise de crédito, e um histórico que diz o que mudou
• SPEC-0038 — Emissão da garantia e a espera pela assinatura
• SPEC-0039 — Emitir a garantia conferindo, e sem poder divergir da análise
• SPEC-0040 — Assinou, fecha o dossiê: alterar arquivo vira exceção nomeada e visível
• SPEC-0041 — A Equipe passa a administrar de verdade: no celular, sem 403, e sem mudar acesso em silêncio
• SPEC-0042 — Tutoriais em vídeo, e onde encontrá-los
• SPEC-0043 — Ninguém consegue dizer que versão está no ar, nem o que mudou nela
• SPEC-0044 — O que mudou não cabe onde está sendo contado
• SPEC-0045 — Assuntos, navegação e a versão certa para cada aparelho
• SPEC-0046 — Documento e telefone com máscara, e erro de formulário que a pessoa consegue ler
• SPEC-0047 — Correção no web sem forma de provar que está certa
• FIX-0001 — Borda e placeholder dos campos de formulário fora dos tokens
• FIX-0002 — Zoom automático no mobile ao focar qualquer campo
• FIX-0003 — A API responde antes de comitar a transação
• FIX-0004 — Separadores escuros demais depois da spec 0019
• FIX-0005 — O topo da imobiliária não mostra título no mobile
• FIX-0006 — Erros encontrados na jornada da análise de crédito
• FIX-0007 — Documento do cadastro do inquilino aparece como "Entregue" numa análise recém-criada, sem nenhuma pista de que veio de antes
• FIX-0008 — A caixa azul do passo Documentos afirma o que o sistema não faz
• FIX-0009 — A aprovação pede num modal o que a tela já mostra, e o setup é um campo vazio sem referência
• FIX-0010 — O anexo grande não sobe, e o que subiu quebrado abre em branco
• FIX-0011 — A imobiliária troca e edita documento com a análise na garantidora
• FIX-0012 — A tela decide com dado que não é dela: identidade congelada, e formulário preenchido pelo navegador
• FIX-0014 — No celular, a Ajuda esconde metade do índice atrás de um gesto que a tela não anuncia
• FIX-0015 — A recusa do servidor não aponta o campo em três formulários
• FIX-0016 — Renda comprovada do inquilino principal não é obrigatória
• FIX-0017 — Salvar em Parâmetros (mobile) trava os botões da tab bar do rodapé
• FIX-0021 — Seletor de parceira só alcança a primeira página, e em Inquilinos nem a busca resolve
• FIX-0024 — O painel de Novidades corta no meio o item de nota que ocupa mais de uma linha
• SPEC-0048 — Geração automática de cobranças e tela de gestão
• SPEC-0049 — Remoção lógica e recuperação: imobiliária, inquilino, imóvel, análise de crédito, garantia e cobrança
• SPEC-0050 — Consulta ao Boa Vista (Cadastro Positivo) na análise de crédito, configurável por tenant
• SPEC-0051 — Usuários da imobiliária: quem tem acesso, e como tirá-lo
• SPEC-0052 — Catálogo de consultas de crédito configurável, com custo e conciliação (API Full)
• SPEC-0053 — Central de ajuda na ordem da jornada: tudo visível, busca e capítulos ao lado do vídeo
• SPEC-0054 — Cobrança com tipo, canal e parcela, e o resumo do mês que hoje mora na planilha
• SPEC-0055 — O acerto com a imobiliária: o que ela recolheu, o que repassou, e o mês fechado
• FIX-0018 — Inquilino cadastrado no formulário de análise não fica vinculado à imobiliária
• FIX-0019 — O painel de Consulta de crédito usa a cor de aprovação para um resultado que não aprova nada
• SPEC-0056 — A taxa de adesão: da imobiliária, por imobiliária, e de volta como comissão
• SPEC-0057 — A mensalidade da garantia: uma faixa por tipo de tomador, escolhida na aprovação

Falta¶

• Telas do sinistro — o processo não existe (ver roadmap).

API — apps/api¶

Feito¶

• SPEC-0001 — Recuperação de senha por e-mail
• SPEC-0002 — Onboarding: usuário conectado, cancelamento e logo
• SPEC-0003 — Análise completa: taxa setup pelo analista, cláusula obrigatória e corresponsável
• SPEC-0004 — Implementação mobile (PWA responsivo) conforme o Figma
• SPEC-0005 — Aviso de atualização do PWA (banner com botão "Atualizar")
• SPEC-0006 — Pacote Locatício como base de cálculo + limpeza das configurações padrão
• SPEC-0007 — Análise de Crédito: rename completo (Proposal → CreditAnalysis) + visão mobile
• SPEC-0008 — Documentos obrigatórios da Análise de Crédito
• SPEC-0009 — Remoção do i18n
• SPEC-0010 — Parametrização de documentos por área: botões e seleção do tipo
• SPEC-0011 — Gaveta de navegação do mobile conforme o design system 1.5.0
• SPEC-0012 — Iconografia Phosphor, conforme o design system 2.3.0
• SPEC-0013 — Inquilinos e Imóveis conforme o design system
• SPEC-0014 — MUI 9 e design system 2.10.0
• SPEC-0015 — Telas de Análise de Crédito no design system
• SPEC-0023 — Padronizar os filtros das listas
• SPEC-0025 — Organização da visualização da análise de crédito
• SPEC-0027 — Contrato vira Garantia
• SPEC-0028 — Ambiente de produção (app.garantora.com.br na box srv01)
• SPEC-0030 — Skill ship: deploy do main em produção
• SPEC-0031 — Convite de garantidora por link
• SPEC-0032 — Templates de e-mail no design system
• SPEC-0034 — Isolamento de tenant e de imobiliária, e login sem credencial pré-preenchida
• SPEC-0035 — Autorização: fechar os portões, sanear as permissões, e o menu obedecer a elas
• SPEC-0036 — O passo de analisar, e o caminho de volta para a imobiliária
• SPEC-0037 — Pendências tipificadas na análise de crédito, e um histórico que diz o que mudou
• SPEC-0038 — Emissão da garantia e a espera pela assinatura
• SPEC-0039 — Emitir a garantia conferindo, e sem poder divergir da análise
• SPEC-0040 — Assinou, fecha o dossiê: alterar arquivo vira exceção nomeada e visível
• SPEC-0041 — A Equipe passa a administrar de verdade: no celular, sem 403, e sem mudar acesso em silêncio
• SPEC-0042 — Tutoriais em vídeo, e onde encontrá-los
• SPEC-0043 — Ninguém consegue dizer que versão está no ar, nem o que mudou nela
• SPEC-0044 — O que mudou não cabe onde está sendo contado
• SPEC-0046 — Documento e telefone com máscara, e erro de formulário que a pessoa consegue ler
• FIX-0002 — Zoom automático no mobile ao focar qualquer campo
• FIX-0003 — A API responde antes de comitar a transação
• FIX-0006 — Erros encontrados na jornada da análise de crédito
• FIX-0007 — Documento do cadastro do inquilino aparece como "Entregue" numa análise recém-criada, sem nenhuma pista de que veio de antes
• FIX-0008 — A caixa azul do passo Documentos afirma o que o sistema não faz
• FIX-0009 — A aprovação pede num modal o que a tela já mostra, e o setup é um campo vazio sem referência
• FIX-0010 — O anexo grande não sobe, e o que subiu quebrado abre em branco
• FIX-0011 — A imobiliária troca e edita documento com a análise na garantidora
• FIX-0012 — A tela decide com dado que não é dela: identidade congelada, e formulário preenchido pelo navegador
• FIX-0016 — Renda comprovada do inquilino principal não é obrigatória
• FIX-0021 — Seletor de parceira só alcança a primeira página, e em Inquilinos nem a busca resolve
• FIX-0023 — E-mail de usuário guarda a maiúscula, e quem digita em minúsculas não entra nem recupera a senha
• SPEC-0048 — Geração automática de cobranças e tela de gestão
• SPEC-0049 — Remoção lógica e recuperação: imobiliária, inquilino, imóvel, análise de crédito, garantia e cobrança
• SPEC-0050 — Consulta ao Boa Vista (Cadastro Positivo) na análise de crédito, configurável por tenant
• SPEC-0051 — Usuários da imobiliária: quem tem acesso, e como tirá-lo
• SPEC-0052 — Catálogo de consultas de crédito configurável, com custo e conciliação (API Full)
• SPEC-0054 — Cobrança com tipo, canal e parcela, e o resumo do mês que hoje mora na planilha
• SPEC-0055 — O acerto com a imobiliária: o que ela recolheu, o que repassou, e o mês fechado
• FIX-0018 — Inquilino cadastrado no formulário de análise não fica vinculado à imobiliária
• SPEC-0056 — A taxa de adesão: da imobiliária, por imobiliária, e de volta como comissão
• SPEC-0057 — A mensalidade da garantia: uma faixa por tipo de tomador, escolhida na aprovação

Falta¶

• Sinistro, emissão de boleto e assinatura eletrônica (ver roadmap).

Dívida técnica¶

• make lint não passa — a maior parte é line-too-long; o código nunca passou por ruff format, e pagar essa dívida é decisão do usuário (o diff é enorme).
• [tool.mypy] ausente do pyproject.toml — o mypy está instalado sem configuração, e sem os plugins de pydantic/SQLAlchemy a maioria dos erros é falso positivo.
• Cobertura desigual: os módulos de maior risco financeiro eram os menos cobertos (credit.py, decision_service.py, guarantee_service.py, billing_service.py). Não remedida desde a criação do monorepo — rode make test-cov antes de afirmar.

Worker e jobs agendados¶

Feito¶

• Consulta ao bureau de crédito em fila, run_credit_check_job — spec 0050.
• Job diário das 6h, daily_credit_finance_job: purga do payload bruto vencido e sincronização de extrato e preços das consultas — specs 0050 e 0052.
• Job diário das 7h, daily_billing_overdue_job: marca as cobranças vencidas — spec 0048.

Falta¶

• Nada além dos três jobs está previsto na arquitetura hoje.

Integrações externas¶

Feito¶

• API Full — consultas de crédito e extrato da conta (specs 0050 e 0052).
• ViaCEP — busca de endereço pelo CEP.
• E-mail — Mailpit em desenvolvimento; AWS SES (Mail Manager SMTP) em produção.

Falta¶

• Assinatura eletrônica (Autentique + biometria facial) — planejada, não integrada.
• Emissão de boleto — hoje "boleto" é só o rótulo do canal da parcela, e a baixa é manual.

Infra — local, dev-remote e produção¶

Feito¶

• SPEC-0017 — Internalizar o design system e aposentar o pacote
• SPEC-0028 — Ambiente de produção (app.garantora.com.br na box srv01)
• FIX-0010 — O anexo grande não sobe, e o que subiu quebrado abre em branco
• FIX-0013 — O make seed some do log do deploy, e o deploy diz que deu certo
• SPEC-0058 — A documentação começa pelo andamento: roadmap, especificações, arquitetura e implementação

Falta¶

• Sem CI.

Testes¶

Feito¶

• SPEC-0001 — Recuperação de senha por e-mail
• SPEC-0002 — Onboarding: usuário conectado, cancelamento e logo
• SPEC-0003 — Análise completa: taxa setup pelo analista, cláusula obrigatória e corresponsável
• SPEC-0004 — Implementação mobile (PWA responsivo) conforme o Figma
• SPEC-0005 — Aviso de atualização do PWA (banner com botão "Atualizar")
• SPEC-0006 — Pacote Locatício como base de cálculo + limpeza das configurações padrão
• SPEC-0007 — Análise de Crédito: rename completo (Proposal → CreditAnalysis) + visão mobile
• SPEC-0008 — Documentos obrigatórios da Análise de Crédito
• SPEC-0009 — Remoção do i18n
• SPEC-0010 — Parametrização de documentos por área: botões e seleção do tipo
• SPEC-0011 — Gaveta de navegação do mobile conforme o design system 1.5.0
• SPEC-0012 — Iconografia Phosphor, conforme o design system 2.3.0
• SPEC-0013 — Inquilinos e Imóveis conforme o design system
• SPEC-0014 — MUI 9 e design system 2.10.0
• SPEC-0015 — Telas de Análise de Crédito no design system
• SPEC-0016 — Topo e espaçamento no mobile: listas e formulários
• SPEC-0018 — Respiro do label dos campos de formulário
• SPEC-0019 — Contraste dos neutros e adoção da paleta de marca
• SPEC-0020 — Padronizar o topo de página
• SPEC-0021 — Borda do topo e tom das linhas, iguais nos dois viewports
• SPEC-0022 — Paginação no mobile: Inquilinos, Imóveis e Análise de Crédito
• SPEC-0023 — Padronizar os filtros das listas
• SPEC-0024 — Ações do formulário no topo
• SPEC-0025 — Organização da visualização da análise de crédito
• SPEC-0027 — Contrato vira Garantia
• SPEC-0028 — Ambiente de produção (app.garantora.com.br na box srv01)
• SPEC-0030 — Skill ship: deploy do main em produção
• SPEC-0031 — Convite de garantidora por link
• SPEC-0032 — Templates de e-mail no design system
• SPEC-0033 — Interface do SaaS admin no design system
• SPEC-0034 — Isolamento de tenant e de imobiliária, e login sem credencial pré-preenchida
• SPEC-0035 — Autorização: fechar os portões, sanear as permissões, e o menu obedecer a elas
• SPEC-0036 — O passo de analisar, e o caminho de volta para a imobiliária
• SPEC-0037 — Pendências tipificadas na análise de crédito, e um histórico que diz o que mudou
• SPEC-0038 — Emissão da garantia e a espera pela assinatura
• SPEC-0039 — Emitir a garantia conferindo, e sem poder divergir da análise
• SPEC-0040 — Assinou, fecha o dossiê: alterar arquivo vira exceção nomeada e visível
• SPEC-0041 — A Equipe passa a administrar de verdade: no celular, sem 403, e sem mudar acesso em silêncio
• SPEC-0042 — Tutoriais em vídeo, e onde encontrá-los
• SPEC-0043 — Ninguém consegue dizer que versão está no ar, nem o que mudou nela
• SPEC-0044 — O que mudou não cabe onde está sendo contado
• SPEC-0045 — Assuntos, navegação e a versão certa para cada aparelho
• SPEC-0046 — Documento e telefone com máscara, e erro de formulário que a pessoa consegue ler
• FIX-0002 — Zoom automático no mobile ao focar qualquer campo
• FIX-0003 — A API responde antes de comitar a transação
• FIX-0006 — Erros encontrados na jornada da análise de crédito
• FIX-0007 — Documento do cadastro do inquilino aparece como "Entregue" numa análise recém-criada, sem nenhuma pista de que veio de antes
• FIX-0008 — A caixa azul do passo Documentos afirma o que o sistema não faz
• FIX-0009 — A aprovação pede num modal o que a tela já mostra, e o setup é um campo vazio sem referência
• FIX-0010 — O anexo grande não sobe, e o que subiu quebrado abre em branco
• FIX-0012 — A tela decide com dado que não é dela: identidade congelada, e formulário preenchido pelo navegador
• FIX-0014 — No celular, a Ajuda esconde metade do índice atrás de um gesto que a tela não anuncia
• FIX-0021 — Seletor de parceira só alcança a primeira página, e em Inquilinos nem a busca resolve
• FIX-0022 — A faxina do e2e e quatro specs falam com um container de banco que não existe mais
• SPEC-0048 — Geração automática de cobranças e tela de gestão
• SPEC-0049 — Remoção lógica e recuperação: imobiliária, inquilino, imóvel, análise de crédito, garantia e cobrança
• SPEC-0050 — Consulta ao Boa Vista (Cadastro Positivo) na análise de crédito, configurável por tenant
• SPEC-0051 — Usuários da imobiliária: quem tem acesso, e como tirá-lo
• SPEC-0052 — Catálogo de consultas de crédito configurável, com custo e conciliação (API Full)
• SPEC-0053 — Central de ajuda na ordem da jornada: tudo visível, busca e capítulos ao lado do vídeo
• SPEC-0054 — Cobrança com tipo, canal e parcela, e o resumo do mês que hoje mora na planilha
• SPEC-0055 — O acerto com a imobiliária: o que ela recolheu, o que repassou, e o mês fechado
• SPEC-0056 — A taxa de adesão: da imobiliária, por imobiliária, e de volta como comissão
• SPEC-0057 — A mensalidade da garantia: uma faixa por tipo de tomador, escolhida na aprovação

Falta¶

• A suíte e2e inteira roda só sob pedido (política de testes do CLAUDE.md); não há execução agendada.