SignuDoc

SignuDoc: copie o prompt e instale.

O que é este material

O prompt pronto para colar no Claude, o botão Deploy to Vercel e o passo a passo para instalar o SignuDoc na sua própria conta.

O que é o SignuDoc

Um app de assinatura de documentos, de código aberto. Roda na sua conta da Vercel, com a sua logo. Você sobe o PDF, marca onde assinar, envia o link, e a pessoa assina pelo celular, sem criar conta. No final, todo mundo recebe o PDF selado e um certificado de auditoria.

O repositório está em github.com/NYLLON-SOFTWARE/SignuDoc.

Do que você precisa

  • Uma conta no GitHub
  • Uma conta na Vercel, conectada a esse GitHub
  • Para uso pessoal, o plano Hobby da Vercel serve. Para clínica ou empresa, use o plano Pro.
  • Na instalação, a Vercel cria três serviços no plano gratuito de cada um: Resend (e-mail), Neon (banco Postgres) e Vercel Blob (arquivos, privado)
  • Um domínio próprio é opcional no começo. Sem ele, você testa enviando um documento para o e-mail da sua conta Resend

Caminho 1. Colar o prompt no Claude

Abra o Claude, cole o texto abaixo e deixe ele te guiar. Ele pede algumas informações, abre o deploy e te avisa quando você precisa entrar na conta ou criar a senha.

Cole no Claude
Você vai me ajudar a instalar o SignuDoc na minha conta da Vercel, passo a passo.

Siga o guia oficial para agentes:
https://github.com/NYLLON-SOFTWARE/SignuDoc/blob/main/docs/deploy-with-an-agent.md

Repositório:
https://github.com/NYLLON-SOFTWARE/SignuDoc

Antes de começar, me pergunte:
1. Se o uso é pessoal ou de clínica/empresa. O plano Hobby da Vercel é só para uso pessoal. Clínica ou empresa precisa do plano Pro.
2. O domínio de onde o e-mail deve sair, por exemplo meudominio.com. O guia sugere um subdomínio sign., como sign.meudominio.com. Se eu ainda não tiver domínio, siga com o padrão do Resend e deixe o e-mail para depois.
3. O nome da organização, como quem assina deve ver.
4. O e-mail de suporte, para quem assina e a equipe pedirem ajuda.
5. Meu nome e e-mail de administrador. A senha eu crio sozinho, ou uso o meu gerenciador de senhas se eu pedir.
6. Se eu quero testar o e-mail antes de verificar o domínio. Se sim, deixe o campo de remetente vazio na configuração.

Regras:
- Se aparecer tela de login, senha, código ou passkey, pare e peça para eu entrar.
- Nunca digite senha, código ou passkey por mim, a menos que eu peça isso.
- Nunca pague, faça upgrade ou inicie teste pago sem o meu ok. Se eu recusar o Pro em uso de clínica ou empresa, pare.
- Neon, Resend e Vercel Blob: escolha o plano gratuito. Se alguma tela pedir cartão, plano pago ou upgrade, pare e me pergunte.
- Nunca apague projeto, banco, repositório ou armazenamento para "começar de novo". Se algo der muito errado, pare e me avise.
- Nunca copie segredo, chave, senha ou URL de banco para o chat, arquivo ou mensagem.
- Faça um passo de cada vez e confira o resultado na tela antes de seguir.

Quando eu responder, abra este endereço (é o botão Deploy to Vercel do README):

https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FNYLLON-SOFTWARE%2FSignuDoc&project-name=signudoc&repository-name=signudoc&stores=%5B%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%22resend%22%2C%22productSlug%22%3A%22resend-email%22%2C%22protocol%22%3A%22messaging%22%7D%2C%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%22neon%22%2C%22productSlug%22%3A%22neon%22%2C%22protocol%22%3A%22storage%22%7D%2C%7B%22type%22%3A%22blob%22%2C%22access%22%3A%22private%22%7D%5D

Siga nesta ordem:
1. Peça para a Vercel copiar o SignuDoc para a minha conta do GitHub, com o nome signudoc, a menos que já esteja em uso. Repositório privado pode. Se o GitHub pedir autorização, passkey ou código, passe para mim.
2. Adicione os três serviços no plano gratuito, nesta ordem: Resend (e-mail; use o domínio que eu informar, por exemplo sign.meudominio.com), Neon (banco Postgres, na região mais próxima de mim) e Vercel Blob (arquivos; deixe privado).
3. Clique em Deploy e espere. Costuma levar de 2 a 4 minutos. Se aparecer "One or more integration resources failed to provision", espere 60 a 120 segundos, atualize a página, confira em Storage se Resend, Neon e Blob estão listados, abra Deployments, no menu (⋯) do deploy que falhou clique em Redeploy. Se falhar do mesmo jeito, espere 3 a 5 minutos e tente de novo. Depois de 3 tentativas, pare e me diga a mensagem e o horário. Se o build falhar com log, não fique tentando de novo: copie as últimas 30 linhas do log e me entregue.
4. Abra o site de produção na hora. Quem abre primeiro fica dono da instalação. Se abrir em /setup, siga. Se pedir para conectar um banco, em Storage conecte o Neon à Production, faça Redeploy e recarregue o site.
5. Na página de setup, preencha o nome da organização e o e-mail de suporte. Confira o campo Send email from. Se eu quiser testar o e-mail antes de verificar o domínio, deixe esse campo vazio. Peça para eu digitar a senha. Não invente senha e não a guarde.
6. Em Settings, Organization, confira o e-mail. Se aparecer "Email is not connected", faça um Redeploy e recarregue. Se listar registros DNS ainda não verificados, me entregue a lista para eu adicionar onde o domínio é gerenciado. Isso pode levar de minutos a algumas horas.

No fim, me diga: o endereço do site, o repositório no GitHub, se o e-mail já está verificado, quais registros DNS ainda faltam e o que você não conseguiu fazer.

Pode começar pelas perguntas.

Caminho 2. Instalar pelo botão Deploy to Vercel

  1. Clique no botão, entre na Vercel e deixe ela copiar o repositório para o seu GitHub.
  2. Adicione, no plano gratuito de cada um, nesta ordem: Resend (e-mail), Neon (banco Postgres, na região mais próxima) e Vercel Blob (arquivos, deixe privado).
  3. Clique em Deploy. Se aparecer "One or more integration resources failed to provision", espere um ou dois minutos, atualize a página e clique em Redeploy.
  4. Abra o site novo na hora: quem abre primeiro vira o administrador. Preencha o nome da organização, o e-mail de suporte e crie a primeira conta.
  5. Em Settings, Organization, preencha o endereço de envio no seu domínio. O site lista os registros DNS para você adicionar. Enquanto esse campo estiver vazio, o e-mail chega só no endereço da sua conta Resend, então você já consegue testar enviando um documento para você mesmo.

Testar no computador

Com Node.js 24 e Docker:

Comandos
npm install
cp .env.example .env
npm run db:start   # Postgres in Docker, with the schema applied
npm run dev        # SignuDoc at http://localhost:3000

O app abre em http://localhost:3000. Os arquivos ficam no disco e os e-mails vão para `.data/outbox`, sem precisar de conta externa.

O botão Deploy to Vercel não pede nenhuma variável: a Vercel liga o banco, o armazenamento e o e-mail sozinha. No computador, estas três são as que o desenvolvimento local precisa:

Variáveis do desenvolvimento local
DATABASE_URL=postgres://signudoc:signudoc@127.0.0.1:5432/signudoc

APP_URL=http://localhost:3000

EMAIL_DRIVER=capture

Depois de instalar

Para testar na hora, deixe "Send email from" vazio e envie o primeiro documento para o e-mail da sua conta Resend.

  1. Suba o PDF.
  2. Adicione quem assina (até 25 pessoas, em ordem ou ao mesmo tempo) e, se quiser, quem só recebe a cópia.
  3. Marque os campos no documento: assinatura, rubrica, data, nome, texto, número, caixa de seleção, lista e botão de opção.
  4. Envie o link. A pessoa assina pelo celular, com assinatura digitada ou desenhada, sem criar conta.
  5. Quando a última pessoa assina, todos recebem o PDF selado e o certificado de auditoria.

Custo

O SignuDoc em si é gratuito. O botão de deploy usa os planos gratuitos da Vercel, do Neon e do Resend, que suportam cerca de 250 documentos por mês. O plano Hobby da Vercel é só para uso pessoal. Clínica ou empresa usa o plano Pro, que na documentação do projeto custa US$ 20 por mês para quem faz o deploy.

Limites dos planos gratuitos, segundo o repositório:

Limites dos planos gratuitos citados no repositório
ServiçoLimite
Vercel Blob2.000 uploads por mês, cerca de 250 documentos
Resend3.000 e-mails por mês e no máximo 100 por dia
Neon1 GB e 100 horas de computação

Passar do limite não gera cobrança. O serviço para até o mês virar ou, no caso do armazenamento, até você apagar documentos antigos.

Na rotina do médico

Exemplos de documentos para mandar assinar:

  • Contrato com plantonista
  • Contrato de prestação de serviço
  • Termo de cessão de imagem
  • Contrato de locação de sala