Gestão de Documentos

A secção de Documentos fornece armazenamento e organização de ficheiros para o seu projeto. Faça upload de ficheiros, organize em pastas e integre com serviços de armazenamento cloud. Todos os documentos relacionados com o projeto vivem aqui, desde assets de design a especificações a gravações de reuniões.

O Problema Que Isto Resolve

Ficheiros de projeto espalham-se por drives pessoais, anexos de email e vários serviços cloud. Encontrar o mockup de design mais recente significa procurar através de emails. Partilhar uma spec requer fazer upload para mais outro serviço. Confusão de versões reina.

Documentos centraliza armazenamento de ficheiros onde o trabalho acontece. Membros da equipa acedem a ficheiros sem perguntar "onde está?" Ficheiros do projeto organizam-se junto com tarefas e discussões, criando uma única fonte de verdade.

O Que Está a Ver

A interface de Documentos apresenta um gestor de ficheiros com funcionalidades modernas:

Barra de Cabeçalho: Toggles de modo de vista (cartão/lista), navegação breadcrumb mostrando caminho da pasta atual, campo de pesquisa e botões de ação para criar pastas e fazer upload de ficheiros.

Barra de Estatísticas: Contagens rápidas de pastas e ficheiros na vista atual, navegação para trás quando dentro de pastas.

Área de Conteúdo: Ficheiros e pastas exibidos em formato de grelha de cartões ou tabela de lista. Suporta arrastar e soltar para uploads e organização.

Modos de Vista

Vista de Cartões

Ficheiros e pastas exibem-se como cartões visuais:

• Ícones de pasta mostram metáfora de contentor
• Cartões de ficheiros mostram ícones de tipo ou thumbnails
• Layout de grelha responsivo ao tamanho do ecrã
• Scanning visual rápido

Alterne vista de cartões usando o ícone de grelha no cabeçalho.

Vista de Lista

Ficheiros e pastas exibem-se numa tabela:

Vista de lista funciona bem para:

• Listagens densas de ficheiros
• Ordenação por colunas
• Navegação rápida por teclado

Alterne vista de lista usando o ícone de lista no cabeçalho.

Navegação de Pastas

Trilho de Breadcrumb

O cabeçalho mostra a sua localização atual:

Documentos > Design > Sprint 23 > Mockups

Clique em qualquer segmento para saltar para esse nível de pasta.

Entrar em Pastas

• Vista de cartões: Clique no cartão da pasta para abrir
• Vista de lista: Clique na linha da pasta para abrir

Voltar Atrás

Navegue para cima usando:

• Botão voltar na barra de estatísticas
• Navegação breadcrumb
• Teclado: Backspace (quando focado)

Fazer Upload de Ficheiros

Arrastar e Soltar

O método mais fácil:

1. Arraste ficheiros do seu computador
2. Solte em qualquer lugar na área de documentos
3. Overlay visual confirma zona de drop
4. Upload começa automaticamente

Múltiplos ficheiros podem ser largados de uma vez.

Botão de Upload

Para upload explícito:

1. Clique no botão "Upload" no cabeçalho
2. Seletor de ficheiros abre
3. Selecione um ou mais ficheiros
4. Upload começa na seleção

Progresso de Upload

Durante upload:

• Notificação toast mostra progresso
• Ficheiros aparecem quando completos
• Uploads falhados mostram notificação de erro

Tipos de Ficheiro

Tipos comuns suportados:

• Documentos: PDF, DOC, DOCX, TXT, MD
• Imagens: PNG, JPG, GIF, SVG, WEBP
• Design: PSD, AI, SKETCH, FIG
• Código: JS, TS, PY, JSON, YAML
• Arquivos: ZIP, RAR, 7Z

Limites de tamanho aplicam-se—verifique definições do workspace para especificidades.

Criar Pastas

Nova Pasta

1. Clique no botão "Criar Pasta"
2. Modal abre para nome da pasta
3. Introduza nome descritivo
4. Clique Criar

A pasta aparece na sua localização atual.

Nomeação de Pastas

Boas práticas:

• Nomes descritivos: "Designs Sprint 23"
• Convenções consistentes: "AAAA-MM Notas de Reunião"
• Evite caracteres especiais

Nota: Criar Pasta pode ser uma funcionalidade Pro.

Operações de Ficheiros

Menu de Contexto

Clique direito em qualquer ficheiro ou pasta para opções:

Ficheiros:

• Pré-visualizar
• Descarregar
• Renomear
• Eliminar
• Mover (se suportado)

Pastas:

• Abrir
• Renomear
• Eliminar

Pré-visualização

Clique num ficheiro para abrir modal de pré-visualização:

• Documentos mostram pré-visualização ou ícone
• Imagens exibem inline
• Botão de download sempre disponível
• Metadados mostrados (tamanho, data, proprietário)

Descarregar

Descarregue ficheiros via:

• Menu de contexto → Descarregar
• Modal de pré-visualização → Botão de download
• Link direto (se partilhado)

Renomear

Altere nomes de ficheiros ou pastas:

1. Clique direito → Renomear
2. Edite nome no modal
3. Confirme alterações

Eliminar

Remova ficheiros ou pastas:

1. Clique direito → Eliminar
2. Confirme eliminação
3. Item removido imediatamente

Aviso: Itens eliminados não podem ser recuperados. Eliminar pastas remove todo o conteúdo.

Integração com Armazenamento Cloud

Dropbox

Importe ficheiros do Dropbox:

1. Clique no botão Dropbox no cabeçalho
2. Autentique se necessário
3. Navegue pelas pastas do Dropbox
4. Selecione ficheiros para importar
5. Ficheiros copiam para a pasta atual

Google Drive

Importe do Google Drive:

1. Clique no botão Google Drive
2. Autentique com Google
3. Navegue pelos ficheiros do Drive
4. Selecione para importar
5. Ficheiros copiam para o projeto

Nota: Integração com armazenamento cloud pode requerer plano Pro.

Pesquisa

Encontre ficheiros e pastas rapidamente:

1. Clique no campo de pesquisa no cabeçalho
2. Escreva termos de pesquisa
3. Pressione Enter para pesquisar
4. Resultados filtram a vista atual

Pesquisa corresponde:

• Nomes de ficheiros
• Nomes de pastas
• Extensões de ficheiros

Limpe a pesquisa para regressar à vista completa.

Organização de Ficheiros

Estrutura de Pastas

Organização sugerida:

Documentos/
├── Design/
│   ├── Mockups
│   ├── Assets
│   └── Marca
├── Técnico/
│   ├── Arquitetura
│   └── Specs API
├── Reuniões/
│   ├── 2024-Q1
│   └── 2024-Q2
└── Recursos/
    ├── Templates
    └── Referências

Convenções de Nomeação

Estabeleça padrões de equipa:

• Prefixos de data: "2024-01-15NotasReunião.pdf"
• Sufixos de versão: "Design_v2.fig"
• Prefixos de estado: "RASCUNHO_Proposta.docx"

Higiene de Ficheiros

Mantenha organização:

• Arquive versões antigas periodicamente
• Remova ficheiros obsoletos
• Mantenha estrutura de pastas suficientemente plana para navegar
• Documente propósitos de pastas em ficheiros README

Permissões

Acesso a documentos segue permissões do projeto:

Definições podem restringir mais o acesso.

Funcionalidades Pro

Algumas funcionalidades de documentos requerem plano Pro:

• Criar Pastas: Organizar em hierarquias
• Integração Dropbox: Importar do Dropbox
• Integração Google Drive: Importar do Drive
• Armazenamento Aumentado: Limites mais altos

Planos Free incluem:

• Upload de ficheiros
• Visualização básica
• Downloads

Limites de Armazenamento

Quotas de armazenamento variam por plano:

Verifique definições do workspace para uso atual.

Quando se aproximar dos limites:

• Arquive ficheiros antigos externamente
• Remova uploads não usados
• Considere fazer upgrade do plano

Melhores Práticas

Upload Ponderado

• Faça upload apenas de ficheiros relevantes ao projeto
• Use pastas apropriadas
• Nomeie ficheiros descritivamente
• Considere tamanho do ficheiro

Organize Cedo

Configure estrutura de pastas antes de fazer upload de muitos ficheiros. Mover ficheiros depois é mais trabalho.

Use Integração Cloud

Para ficheiros grandes ou armazenamento cloud existente:

• Ligue do Dropbox/Drive
• Evite uploads duplicados
• Mantenha master numa localização

Documente Propósito

Crie ficheiros README em pastas explicando:

• O que pertence aqui
• Quem mantém
• Convenções de nomeação usadas

Resolução de Problemas

Upload falha:

• Verifique limites de tamanho de ficheiro
• Confirme tipo de ficheiro permitido
• Garanta internet estável
• Tente lotes menores

Ficheiro não aparece:

• Atualize a página
• Verifique pasta correta
• Aguarde conclusão do upload
• Verifique notificações de erro

Não consigo criar pasta:

• Verifique subscrição Pro
• Confirme permissões
• Tente nome de pasta diferente

Pré-visualização não carrega:

• Alguns tipos de ficheiro não pré-visualizam
• Descarregue para ver localmente
• Ficheiros grandes podem demorar

Importação cloud parada:

• Re-autentique serviço
• Verifique estado do serviço cloud
• Tente menos ficheiros de uma vez

Como Reportar um Problema ou Solicitar uma Funcionalidade

O seu feedback importa. Aqui está como partilhá-lo:

Se gestão de documentos se comporta inesperadamente ou precisa de funcionalidades adicionais, queremos saber.

Na Barra Lateral, clique em Tickets de Suporte e abra um ticket para o problema. Tudo é interativo e rápido através da plataforma GitScrum Studio.