LQA — Cadeia Produtiva Cognitiva (Linha de Produção do Livro que Aprende)

LQA O Livro que Aprende

Página Autor / Profissional (Engenharia de Sistema LQA) - Cadeia Produtiva Cognitiva

Panorama do Processo Cognitivo (clique para expandir/contrair)

Layout: Modo: Mostrar predicados Fixar nós ao arrastar Mostrar rótulos

Tema: Escuro Modo: 🏗️ Linha de Produção do LQA Interação: drag • wheel zoom • pan

Descrição

Clique em um nó para ver a descrição aqui.

📊 Métricas (KPIs) da Cadeia Produtiva

Introdução

O que são: indicadores quantitativos/qualitativos usados para monitorar o desempenho de cada etapa (Entrada, Processamento, Produção, Avaliação, Entrega) e o impacto no aprendiz/usuário.

Como são coletadas: por telemetria (eventos de uso, tempo, cliques), instrumentos de avaliação (quizzes, rubricas), e logs de pipeline (ETL, build, publicação).

Como são calculadas: normalização percentual (0–100%), agregações por janela de tempo, e ponderações por criticidade. Exemplos: média móvel de acurácia de recomendação, taxa de aderência, tempo de publicação normalizado.

Como interpretar: barras mais cheias indicam melhor desempenho (exceto métricas invertidas marcadas com “↓ melhor”). Use-as para direcionar melhorias no processo e na experiência do aprendiz.

Qualidade Desempenho Experiência

Visão Geral por Etapa

📐 Especificações de Interface — Contratos (REST) & Schemas (JSON/JSON-LD)

1) Endpoints REST (resumo)

POST /perfis — cria/ingere perfil do aprendiz
PATCH /perfis/{id} — atualiza preferências/metadados
POST /ontologias — registra ontologia (JSON-LD/TTL) com versão
POST /grafos — registra grafo de tópicos/relacionamentos
POST /trilhas — gera trilha adaptativa
POST /oas — registra OA (conteúdo didático)
POST /metricas — armazena métrica/telemetria
POST /publicacoes — publica artefato (web/pdf), gera versão imutável

2) Schema — Perfil (JSON Schema, mínimo)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://lqa.dev/schema/perfil.json",
  "type": "object",
  "required": ["idExterno", "preferencias", "consentimentos"],
  "properties": {
    "idExterno": {"type": "string"},
    "preferencias": {
      "type": "object",
      "properties": {
        "idioma": {"type": "string", "enum": ["pt-BR", "en-US"]},
        "tema": {"type": "string", "enum": ["claro", "escuro"]}
      }
    },
    "objetivos": {"type": "array", "items": {"type": "string"}},
    "nivelAtual": {"type": "object", "properties": {"topico": {"type":"string"}, "nivel": {"type":"string"}}},
    "consentimentos": {"type": "object", "properties": {"lgpd": {"type": "boolean"}}}
  }
}

3) Schema — Ontologia/Grafo (JSON-LD, mínimo)

{
  "@context": {"@vocab": "https://schema.org/", "Topico": "https://lqa.dev/topico/"},
  "@id": "https://lqa.dev/ontologia/2025-10-31",
  "@type": "CreativeWork",
  "name": "Ontologia LQA",
  "version": "2025.10.31",
  "@graph": [
    {"@id": "Topico:DesignResponsivo", "@type": "Thing", "name": "Design Responsivo"},
    {"@id": "Topico:GridCSS", "@type": "Thing", "name": "Grid CSS"},
    {"@id": "_:r1", "@type": "Relationship", "source": "Topico:DesignResponsivo", "target": "Topico:GridCSS", "predicate": "define"}
  ]
}

4) Schema — Trilha (JSON Schema, mínimo)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://lqa.dev/schema/trilha.json",
  "type": "object",
  "required": ["aluno", "topicoAlvo", "oAs"],
  "properties": {
    "aluno": {"type": "string"},
    "topicoAlvo": {"type": "string"},
    "restricoes": {"type": "object"},
    "politicas": {"type": "object"},
    "oAs": {
      "type": "array",
      "items": {"type": "object", "required": ["id", "tipo"],
        "properties": {"id": {"type":"string"}, "tipo": {"type":"string"}}}
    }
  }
}

5) Notas

Versão: versionamento semântico para ontologias/grafos; publicação gera novos IDs.
Segurança & LGPD: consentimento obrigatório, escopos por serviço, anonimização/retensão.
Telemetria: cada endpoint emite eventos (nome, payload mínimo, traceId).