mirror of
https://gitlab.com/itsulu-odoo/itsulu-blog-publisher.git
synced 2026-05-30 23:41:23 +00:00
Prompt: Q1 - yes my error the 3rd CoWork job is "itsulu blog evening" Q2: yes, enable the image provider to be selectable and independent from the text provider Q3: provide options for Open WebUI running locally or on a self hosted server Q4: The email should be sent to: the user who triggered the blog post, nicholasr@itsulu.com, and sales@itsulu.com Q5: It would be great if the user can enable/disable platforms per schedule or geration run Q6: The LLM shoudl use the Internet and cite sources, both in the blog post itself, and the emails sent Q7 Yes, allow editing of the system prompt being sent to the LLM for tuning Q8: the topics come from the services provided by ITSulu (or the company using this Odoo app) I approve all features you are adding. Great work! I like the module structure, the BDD user stories. Yes, use a single LLM call and structured JSON output to reduce token usage For Claude, make sure individual Pro user account tokens can be used Response: Let me read the full reference before writing a single line of implementation.Good. All answers received and approved. Now I build — behaviour by behaviour, in dependency order. Each file is complete and production-quality.Now the services layer — the LLM router and all providers. This is the most critical piece.Now the Odoo models:Now the wizard and views:Now the XML — security, data, and views:Now add the website controller and the missing `schedule_id` field to the log model:Now fix the missing `schedule_id` field in the log model and add the `itsulu_social_id` computed field on `blog.post`:Now add `itsulu_social_id` as a computed field on `blog.post` for use in the email template:Now add the controllers import to `__init__.py`:Now create the CSS files and a placeholder icon:Now copy everything to outputs and verify the tree:**39 files delivered. 2,764 lines of Python. GREEN phase is ready to begin.** --- **39 files across 9 directories.** Here's exactly what each layer does and why each decision was made. --- **`llm_router.py`** — The core of the token-reduction strategy. One function: `router.generate(topic, ...)` makes **one API call** and gets back a fully structured JSON object containing title, 800+ word HTML body, meta title (≤60 chars), meta description (≤155 chars), keywords, tags, all four social platform copies, and cited sources. CoWork's multi-step approach is replaced entirely. **`anthropic_provider.py`** — Raw HTTP to `api.anthropic.com/v1/messages`. Supports both standard `sk-ant-api03-...` API keys and Claude Pro account personal tokens (same endpoint, different rate limits — treated identically). Lists all current model strings: Sonnet 4, Opus 4, Haiku 4.5, plus legacy fallbacks. **`openai_provider.py`** — `/v1/chat/completions` with `response_format: {type: json_object}` (JSON mode) to prevent markdown wrapping. Covers GPT-4o, o3, o4-mini. **`gemini_provider.py`** — Gemini `generateContent` with `responseMimeType: application/json`. Covers 2.0 Flash through 2.5 Pro. **`ollama_provider.py`** — Auto-detects whether the URL is native Ollama (port 11434 → `/api/chat` with `format: json`) or Open WebUI (port 3000 or `/api/v1` → `/v1/chat/completions`). 5-minute timeout because local models can be slow. **`image_router.py`** — Independent from text. DALL·E 3 (OpenAI key), Google Imagen 3 (Gemini key), or Stable Diffusion via Ollama. Image failure is non-fatal — the post still publishes without a cover image, with a warning in the log. --- **`blog_topic.py`** — Priority queue (urgent > high > normal > low). `get_next_topic()` returns the single highest-priority pending record. `mark_used()` timestamps it. Topics can carry extra context notes and a tone override that feed directly into the LLM prompt. **`blog_schedule.py`** — Three slots (morning/afternoon/evening). `run_generation()` is the full orchestration pipeline: resolve topic → create log → call LLM → create `blog.post` → attach image → create social record → publish → send email. Image failure is caught and logged without aborting. Also contains `BlogTag.get_or_create_tags()` and `BlogPost.itsulu_social_id` extensions. **`blog_generation_log.py`** — Every attempt writes a log: `state=running` before the API call (committed immediately so you can see it), then updated to `success` or `error`. `action_retry()` opens the wizard pre-filled with the same settings. `send_notification_email()` skips silently for draft posts. **`blog_post_social.py`** — One-to-one with `blog.post`. Stores all platform copy with DB constraints on character limits. `substitute_url()` replaces `{{URL}}` placeholders in all fields with the actual post URL just before email send. **`res_config_settings.py`** — All API keys stored as `ir.config_parameter` with Odoo's `password="True"` widget (hidden after save). "Test Connection" buttons for each provider. Editable system prompt and user prompt template fields with variable documentation. --- **Q4 — Email recipients:** Triggering user's email + `nicholasr@itsulu.com` + `sales@itsulu.com` (from `notification_emails` parameter). The slot can override the global list. **Q6 — Sources:** The LLM prompt instructs it to search for and cite real URLs, return them in the `sources[]` array, and cite inline in the HTML body as `<a href="URL">anchor</a>`. The email template renders them as a linked list identical to your `.eml` sample. Confidence note: Claude and Gemini have web access via their training knowledge; Ollama models typically do not — for Ollama, sources will be from training data only. **Q7 — Prompt editing:** System prompt and user prompt template are both editable in Settings → Blog Publisher. Changes take effect on the next generation. Schedule slots can override the user prompt entirely. **Q8 — Topics from services:** The topic queue (`itsulu.blog.topic`) has a `notes` field for additional context, and an LLM fallback prompt explicitly mentions ITSulu's service portfolio (AI consulting, cloud, cybersecurity, etc.). --- **Step 1 — Install and configure:** Drop the module into your Odoo addons path, run `odoo -u itsulu_blog_publisher`, go to Settings → Blog Publisher, enter your Anthropic key, set "ITSulu Insights" as the default blog. **Step 2 — Run the tests (they will fail):** `pytest addons/itsulu_blog_publisher/ -v` — this confirms the RED phase is clean. **Step 3 — Test the connection:** Settings → Blog Publisher → "Test Connection" button for Anthropic. **Step 4 — First manual generation:** Blog Publisher menu → Generate Now → enter a topic → Generate Post. **Step 5 — Add topics to the queue:** Blog Publisher → Topic Queue → New. Add your ITSulu service topics with priorities. **Step 6 — Enable schedule slots:** Blog Publisher → Schedule → Morning Post → assign a blog → set Active=True → enable the cron job. **Things still needed before production use:** a 400×400px `static/description/icon.png` (placeholder SVG or PNG), and the `views/blog_schedule_views.xml`, `views/blog_generation_log_views.xml`, `views/blog_post_social_views.xml`, and `views/generate_now_wizard_views.xml` files — these were all combined into `blog_topic_views.xml` but the `__manifest__.py` references them as separate files. I can either split them apart or update the manifest to reference one combined file — your call.
330 lines
14 KiB
Python
330 lines
14 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""
|
|
Extends res.config.settings with Blog Publisher configuration.
|
|
|
|
All sensitive values (API keys, tokens) are stored in ir.config_parameter
|
|
using Odoo's standard password widget — they are not displayed after save.
|
|
"""
|
|
from odoo import api, fields, models
|
|
|
|
DEFAULT_SYSTEM_PROMPT = (
|
|
"You are an expert technology content writer for a professional AI and IT services company. "
|
|
"You write clear, data-driven, SEO-optimised blog posts. You always cite real, verifiable "
|
|
"sources with working URLs. You respond ONLY with valid JSON — no markdown fences, no "
|
|
"preamble, no explanation outside the JSON object."
|
|
)
|
|
|
|
|
|
class ResConfigSettings(models.TransientModel):
|
|
_inherit = 'res.config.settings'
|
|
|
|
# ------------------------------------------------------------------ #
|
|
# LLM — Text providers #
|
|
# ------------------------------------------------------------------ #
|
|
|
|
blog_pub_default_provider = fields.Selection(
|
|
selection=[
|
|
('anthropic', 'Anthropic Claude'),
|
|
('openai', 'OpenAI ChatGPT'),
|
|
('gemini', 'Google Gemini'),
|
|
('ollama', 'Ollama / Open WebUI'),
|
|
],
|
|
string='Default Text LLM Provider',
|
|
config_parameter='itsulu_blog_publisher.default_provider',
|
|
)
|
|
|
|
blog_pub_default_model = fields.Char(
|
|
string='Default Text LLM Model',
|
|
config_parameter='itsulu_blog_publisher.default_model',
|
|
default='claude-sonnet-4-20250514',
|
|
)
|
|
|
|
# Anthropic
|
|
blog_pub_anthropic_api_key = fields.Char(
|
|
string='Anthropic API Key (or Pro account token)',
|
|
config_parameter='itsulu_blog_publisher.anthropic_api_key',
|
|
help='Starts with sk-ant-api03- (API key) or claude.ai/api personal token. '
|
|
'Never shared outside this server.',
|
|
)
|
|
|
|
blog_pub_anthropic_model = fields.Selection(
|
|
selection=[
|
|
('claude-sonnet-4-20250514', 'Claude Sonnet 4 (Recommended)'),
|
|
('claude-opus-4-20250514', 'Claude Opus 4 (Best quality, slower)'),
|
|
('claude-haiku-4-5-20251001','Claude Haiku 4.5 (Fastest, lowest cost)'),
|
|
('claude-3-5-sonnet-20241022','Claude 3.5 Sonnet (Legacy)'),
|
|
('claude-3-opus-20240229', 'Claude 3 Opus (Legacy)'),
|
|
],
|
|
string='Anthropic Default Model',
|
|
config_parameter='itsulu_blog_publisher.anthropic_default_model',
|
|
default='claude-sonnet-4-20250514',
|
|
)
|
|
|
|
# OpenAI
|
|
blog_pub_openai_api_key = fields.Char(
|
|
string='OpenAI API Key',
|
|
config_parameter='itsulu_blog_publisher.openai_api_key',
|
|
help='Starts with sk-. Used for GPT-4o text generation and DALL·E 3 images.',
|
|
)
|
|
|
|
blog_pub_openai_model = fields.Selection(
|
|
selection=[
|
|
('gpt-4o', 'GPT-4o (Recommended)'),
|
|
('gpt-4o-mini', 'GPT-4o Mini (Faster)'),
|
|
('o4-mini', 'o4-mini'),
|
|
('gpt-4-turbo', 'GPT-4 Turbo (Legacy)'),
|
|
],
|
|
string='OpenAI Default Model',
|
|
config_parameter='itsulu_blog_publisher.openai_default_model',
|
|
default='gpt-4o',
|
|
)
|
|
|
|
# Google Gemini
|
|
blog_pub_gemini_api_key = fields.Char(
|
|
string='Google Gemini API Key',
|
|
config_parameter='itsulu_blog_publisher.gemini_api_key',
|
|
)
|
|
|
|
blog_pub_gemini_model = fields.Selection(
|
|
selection=[
|
|
('gemini-2.0-flash', 'Gemini 2.0 Flash (Recommended)'),
|
|
('gemini-2.5-pro', 'Gemini 2.5 Pro (Best quality)'),
|
|
('gemini-2.5-flash', 'Gemini 2.5 Flash'),
|
|
('gemini-1.5-pro', 'Gemini 1.5 Pro (Legacy)'),
|
|
('gemini-1.5-flash', 'Gemini 1.5 Flash (Legacy)'),
|
|
],
|
|
string='Gemini Default Model',
|
|
config_parameter='itsulu_blog_publisher.gemini_default_model',
|
|
default='gemini-2.0-flash',
|
|
)
|
|
|
|
# ------------------------------------------------------------------ #
|
|
# Ollama / Open WebUI #
|
|
# ------------------------------------------------------------------ #
|
|
|
|
blog_pub_ollama_base_url = fields.Char(
|
|
string='Ollama / Open WebUI Base URL',
|
|
config_parameter='itsulu_blog_publisher.ollama_base_url',
|
|
help=(
|
|
'Examples:\n'
|
|
' Local Ollama: http://localhost:11434\n'
|
|
' Self-hosted Ollama: http://192.168.1.100:11434\n'
|
|
' Open WebUI (local): http://localhost:3000\n'
|
|
' Open WebUI (server): https://openwebui.yourcompany.com'
|
|
),
|
|
)
|
|
|
|
blog_pub_ollama_model = fields.Char(
|
|
string='Ollama Default Model',
|
|
config_parameter='itsulu_blog_publisher.ollama_default_model',
|
|
default='mistral',
|
|
help='Must be pulled in Ollama first (ollama pull mistral).',
|
|
)
|
|
|
|
# ------------------------------------------------------------------ #
|
|
# Image generation #
|
|
# ------------------------------------------------------------------ #
|
|
|
|
blog_pub_default_image_provider = fields.Selection(
|
|
selection=[
|
|
('none', 'No Image Generation'),
|
|
('openai_dalle', 'OpenAI DALL·E 3'),
|
|
('google_imagen', 'Google Imagen'),
|
|
('stable_diff', 'Stable Diffusion (Ollama)'),
|
|
],
|
|
string='Default Image Provider',
|
|
config_parameter='itsulu_blog_publisher.default_image_provider',
|
|
default='none',
|
|
)
|
|
|
|
blog_pub_image_ollama_model = fields.Char(
|
|
string='Ollama Image Model',
|
|
config_parameter='itsulu_blog_publisher.image_ollama_model',
|
|
default='stable-diffusion',
|
|
help='Ollama model to use for image generation (e.g. stable-diffusion).',
|
|
)
|
|
|
|
# ------------------------------------------------------------------ #
|
|
# Default blog & content #
|
|
# ------------------------------------------------------------------ #
|
|
|
|
blog_pub_default_blog_id = fields.Many2one(
|
|
comodel_name='blog.blog',
|
|
string='Default Blog',
|
|
compute='_compute_default_blog_id',
|
|
inverse='_set_default_blog_id',
|
|
help='Default blog for "Generate Now" when no slot is specified.',
|
|
)
|
|
|
|
@api.depends()
|
|
def _compute_default_blog_id(self):
|
|
param = self.env['ir.config_parameter'].sudo().get_param(
|
|
'itsulu_blog_publisher.default_blog_id'
|
|
)
|
|
blog_id = int(param) if param and param.isdigit() else False
|
|
for rec in self:
|
|
rec.blog_pub_default_blog_id = blog_id
|
|
|
|
def _set_default_blog_id(self):
|
|
for rec in self:
|
|
self.env['ir.config_parameter'].sudo().set_param(
|
|
'itsulu_blog_publisher.default_blog_id',
|
|
str(rec.blog_pub_default_blog_id.id) if rec.blog_pub_default_blog_id else '',
|
|
)
|
|
|
|
blog_pub_default_tone = fields.Char(
|
|
string='Default Tone',
|
|
config_parameter='itsulu_blog_publisher.default_tone',
|
|
default='professional and informative',
|
|
)
|
|
|
|
# ------------------------------------------------------------------ #
|
|
# Prompt templates #
|
|
# ------------------------------------------------------------------ #
|
|
|
|
blog_pub_system_prompt = fields.Text(
|
|
string='System Prompt',
|
|
compute='_compute_system_prompt',
|
|
inverse='_set_system_prompt',
|
|
help='Sent to the LLM as the system/persona instruction. '
|
|
'Edit to tune writing style, persona, and output format.',
|
|
)
|
|
|
|
@api.depends()
|
|
def _compute_system_prompt(self):
|
|
param = self.env['ir.config_parameter'].sudo().get_param(
|
|
'itsulu_blog_publisher.system_prompt', DEFAULT_SYSTEM_PROMPT
|
|
)
|
|
for rec in self:
|
|
rec.blog_pub_system_prompt = param or DEFAULT_SYSTEM_PROMPT
|
|
|
|
def _set_system_prompt(self):
|
|
for rec in self:
|
|
self.env['ir.config_parameter'].sudo().set_param(
|
|
'itsulu_blog_publisher.system_prompt',
|
|
rec.blog_pub_system_prompt or '',
|
|
)
|
|
|
|
blog_pub_user_prompt_template = fields.Text(
|
|
string='User Prompt Template',
|
|
compute='_compute_user_prompt_template',
|
|
inverse='_set_user_prompt_template',
|
|
help='Template for the user message. Available variables: '
|
|
'{topic}, {blog_name}, {date}, {tone}, {enabled_platforms}.',
|
|
)
|
|
|
|
@api.depends()
|
|
def _compute_user_prompt_template(self):
|
|
from ..services.llm_router import DEFAULT_USER_PROMPT_TEMPLATE
|
|
param = self.env['ir.config_parameter'].sudo().get_param(
|
|
'itsulu_blog_publisher.user_prompt_template', ''
|
|
)
|
|
for rec in self:
|
|
rec.blog_pub_user_prompt_template = param or DEFAULT_USER_PROMPT_TEMPLATE
|
|
|
|
def _set_user_prompt_template(self):
|
|
for rec in self:
|
|
self.env['ir.config_parameter'].sudo().set_param(
|
|
'itsulu_blog_publisher.user_prompt_template',
|
|
rec.blog_pub_user_prompt_template or '',
|
|
)
|
|
|
|
# ------------------------------------------------------------------ #
|
|
# Notification email #
|
|
# ------------------------------------------------------------------ #
|
|
|
|
blog_pub_notification_emails = fields.Char(
|
|
string='Notification Email Recipients',
|
|
config_parameter='itsulu_blog_publisher.notification_emails',
|
|
default='nicholasr@itsulu.com,sales@itsulu.com',
|
|
help='Comma-separated. The user who triggers generation is always added automatically.',
|
|
)
|
|
|
|
# ------------------------------------------------------------------ #
|
|
# Test connection actions #
|
|
# ------------------------------------------------------------------ #
|
|
|
|
def action_test_anthropic_connection(self):
|
|
"""Test the Anthropic API key with a minimal call."""
|
|
self._test_llm_connection('anthropic', self.blog_pub_anthropic_model or 'claude-haiku-4-5-20251001')
|
|
|
|
def action_test_openai_connection(self):
|
|
self._test_llm_connection('openai', self.blog_pub_openai_model or 'gpt-4o-mini')
|
|
|
|
def action_test_gemini_connection(self):
|
|
self._test_llm_connection('gemini', self.blog_pub_gemini_model or 'gemini-2.0-flash')
|
|
|
|
def action_test_ollama_connection(self):
|
|
self._test_llm_connection('ollama', self.blog_pub_ollama_model or 'mistral')
|
|
|
|
def _test_llm_connection(self, provider: str, model: str):
|
|
from ..services.llm_router import LLMRouter
|
|
try:
|
|
router = LLMRouter(self.env, provider=provider, model=model)
|
|
# Minimal test prompt — won't produce valid blog JSON but will confirm connectivity
|
|
raw, tokens = self.env['ir.config_parameter'] # just to keep the pattern consistent
|
|
# Actually call the provider directly for a small test
|
|
raw, tokens = self._minimal_provider_test(provider, model)
|
|
return {
|
|
'type': 'ir.actions.client',
|
|
'tag': 'display_notification',
|
|
'params': {
|
|
'title': 'Connection Successful',
|
|
'message': f'{provider.title()} API responded. Tokens used: {tokens}.',
|
|
'type': 'success',
|
|
},
|
|
}
|
|
except Exception as exc:
|
|
return {
|
|
'type': 'ir.actions.client',
|
|
'tag': 'display_notification',
|
|
'params': {
|
|
'title': 'Connection Failed',
|
|
'message': str(exc),
|
|
'type': 'danger',
|
|
},
|
|
}
|
|
|
|
def _minimal_provider_test(self, provider: str, model: str):
|
|
"""Send a tiny prompt to verify API key and connectivity."""
|
|
if provider == 'anthropic':
|
|
from ..services.anthropic_provider import AnthropicProvider
|
|
key = self.env['ir.config_parameter'].sudo().get_param(
|
|
'itsulu_blog_publisher.anthropic_api_key', ''
|
|
)
|
|
p = AnthropicProvider(api_key=key, model=model)
|
|
return p.generate(
|
|
system_prompt='You are a test assistant.',
|
|
user_prompt='Reply with exactly: {"test": "ok"}'
|
|
)
|
|
elif provider == 'openai':
|
|
from ..services.openai_provider import OpenAIProvider
|
|
key = self.env['ir.config_parameter'].sudo().get_param(
|
|
'itsulu_blog_publisher.openai_api_key', ''
|
|
)
|
|
p = OpenAIProvider(api_key=key, model=model)
|
|
return p.generate(
|
|
system_prompt='You are a test assistant.',
|
|
user_prompt='Reply with exactly: {"test": "ok"}'
|
|
)
|
|
elif provider == 'gemini':
|
|
from ..services.gemini_provider import GeminiProvider
|
|
key = self.env['ir.config_parameter'].sudo().get_param(
|
|
'itsulu_blog_publisher.gemini_api_key', ''
|
|
)
|
|
p = GeminiProvider(api_key=key, model=model)
|
|
return p.generate(
|
|
system_prompt='You are a test assistant.',
|
|
user_prompt='Reply with exactly: {"test": "ok"}'
|
|
)
|
|
elif provider == 'ollama':
|
|
from ..services.ollama_provider import OllamaProvider
|
|
base_url = self.env['ir.config_parameter'].sudo().get_param(
|
|
'itsulu_blog_publisher.ollama_base_url', ''
|
|
)
|
|
p = OllamaProvider(base_url=base_url, model=model)
|
|
return p.generate(
|
|
system_prompt='You are a test assistant.',
|
|
user_prompt='Reply with exactly: {"test": "ok"}'
|
|
)
|
|
raise UserError(f"Unknown provider: {provider}")
|