arnes/spec/sdd/components/bulk-seo-worker.md

Component: Bulk SEO worker

Responsibility

Read product ids from queue. Call OpenAI with EN and ES prompts. Clean output. Update OpenCart product description fields. Write processing logs.

Interfaces

• Input:
  • CLI run of worker_bulk.php
  • rows from oc_product_queue
  • prompt files inc/prompt_en.md and inc/prompt_es.md
• Output:
  • updates in oc_product_description
  • status fields in oc_product_queue
  • log files under logs/

Dependencies

• MariaDB/MySQL
• OpenAI Chat Completions API
• local prompt markdown files

Limits

• No secret management yet.
• No retry queue store outside DB.
• No metrics or structured logs.

Success criteria

• Worker path is documented
• Queue and DB side effects are known
• Log location is explicit in design docs