# Ecommercen Docs

> API & Business Logic Documentation

Reference, guides, and business flow traces for the Ecommercen platform

## Table of Contents

### API Usage Guides

- [Authentication](/api-guides/authentication.md)
- [Pagination](/api-guides/pagination.md)
- [Filtering](/api-guides/filtering.md)
- [Sorting](/api-guides/sorting.md)
- [Relations (Eager Loading)](/api-guides/relations.md)
- [Multi-Language Support](/api-guides/multi-language.md)
- [Response Scoping](/api-guides/response-scoping.md)
- [Error Responses](/api-guides/errors.md)






















































































































### Architecture & Patterns

- [REST API Modules Documentation](/guides/RestApiModules.md)
- [REST Middleware & RBAC](/guides/rest-middleware.md)
- [Documentation Site](/guides/DocsSite.md)
- [Architectural Refactoring: Data Access Layer](/guides/RefactorDomainsToRepositoryWithSpecifications.md)
- [Code Style Guide](/guides/CodeStyleGuide.md)
- [Untitled](/guides/CI3UpgradePath.md)

### Features & Modules

- [Cache System](/guides/Cache.md)
- [Circuit Breaker](/guides/CircuitBreaker.md)
- [Deferred Task Runner](/guides/DeferredTask.md)
- [Job Manager](/guides/JobManager.md)
- [Storage Refactoring and S3 Integration](/guides/Storage.md)
- [Gifts Module](/guides/GiftsModule.md)
- [Builder](/guides/Builder.md)
- [Contact Forms From Config](/guides/ContactFormsFromConfig.md)
- [Step 2](/guides/LangFiles.md)
- [Settings in database](/guides/settings_in_database.md)
- [Social Auth](/guides/SocialAuth.md)
- [Image Optimizations in EcommerceN 4.6](/guides/ImageOptimizationsIn4.6.md)
- [Lighthouse Performance Optimization - Product Page](/guides/LightHousePerformanceOptimize.md)

### Integrations

- [Advisable AI](/guides/AdvisableAI.md)
- [Google Recommendations AI](/guides/GoogleRecommendationsAi.md)
- [Databox integration](/guides/Databox.md)
- [Dhl](/guides/Dhl.md)
- [Iqvia](/guides/Iqvia.md)
- [[Stripe Docs](https://stripe.com/docs)](/guides/Stripe.md)

### Database & Migrations

- [Database Initialization](/guides/DatabaseInitialization.md)
- [Migrations](/guides/Migrations.md)
- [Testing Guide](/guides/Testing.md)

### DevOps & Setup

- [Docker for Local Development](/guides/docker/local-development.md)
- [🧩 Client Branch Setup & Workflow Guide](/guides/InitNewClient.md)
- [🧩 Plesk New Client Setup Guide](/guides/Plesk_New_Client_Setup_Guide.md)

### Solr Search

- [Setting Up a New Client with Solr](/guides/solr/setup_guide.md)
- [Adveshop4 and Solr](/guides/solr/adveshop4_and_solr.md)
- [Search V2](/guides/solr/search_v2.md)

### Claude Code

- [Agent System Overview](/guides/claude/system-overview.md)
- [Agent Catalog](/guides/claude/agent-catalog.md)
- [Usage Guide](/guides/claude/usage-guide.md)
- [Per-Developer Overrides](/guides/claude/developer-overrides.md)
- [Main vs Client Repo Flexibility](/guides/claude/repo-flexibility.md)


### Changelog

- [Version 4](/changelog/Changelog.md)

### Recent (4.90+)

- [Version 4](/changelog/Changelog.4.99.md)
- [Version 4](/changelog/Changelog.4.98.md)
- [Version 4](/changelog/Changelog.4.97.md)
- [Version 4](/changelog/Changelog.4.96.md)
- [Version 4](/changelog/Changelog.4.95.md)
- [Version 4](/changelog/Changelog.4.94.md)
- [Version 4](/changelog/Changelog.4.93.md)
- [Version 4](/changelog/Changelog.4.92.md)
- [Version 4](/changelog/Changelog.4.91.md)
- [Version 4](/changelog/Changelog.4.90.md)

### 4.80 – 4.89

- [Version 4](/changelog/Changelog.4.89.md)
- [Version 4](/changelog/Changelog.4.88.md)
- [Version 4](/changelog/Changelog.4.87.md)
- [Version 4](/changelog/Changelog.4.86.md)
- [Version 4](/changelog/Changelog.4.85.md)
- [Version 4](/changelog/Changelog.4.84.md)
- [Version 4](/changelog/Changelog.4.83.md)
- [Version 4](/changelog/Changelog.4.82.md)
- [Version 4](/changelog/Changelog.4.81.md)
- [Version 4](/changelog/Changelog.4.80.md)

### 4.60 – 4.79

- [Version 4](/changelog/Changelog.4.79.md)
- [Version 4](/changelog/Changelog.4.78.md)
- [Version 4](/changelog/Changelog.4.77.md)
- [Version 4](/changelog/Changelog.4.76.md)
- [Version 4](/changelog/Changelog.4.75.md)
- [Version 4](/changelog/Changelog.4.74.md)
- [Version 4](/changelog/Changelog.4.73.md)
- [Version 4](/changelog/Changelog.4.72.md)
- [Version 4](/changelog/Changelog.4.71.md)
- [Version 4](/changelog/Changelog.4.70.md)
- [Version 4](/changelog/Changelog.4.69.md)
- [Version 4](/changelog/Changelog.4.68.md)
- [Version 4](/changelog/Changelog.4.67.md)
- [Version 4](/changelog/Changelog.4.66.md)
- [Version 4](/changelog/Changelog.4.65.md)
- [Version 4](/changelog/Changelog.4.64.md)
- [Version 4](/changelog/Changelog.4.63.md)
- [Version 4](/changelog/Changelog.4.62.md)
- [Version 4](/changelog/Changelog.4.61.md)
- [Version 4](/changelog/Changelog.4.60.md)

### 4.2 – 4.59

- [Version 4](/changelog/Changelog.4.59.md)
- [Version 4](/changelog/Changelog.4.58.md)
- [Version 4](/changelog/Changelog.4.57.md)
- [Version 4](/changelog/Changelog.4.56.md)
- [Version 4](/changelog/Changelog.4.55.md)
- [Version 4](/changelog/Changelog.4.54.md)
- [Version 4](/changelog/Changelog.4.53.md)
- [Version 4](/changelog/Changelog.4.52.md)
- [Version 4](/changelog/Changelog.4.51.md)
- [Version 4](/changelog/Changelog.4.50.md)
- [Version 4](/changelog/Changelog.4.49.md)
- [Version 4](/changelog/Changelog.4.48.md)
- [Version 4](/changelog/Changelog.4.47.md)
- [Version 4](/changelog/Changelog.4.46.md)
- [Version 4](/changelog/Changelog.4.45.md)
- [Version 4](/changelog/Changelog.4.44.md)
- [Version 4](/changelog/Changelog.4.43.md)
- [Version 4](/changelog/Changelog.4.42.md)
- [Version 4](/changelog/Changelog.4.41.md)
- [Version 4](/changelog/Changelog.4.40.md)
- [Version 4](/changelog/Changelog.4.39.md)
- [Version 4](/changelog/Changelog.4.38.md)
- [Version 4](/changelog/Changelog.4.37.md)
- [Version 4](/changelog/Changelog.4.36.md)
- [Version 4](/changelog/Changelog.4.35.md)
- [Version 4](/changelog/Changelog.4.34.md)
- [Version 4](/changelog/Changelog.4.33.md)
- [Version 4](/changelog/Changelog.4.32.md)
- [Version 4](/changelog/Changelog.4.31.md)
- [Version 4](/changelog/Changelog.4.30.md)
- [Version 4](/changelog/Changelog.4.29.md)
- [Version 4](/changelog/Changelog.4.28.md)
- [Version 4](/changelog/Changelog.4.27.md)
- [Version 4](/changelog/Changelog.4.26.md)
- [Version 4](/changelog/Changelog.4.25.md)
- [Version 4](/changelog/Changelog.4.24.md)
- [Version 4](/changelog/Changelog.4.23.md)
- [Version 4](/changelog/Changelog.4.22.md)
- [Version 4](/changelog/Changelog.4.21.md)
- [Version 4](/changelog/Changelog.4.20.md)
- [Version 4](/changelog/Changelog.4.19.md)
- [Version 4](/changelog/Changelog.4.18.md)
- [Version 4](/changelog/Changelog.4.17.md)
- [Version 4](/changelog/Changelog.4.16.md)
- [Version 4](/changelog/Changelog.4.15.md)
- [Version 4](/changelog/Changelog.4.14.md)
- [Version 4](/changelog/Changelog.4.13.md)
- [Version 4](/changelog/Changelog.4.12.md)
- [Version 4](/changelog/Changelog.4.11.md)
- [Version 4](/changelog/Changelog.4.10.md)
- [Version 4](/changelog/Changelog.4.9.md)
- [Version 4](/changelog/Changelog.4.8.md)
- [Version 4](/changelog/Changelog.4.7.md)
- [Version 4](/changelog/Changelog.4.6.md)
- [Version 4](/changelog/Changelog.4.5.md)
- [Version 4](/changelog/Changelog.4.4.md)
- [Version 4](/changelog/Changelog.4.3.md)
- [Version 4](/changelog/Changelog.4.2.md)
- [Untitled](/changelog/ArchiveChangelog.md)

### Overview

- [Business Logic Flows](/flows.md)
- [Documentation Guidelines](/flows/guidelines.md)

### Customer-Facing Flows

- [Product Browsing (Category Page)](/flows/customer/CF-01-product-browsing.md)
- [Product Detail Page](/flows/customer/CF-02-product-detail.md)
- [URL Routing & Slug Resolution](/flows/customer/CF-03-url-routing.md)
- [Search](/flows/customer/CF-04-search.md)
- [Cart Management](/flows/customer/CF-05-cart-management.md)
- [Order Preview (Checkout Form)](/flows/customer/CF-06-order-preview.md)
- [Order Confirmation (Checkout View)](/flows/customer/CF-07-order-confirmation.md)
- [Payment Processing](/flows/customer/CF-08-payment-processing.md)
- [Payment Webhooks & Callbacks](/flows/customer/CF-09-payment-webhooks.md)
- [Customer Registration & Login](/flows/customer/CF-10-customer-auth.md)
- [Customer Account Management](/flows/customer/CF-11-customer-account.md)
- [Promotions (Storefront)](/flows/customer/CF-12-promotions-front.md)
- [Coupons](/flows/customer/CF-13-coupons.md)
- [Gift Rules & Free Products](/flows/customer/CF-14-gift-rules.md)
- [Waiting List (Notify When Available)](/flows/customer/CF-15-waiting-list.md)
- [Product Reviews](/flows/customer/CF-16-product-reviews.md)
- [Wishlist](/flows/customer/CF-17-wishlist.md)
- [Product Tags & Tag Pages](/flows/customer/CF-18-product-tags.md)
- [Vendors & Vendor Pages](/flows/customer/CF-19-vendors.md)
- [Blog](/flows/customer/CF-20-blog.md)
- [Offers / Special Offer Pages](/flows/customer/CF-21-offers.md)
- [Events](/flows/customer/CF-22-events.md)
- [Gift Cards](/flows/customer/CF-23-gift-cards.md)
- [Product Bundles](/flows/customer/CF-24-product-bundles.md)
- [Product Variations & Lines](/flows/customer/CF-25-product-variations.md)
- [Home Page](/flows/customer/CF-26-home-page.md)
- [Store Locator / Maps](/flows/customer/CF-28-maps.md)
- [Contact Forms](/flows/customer/CF-29-contact-forms.md)
- [Cookie Consent / GDPR](/flows/customer/CF-30-cookie-consent.md)
- [Documents / File Downloads](/flows/customer/CF-31-documents.md)
- [Loyalty Points System](/flows/customer/CF-32-loyalty-points.md)
- [Multi-Currency](/flows/customer/CF-33-multi-currency.md)
- [AI Recommendations](/flows/customer/CF-34-ai-recommendations.md)
- [Page Builder / Block System](/flows/customer/CF-35-page-builder.md)
- [Cart Customizations](/flows/customer/CF-36-cart-customizations.md)

### Admin Flows

- [Admin Authentication & SSO](/flows/admin/AD-01-admin-auth.md)
- [Product Management (Admin)](/flows/admin/AD-02-product-management-admin.md)
- [Admin Order Management](/flows/admin/AD-03-order-management-admin.md)
- [Admin Customer Management](/flows/admin/AD-04-customer-management-admin.md)
- [Category Management (Admin)](/flows/admin/AD-05-category-management.md)
- [Transporter / Shipping Management (Admin)](/flows/admin/AD-06-transporter-admin.md)
- [Promotion Management (Admin)](/flows/admin/AD-07-promotion-management.md)
- [Coupon Management (Admin)](/flows/admin/AD-08-coupon-management.md)
- [Gift Rules Management (Admin)](/flows/admin/AD-09-gift-rules-admin.md)
- [Reporting & Analytics](/flows/admin/AD-10-reporting.md)
- [Marketplace Order Management](/flows/admin/AD-11-marketplace-orders.md)
- [Blog Management (Admin)](/flows/admin/AD-12-blog-admin.md)
- [Admin Settings & Configuration](/flows/admin/AD-13-settings.md)
- [SEO Management (Admin)](/flows/admin/AD-14-seo-management.md)
- [Attributes & Tags Management (Admin)](/flows/admin/AD-15-attributes-tags.md)
- [Product Variations Management (Admin)](/flows/admin/AD-16-variations-admin.md)
- [Product Lines Management (Admin)](/flows/admin/AD-17-lines-admin.md)
- [Store Management (Admin)](/flows/admin/AD-18-store-management.md)
- [Vendor Management (Admin)](/flows/admin/AD-19-vendor-management.md)
- [Supplier Management (Admin)](/flows/admin/AD-20-supplier-management.md)
- [Slider / Slideshow Management](/flows/admin/AD-21-slider-management.md)
- [Audience & Campaign Management](/flows/admin/AD-22-audience-campaigns.md)
- [Gift Card Management (Admin)](/flows/admin/AD-23-gift-cards-admin.md)
- [Product Bundle Management (Admin)](/flows/admin/AD-24-bundles-admin.md)
- [Product Badges (Admin)](/flows/admin/AD-25-badges.md)
- [Language / i18n Management (Admin)](/flows/admin/AD-26-language-management.md)
- [Product Lists Management (Admin)](/flows/admin/AD-27-product-lists.md)
- [Order Tags (Admin)](/flows/admin/AD-28-order-tags.md)
- [Page Builder (Admin)](/flows/admin/AD-29-builder-admin.md)
- [Product Video Management (Admin)](/flows/admin/AD-30-video-management.md)
- [Admin Audit Logging](/flows/admin/AD-32-audit-logging.md)
- [Multi-Carrier Tracking](/flows/admin/AD-33-multi-carrier-tracking.md)
- [Shipping Voucher Generation](/flows/admin/AD-34-voucher-generation.md)
- [Currency Management (Admin)](/flows/admin/AD-36-currency-admin.md)
- [Metadata / Registry System](/flows/admin/AD-37-metadata-system.md)
- [Product Relations Admin](/flows/admin/AD-38-product-relations.md)
- [Country & County Management](/flows/admin/AD-39-country-management.md)
- [Internal Notes](/flows/admin/AD-40-internal-notes.md)
- [Customer Mail History](/flows/admin/AD-41-customer-mail-history.md)
- [Marketing Admin & Product Catalogs](/flows/admin/AD-42-marketing-catalogs.md)
- [New Product Prices (ERP Price Import)](/flows/admin/AD-43-new-product-prices.md)
- [Social Auth Settings](/flows/admin/AD-44-social-auth-settings.md)
- [Search Debug Admin](/flows/admin/AD-45-search-debug.md)
- [Plus / Audience Management REST](/flows/admin/AD-46-audience-rest.md)
- [AI Content Generation Admin](/flows/admin/AD-47-ai-content-generation.md)
- [CMS Static Pages](/flows/admin/AD-48-cms-pages.md)
- [Subcontent / Embeddable Blocks](/flows/admin/AD-49-subcontent.md)
- [VAT Rate Management](/flows/admin/AD-50-vat-management.md)
- [Shelf Code Management](/flows/admin/AD-51-shelf-codes.md)
- [Product Review Moderation](/flows/admin/AD-52-review-moderation.md)
- [Email Template Viewer](/flows/admin/AD-53-email-template-viewer.md)
- [POS / Phone Order Creation](/flows/admin/AD-54-pos-phone-orders.md)
- [Admin Task Management](/flows/admin/AD-55-task-management.md)
- [Recommendation Algorithm Priority](/flows/admin/AD-56-recommendation-algorithms.md)
- [Advisable Services Newsfeed](/flows/admin/AD-57-admin-newsfeed.md)

### System Flows

- [Cron Job Framework](/flows/system/SY-01-cron-framework.md)
- [Order Status Email Notifications](/flows/system/SY-02-order-status-emails.md)
- [Incomplete Order Cancellation](/flows/system/SY-03-incomplete-order-cancellation.md)
- [Price Tracking](/flows/system/SY-04-price-tracking.md)
- [Sitemap Generation](/flows/system/SY-05-sitemap-generation.md)
- [Solr Search Indexing](/flows/system/SY-06-solr-indexing.md)
- [Cache Management](/flows/system/SY-07-cache-management.md)
- [Database Backup](/flows/system/SY-08-database-backup.md)
- [Customer Data Jobs (GDPR / Sanitize / Tags / Audience)](/flows/system/SY-09-customer-data-jobs.md)
- [Loyalty Points Jobs](/flows/system/SY-10-loyalty-points-jobs.md)
- [Review Reminder Emails](/flows/system/SY-11-review-reminders.md)
- [Birthday & Points Emails](/flows/system/SY-12-birthday-points-emails.md)
- [Waiting List Notifications](/flows/system/SY-13-waiting-list-notifications.md)
- [Order Reminder Emails](/flows/system/SY-14-order-reminders.md)
- [Delivery Delay Notifications](/flows/system/SY-15-delivery-delay.md)
- [PayByBank Status Polling](/flows/system/SY-16-paybybank-polling.md)
- [Bulk Product Import](/flows/system/SY-17-bulk-product-import.md)
- [Image Upload from ZIP](/flows/system/SY-18-image-upload-zip.md)
- [Config Registry System](/flows/system/SY-19-config-registry.md)
- [Geolocation & Shipping Zones](/flows/system/SY-20-geolocation-shipping-zones.md)
- [Admin Dashboard Charts](/flows/system/SY-21-admin-dashboard-charts.md)
- [Job Manager & Queue Processing](/flows/system/SY-22-job-manager.md)
- [Multi-Language (MUI) Translation Pattern](/flows/system/SY-23-mui-translation-pattern.md)
- [Email Dispatch System (Adv\_mailer)](/flows/system/SY-24-email-dispatch.md)
- [File Upload & Storage Pattern](/flows/system/SY-25-file-upload-storage.md)
- [Circuit Breaker System](/flows/system/SY-26-circuit-breaker.md)
- [Deferred Task Runner](/flows/system/SY-27-deferred-task-runner.md)
- [Storage Abstraction Layer](/flows/system/SY-28-storage-abstraction.md)
- [Deployment Architecture](/flows/system/SY-29-deployment-architecture.md)
- [Client Features Reference](/flows/system/SY-30-client-features-reference.md)

### Integration Flows

- [Product Feed Generation (XML)](/flows/integration/IN-01-feed-generation.md)
- [Skroutz Marketplace Integration](/flows/integration/IN-02-skroutz-marketplace.md)
- [Shopflix Marketplace Integration](/flows/integration/IN-03-shopflix-marketplace.md)
- [Public Marketplace (Mirakl) Integration](/flows/integration/IN-04-public-marketplace.md)
- [eMAG Marketplace Feed](/flows/integration/IN-05-emag-marketplace.md)
- [Google Merchant Center Feed](/flows/integration/IN-06-google-merchant.md)
- [Facebook Catalog & Conversions API](/flows/integration/IN-07-facebook-catalog-capi.md)
- [ERP Integrations (Pharma)](/flows/integration/IN-08-erp-integrations.md)
- [Transporter Integrations (Courier APIs)](/flows/integration/IN-09-transporter-integrations.md)
- [Doofinder Search Integration](/flows/integration/IN-10-doofinder.md)
- [Analytics Integrations (Matomo, Databox, Criteo, Contactpigeon)](/flows/integration/IN-12-analytics.md)
- [Newsletter Integrations (Mailchimp, Manago, Moosend, Apifon)](/flows/integration/IN-13-newsletter.md)
- [SMS Integrations (Yuboto, Routee, Plivo, Bulker, Apifon, OmniMessaging)](/flows/integration/IN-14-sms.md)
- [Content Embeddings / Smart Search](/flows/integration/IN-16-content-embeddings.md)
- [Order Webhooks (External Notifications)](/flows/integration/IN-20-order-webhooks.md)

### Other

- [Admin User Management](/flows/admin/AD-58-admin-user-management.md)
- [AdvEshop4 and Ethniki](/guides/ethniki/adveshop4_and_ethniki.md)
- [Adveshop4 and Project Agora](/guides/project_agora/adveshop4_and_project_agora.md)
- [Apache Nginx Reverse Proxy](/guides/servers/ApacheNginxReverseProxy.md)
- [Authentication & authorization](/guides/solr/configuring_solr/authentication_and_authorization.md)
- [Configuring Adveshop4 to work with solr](/guides/solr/configuring_adveshop4/configuring_adveshop4.md)
- [Configuring Solr](/guides/solr/configuring_solr/configuring_solr.md)
- [Creating a new core](/guides/solr/configuring_solr/creating_a_new_core.md)
- [Creating the schema from CLI](/guides/solr/configuring_adveshop4/creating_the_schema_from_cli.md)
- [Installing adveshop-processor](/guides/solr/configuring_solr/installing_adveshop-processor.md)
- [Nexi XPay Greece — Hosted Payment Page Integration](/flows/integration/IN-23-xpay-nexi-payment-gateway.md)
- [Overview](/guides/vue/plugins/config.md)
- [Overview](/guides/vue/plugins/locale.md)
- [REST API Versioning](/flows/system/SY-31-rest-api-versioning.md)
- [Settings To Registry Equivalent](/changelog/SettingsBackToRegistry.md)
- [SY-32: Logging Architecture and Migration Guide](/flows/system/SY-32-logging.md)
- [SY-33: Bot Detection and Session Exclusion](/flows/system/SY-33-bot-detection-session-exclusion.md)
- [Updating solr's indexes from cronjob](/guides/solr/configuring_adveshop4/updating_index_from_cronjob.md)
- [Version 4](/changelog/Changelog.4.100.md)
- [Version 4](/changelog/Changelog.4.101.md)
- [Version 4](/changelog/Changelog.4.102.md)
- [Version 4](/changelog/Changelog.4.103.md)
- [Version 4](/changelog/Changelog.4.104.md)
- [Vue.js SaaS Wizard - Developer Wiki](/guides/vue/saas/wizard.md)
- [Wamp with SSL](/guides/servers/WampWithSSL.md)