personnel para TYPO3

personnel organiza diretórios de colaboradores como modelo de dados próprio

Páginas de equipe, listas de contatos e diretórios de departamentos são padrão em sites corporativos, mas não podem ser mantidos de forma sensata como content element. Quem gerencia 50 colaboradores com nome, função, foto, telefone, email, LinkedIn, departamento e localização precisa de um modelo de dados próprio. A extensão personnel traz exatamente isso: uma tabela limpa para pessoas, conectada a departamentos e localizações, entregue via templates Fluid configuráveis. Em todo projeto TYPO3 de médio porte com presença corporativa, essa exigência aparece repetidamente, e o personnel é uma das soluções consolidadas. Alternativas como tt_address ficam curtas, porque lhes falta estrutura de departamento, lógica de filtro e integração limpa com o frontend.

Cenários típicos são escritórios, agências e universidades

Escritórios de advocacia são um use case clássico. Um escritório com 30 advogados e 10 paralegais precisa de uma página de equipe com filtro por área de atuação (trabalhista, tributário, sucessões), por localização (São Paulo, Rio de Janeiro, Brasília) e por função (sócio, associado, estagiário). O personnel entrega o modelo de dados, e a extensão pode ser expandida com poucos ajustes Fluid para formar um diretório completo. Cada perfil de advogado contém adicionalmente a inscrição na OAB, as afiliações profissionais e os artigos técnicos publicados, para que clientes encontrem o contato certo de relance.

Agências e consultorias usam o personnel para páginas de equipe com mini biografias, áreas de atuação e links de contato. Aqui, menos importante é o filtro do que a apresentação: retratos grandes, citações, botões LinkedIn e linking interno para cases nos quais a pessoa esteve envolvida. A página de equipe vira vitrine, e o personnel entrega o modelo de dados sem que cada colaborador vire um content element próprio.

Universidades e instituições de pesquisa têm outra exigência: colaboradores costumam estar vinculados a institutos, cátedras e projetos de pesquisa. O personnel se torna então o modelo de dados-mestre, referenciado por news, listas de publicações e eventos. A pessoa aparece não só na página de equipe, mas também como autora em publicações e como contato em projetos de pesquisa. Assim a extensão vira a base central de pessoas, usada por várias sub-extensões simultaneamente, e entrega perfis consistentes por anos.

Arquitetura técnica é baseada em Extbase com relações para departamento e localização

O personnel define três tabelas centrais: tx_personnel_domain_model_personnel, tx_personnel_domain_model_department e tx_personnel_domain_model_location. Uma pessoa é conectada via foreign_field ou relação MM a um ou mais departamentos, além de uma localização. O schema de banco representa assim uma organização em matriz típica.

Os campos de uma pessoa cobrem os atributos padrão: título, nome, sobrenome, função, descrição curta, telefone, celular, fax, email, endereço, foto de perfil (FAL), links de redes sociais. Via TCA overrides, campos adicionais como áreas de atuação, certificações ou idiomas podem ser incluídos sem fazer fork da extensão.

O plugin renderiza via templates Fluid do diretório EXT. As variantes padrão são lista, detalhe e visão de filtro. Quem usa grids como CSS Grid ou Flexbox sobrescreve o template de lista no próprio site package. Para filtros e busca, a extensão usa repositories Extbase com filtros querybuilder, configuráveis via TypoScript. Uma implementação Gosign típica oferece no frontend uma busca textual sobre nome e função combinada com filtros select para departamento e localização, de forma que usuários encontrem em poucos cliques o contato certo entre 200 colaboradores.

Problemas frequentes envolvem LGPD (PT: RGPD), direitos de imagem e multilinguismo

O primeiro e mais importante tema de suporte é a LGPD. Dados de colaboradores são dados pessoais, e a publicação exige ou consentimento ou legítimo interesse. Quem trabalha com fotos, ramais e celulares pessoais precisa de um processo limpo: documentar consentimento, botão on/off por pessoa, remoção automática após desligamento. O personnel não oferece audit log de fábrica, mas o workflow pode ser modelado com formulários próprios e um campo de consent adicional. No desligamento, o registro não deve ser simplesmente deletado, mas desativado via soft delete, para que news antigas continuem resolvendo corretamente.

O segundo tema são direitos de imagem. Fotos de perfil ficam no FAL e são entregues em variantes por apresentação. É importante que a atribuição de copyright e o consentimento do colaborador estejam documentados, especialmente quando a foto também é usada como teaser em news ou em redes sociais. Recomendamos manter os campos FAL “Fotógrafa/Fotógrafo” e “Licença” de forma consistente.

Em terceiro, multilinguismo é um problema prático. Uma pessoa tem um nome, mas sua função e a mini biografia diferem em português e inglês. O personnel suporta o padrão TYPO3 para traduções, mas muitos projetos esquecem de localizar também os registros de departamento e localização, o que leva a saídas mistas em idiomas.

Migração para TYPO3 v12 exige update do Extbase e revisão de TCA

O personnel está disponível para várias versões do TYPO3 no TER. No upgrade de uma instalação v10 ou v11, os Extbase repositories precisam ser adaptados à persistence API atual, e a estrutura TCA deve ser verificada quanto a incompatibilidades de tipo (especialmente em campos “passthrough” e “none”, que no v12 são validados de forma mais rígida).

A Gosign frequentemente migra instalações personnel no âmbito de um refactoring das páginas de equipe. No mesmo passo verificamos se o acervo pode ser elevado a um schema de pessoa mais moderno (com marcação JSON-LD), se filtros e busca lidam com grandes datasets de forma performática e se a página de equipe é entregue de forma responsiva e acessível. Para projetos com datasets extremamente grandes (vários milhares de pessoas) vale ainda um olhar em indexação e lazy loading, para que a visão de lista não vire gargalo em dispositivos móveis. Em estruturas de equipe especialmente complexas, ocasionalmente substituímos o personnel por um modelo Extbase custom, quando a estrutura padrão de campos não basta ou quando é necessária conexão a um sistema de RH externo.