Manual do Usuário

Versão de preparação: o briefing local já funciona. Login, salvamento em nuvem e agentes de IA ainda não estão ativos.

O objetivo futuro do JOHN | VENTURES é ajudar você a estruturar, criar e operar negócios com apoio de inteligência artificial, sempre sob a sua supervisão. Esse produto completo ainda não existe nesta versão.

Hoje o sistema não cria empresas, não publica sites e não gera conteúdo com IA. As telas futuras já aparecem no menu para explicar o propósito de cada parte, mas elas não executam essas funções. Conseguir abrir uma tela não significa que exista um agente trabalhando por trás dela.

• O que você já consegue fazer: preparar um briefing do seu negócio, revisar suas respostas, baixar um backup no seu próprio dispositivo e reabrir esse backup depois.
• O que ainda não acontece: entrar com login, salvar na nuvem, receber diagnóstico, plano, tarefas ou entregas produzidas por IA.
• Nada aqui promete faturamento, resultado comercial ou sucesso de um negócio.

1. Abra a tela Visão geral.
2. Escolha “Quero criar um negócio” ou “Quero organizar um negócio existente”.
3. Preencha o que você já sabe. Não é preciso responder tudo.
4. Avance pelas 5 etapas usando “Próxima”; volte com “Anterior” quando quiser corrigir.
5. Chegue à Revisão e confira todas as respostas; use os atalhos para voltar a um campo.
6. Exporte o arquivo JSON e confirme na pasta de downloads que ele foi mesmo salvo antes de fechar a aba.

Criar um negócio aqui significa preparar um rascunho de briefing. Não abre empresa, não registra marca, não contrata nada e não publica aplicativo.

O formulário começa vazio de propósito: nenhum exemplo é inserido automaticamente para você não confundir texto de demonstração com informação sua.

Todo campo em branco é registrado como “Não informado”. Você pode avançar, revisar e exportar mesmo com respostas faltando.

Etapa 1 — Identificação: nome e descrição

Nome do negócio: como você chama o projeto hoje, até 120 caracteres. Descrição: em poucas linhas, o que o negócio faz ou pretende fazer (até 50000 caracteres).

Etapa 2 — Problema e público

Problema que resolve: a dor concreta de quem vai pagar (até 2000 caracteres). Público-alvo: quem é essa pessoa ou empresa (até 50000 caracteres).

Etapa 3 — Oferta e receita

Oferta: o que exatamente é entregue ao cliente. Modelo de receita: como entra dinheiro (venda avulsa, assinatura, comissão, serviço). Ambos até 500 caracteres.

Etapa 4 — Objetivo e estágio

Objetivo principal: o que você quer alcançar primeiro (até 500 caracteres). Estágio atual: escolha entre Não informado, Ideia, Em validação, Operando (início) e Operando (estável). O padrão é “Não informado” — o sistema não presume que seu negócio é apenas uma ideia.

Etapa 5 — Recursos e limites

Orçamento disponível e moeda, disponibilidade semanal (até 120 caracteres) e restrições, como prazos, regras do seu setor ou coisas que você não quer fazer (até 2000 caracteres).

• Orçamento aceita dois formatos: 1.500,50 (padrão brasileiro) ou 1500.50 (decimal simples). Não escreva “R$”, texto ou sinais.
• O campo de valor aceita até 30 caracteres e o teto é 1.000.000.000.000.
• A moeda (BRL, USD ou EUR) é escolhida à parte e fica registrada junto com o valor. Não existe conversão automática entre moedas.
• Orçamento em branco significa “desconhecido”, e isso é diferente de zero.
• Se o formato ou o tamanho estiver errado, aparece uma mensagem no próprio campo; corrija ali e siga.

Depois da quinta etapa vem a Revisão, com todas as respostas em uma lista legível. De lá você volta direto ao campo que quiser ajustar ou exporta o arquivo.

Existe UM rascunho por aba do navegador, guardado só na memória daquela sessão. Não é uma lista de empresas cadastradas.

• Você pode navegar entre os menus à vontade: o rascunho continua na sessão.
• Recarregar a página, fechar a aba ou abrir em outro dispositivo NÃO recupera o conteúdo automaticamente.
• Exportar em JSON é o backup que pode ser reaberto depois nesta mesma tela.
• Exportar em Markdown gera um texto para ler ou compartilhar; ele NÃO pode ser reimportado aqui.
• Guarde os arquivos no seu dispositivo usando um nome com o negócio e a data. O sistema não renomeia nem organiza nada por você.
• Toda vez que editar algo importante, exporte uma cópia nova.
• O aviso do navegador ao sair da página depende do navegador e não é garantia de nada.
• O aplicativo não consegue confirmar se o download foi realmente salvo; confira o arquivo na sua pasta.

Se você fechou a aba sem exportar, não há como recuperar o conteúdo: ele não foi enviado a lugar nenhum.

1. Abra a tela do briefing.
2. Use “Reabrir JSON exportado”.
3. Escolha um arquivo JSON gerado por este próprio aplicativo.
4. O arquivo precisa ter no máximo 256 KiB.
5. Se já houver conteúdo no rascunho atual, confira a prévia e confirme a substituição — ou cancele.
6. Revise os dados carregados antes de continuar preenchendo.

• Essa leitura acontece no seu dispositivo. Não é envio de anexo para a nuvem.
• Se o arquivo for inválido, o rascunho atual continua intacto. Procure uma cópia válida — não existe e não deve existir opção de desligar a validação.
• Um arquivo Markdown não pode ser reaberto como JSON.
• “Limpar rascunho” pede confirmação em “Apagar rascunho”. Isso apaga o conteúdo da sessão; cancelar preserva tudo. Exporte um backup antes.

Para cada tela, o propósito é uma coisa e o que ela faz hoje é outra. Nenhuma delas mostra clientes, números ou atividade de exemplo.

Visão geral

Propósito: ponto de partida e resumo do que está pronto. Hoje: mostra o estado real da configuração e leva ao briefing.

Meus negócios

Propósito: lista dos seus negócios. Hoje: não existe cadastro permanente; só o rascunho da sessão atual.

JOHN

Propósito: o coordenador que conversa com você e distribui trabalho. Hoje: inativo, aguardando configuração.

Tarefas

Propósito: acompanhar o que os agentes estão fazendo. Hoje: não executa nenhuma tarefa.

Aprovações

Propósito: você aprovar ou recusar o que foi produzido. Hoje: não há decisão registrada em servidor.

Entregas

Propósito: guardar os materiais produzidos e suas versões. Hoje: não há geração nem histórico.

Integrações

Propósito: mostrar o que precisa ser conectado por um responsável técnico. Hoje: orientação e estado documentado; nenhum botão do aplicativo conecta serviços.

Configurações

Propósito: preferências, convites, limites e pausa da operação. Hoje: nada disso está ativo.

Manual

Esta página: explica o que existe hoje e o que ainda está por vir.

Diretrizes

São as regras de trabalho de cada agente: o que ele pode fazer, o que nunca pode inventar e quando precisa perguntar. Ficam escritas dentro do próprio sistema e têm número de versão.

Modelo

É quem processa o texto e devolve a resposta. As diretrizes dizem como trabalhar; o modelo é quem faz o trabalho.

Integração (API)

É o caminho de comunicação entre este sistema e o modelo. Sem esse caminho configurado no servidor, nenhuma resposta é gerada.

Banco de dados

É a memória: guarda seu briefing, as entregas, as tarefas e o histórico. Sem ele, nada do que a IA produzir fica salvo.

A integração usada aqui é nativa da plataforma, então você não precisa cadastrar uma chave própria de IA. Isso não quer dizer que seja gratuito ou ilimitado: continua existindo um serviço, um modelo e um consumo por uso, que o sistema registra a cada execução.

• As diretrizes dos três primeiros agentes (JOHN, Estratégia e Marketing) já estão escritas no sistema.
• Existe também um perfil especializado: JOHN | INVESTIDOR PRO — diretrizes preparadas. Ele é educativo sobre o mercado financeiro brasileiro: explica conceitos e método, não indica onde investir, não promete retorno e não movimenta dinheiro. Depende da mesma ativação (login e banco) e ainda não está ligado.
• A base de mercado usada por esse perfil tem data de referência de janeiro de 2025: serve como referência histórica e precisa ser conferida em fonte oficial antes de virar decisão.
• A comunicação com o modelo já está implementada no servidor e foi verificada com uma chamada técnica de teste, com dados inventados só para o teste.
• O uso no dia a dia ainda depende de login e banco de dados: sem eles não há como saber de quem é o negócio nem onde guardar o resultado.
• Nenhum texto gerado por IA é publicado, enviado ou aprovado automaticamente. Aprovação é sempre sua.

Disponível agora

Navegação pelas telas, briefing em 5 etapas, revisão, exportação em JSON e Markdown e reabertura local do JSON.

Ainda não implementado / aguardando configuração

Banco de dados exclusivo do projeto, login, salvamento em nuvem, arquivos privados, serviço real de IA, tarefas, entregas, aprovações, auditoria e os testes de isolamento entre contas.

Planejado

Ampliação da equipe de agentes, acompanhamento de custos por execução e histórico completo de versões.

Conectar o banco de dados sozinho não liga tudo automaticamente: cada parte acima ainda precisa ser construída e verificada depois disso.

Na visão futura, JOHN coordena o trabalho, o agente de Estratégia analisa o negócio e o de Marketing produz rascunhos de material. Produto, Comercial e Operações estão planejados.

O caminho ideia → diagnóstico → plano → tarefas → entregas → revisão → aprovação → execução → resultados é o desenho PLANEJADO do produto. Não é um passo a passo que você consiga seguir hoje.

• Nunca escreva senhas, chaves, tokens, dados bancários ou dados pessoais sensíveis nos campos do briefing.
• Esta versão não é uma área autenticada e privada: não existe login nem separação de contas.
• Os arquivos que você exporta ficam sob sua responsabilidade. Tenha cuidado extra em computador compartilhado.
• O rascunho vive apenas na sua aba. Ele não é enviado a servidor nem compartilhado com outras pessoas — e também não fica guardado quando a aba fecha.

No produto futuro, aprovar um conteúdo não significa publicar nem enviar para ninguém; a IA não aprova as próprias ações; e cada aprovação fica presa à versão exata que foi revisada. Esses controles ainda NÃO estão implementados.

Por que “Salvar no sistema” está bloqueado?

Porque não existe banco de dados nem login conectados. Salvar de mentira seria pior: use “Exportar JSON” para guardar seu trabalho.

Por que o JOHN não responde?

O coordenador ainda não foi ligado a um serviço de IA. A tela existe para explicar o propósito, não para conversar.

O sistema já cria empresas ou sites sozinho?

Não. Hoje ele apenas ajuda a organizar as informações do negócio.

Meu rascunho sumiu

Provavelmente a página foi recarregada ou a aba fechada. Reabra o último JSON exportado. Sem esse arquivo, o conteúdo não pode ser recuperado.

Meu orçamento foi recusado

Escreva só números, em 1.500,50 ou 1500.50, sem “R$”, sem espaço e sem sinal. A moeda é escolhida no campo ao lado.

Arquivo inválido ou grande demais

Use preferencialmente o JSON exportado pelo app, com até 256 KiB. Arquivos Markdown, arquivos acima do limite e JSON com estrutura ou valores incompatíveis são recusados — e o rascunho atual continua como estava. Editar manualmente pode tornar o arquivo inválido; mantenha uma cópia original.

Onde vejo meus negócios depois?

Por enquanto, nos arquivos que você exportou. A lista permanente só existirá quando o banco de dados e o login estiverem ativos.

Posso usar no celular?

Sim, as telas funcionam em tela pequena. Confirme onde o navegador do celular salva o arquivo exportado.

Preciso pagar agora?

Não há cobrança nem catálogo de planos ativos nesta versão. Isso não é promessa de que o serviço será gratuito no futuro.

O manual está diferente do que eu vejo

Confira se você está na versão em desenvolvimento ou na versão publicada, que podem estar em pontos diferentes. Antes de recarregar qualquer tela para conferir, exporte o briefing.

Dúvidas sobre o que falta conectar são assunto do responsável técnico: a tela Integrações mostra o estado documentado. As conexões de serviços são configuradas pelo responsável técnico em fluxo seguro. Não coloque senhas, chaves ou tokens nos campos de briefing. Consulte Integrações para entender as dependências.

Briefing

O conjunto de respostas que descreve o seu negócio.

Rascunho

O briefing em andamento, guardado só na aba aberta.

Exportar

Baixar o conteúdo como arquivo no seu dispositivo.

JSON

Formato de arquivo que o aplicativo consegue ler de volta.

Markdown

Formato de texto simples para ler ou compartilhar; não é reimportável aqui.

Agente

Assistente de IA com uma função definida. Nenhum está ativo hoje.

Entrega

Material produzido por um agente. Ainda não existe.

Aprovação

Sua decisão registrada sobre um material. Ainda não existe.

Espaço de trabalho

Área futura que separa os dados de cada conta ou equipe.