Conceitos fundamentais

Sete palavras explicam quase tudo na IRIS. Vale ler esta página antes das outras — várias telas só fazem sentido depois dela.

Contrato e Projeto (Empreendimento)

Estes dois são o par mais importante, e são coisas diferentes.

O Contrato é o instrumento administrativo. Ele guarda os empreendimentos executados sob ele e define o que eles herdam: empresa, órgão e escopo. O Contrato não recebe documentos nem análises.

O Projeto — chamado de Empreendimento nas telas administrativas — é o que efetivamente se analisa. É ele que recebe disciplinas, peças técnicas, membros da equipe e as análises de conformidade.

A relação é um Contrato para vários Projetos. Um contrato de duplicação pode conter o Lote 1, o Lote 2 e o Lote 3 como projetos distintos, cada um com suas peças e seu próprio percentual de conformidade.

Um Projeto também pode ter subempreendimentos — filhos dele, exibidos ao expandir o cartão na tela de Projetos.

Atenção ao vocabulário

A tela Projetos e o seletor do compositor falam em "Projeto". A tela Contratos, em Governança, fala em "Empreendimento". São o mesmo objeto — a diferença é só o nome usado em cada área. Já "Contrato" é sempre o nível de cima.

Criar um contrato não cria projeto nenhum: são dois cadastros, nessa ordem.

Disciplina

A área técnica sob análise — pavimentação, drenagem, terraplenagem, obras de arte especiais, sinalização, e assim por diante.

A disciplina é o eixo organizador da IRIS: a análise acontece por disciplina, a matriz de conformidade é uma por disciplina, o laudo é por disciplina, e os agentes de IA são especializados por disciplina.

Um projeto sem disciplinas configuradas não consegue rodar análise. Se a Matriz avisar que "este projeto ainda não tem disciplinas configuradas", é isso que está faltando.

Peça

É um documento técnico do projeto que está sob julgamento: um memorial descritivo, uma planilha orçamentária, um projeto geométrico, um relatório de sondagem. As peças são o que a IRIS confere.

Não confunda com os documentos contratuais (Termo de Referência, Edital, Ordem de Serviço), que descrevem o que foi contratado, nem com os normativos, que são a régua.

Normativo

A norma, o manual ou o critério do órgão que serve de régua para a conformidade — GOINFRA, DNIT, TCE-GO, IBRAOP, entre outros. Os normativos vivem na Biblioteca e são indexados para que os agentes possam citá-los.

Um normativo só serve de evidência depois de indexado. Enquanto não estiver, ele aparece na Biblioteca mas não sustenta veredito nenhum.

Agente

Um especialista de IA. Cada agente tem uma disciplina, os órgãos que ele conhece e os modais em que atua. O Marketplace é a vitrine deles.

Na conversa, você normalmente não escolhe o agente: o orquestrador decide qual é o certo para a sua pergunta. Escolher à mão é possível, e é o override manual.

Item de verificação e Matriz de Conformidade

Um item de verificação é uma checagem — "o fck especificado é compatível com a classe de agressividade ambiental?". A Matriz de Conformidade cruza as verificações com as peças do projeto: cada célula é o veredito de uma verificação sobre uma peça.

Estado da célula	O que significa
Conforme	A peça atende à verificação, com citação normativa que sustenta o veredito.
Não conforme	A peça contraria a verificação. É o achado que exige ação.
Em análise	Atendimento parcial, ou evidência insuficiente para fechar o veredito.
Pendente	A verificação existe para esta análise, mas ainda não foi avaliada.
Ausente	A peça que a verificação exigia não foi entregue. Aparece só quando há ausência.
Célula vazia (—)	Aquela verificação não se aplica àquela peça. Não é o mesmo que pendente.

Roteiro

Um conjunto reutilizável de regras de checklist, agrupadas por seção. Em vez de recadastrar as mesmas trinta verificações a cada projeto novo, você monta o roteiro uma vez e o aplica aos projetos.

Roteiro não é análise: é molde de análise. Aplicar um roteiro é que anexa as regras à análise da disciplina e dispara a execução. Ver Roteiros.

Laudo e Parecer

O laudo é a saída formal da análise de uma disciplina — resumo, não conformidades e rodapé, em folha A4 pronta para impressão.

O parecer é o documento técnico que a equipe humana escreve, e que na Revisão de Análise passa a ser o objeto que a IRIS critica.