Pular para o conteúdo
Loomty/Spec Técnica

Spec Técnica dos Módulos.

Resumo executivo dos 12 módulos da plataforma Loomty. Documento operacional para parceiros B2B técnicos, com foco em integração, compreensão funcional e limites de cada bloco do sistema.

Versão
v1.0 · Abr/2026
Escopo
12 módulos
Audiência
Parceiro B2B técnico
Base teórica
Holland · O*NET · Big Five
Nota
Zero inferência. Este documento lista apenas o que está na documentação oficial do produto. Campos não documentados (IDs técnicos internos, endpoints, pesos de cálculo, SLAs) foram omitidos intencionalmente. Nenhum deles foi inventado.
Preâmbulo · Entidades do domínio

Vocabulário canônico.

Termos usados ao longo do documento. A grafia e a forma são fixas; variações não são aceitas.

Perfil RIASEC
Seis tipos do modelo de Holland (1959): Realista, Investigativo, Artístico, Social, Empreendedor, Convencional.
Subtipo
54 identidades vocacionais fixas (9 por perfil RIASEC). Lista oficial imutável.
Ficha de Identidade
Representação granular do perfil do jogador. 8 fichas compõem o mapa pessoal.
Profissão
Unidade do banco de profissões. Vinculada a 4 subtipos (1 principal + 3 secundários) e a cursos acadêmicos reais.
EAV
Escala de Alinhamento Vocacional. 5 níveis ordinais que medem fit jogador × profissão.
Iara
Orientadora vocacional com IA. Grafia: Iara, nome próprio, inicial maiúscula, resto minúsculo.
Crédito
Unidade transacional. Consumida na geração de PDFs (Relatório ou Mapa).
Parceiro
Entidade institucional B2B (colégio, universidade, empresa) com slug próprio e pool de créditos.
Preâmbulo · Ambientes

Dois ambientes, uma plataforma.

play.loomty.com
App do jogador. Ambiente de consumo do jogo, acesso via link direto ou via slug do parceiro (play.loomty.com/{parceiro}).
admin.loomty.com
Painel institucional. Usado por parceiros (monitoramento e gestão de créditos) e pela operação interna (configuração e observabilidade agregada).
Capítulo 1 · Motor científico

A base de dados vocacional.

Banco de perguntas, subtipos, profissões e fichas compõem os quatro módulos que sustentam a leitura.

Módulo AAmbiente · play

Motor RIASEC · Banco de Perguntas Vocacionais

O coração científico do Loomty. Mantém 1.076 perguntas vocacionais curadas e ativas, cada uma vinculada a subtipos específicos entre os 6 perfis RIASEC. É o módulo responsável por alimentar a construção das Fichas de Identidade a partir das respostas do jogador.

Opera no formato de 36 perguntas por partida (uso avulso vs. institucional). A taxa atual de conclusão observada é de 96,7%, indicador central de qualidade da experiência.

Capacidade
1.076 perguntas ativas
Formato
36 perguntas por sessão
Vínculo
Cada pergunta vincula-se a subtipos específicos dentro dos 6 perfis RIASEC
Saída
Respostas que alimentam o Módulo D (Fichas de Identidade)
Métrica-chave
Taxa de conclusão do jogo: 96,7%
Módulo BAmbiente · shared

Sistema de 54 Subtipos

Catálogo fixo e imutável das identidades vocacionais reconhecidas pela plataforma. 6 perfis RIASEC × 9 perfis = 54 subtipos, com nomes oficiais que nunca podem ser alterados, substituídos ou inventados.

É a fonte de verdade que conecta perguntas (Módulo A), profissões (Módulo C) e fichas (Módulo D). Funciona como vocabulário estrutural, pois todos os outros módulos referenciam subtipos por nome canônico.

Realista (R)
Concreto · Material · Físico · Manual · Fôlego · Operacional · Mecânico · Instrumental · Construção
Investigativo (I)
Abstrato · Teórico · Racional · Analítico · Dedução · Experimental · Exatidão · Investigação · Metódico
Artístico (A)
Expressivo · Imaginativo · Estesia · Estético · Autonomia · Original · Elaboração · Criação · Narrativa
Social (S)
Empático · Acolhimento · Cuidado · Orientação · Doação · Facilitação · Parceria · Escuta · Ensino
Empreendedor (E)
Influência · Persuasão · Liderança · Iniciativa · Decisão · Ousadia · Negociação · Ambição · Autoridade
Convencional (C)
Padronização · Ordenação · Procedimento · Conformidade · Documentação · Precisão · Controle · Arquivamento · Regulamentar
Invariante
Os 54 nomes acima são canônicos. Nenhuma instância do produto, documentação ou relatório pode usar variações, sinônimos ou traduções.
Módulo CAmbiente · shared

Banco de Profissões

Repositório com as ocupações da Classificação Brasileira de Ocupações (CBO), cada uma vinculada a 4 subtipos (1 principal + 3 secundários) e cruzada contra três bases científicas: Holland × O*NET × Big Five. Cada profissão também traz vínculo com cursos acadêmicos reais, incluindo graduação, técnico e livre.

Alimenta o mecanismo de match final (consumido pelo Módulo F · EAV) e a fase eliminatória (Módulo E · Peneira dos Nãos). É o catálogo contra o qual a Ficha de Identidade do jogador é confrontada.

Tamanho
Todas as ocupações catalogadas na Classificação Brasileira de Ocupações (CBO), o registro oficial das ocupações no Brasil.
Estrutura por profissão
1 subtipo principal + 3 secundários (4 dos 54 totais)
Validação cruzada
Holland · O*NET · Big Five
Vínculo acadêmico
Cada profissão traz cursos reais: graduação · técnico · livre
Consumido por
Módulo E (Peneira dos Nãos) · Módulo F (EAV)
Módulo DAmbiente · play

Mecânica de Fichas de Identidade

Fichas são os subtipos selecionados pelo jogador na segunda fase do jogo. A estrutura trabalha com 8 fichas escolhidas pelo jogador para compor seu mapa vocacional pessoal.

Cada resposta do Motor RIASEC (Módulo A) distribui pontos nas fichas vinculadas aos subtipos envolvidos, construindo a identidade de forma cumulativa ao longo da sessão. A saída final consolida os subtipos em dois grupos: 3 primários + 3 secundários (6 subtipos que representam o jogador). Os outros 48 subtipos não o representam. O módulo também produz um código RIASEC de 3 letras (ex.: CSI, IAS, REA) que sumariza o perfil.

Fichas por jogador
8 subtipos selecionados pelo jogador na segunda fase do jogo
Subtipos representativos
6 de 54 (3 primários + 3 secundários)
Código resumo
RIASEC de 3 letras (ex.: CSI, IAS, REA)
Consumido por
Módulo F (EAV) · Módulo G (Iara) · Módulos H e I (artefatos PDF)

Fluxo de construção da Ficha

SessãoiniciadaRespostaregistradaPontosdistribuídos36 perguntasConsolidarnão · próxima perguntasim
Capítulo 2 · Mecânica de jogo

Como a partida opera.

Módulo EAmbiente · play

Peneira dos Nãos

Fase eliminatória do fluxo de jogo. O jogador elimina ativamente cartas de profissão que não fazem sentido para ele, reduzindo o universo de candidatos antes da fase construtiva de pontuação.

Objetivo duplo: reduzir carga cognitiva do jogador e aumentar a precisão do match final, eliminando ruído do banco de profissões antes que o EAV seja calculado. Ocorre antes da construção completa da Ficha de Identidade.

Posição no fluxo
Antes da fase construtiva de pontuação (Módulo D)
Ação do jogador
Eliminar ativamente profissões que não fazem sentido
Efeito
Reduz carga cognitiva · melhora precisão do match final
Catálogo de entrada
Banco de Profissões (Módulo C)
Módulo FAmbiente · shared

Escala EAV · Escala de Alinhamento Vocacional

Quantifica o fit entre o jogador e cada profissão do banco, convertendo a relação entre subtipos em uma escala ordinal de 5 níveis com interpretação humanizada. É o output que traduz o mapeamento técnico em linguagem de decisão para o jogador.

Cálculo: soma dos subtipos da profissão que coincidem com os 6 subtipos representativos do jogador (3 primários + 3 secundários). Alimenta o Relatório Vocacional (H) e o Mapa de Trajetória (I).

Os 5 níveis oficiais

NívelDescrição oficial
EAV 01 · Incompatível"Aquele emprego que te faria pedir demissão na segunda semana"
EAV 02 · Baixo Alinhamento"Sobreviveria, mas não floresceria"
EAV 03 · Alinhamento Parcial"Tem potencial com as condições certas"
EAV 04 · Alto Alinhamento"Quase perfeito. Vai para o trabalho de bom humor"
EAV 05 · Fit Perfeito"Não é trabalho, é vocação"
Regra
A escala é fechada em [1, 5]. Cálculo puro (função), sem estado persistente próprio.
Capítulo 3 · Orientação & artefatos

O que sai da partida.

Módulo GAmbiente · play

Iara · Assistente Vocacional com IA

Orientadora vocacional com IA especializada no modelo RIASEC. Gera respostas contextualizadas ao perfil do jogador, conduzindo a jornada em tempo real durante e após o jogo. Usa uma linguagem voltada ao desenvolvimento, nunca diagnóstica nem própria de um chatbot genérico.

É também o motor responsável pela geração dos dois PDFs oficiais: Relatório Vocacional (Módulo H) e Mapa de Trajetória (Módulo I). Nenhum dos dois é pré-fabricado.

Disponibilidade
Tempo real · durante e após o jogo
Especialização
Modelo RIASEC de Holland
Gera
Relatório Vocacional (H) · Mapa de Trajetória (I)
Grafia oficial
Iara, nome próprio. A forma iARA foi revogada em 10/09/2026
Invariante
Escreva Iara, como qualquer nome próprio. A forma iARA (i minúsculo + ARA maiúsculo) era obrigatória e foi revogada em 10/09/2026: não use mais. Em caixa-alta (menu, título display), quem resolve é o CSS, e IARA ali é consequência da caixa, não grafia escrita à mão. Yara nunca existiu.
Módulo HAmbiente · play

Gerador de Relatório Vocacional (PDF)

Documento narrativo completo do perfil vocacional identificado. Traz contextualização sociocultural, qualificação epistêmica dos insights e linguagem de desenvolvimento. É gerado sob demanda pela Iara e nunca é pré-fabricado.

A versão atual do relatório recebeu 9,7/10 em painel simulado de 7 especialistas.

Formato
PDF narrativo
Gerador
Iara (Módulo G)
Custo
1 crédito por geração (Módulo L)
Score atual
9,7/10 · painel simulado de 7 especialistas
Módulo IAmbiente · play

Gerador de Mapa de Trajetória (PDF A4)

Documento A4 visual que sintetiza perfil, subtipos dominantes e caminhos profissionais em uma única folha imprimível e compartilhável. Produto complementar ao Relatório Vocacional (Módulo H).

Formato
PDF A4 · imprimível · compartilhável
Conteúdo
Perfil · subtipos dominantes · caminhos profissionais
Gerador
Iara (Módulo G)
Custo
1 crédito por geração (Módulo L)
Capítulo 4 · Operação institucional

O produto na perspectiva do parceiro.

Módulo JAmbiente · admin

Plataforma B2B de Parceiros Institucionais

Permite que instituições configurem sua presença no Loomty com slug público (play.loomty.com/{parceiro}), formato de jogo (36 perguntas), branding parcial, pool de créditos e monitoramento de partidas em tempo real.

Slug público
play.loomty.com/{parceiro}
Configuração
Formato de 36 perguntas · branding parcial · pool de créditos
Operação
Monitoramento de partidas em tempo real · distribuição de créditos
Módulo KAmbiente · admin

Dashboard Analítico

Painel agregado no admin.loomty.com. Expõe métricas em tempo real com filtros por período (7, 30 ou 90 dias), por parceiro, por perfil RIASEC predominante e por traços.

Suporta exportação consolidada de relatórios e comparativos temporais (mês vs. mês, turma vs. turma), para leitura institucional e tomada de decisão.

Filtros
Período (7 / 30 / 90 dias) · parceiro · perfil RIASEC · traços
Métricas agregadas
Partidas ativas · taxa de conclusão · tempo médio · distribuição RIASEC
Exportação
Relatórios consolidados · comparativos temporais (mês vs. mês · turma vs. turma)
URL
admin.loomty.com
Módulo LAmbiente · shared

Sistema de Créditos

Modelo transacional ético: jogar é sempre gratuito. O crédito é consumido apenas na geração de artefatos PDF, seja o Relatório Vocacional (H) ou o Mapa de Trajetória (I), com consumo de 1 crédito por PDF.

Duas modalidades operam em paralelo: no B2C, o jogador compra créditos avulsos; no B2B, o parceiro compra pacotes e os distribui para sua base. Não há assinatura compulsória, e o consumo é totalmente transparente em ambos os painéis.

Consumo
1 crédito = 1 PDF (Relatório OU Mapa)
Modalidade B2C
Compra avulsa de créditos pelo jogador
Modalidade B2B
Parceiro compra pacotes e distribui
Invariante
Jogar é sempre gratuito · sem assinatura compulsória

Máquina de estados do Crédito

pedido PDFsucessofalharetorna ao poolCompradoDisponívelReservadoConsumidoLiberadoPDF gerado

Acesso (RBAC simplificado)

PapelComprarDistribuirConsumirVer saldo
JogadorB2CNão se aplicaSimPróprio
ParceiroPacote B2BPara sua baseNão se aplicaPool da instituição
AdminNão se aplicaOperacionalNão se aplicaGlobal
Fim do documento

Próximos passos.

Precisa da versão técnica exaustiva (10 seções por módulo · endpoints · pesos de cálculo · SLAs)? Fale com a equipe técnica do Loomty. O material avançado é compartilhado sob NDA.