itsulu-blog-publisher/README.md

ITSulu Blog Publisher

AI-powered blog post generation for Odoo with multi-LLM support, scheduling, and social media integration.

Overview

ITSulu Blog Publisher replaces fragile external blog-generation workflows with a fully server-side Odoo addon. Generate blog posts on-demand or on a schedule using Claude (Anthropic), OpenAI, Google Gemini, or Ollama. Posts are auto-populated with SEO metadata and social media copy, ready to publish.

Features

• Multi-LLM Support: Anthropic Claude, OpenAI GPT, Google Gemini, Ollama / Open WebUI
• Three Configurable Daily Slots: morning, afternoon, evening — each with independent LLM provider + model selection
• On-Demand & Scheduled Generation: Backend wizard + website toolbar button + hourly cron dispatcher
• Topic Queue: Priority-ranked topic suggestions from ITSulu/company services
• Single Structured-JSON LLM Call: Lowest possible token usage — one API call returns title, body, SEO fields, tags, and social copy
• Auto-Populated SEO: meta title, description, keywords, tags
• Social Media Copy: X/Twitter (A+B), BlueSky (A+B), Mastodon, LinkedIn — platform-specific length limits
• Notification Email: Matches ITSulu Insights template format with social copy and source citations
• Generation Log: Full audit trail with token usage, duration, error messages, and retry button
• Editable Prompt Templates: System and user prompts in Settings UI

Requirements

Odoo Version

• Target: Odoo 17.0 Community (development branch)
• Planned: Odoo 14.0 Community (separate branch for App Store)

Python Dependencies

• requests (included in Odoo)
• anthropic (for Anthropic Claude) — optional
• openai (for OpenAI) — optional
• google-generativeai (for Gemini) — optional
• Ollama uses OpenAI-compatible REST API (no SDK needed)

Odoo Module Dependencies

• base
• website
• website_blog
• mail
• base_setup

Installation

From Source (Development)

# Clone the addon
git clone https://github.com/itsulu/itsulu-blog-publisher.git
cd itsulu-blog-publisher

# Copy addon into your Odoo addons path
cp -r addons/itsulu_blog_publisher /path/to/odoo/addons/

# Install via Odoo UI: Apps > Search "Blog Publisher" > Install

Docker (Testing)

docker build -t itsulu-blog-publisher:latest .
docker run -p 8069:8069 itsulu-blog-publisher:latest

Configuration

1. Enable the addon: Apps > Search "Blog Publisher" > Install
2. Settings: Go to Blog Publisher > Settings
   • Set API keys for your LLM provider(s)
   • Configure default LLM provider and model
   • Set notification email recipients
   • (Optional) Edit system and user prompt templates
3. Create a blog: Website > Blogs (if not already created)
4. Schedule slots: Blog Publisher > Schedule Slots
   • Create or edit morning/afternoon/evening slots
   • Select target blog, LLM provider + model, auto-publish
5. Activate scheduling: Set active=True on desired slots + enable the cron in Settings

Usage

Generate On-Demand

1. From backend: Blog Publisher > Generate Now (wizard selects topic, LLM, blog, tone)
2. From website: Visit your blog frontend, click "Generate Post" button in toolbar
3. View result: Blog Publisher > Generation Log (inspect token usage, errors, or publish)

Topic Queue

• Blog Publisher > Topic Queue
• Create topics with priority (low / normal / high / urgent)
• Scheduler pulls pending topics in priority order
• Mark used/skipped after generation

Scheduled Generation

• Enable the hourly cron: Settings > Blog Publisher > Activate Scheduling
• Each active slot (morning/afternoon/evening) triggers at configured UTC time
• Auto-publishes if auto_publish=True, otherwise in draft

Development

Testing Framework

• Unit tests: pytest-odoo (TransactionCase)
• BDD tests: pytest-bdd (Gherkin features)
• E2E tests: Playwright (critical user journeys only)

Run tests locally:

# All tests
pytest addons/itsulu_blog_publisher/tests/ -v

# Single test class
pytest addons/itsulu_blog_publisher/tests/test_llm_router.py::TestLLMRouter -v

# With coverage
pytest addons/itsulu_blog_publisher/tests/ --cov=addons/itsulu_blog_publisher

# BDD features only
pytest addons/itsulu_blog_publisher/features/ -v

Kubernetes CI/CD

The addon includes full Kubernetes test infrastructure:

• Template database priming (Odoo 17 init job)
• Ephemeral test job pods (auto-cleanup)
• PostgreSQL 15 persistent database
• GitLab Container Registry integration

See kubernetes/itsulu-testing/README.md for setup details.

Architecture

See ARCHITECTURE.md for:

• Data model specifications
• LLM router design
• Generation orchestration flow
• Settings and notification email format
• CI/CD infrastructure

See CLAUDE.md for:

• Odoo testing framework (TDD/BDD)
• Kubernetes test infrastructure gotchas
• Pre-commit hooks
• Failure recovery reference

Contributing

We follow strict TDD discipline:

1. Write a failing test (show to reviewers)
2. Implement minimum code to pass
3. Refactor; test stays green
4. Run pre-commit hooks before submitting PR

All code contributions must:

• Have > 80% test coverage on new code
• Pass pre-commit run --all-files
• Follow PEP 8 (via black, isort, flake8)
• Include descriptive test names (not just "test1, test2")

See CLAUDE.md for the complete TDD workflow.

Roadmap

Phase 1 (Current)

• ✅ Core generation orchestration
• ✅ Multi-LLM router
• ✅ Blog.post + social media model
• ✅ Schedule slots + cron dispatcher
• ✅ Settings + notification email
• ✅ Kubernetes test infrastructure
• 🔄 BDD/TDD test suite (in progress)

Phase 2

• Image generation provider (DALL·E, Stable Diffusion)
• Coverage gates (≥80% on new code)
• Multi-language support
• Advanced scheduling (time zones, day-of-week patterns)

Phase 3

• Playwright E2E journeys
• Performance regression testing
• Nightly smoke testing (CronJob)
• Runboat preview environment integration

License

This addon is licensed under the LGPL v3.0. See LICENSE for details.

Support

• Issues: https://github.com/itsulu/itsulu-blog-publisher/issues
• Documentation: See CLAUDE.md and ARCHITECTURE.md
• Testing Setup: See kubernetes/itsulu-testing/README.md

Authors

Built with ❤️ by ITSulu