Tags e grupos

Tags e groups são duas formas de organizar poços no PetroBench. Parecem similares, mas resolvem problemas diferentes.

Use tags para rótulos flexíveis que cruzam a hierarquia. Exemplos: High Priority, Workover Candidate, ESP Conversion. Use groups para controlar quais membros da equipe veem e trabalham com poços específicos.

Um poço pode ter muitas tags e pertencer a um group ao mesmo tempo.

Como Se Encaixam

Groups seguem a hierarquia da organização. Tags flutuam como rótulos flexíveis.

Lendo o diagrama:

• Setas sólidas são a hierarquia da organização. Headquarters contém divisões, divisões contêm regiões, regiões contêm groups, groups contêm usuários e poços, poços possuem simulações e arquivos
• Setas tracejadas de Tags mostram que tags se ligam diretamente a poços, simulações e arquivos sem passar pela hierarquia

Na prática:

• Usuário só vê poços dentro de groups aos quais pertence (acesso por group é aplicado)
• Tag aplicada em qualquer nível é visível para quem tem acesso ao item tagueado
• Remover usuário de um group remove acesso aos poços daquele group, mas não afeta tags

---

1. Etiquetas

Tag é nome mais cor. O PetroBench aplica tags a três tipos de ativo: poços, simulações e arquivos.

1.1 Criar Tag

Duas formas de criar tag.

Na página de gerenciamento de Tags

1. Vá para Dashboard > Tags
2. Clique em Create Tag
3. Informe nome (até 50 caracteres) e escolha cor
4. Clique em Create Tag

Inline a partir de um poço

1. Abra a página Details de qualquer poço
2. Clique em Add tags... abaixo do nome do poço
3. Digite nome que não corresponda a tag existente
4. Clique em Create new tag no dropdown

O método inline cria a tag e aplica em um passo.

1.2 Aplicar Tags

1. Abra poço, simulação ou arquivo
2. Clique em Add tags...
3. Digite para buscar ou escolha no dropdown
4. A tag aplica imediatamente

Para remover, clique no x na pill da tag.

1.3 Bulk Tag

Aplique ou remova tags em muitos itens de uma vez.

1. Vá para Wells (ou tabela Simulations)
2. Selecione linhas com checkboxes
3. Clique em Tag Selected Items no menu de ações em massa
4. Escolha tags para aplicar
5. Clique em Apply

Para remover, clique em Remove Tags from Selected Items.

1.4 Editar, Cor ou Excluir Tag

Vá para Dashboard > Tags. Clique no menu More de qualquer linha de tag.

Cor é puramente visual. Escolher cor não muda comportamento, só facilita escanear listas.

1.5 Mesclar Tags

Merge combina duas tags. Use quando houver duplicatas ou quase duplicatas (por exemplo, Workover vs Work-over).

1. Abra menu More na tag de origem
2. Clique em Merge Tag
3. Escolha tag de destino no dropdown
4. Clique em Merge Tags

O que acontece:

• Todo poço, simulação e arquivo tagueado com a origem passa para o destino
• Tag de origem é excluída
• Merge é permanente (sem undo, mas você pode recriar a tag de origem se precisar)

Se a tag de destino for a única outra tag na org, verá "There are no other tags to merge into. Create at least one more tag first."

1.6 Página de Detalhe da Tag

Clique qualquer linha de tag na página de gerenciamento para ver detalhes.

A página de detalhe tem três abas:

Cada aba tem busca própria e ação Remove from Tag para limpar associações item a item sem alterar a tag.

1.7 Filtrar por Tag

Tags aparecem no filtro de Wells:

1. Vá para Wells
2. Clique em Filter
3. Selecione Tags
4. Escolha uma ou mais

Combine com outros filtros (Status, Wellbore Profile, Lease) para restringir mais.

---

2. Grupos

Groups agrupam usuários e poços em equipes. Diferente de tags, groups ligam-se à hierarquia organizacional (HQ → Division → Region) e controlam acesso a dados.

2.1 Como Groups Funcionam

• Um group contém users e wells
• Usuários no group acessam poços atribuídos ao group
• Groups podem ser atribuídos a uma region na organização
• Admins gerenciam groups no admin panel

2.2 Ver Seus Groups

1. Vá para My Groups no menu principal
2. Você vê cada group ao qual pertence com contagens de usuários e poços
3. Clique em um group para ver poços e membros

2.3 Criar Group

1. Vá para Dashboard > User Groups
2. Clique em Create Group
3. Informe nome do group e descrição opcional
4. Busque e atribua membros e poços
5. Clique em Create Group

2.4 Gerenciar Groups

Na tabela de groups, admins podem:

Ações em massa estão disponíveis ao selecionar vários groups com checkboxes.

2.5 Filtrar por Group

Groups aparecem no filtro de Wells:

1. Vá para Wells
2. Clique em Filter
3. Selecione Group
4. Escolha um group para ver só seus poços

---

3. Permissões

Ações de tag usam seis permissões. Por padrão vêm agrupadas com mapeamentos sensatos por role, mas admins podem personalizar por role.

Sem permissão, o botão correspondente fica oculto ou desabilitado.

Permissões de group são mais simples: só admins (HQ, Division ou Region) criam, editam ou excluem groups. Membros de um group herdam automaticamente acesso aos poços nele.