TheEye · Cadastro de Perfis e Grupos

Inclusao/atualizacao de perfil com regras de padronizacao e relacionamentos obrigatorios.

Banco conectado: postgres@debatim-postgres-nfuqhf:5432/debatim_staging

Importacao em lote via CSV

Cada linha do CSV representa um perfil. O import faz upsert por name, preenchendo ID numerico do Instagram e secUid do TikTok automaticamente quando houver somente username.

Colunas de redes ainda nao implementadas no parser (ex.: facebook, telegram, linkedin) sao aceitas no CSV e ignoradas por enquanto.

Separadores aceitos em colunas de lista: virgula ou ponto e virgula. Exemplo: group_names=Geral;Monitoramento Camara.

Para campos politicos: se has_party_affiliation=true, informe partido, tipo de vinculacao e status; para AF_ELECTED, informe cargo e local de mandato.

Baixar CSV modelo

Colunas esperadas

ColunaDescricao
name Nome do perfil (chave de upsert; nao pode ficar vazio).
instagram_username Username do Instagram sem @. Se instagram estiver vazio, o ID numerico sera resolvido automaticamente.
instagram ID numerico do perfil no Instagram.
tiktok_username Username do TikTok sem @. Se tiktok_secuid estiver vazio, sera resolvido automaticamente via RapidAPI.
tiktok_secuid secUid do TikTok. Opcional no CSV quando tiktok_username for informado.
tiktok Alias legado para username do TikTok (mantido por compatibilidade).
youtube Canal/username do YouTube.
x Username da conta no X/Twitter.
kwai Username da conta no Kwai.
facebook Coluna aceita para futuro parser (atualmente ignorada).
telegram Coluna aceita para futuro parser (atualmente ignorada).
linkedin Coluna aceita para futuro parser (atualmente ignorada).
gender Codigo padronizado (GN_MASC, GN_FEM, GN_NBIN, GN_OTHR, GN_UNK).
race Codigo padronizado (RC_BRAN, RC_PRET, RC_PARD, RC_AMAR, RC_INDI, RC_UNK).
place_id ID do local ja existente na tabela place.
place_name Nome do local para criar automaticamente quando place_id estiver vazio.
group_ids Lista de IDs de grupos (separados por ; ou ,).
group_names Lista de nomes de grupos; os inexistentes serao criados automaticamente.
has_party_affiliation true/false para vinculo partidario.
party_id ID do partido.
party_acronym Sigla do partido (usada quando party_id nao for informado).
affiliation_type_code AF_MEMBER, AF_LEADER, AF_STAFF ou AF_ELECTED.
office_code Obrigatorio para AF_ELECTED (ex.: OF_FEDERAL_DEPUTY).
status_code Codigo de status politico (ex.: ST_IN_OFFICE).
mandate_place_id ID do local do mandato (obrigatorio para AF_ELECTED).
mandate_place_name Cria local do mandato quando mandate_place_id estiver vazio.
politician_votes Quantidade de votos (opcional).
politician_source_system_code Origem externa do vinculo politico (opcional; ex.: CAMARA_DEPUTADOS).
politician_source_external_id ID externo na origem politica (opcional; ex.: id do deputado).