InícioDocs para devsComo criar um diário do zero por um módulo
Tutoriais de implementação 2 min de leitura

Como criar um diário do zero por um módulo

Use create pelo formulário table.interface e abra o documento privado criado.

O módulo de diário acrescentou uma página privada do GM e abriu o conteúdo no diário nativo. Gravewright 0.3.0, interface em inglês.
O módulo de diário acrescentou uma página privada do GM e abriu o conteúdo no diário nativo. Gravewright 0.3.0, interface em inglês. · Abrir captura completa ↗

Crie um diário por um módulo comum

Este exercício usa o mesmo pacote Session notebook, sem instalar um segundo módulo. O objetivo é partir da mesa sem diário aberto e criar um documento privado persistente. Para árvore, código completo, ZIP, instalação e ativação, siga Como criar um módulo de diário.

Execute

  1. Baixe o pacote completo, instale em Módulos como proprietário e ative Session notebook1.0.0 em Gravewright → Extensions como GM.

  2. No painel do módulo, preencha Título do diário com Expedição do Farol e clique Criar diário de sessão.

  3. Aguarde a confirmação e abra Journals / Diários. Expedição do Farol aparece na raiz, vazio e privado.

  4. Abra o documento e clique Adicionar seção de sessão para gravar o primeiro rascunho original. Salve o texto pelo editor nativo e reabra o diário.

A chamada pública concreta

A função abaixo é o núcleo de mountCreate, executada com api/context/signal da montagem. O pacote completo inclui formulário, validação, tradução e bloqueio de duplo envio.

javascript
const state = await api.journals.state({}, { signal });
if (signal.aborted) return;
if (context.role !== "gm" || state.is_gm !== true) throw new Error("GM required");
const result = await api.journals.create({
  title: "Expedição do Farol", journal_type: "diary", folder_id: null
}, { requestId: crypto.randomUUID(), signal });
if (signal.aborted) return;
// result.journal_id identifies the created document; result.version is its revision.

Create não aceita um novo tipo de pacote journal nem grava um objeto data inicial neste contrato. Para acrescentar conteúdo, leia a projeção completa GM e faça update como no tutorial principal. A conta criadora recebe acesso de proprietário ao documento; o documento começa privado.

Confira

Abra outra conta como jogador e confirme que o diário privado não é listado. Clique uma vez e confirme que só um documento é criado. Desative antes de a leitura terminar e confirme que create não é enviado. Se a resposta de create se perder, confira o diretório antes de decidir criar outro documento. Não reutilize o UUID de uma operação para um diário diferente.

Como usar a IA para mudar a criação

text
Adapte o formulário mountCreate do pacote example.session-notebook para solicitar um título original e uma pasta já existente no Gravewright0.3.0. Verifique folder_id e as permissões reais do servidor. Preserve a confirmação GM, signal e UUID por operação. Não acrescente data nem campos de manifesto inventados. Entregue código completo e testes para pasta ausente, outra campanha e duplo clique.

Tutorial completo · Todos os tutoriais