# DF Test Data Generator: gerar dados de teste no PrestaShop

> Instalação, definições, geração, relatório de desempenho, limpeza e linha de comandos do gerador de dados de teste DataFirefly para PrestaShop 8 e 9.

- Página: <https://www.datafirefly.com/pt/documentation/dftestdata/>
- Idioma: pt
- Atualizado em: 2026-09-30
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/dftestdata/index.md), [en](https://www.datafirefly.com/en/documentation/dftestdata/index.md), [es](https://www.datafirefly.com/es/documentation/dftestdata/index.md), [de](https://www.datafirefly.com/de/documentation/dftestdata/index.md), [it](https://www.datafirefly.com/it/documentation/dftestdata/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftestdata/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftestdata/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

O DF Test Data Generator enche uma loja PrestaShop 8 ou 9 com um catálogo, clientes e histórico de encomendas fictícios mas realistas, e depois elimina exatamente o que criou. Serve para testar um servidor, um tema ou um módulo com volumes próximos da produção.

**Apenas lojas de teste.** Os dados gerados aparecem como produtos, clientes e encomendas reais. Use o módulo numa loja de pré-produção, numa cópia de staging ou num ambiente local, nunca numa loja aberta ao público.

## Instalação

1. Em **Módulos > Gestor de módulos**, clique em **Carregar um módulo** e envie o ficheiro `dftestdata.zip`.
2. O módulo cria duas tabelas de rastreio e um separador em **Parâmetros avançados > Dados de teste**.
3. O botão **Configurar** do gestor de módulos abre a mesma página.

Requisitos: PrestaShop 8.0 a 9.x, extensão PHP GD para as imagens (sem GD, os produtos são criados sem imagem). Para as avaliações de produtos, o módulo nativo **Comentários de produtos** (productcomments) tem de estar instalado.

## Lançar uma primeira geração

1. Escolha uma predefinição: **Pequeno** (50 produtos, 50 clientes, 100 encomendas), **Médio** (200, 300, 800), **Grande** (2000, 5000, 15 000) ou **Teste de carga** (20 000, 50 000, 150 000).
2. Ajuste os valores se necessário. O painel **Volume estimado** atualiza-se em direto: combinações, ficheiros de imagem, linhas de encomenda e duração estimada.
3. Marque **Confirmo que esta é uma loja de teste ou de pré-produção** e clique em **Iniciar a geração**.

A geração corre em lotes de 6 segundos. Durante a execução vê a barra de progresso, os contadores por etapa, a velocidade e o tempo restante. O botão **Pausa** para de forma limpa após o lote em curso; pode retomar de imediato ou mais tarde a partir do histórico. Se fechar a página, a geração é interrompida e pode ser retomada.

O formulário assinala as definições incoerentes antes do arranque, por exemplo encomendas sem nenhum cliente gerado. O botão fica desativado enquanto houver alguma.

## Definições disponíveis

### Catálogo

- **Categorias e marcas**: distribuídas por 8 universos, marcas com logótipo gerado.
- **Produtos**, **% com combinações** e **combinações máx. por produto** (tamanho, número de calçado, cor).
- **Packs**: packs nativos de 2 a 4 produtos gerados, cerca de 15 % mais baratos do que a soma dos artigos.
- **% de produtos virtuais**: cartão presente, guia digital, workshop online, extensão de garantia.
- **Imagens por produto** (0 a 3), **% em promoção**, intervalos de preço e de stock, regra de imposto (por defeito, a taxa normal do país da loja).
- Opções: características para a pesquisa por facetas, indexação para o motor de pesquisa.

### Clientes

- **Número de clientes**, **% de convidados**, **% com segunda morada**, **% de profissionais**.
- **Países dos clientes**: França, Reino Unido, Espanha, Alemanha, Itália, Países Baixos, Polónia, Portugal. Nomes, moradas, códigos postais e telefones seguem o formato de cada país.
- **Grupo profissionais**: os clientes profissionais entram num grupo «Profissionais (test)» com preços sem IVA e desconto ajustável, e as suas moradas têm um NIF intracomunitário.

### Encomendas

- **Número de encomendas** e **período** (de / até), **produtos máx. por encomenda**.
- **Distribuição de estados**: realista, maioritariamente entregues ou maioritariamente pendentes.
- **% com cupão**: são criados três códigos de teste (-10, -15, -20 %) que ficam ativos durante um ano.
- **% com mensagem do cliente**: uma troca de pergunta e resposta com o apoio ao cliente, no idioma do cliente.
- **Carrinhos abandonados**, nos últimos 45 dias.
- Opções: encomendar também produtos existentes do catálogo, criar as faturas das encomendas pagas, encomendar na moeda local do cliente (GBP, PLN, CHF, USD) quando a loja a disponibiliza.

### Avaliações e estatísticas

- **Avaliações de produtos**: escritas no idioma do cliente, sobretudo de 4 e 5 estrelas.
- **Visitantes**: cada visitante regressa uma a três vezes a partir de um motor de busca, de uma rede social, da newsletter ou diretamente. O painel mostra então visitas, taxa de conversão e fontes de tráfego.

### Semente aleatória

Deixe vazio para uma semente automática. Com a mesma semente e as mesmas definições na mesma loja obtém exatamente o mesmo conjunto de dados.

## O que contêm as encomendas

As encomendas são escritas diretamente nas tabelas do núcleo, sem módulo de pagamento e sem email. Cada uma tem as suas linhas, impostos, transportadora escolhida pela zona, portes, histórico de estados datado, pagamento e, se a opção estiver ativa, fatura. As encomendas reembolsadas recebem uma nota de crédito. As encomendas validadas alimentam os mais vendidos e o stock dos produtos é respeitado: os artigos em stock são escolhidos primeiro.

Todos os clientes de teste têm um endereço `@example.com` e a mesma palavra-passe, indicada no painel Como funciona, para testar a conta de cliente na loja.

## Histórico e relatório de desempenho

Cada geração aparece no histórico com o estado, os volumes e a duração. O botão **Detalhes** mostra as definições usadas e o relatório do servidor: número de registos, milissegundos por registo e registos por minuto em cada etapa, tempo de trabalho total e pico de memória PHP. O botão **Usar estas definições** volta a carregar a configuração no formulário.

Para comparar dois servidores ou duas configurações, lance a mesma predefinição com a mesma semente em cada um e compare as colunas ms por registo.

## Limpar os dados de teste

O botão **Limpar** numa linha do histórico elimina os dados dessa geração. O botão **Limpar todos os dados de teste** elimina os de todas as gerações da loja atual. Só são eliminados os objetos criados pelo módulo, por esta ordem: visitas, avaliações, encomendas (com faturas, notas de crédito e mensagens), carrinhos, cupões, moradas, clientes, grupo profissionais, produtos e packs, marcas, categorias, grupos de atributos e características. O stock retirado por encomendas dos seus produtos existentes é reposto.

Limpe antes de desinstalar o módulo. A desinstalação apaga as tabelas de rastreio e os dados restantes deixariam de poder ser identificados.

## Linha de comandos

Para volumes muito grandes ou um ambiente automatizado, lance o gerador a partir da raiz da loja:

```
php modules/dftestdata/cli.php --preset=large --shop=1 --confirm-test-shop
php modules/dftestdata/cli.php --preset=small --orders=2000 --locales=fr,de --confirm-test-shop
php modules/dftestdata/cli.php --resume=12 --shop=1
php modules/dftestdata/cli.php --purge=all --shop=1
php modules/dftestdata/cli.php --list --shop=1
php modules/dftestdata/cli.php --help
```

Cada valor do formulário tem a sua opção (`--products`, `--customers`, `--orders`, `--packs`, `--visits`, `--voucher-pct`...). A opção `--confirm-test-shop` é obrigatória para gerar. O relatório de desempenho é apresentado no fim.

## Multiloja

Selecione uma única loja no contexto multiloja antes de gerar ou limpar. Cada geração fica associada à loja em que foi lançada.

## Perguntas frequentes

### A geração para com erros

Após 25 erros consecutivos, a geração passa ao estado «Falhou» e mostra as últimas mensagens. Corrija a causa (muitas vezes um módulo de terceiros que reage à criação de produtos ou clientes) e clique em **Retomar** no histórico.

### As avaliações não estão disponíveis

O campo fica desativado se o módulo Comentários de produtos não estiver instalado. Instale-o, recarregue a página e o campo fica ativo.

### As encomendas não estão em libras nem em zlótis

A moeda local só é usada se estiver instalada e ativa na loja. Adicione-a em **Internacional > Localização > Moedas** antes de gerar.
