Add <product> element validation for SPS 1.10 compliance

[Copilot]

O que esse PR faz?

Implementa 7 das 10 regras de validação para o elemento <product> (70% de conformidade SPS 1.10), cobrindo resenhas de livros (book-review).

Regras implementadas:

Regra	Nível	Descrição
@product-type presença	CRITICAL	Atributo obrigatório
@product-type valor	ERROR	Deve ser "book"
<source> presença	CRITICAL	Título do livro obrigatório
Consistência article-type	ERROR	Deve ser "book-review" quando <product> presente
Autor	WARNING	<person-group person-group-type="author"> recomendado
Editora	WARNING	<publisher-name> recomendado
Ano	WARNING	<year> recomendado

Arquivos criados:

• packtools/sps/models/product.py — modelo de extração de dados do XML
• packtools/sps/validation/product.py — ProductValidation e ArticleProductValidation
• packtools/sps/validation_rules/product_rules.json — níveis de erro configuráveis
• tests/sps/validation/test_product.py — 53 testes unitários

Arquivos modificados:

• packtools/sps/validation/xml_validations.py — validate_products() + import
• packtools/sps/validation/xml_validator.py — grupo "product" no orquestrador

Onde a revisão poderia começar?

packtools/sps/validation/product.py — contém toda a lógica de validação. O modelo em packtools/sps/models/product.py extrai os dados do XML.

Como este poderia ser testado manualmente?

from lxml import etree
from packtools.sps.validation.product import ArticleProductValidation

xml = '''<article article-type="book-review" xml:lang="en">
  <front><article-meta>
    <product product-type="book">
      <source>Book Title</source>
    </product>
  </article-meta></front>
</article>'''

rules = {"product_type_list": ["book"],
         "product_type_presence_error_level": "CRITICAL",
         "product_type_value_error_level": "ERROR",
         "source_presence_error_level": "CRITICAL",
         "article_type_consistency_error_level": "ERROR",
         "author_presence_error_level": "WARNING",
         "publisher_name_presence_error_level": "WARNING",
         "year_presence_error_level": "WARNING"}

validator = ArticleProductValidation(etree.fromstring(xml), rules)
for r in validator.validate():
    print(f"{r['title']}: {r['response']}")

Testes unitários:

python -m unittest tests.sps.validation.test_product -v

Algum cenário de contexto que queira dar?

Segue o padrão estabelecido por ext_link.py e tablewrap.py: usa build_response() com suporte completo a i18n (advice_text/advice_params), modelo separado da validação, regras configuráveis via JSON, e integração no orquestrador via xml_validations.py + xml_validator.py.

Todas as mensagens usam gettext.gettext (_()) para internacionalização. Validações condicionais retornam None quando não aplicáveis (ex: validate_product_type_value retorna None se o atributo está ausente).

Screenshots

N/A — sem impacto em UI.

Quais são tickets relevantes?

Criar validações para o elemento <product>.

Referências

• SPS 1.10 – <product>
• JATS 1.3 – <product>

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Criar validações para o elemento </issue_title>
<issue_description>## Objetivo

Implementar validações para o elemento <product> conforme a especificação SPS 1.10, aumentando a conformidade de X% para 70% (7 de 10 regras).

Nota: Algumas validações para <product> podem já estar parcialmente implementadas no repositório. Este Issue visa reavaliar, complementar e garantir cobertura completa das regras SPS 1.10.

---

Contexto

O elemento <product> é usado para marcação da referência de resenha quando relacionada a um livro ou capítulo de livro. Deve aparecer em artigos com @article-type="book-review". Validações corretas garantem que o atributo obrigatório esteja presente, que elementos essenciais da referência bibliográfica estejam completos, e que haja consistência com o tipo de artigo.

Conformidade atual: X de 10 regras implementadas (X%)
Meta após implementação: 7 de 10 regras (70%)

---

Documentação SPS

Referência oficial: https://docs.google.com/document/d/1GTv4Inc2LS_AXY-ToHT3HmO66UT0VAHWJNOIqzBNSgA/edit?tab=t.0#heading=h.product

Regras principais conforme SPS 1.10:

1. Ocorrência:

   • <product> pode aparecer zero ou mais vezes em <article-meta>

2. Atributo obrigatório:

   • @product-type="book" é obrigatório em <product>

3. Contexto de uso:

   • <product> deve aparecer em artigos com @article-type="book-review"
   • Serve para resenhas de livros ou capítulos de livros

4. Elementos tipicamente presentes:

   • <person-group person-group-type="author"> - Autor(es) do livro resenhado
   • <source> - Título do livro
   • <publisher-name> - Editora
   • <publisher-loc> - Local de publicação
   • <year> - Ano de publicação
   • <isbn> - ISBN do livro
   • <size units="pages"> - Número de páginas
   • <person-group person-group-type="translator"> - Tradutor(es) quando aplicável

5. Elementos essenciais para referência bibliográfica:

   • Autor, título (<source>), editora, ano são elementos fundamentais

---

Regras a Implementar

P0 – Críticas (implementar obrigatoriamente)

#	Regra	Nível	Descrição
1	Validar presença de @product-type	CRITICAL	O atributo @product-type é obrigatório em <product>
2	Validar valor de @product-type	ERROR	O valor de @product-type deve ser "book" para resenhas de livros
3	Validar presença de <source>	CRITICAL	O elemento <source> (título do livro) é obrigatório em <product>
4	Validar consistência com tipo de artigo	ERROR	Se <product> está presente, <article> deve ter @article-type="book-review"

P1 – Importantes (implementar se possível)

#	Regra	Nível	Descrição
5	Validar presença de autor	WARNING	Recomenda-se que <product> contenha <person-group person-group-type="author"> com informações do(s) autor(es)
6	Validar presença de editora	WARNING	Recomenda-se que <product> contenha <publisher-name>
7	Validar presença de ano	WARNING	Recomenda-se que <product> contenha <year>

P2 – Futuras (fora do escopo deste Issue)

#	Regra	Motivo de exclusão
8	Validar formato completo de ISBN	Média complexidade - requer validação de checksum
9	Validar consistência de dados bibliográficos	Baixa prioridade - dados bibliográficos têm variações aceitas
10	Validar que não há <product> quando @article-type não é "book-review"	Baixa prioridade - inverso da regra 4

---

Arquivos a Criar/Modificar

Avaliar existentes (podem ter validações parciais):

• packtools/sps/models/product.py ou similar – Verificar se modelo existe
• packtools/sps/validation/product.py – Verificar validações existentes
• packtools/sps/validation/rules/product_rules.json ou similar – Verificar configuração

Criar (se não existirem):

• packtools/sps/models/product.py – Modelo de extração de dados
• packtools/sps/validation/product.py – Validações
• packtools/sps/validation/rules/product_rules.json – Configuração de níveis de erro
• tests/sps/validation/test_product.py – Testes unitários

Referenciar (implementações similares):

• packtools/sps/validation/article_contribs.py – Validação de person-group
• packtools/sps/validation/utils.py – Funções auxiliares (build_response)

---

Exemplos de XML

XML Válido (deve passar sem erros):

<!-- Exemplo 1: Produto completo com todos os elementos recomendados -->
<article article-type="book-review" xml:lang="en">
    <front>
        <article-meta>
            <product product-type="book">
                <person-group person-group-type="author">
                    <name>
                        <surname>ONFRAY</surname>
                        <given-names>Michel</given-names>
         ...

</details>



<!-- START COPILOT CODING AGENT SUFFIX -->

- Fixes scieloorg/packtools#1102

<!-- START COPILOT CODING AGENT TIPS -->
---

💬 Send tasks to Copilot coding agent from [Slack](https://gh.io/cca-slack-docs) and [Teams](https://gh.io/cca-teams-docs) to turn conversations into code. Copilot posts an update in your thread when it's finished.