========================
3. Projetos e Datasets
========================

Objetivo
========

Criar projetos, subir datasets e validar integridade dos dados antes de modelagem.

Precondicoes
============

1. Usuario com permissao de criar projeto e upload.
2. Arquivo fonte em CSV ou Parquet.

Criar projeto
=============

1. Abrir ``Projects``.
2. Clicar em ``Create Project``.
3. Definir:
   - Nome do projeto.
   - Descricao opcional.
   - Escopo de visibilidade/team se aplicavel.
4. Salvar e confirmar item na lista.

Upload de dataset
=================

1. Abrir ``Datasets`` dentro do projeto alvo.
2. Clicar em ``Upload Dataset``.
3. Selecionar arquivo e metadata opcional.
4. Aguardar status de ingestao finalizado.
5. Abrir detalhe do dataset.

Validar qualidade de dados
==========================

1. Revisar inferencia de schema:
   - Nomes de colunas.
   - Tipos de dados.
   - Nulos por coluna.
2. Revisar contagem de linhas e duplicados.
3. Revisar preview para erro de parsing.
4. Confirmar interpretacao correta de datas/delimitadores.

Checklist de validacao funcional
================================

1. Artifact de dataset criado e visivel.
2. Row count reportado confere com expectativa.
3. Colunas criticas preservam tipo correto.
4. Preview sem deslocamento/truncamento indevido.
5. Reabrir detalhe retorna metadata consistente.

Resultado esperado
==================

1. Projeto e dataset prontos para Builder e Experiments.
2. Versao de dataset disponivel para selecao.

Erros comuns e recuperacao
==========================

1. Upload travado:
   - Repetir com amostra menor.
   - Revisar logs de parser.
2. Tipagem incorreta:
   - Reenviar arquivo com cabecalhos/formatos normalizados.
3. Divergencia de linhas:
   - Validar delimitador, aspas e linhas mal formadas.

Imagens
=======

.. figure:: ../../_static/user-manual/common/projects.png
   :alt: Lista de projetos e criacao
   :width: 90%

   Modulo Projects com criacao e selecao.

.. figure:: ../../_static/user-manual/common/datasets.png
   :alt: Upload e registro de datasets
   :width: 90%

   Registro de datasets com status e metadata.