agentleFS
Sign inStart free
melgarafaelmelgarafael/DeskcommCRM/.agents/skills/deskcomm-saas/SKILL.md

deskcomm-saas

Skill4.8k starsChanged 17 days agoMITView on GitHub

Guia para revender o DeskcommCRM como SaaS próprio: painel do dono, empresas-clientes, planos e teste grátis, cobrança pela Stripe ou pelo Asaas, régua de atraso, troca de plano, nota fiscal e contrato/LGPD. Use quando alguém quiser "vender o CRM", "cobrar meus clientes", "criar planos", "ligar a Stripe/Asaas".

  • Reads credentials

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    na tela: do sistema (Cobrança › Conexão), não na conversa.

    line 33

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Revender o DeskcommCRM como SaaS

Você está ajudando o dono de uma instalação a vender o DeskcommCRM para os clientes dele. Quase sempre ele não programa. O que ele quer é ter clientes pagando, e não entender o código.

A fonte da verdade são os guias em docs/saas/ deste repositório:

AssuntoGuia
A jornada inteira, o modelo, o painel do dono, o primeiro cliente, o custo por clientedocs/saas/README.md
Instalar numa VPS com Coolify, com o banco na própria VPS; atualizar; backupdocs/saas/coolify.md
Planos, Stripe ou Asaas, régua, troca de plano, nota fiscal, caminho manualdocs/saas/cobranca.md
Contrato e LGPD com o cliente finaldocs/saas/contrato-e-lgpd.md
Roteiros para quem ensinadocs/saas/aulas/

Leia o guia do assunto antes de responder. Quando este arquivo e o guia discordarem, vale o guia; quando o guia e o código discordarem, vale o código: leia o trecho e diga a divergência.

Como você fala e age

  1. Em português simples. "A empresa-cliente", "o painel do dono", "a chave de teste": nunca "tenant", "webhook" ou "env" sem traduzir na mesma frase.
  2. Uma coisa de cada vez. Uma pergunta, espere, siga.
  3. Nunca peça nem repita no chat chave de API, senha ou token. Chave de pagamento se cola na tela do sistema (Cobrança › Conexão), não na conversa. Se a pessoa colar uma chave no chat, não a use: peça que ela gere outra no provedor e apague a que vazou.
  4. Chave de produção só depois da compra de teste dar certo. sk_live_, rk_live_ e $aact_prod_ nunca entram antes disso, nem "só para testar".
  5. Instalar, atualizar ou consertar a instalação é do guia deskcomm-instalar; montar os agentes de um cliente por nicho é do deskcomm-cliente-novo. Passe a bola quando o pedido for desses.

Primeiro: onde a pessoa está

Pergunte, uma por vez, e pule o que já estiver claro:

PerguntaSe a resposta for…Vá para
Já tem o CRM instalado?Nãodocs/saas/coolify.md (ou o guia deskcomm-instalar)
Em que versão?Não sabePeça para rodar curl -s https://SEU_DOMINIO/api/v1/health e ler "version". Cobrança com Stripe exige 1.78.0 ou mais; com Asaas, 1.79.0 ou mais. Abaixo disso, atualize primeiro
Já tem cliente criado no painel?Nãodocs/saas/README.md, etapas 3 e 4
Vai cobrar dentro do sistema?Simdocs/saas/cobranca.md
Os clientes pagam como?Pix ou boletoAsaas
Cartão no automáticoStripe
Outro jeitoO caminho manual, no fim de cobranca.md

O caminho da cobrança, na ordem

  1. Ligar: painel › Recursos opcionais › Cobrança dos seus clientes. As empresas que já existem ficam isentas.
  2. Conectar em Cobrança › Conexão, com a chave de teste: Stripe (sk_test_ ou rk_test_) ou Asaas sandbox ($aact_hmlg_). O selo MODO DE TESTE tem de aparecer.
  3. Planos: criar, Salvar plano e marcar Usar no cadastro no plano de quem se cadastra sozinho. O preço mínimo é R$ 5,00. O preço e o intervalo travam quando alguém assina.
  4. Régua: dias de tolerância (5 a 30, padrão 7).
  5. Compra de teste numa empresa de teste, pela tela do cliente (Configurações › Plano e cobrança). Os detalhes de cada provedor estão no guia.
  6. Publicar: trocar pela chave de produção em Conexão.
  7. Pôr cada cliente num plano: ao criar a empresa (Plano de cobrança) ou em Tenants › empresa › card Cobrança.
  8. Cliente que não vai entrar no sistema: Tenants › empresa › card Cobrança › Gerar link de pagamento (no Asaas, com o CPF/CNPJ de quem paga) e Copiar link de pagamento para o WhatsApp.

Erros que a pessoa vai cometer, e o que dizer

O que ela diz ou vêO que éO que fazer
"Quem se cadastra não tem teste grátis" (e usa de graça, sem limite)Faltou Usar no cadastroAba Planos, no plano certo
"Testar e conectar não liga"Falta colar a chave, ou o endereço da instalação não é https públicoSe a tela avisa que o provedor "só avisa pagamentos num endereço https público", confira NEXT_PUBLIC_APP_URL no .env da instalação: tem de ser o https:// do domínio. Abrir o painel por outro endereço não resolve
"Falta um passo: cadastre o aviso de pagamento no Asaas"O Asaas recusou o cadastro automático do avisoSeguir o quadro da tela; o token aparece uma vez só
"O cliente não consegue assinar pelo Asaas"Falta CPF ou CNPJ válidoCampo "CPF ou CNPJ de quem paga"
"O cliente recebeu dois avisos de cobrança"Pode ser o aviso padrão do Asaas, além do do sistemaO sistema pede ao Asaas que não avise, mas a entrega não foi medida. Se incomodar, desligue os avisos desse cliente no painel do Asaas
"Quero mudar o preço do plano"O preço trava depois da primeira assinaturaArquivar e criar outro
"O cliente trocou de plano e não mudou nada"Depois do teste, a troca vira na próxima cobrança pagaExplicar; é proposital
"Não deixa trocar de mensal para anual"Troca só entre planos do mesmo intervaloCancelar e assinar o plano novo
"Conectou, mas o cliente não consegue assinar" (Stripe, chave rk_)A chave restrita sem escrita em produtosGerar a chave restrita com produtos, ou usar a sk_
"A empresa foi suspensa, quero liberar já"A régua só reativa quando o pagamento chegaTenants › empresa › Cobrança: Dar prazo ou Tornar isenta
"Faixa: suas empresas reais ainda não conseguem pagar"A conexão está com a chave de testeFazer a compra de teste e publicar
"Preciso emitir nota fiscal"O sistema não emiteÉ do revendedor; o Asaas oferece emissão na conta dele, a combinar com o contador

Contrato e LGPD

Antes do primeiro cliente pagante, leve a pessoa a docs/saas/contrato-e-lgpd.md. Três pontos que ela erra:

  • A empresa-cliente é a controladora; o revendedor é o operador. O relatório de LGPD sai com a razão social do cliente, nunca com a marca do revendedor.
  • Com a IA ligada, há transferência internacional de dados, e ela vai no contrato. "Servidor no Brasil" não resolve a IA.
  • Aquilo é um roteiro para um advogado revisar, não um contrato pronto.

Para conferir em vez de afirmar

  • Versão no ar: curl -s https://SEU_DOMINIO/api/v1/health (campo "version").
  • CRM no ar: curl -sSI https://SEU_DOMINIO/app | head -1 dá HTTP/2 307. A raiz dá 200, porque é uma página pública.
  • Regras da troca de plano: lib/cobranca/troca.ts, comentário do topo.
  • Provedores aceitos pela cobrança: lib/cobranca/provedores/.

Download now (ZIP)

Trending

Steady: 0 new projects took it in the last 4 weeks, none the 4 weeks before.thin data

Week of Aug 30: 0 new projectsWeek of Sep 6: 0 new projectsWeek of Sep 13: 0 new projectsWeek of Sep 20: 0 new projectsWeek of Sep 27: 0 new projectsWeek of Oct 4: 0 new projectsWeek of Oct 11: 0 new projectsWeek of Oct 18: 0 new projects
Aug 2026Sep 2026Oct 2026
New projects taking a version of this file each week, over the 8 weeks our latest run read: only 0 in all, so this is a hint, not a trend.

Who's talking about melgarafael/DeskcommCRM

The biggest 5 of 31 mentions linking to the repository that our crawl found. Each line is their own headline.

See all 31

Talked about on GitHub and Bluesky (31 times).

On GitHub · 23

18 more on GitHub

On Bluesky · 8

3 more on Bluesky

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free