AI Content Generation Admin

Flow ID: AD-47 | Module(s): Ai (domain layer), ai (legacy module) | Complexity: High Last Updated: 2026-04-04

Business Context

The AI content generation system integrates OpenAI (and potentially other LLM providers) to help administrators generate product descriptions, blog content, category descriptions, and other text content directly within the admin panel. The system has two major subsystems:

Content Generation: The actual text generation pipeline, backed by OpenAI's completion API. Administrators provide a prompt, and the system generates text that can be applied to product fields, blog articles, or other entity fields. Every generation is logged for audit.
AI Positions: Configuration for AI-powered product recommendation widgets on the storefront. Each "position" defines a placement on a specific page (product detail, cart, homepage, etc.) with parameters for recommendation type, minimum items, and request limits.

Both subsystems have full modern domain layers with REST CRUD APIs, while the content generation also has a legacy library layer that integrates directly with OpenAI.

API Reference

REST Endpoints -- Content Generation

Method	Path	Action	Description
GET	`/rest/ai/content-generation`	`index`	List generation log entries (paginated)
GET	`/rest/ai/content-generation/item`	`item`	Get single entry by filter
GET	`/rest/ai/content-generation/{id}`	`show`	Get entry by ID
POST	`/rest/ai/content-generation`	`store`	Create/log a generation entry
POST	`/rest/ai/content-generation/{id}`	`update`	Update a generation entry
DELETE	`/rest/ai/content-generation/{id}`	`destroy`	Delete a generation entry

Filters: id (exact), user (exact), field (exact), entityType (exact), lang (exact) Sorts: id

REST Endpoints -- AI Position

Method	Path	Action	Description
GET	`/rest/ai/position`	`index`	List positions (paginated)
GET	`/rest/ai/position/item`	`item`	Get single position by filter
GET	`/rest/ai/position/{id}`	`show`	Get position by ID
POST	`/rest/ai/position`	`store`	Create a position
POST	`/rest/ai/position/{id}`	`update`	Update a position
DELETE	`/rest/ai/position/{id}`	`destroy`	Delete a position

Filters: id (exact), slug (exact), recommendationType (exact), page (exact), active (exact), title.{locale} (partial via MUI) Sorts: id, slug, title.{locale}Relations: translations (one_to_many)

Legacy Admin Routes

AI settings and content generation are managed through the legacy AI module controllers:

Route	Controller	Purpose
`settings/advisable-ai/(.+)`	`AdvAdvisableAiSettings`	AI provider settings page
`xml/advisable_ai`	`AdvAdvisableAIXml`	AI data feed XML export

Code Flow

Content Generation (Legacy Library)

Admin triggers content generation from a product/entity edit page.
The admin page calls the AdvContentGeneration library with a prompt string.
generate($content, $user, $provider): a. If no provider specified, creates getDefaultProvider() using OpenAI with registry-stored config. b. Calls $provider->generateCompletion($content, $user) which sends the prompt to OpenAI's completions API. c. Returns the generated text.
The calling controller logs the generation in ai_content_generation table via the model.
The generated text is returned to the admin UI for review and application.

Content Generation (REST API)

The REST API primarily serves as a log/audit layer for content generation records:

POST /rest/ai/content-generation with:

json

{
  "user": "admin@example.com",
  "field": "description",
  "entityType": "product",
  "prompt": "Write a description for...",
  "generatedText": "Generated content...",
  "lang": "el"
}

Controllers\ContentGeneration::store() -> WriteService::create().
WriteData::fromArray() maps to entity columns.
Inserts into ai_content_generation with automatic timestamps.

AI Position Management

GET /rest/ai/position?filter[active]=1&with=translations
Returns active recommendation positions with localized titles.
Storefront recommendation widgets query positions by slug to determine which recommendation types to display and how many items to request.

Domain Layer

ContentGeneration (`src/Domains/Ai/ContentGeneration/`)

Component	Class	Description
Entity	`Repository\Entity`	`id`, `user`, `field`, `entity_type`, `prompt`, `generated_text`, `entry_date`, `entry_datetime`, `lang`
Repository	`Repository\Repository`	Table `ai_content_generation`
RepositoryConfigurator	`Repository\RepositoryConfigurator`	No relations
Service	`Service`	Read service
WriteService	`WriteService`	Full CRUD
WriteData	`WriteData`	All entity fields as writable properties
Validator	`Validator`	Stub validator

Position (`src/Domains/Ai/Position/`)

Component	Class	Description
Entity	`Repository\Entity`	`id`, `slug`, `recommendation_type`, `page`, `min_items`, `request_limit`, `active`. Implements `FilterTranslation`
MuiEntity	`Repository\MuiEntity`	MUI translations for position titles
Repository	`Repository\Repository`	Table `ai_position`
MuiRepository	`Repository\MuiRepository`	Translation repository
Service	`Service`	Read service with MUI filter/sort
WriteService	`WriteService`	Full CRUD with MUI writes
WriteData	`WriteData`	`slug`, `recommendationType`, `page`, `minItems`, `requestLimit`, `active`
MuiWriteData	`MuiWriteData`	Translation write data
FilterByTranslation	`Specification\FilterByTranslation`	MUI join for title filtering
SortByTranslation	`Specification\SortByTranslation`	MUI join for title sorting

REST Layer (`src/Rest/Ai/`)

Component	Class	Description
Controller	`Controllers\ContentGeneration`	Full CRUD with HandlesWriteActions
Controller	`Controllers\Position`	Full CRUD with HandlesWriteActions
Resource	`Resources\ContentGeneration\Resource`	Generation log entry resource
Resource	`Resources\Position\Resource`	Position resource with translations
MuiResource	`Resources\Position\MuiResource`	Position translation resource

DI Container (`src/Domains/Ai/container.php`)

Registers all ContentGeneration and Position domain services, repositories, write services, and validators.

Architecture

Legacy AI Module (`ecommercen/ai/`)

Component	Path	Purpose
`AdvContentGeneration`	`ecommercen/ai/libraries/AdvContentGeneration.php`	OpenAI integration library
`AdvAIConnector`	`ecommercen/ai/libraries/AdvAIConnector.php`	HTTP client for AI service
`CoreAIConnector`	`ecommercen/ai/libraries/CoreAIConnector.php`	Core connector abstraction
`AdvAdvisableAI`	`ecommercen/ai/libraries/AdvAdvisableAI.php`	Advisable AI recommendation engine client
`AdvAIRecommendationPages`	`ecommercen/ai/libraries/AdvAIRecommendationPages.php`	Page type definitions for recommendations
`AdvAIRecommendationTypes`	`ecommercen/ai/libraries/AdvAIRecommendationTypes.php`	Recommendation algorithm types
`AdvAIRecommendationViewModel`	`ecommercen/ai/libraries/AdvAIRecommendationViewModel.php`	View model for recommendation widgets
`AdvAiContentGeneration`	`ecommercen/ai/models/AdvAiContentGeneration.php`	Legacy model for generation log
`AdvAIPagePositions`	`ecommercen/ai/models/AdvAIPagePositions.php`	Legacy model for position management
`aiContentGenerationTrait`	`ecommercen/ai/traits/aiContentGenerationTrait.php`	Shared trait for content generation
`AdvAdvisableAiSettings`	`ecommercen/ai/controllers/AdvAdvisableAiSettings.php`	AI settings admin controller

Modern Layer

Component	Path	Purpose
Domain container	`src/Domains/Ai/container.php`	DI registration
REST container	`src/Rest/Ai/container.php`	REST controller registration
REST routes	`application/config/rest_routes.php:1249-1278`	Content generation and position routes

Data Model