1. Identificação
| Issue | LIM-268 — Resolver pareceres técnicos de docs/revisao_artigo_LIM-266.md e outros |
| Data | 2026-05-20 |
| Agente | Documentador Acadêmico Free (f1b0f6c7) |
| Tipo | Estudo técnico preparatório |
| Status | Concluído |
2. Escopo
Resolver os pareceres técnicos emitidos nas revisões de artigo:
docs/revisao_artigo_LIM-266.md— Revisão principal (2 achados)docs/revisao_artigo_LIM-249.md— Revisão secundária (2 achados)
3. Achados da Revisão LIM-266
Achado ALTO — Inconsistência role vs schema
Problema: O artigo e o código (src/config/auth.php) afirmam autorização por role, mas o schema oficial (docker/mysql/init.sql) não possui coluna role na tabela usuarios.
| Arquivo | Evidência |
|---|---|
docs/artigo.html:523 | RN-02 menciona coluna role (admin/librarian) |
docs/artigo.html:1095 | Dicionário lista coluna role inexistente no schema |
src/config/auth.php:25 | Consulta SELECT role FROM usuarios — coluna ausente |
docker/mysql/init.sql:9-16 | Define apenas coluna tipo ENUM('administrador','padrao') |
src/login.php:29 | Consulta corretamente tipo (não role) |
Correção documental: Alinhar docs/artigo.html com o schema real — usar tipo em vez de role em RN-02 e remover linha fictícia role do dicionário.
Nota sobre código: src/config/auth.php permanece com query SELECT role — é uma inconsistência técnica que requer correção pelo Dev executor. A documentação deve refletir a realidade do schema, não do código incorreto.
Achado MÉDIO — Contradição "congelado v2.0"
Problema: O artigo (seção 17, linha 1522-1528) afirma que src/doc/artigo.html está congelado como versão 2.0, mas o arquivo real exibe "VERSÃO OFICIAL" e "Versão 2.1".
Correção documental: Remover a afirmação de versão congelada. Manter apenas a nota de que src/doc/artigo.html e src/doc/artigo1.html são cópias legadas não-oficiais, sem versão declarada.
4. Achados da Revisão LIM-249
Achado MÉDIO — src/doc/artigo1.html não rastreado
Problema: A seção 17 do artigo documenta apenas src/doc/artigo.html como cópia legada, mas src/doc/artigo1.html também existe no repositório.
Correção documental: Adicionar src/doc/artigo1.html à nota de divergência na seção 17.
Achado BAIXO — Terminologia híbrida (tipo e role)
Problema: Modelo de autorização híbrido (tipo no login, role em auth.php) complexifica a leitura acadêmica.
Correção documental: Com a remoção da coluna role fictícia, a terminologia fica unificada em tipo. Incluir nota explicativa no artigo sobre a divergência em auth.php.
5. Plano de Correção
| # | Arquivo | Alteração | Achado |
|---|---|---|---|
| 1 | docs/artigo.html:523 | RN-02: trocar role por tipo, remover referência a 'librarian' | LIM-266 ALTO |
| 2 | docs/artigo.html:1095 | Remover linha da coluna role do dicionário de dados | LIM-266 ALTO |
| 3 | docs/artigo.html:1521-1529 | Corrigir nota de divergência: remover "congelado v2.0", adicionar src/doc/artigo1.html | LIM-266 MÉDIO + LIM-249 MÉDIO |
| 4 | docs/artigo.html:317 | Atualizar versão: 2.1 → 2.2 | Histórico |
6. Riscos
- Código quebrado:
src/config/auth.phpconsulta colunaroleinexistente. Ambientes novos cominit.sqlpuro terão falha de autorização. Este risco não é resolvido apenas com documentação. - Cópia legada:
src/doc/artigo.htmlainda se autodenomina "VERSÃO OFICIAL" — pode confundir revisores. Recomendar remoção futura.