No tutorial passo a passo · Módulo 1

Abrir o aplicativo e criar o projeto

Você terá um projeto ativo, com pasta própria, dimensões definidas e os módulos analíticos visíveis.

Organização recomendada

A estrutura abaixo separa o que é imutável (os arquivos brutos) do que é derivado (o corpus e os resultados), que é a distinção que mais economiza tempo meses depois:

Estrutura interna gerada pelo SciForesight

E:\projs_biblio\200-proj-guide\
├── proj_guide.yml              # manifesto YAML do projeto e framework multidimensional
├── proj_guide_data/            # exportações brutas (Scopus CSV, WoS TXT, refs)
│   ├── scopus_sources_combinado.csv
│   ├── scopus_references_combinado.csv
│   ├── wos_sources_combinado.csv
│   └── wos_references_combinado.csv
├── proj_guide_utils/           # prompts de IA gerados e saídas intermediárias
│   ├── prompts_to_parse_references.txt
│   └── refs_structured.txt
└── proj_guide_db.duckdb        # banco de dados relacional DuckDB local

Nunca edite manualmente o banco DuckDB ou os arquivos brutos

Abrir uma exportação no Excel e salvar por cima é a forma mais rápida de tornar um estudo irreproduzível: separadores mudam, zeros à esquerda somem, acentos quebram. Toda a transformação deve ser operada pelos módulos de ingestão e refinamento do SciForesight.

O arquivo de método

Um arquivo de texto simples no topo da pasta resolve quase todo problema de rastreabilidade. Registre nele:

a expressão de busca completa, por base;
a data em que a busca foi executada;
filtros aplicados na exportação;
parâmetros de deduplicação e desambiguação;
decisões manuais — quais entidades foram unificadas ou separadas à mão, e por quê.

Versionamento

Projetos de prospecção evoluem: a busca é atualizada, novas bases entram, regras são refinadas. Duas abordagens funcionam bem:

Abordagem	Quando usar	Cuidado
Datar a pasta do projeto	Estudos pontuais com entregável fechado	Ocupa mais espaço, mas mantém cada entrega intacta.
Ingestão incremental na mesma pasta	Monitoramento contínuo de um tema	Exige anotar cada atualização no arquivo de método.

Sincronização automática e arquivos grandes

Pastas de projeto em serviços de sincronização podem ser corrompidas se o cliente tentar sincronizar índices enquanto o SciForesight escreve neles. Feche o aplicativo antes de sincronizar, ou mantenha o projeto fora da pasta sincronizada e faça a cópia ao final. Vale lembrar também que sincronizar o corpus para a nuvem contraria a premissa local-first descrita em Conceitos fundamentais — e pode conflitar com a política de dados da sua organização.

Trabalho em equipe

Não há edição simultânea: o projeto é um diretório local, e duas pessoas escrevendo nele ao mesmo tempo geram conflito. O padrão que funciona é dividir por escopo — cada analista com seu projeto e seu recorte — e consolidar os resultados na etapa de relatório. Para reproduzir o trabalho de outra pessoa, o que precisa ser compartilhado é a pasta 01-brutos/ junto do arquivo de método; o corpus pode ser reconstruído a partir disso.

Backup

Como tudo é local, o backup é responsabilidade sua. Priorize 01-brutos/ e o arquivo de método: com eles, qualquer corpus e qualquer figura podem ser refeitos. A pasta do projeto acelera a retomada, mas não é insubstituível.