# Visão geral dos módulos de referência

> Seis acessos, um inspetor partilhado, cor e identidade, e como os módulos se ligam.

Source: https://loomworld.ai/pt-pt/docs/modules-overview

## Porque existem módulos de referência

Numa obra longa, a parte mais exigente não é digitar. É recordar. Uma personagem secundária que entra no capítulo três não deve mudar de temperamento no capítulo trinta; uma pista plantada no primeiro ato deve ser colhida no quinto ato; “a velha casa de chá” e “a Casa de Chá Yuelai” não devem exigir um teste de memória para serem o mesmo local. Os módulos de referência guardam essas decisões: seis tipos de conteúdo, cada um dedicado a um tipo de facto, cada um citável a partir do rascunho, contabilizado a partir da sua escrita e lido pela IA.

Uma regra prática: o rascunho é o que aconteceu, a biblioteca é o que decidiu explicitamente. Por conseguinte, os registos não crescem sozinhos — à exceção de dois caminhos reais (uma linha de interveniente regista uma personagem, um nome entre parênteses retos regista um objeto), cabe-lhe a si criá-los.

## Seis acessos e o que cada um contém

Personagens

Elenco e mapa de relações: cinco níveis, relações criadas por si, identidade de fação, evolução por capítulo e contagem de presenças.

Locais

Os registos e os mapas mantêm-se separados: o relevo e as anotações em 2D / 3D são guardados de forma independente, enquanto partilham os registos de locais.

Objetos

Objetos que circulam: categoria e etiquetas, cinco níveis de peso narrativo, detentores com a sua relação com o objeto e presenças no manuscrito.

Mundo

Cinco categorias de entradas; a categoria de fações serve também de referência para o elenco, e a barra lateral de tabelas de classificação reside aqui.

Linha do tempo

Múltiplos fios de enredo: fluxo de cartões para a ordem, eixo de escala para anos e durações, eventos associáveis a um ponto do manuscrito.

Prenúncios

O Gestor de prenúncios na página de Ritmo: âncoras para plantar, reforçar e colher, com intervalos e avisos calculados.

Os primeiros cinco módulos têm a sua própria página na navegação à esquerda; os prenúncios residem em Ritmo. Essa página é também o diagnóstico de toda a obra: a Curva de densidade do ritmo sobre os Blocos de cor dos capítulos, o Mapa de calor de presenças das personagens, o Mapa de calor de presenças dos objetos e o painel de prenúncios num único ecrã. A curva combina apenas volume de texto, mudanças de cena, dimensão do elenco, alterações de local e referências a objetos; não avalia onde se situa o clímax.

## Abrir um cartão a partir de qualquer lugar: um inspetor partilhado

Uma etiqueta de referência no texto do mundo, um nome num mapa de calor, um bloco de capítulo sob a curva: todos abrem o mesmo elemento — um inspetor flutuante à direita que apresenta o resumo, o qual pode expandir para o editor completo com “Ver detalhes →”. Personagens, objetos, locais, capítulos e entradas do mundo partilham-no, pelo que basta aprender um único gesto.

- **Espreitar**O inspetor apresenta o que é essencial sobre esse cartão, juntamente com o contexto mínimo, como os seus sublocais diretos. Um cartão sem nome é apresentado como Personagem sem título, Local sem título, Objeto sem título, Tempo e lugar sem título ou Capítulo sem título.

- **Expandir para editar**“Ver detalhes →” abre o editor completo, que continua a ser a gaveta ou janela de diálogo própria de cada módulo.

- **Apenas as personagens usam a gaveta direita**Objetos, entradas do mundo e locais abrem por predefinição uma janela de diálogo centrada. Apenas a ficha da personagem e o respetivo editor de relações mantêm a gaveta direita não modal, para que os possa editar enquanto observa a tela.

## Cor e identidade: mudar de nome é livre, eliminar não

A cor dos objetos, a cor dos capítulos, a cor dos prenúncios e a cor dos locais provêm todas de um seletor de 64 quadrículas (8 matrizes por 8 tonalidades, aberto a partir da amostra atual). Novos objetos, capítulos e prenúncios alternam pela linha central, pelo que raramente precisa de escolher; os locais e os prenúncios permitem limpar a seleção — a partir daí, um local não tem cor e um prenúncio assume a cor de acordo com a importância. As personagens não têm qualquer campo de cor: o nível colore o cartão.

Nomes, pseudónimos, níveis e relações de pertença são guardados como identidade, pelo que mudar um nome nunca exige operações de pesquisar e substituir. O que tem impacto entre módulos é a eliminação: remover uma personagem remove as respetivas linhas de relação, um local ainda referenciado pelo manuscrito não pode ser eliminado e remover um fio de enredo propaga-se aos seus eventos.

## Como os módulos se ligam

Os seis módulos não são ilhas isoladas: as personagens residem em locais e pertencem a fações, os objetos passam de mão em mão, os eventos associam-se a um ponto do manuscrito e indicam o que está envolvido, os prenúncios ancoram-se a capítulos e cenas. Dois tipos de ligação, duas regras:

- Ligações de identidade (personagem–fação, local–origem, cena–local, citação–entrada) guardam o objeto, acompanham alterações de nome automaticamente e estão protegidas contra eliminação.
- Ligações de informação (apontadores entre capítulos, cenas, tempos e lugares, blocos, definições, linhas do tempo e prenúncios) apenas localizam e navegam. Nunca reescrevem o módulo de destino.

As regras completas encontram-se em [Menções de entidades e @](https://loomworld.ai/pt-pt/docs/references) e [Ligações entre módulos](https://loomworld.ai/pt-pt/docs/cross-sync); a aplicação prática de cada módulo está em [Personagens](https://loomworld.ai/pt-pt/docs/module-characters), [Locais](https://loomworld.ai/pt-pt/docs/module-locations), [Objetos](https://loomworld.ai/pt-pt/docs/module-props), [Mundo](https://loomworld.ai/pt-pt/docs/module-lore), [Linha do tempo](https://loomworld.ai/pt-pt/docs/module-timeline) e [Prenúncios](https://loomworld.ai/pt-pt/docs/module-foreshadowing).

## Os limites do sistema

O que estes módulos não fazem: nenhuma avaliação automática da narrativa, nenhum reparo sobre quem esteve fora de cena demasiado tempo, nenhum preenchimento automático de entradas ou categorias e nenhuma decisão sobre quem deve ser o seu protagonista. Cada estatística provém do rascunho que escreveu; cada facto resulta do que guardou.
