[ { "path": "factory-core/ConfigIni.md", "title": "Run all ConfigIni tests", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-19 // : < (CLASSES END) Overview ConfigIni is the central configuration manager for Axion. It loads hierarchical YAML configuration from config.yaml with package-specific overrides, variable substitution, and optional secret backends (Infisical, AWS Secrets Manager). No longer inherits from ConfigParser — it is a standalone c" }, { "path": "factory-core/Decorators.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) Technocore - All Rights Reserved. // : < (CYTHON START) Cython compile cythonize -3 -a -i Decorators.py Updated : 2025-10-02 // : < (CYTHON END)" }, { "path": "factory-core/ObjAI.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) Technocore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore. The intellectual and technical concepts contained herein are proprietary to TechnoCore and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore. ObjAI The ObjAI class provides a high-level interface for interacting wit" }, { "path": "factory-core/ObjAlert.md", "title": "ObjAlert — Alert Management System", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjAlert — Alert Management System Overview ObjAlert is the core alert engine for the Axion platform. It runs a continuous check loop against configurable TriggerSql queries, tracks results in the database, auto-creates incidents for high-severity events, dispatches notifications through ObjNotify , and maintains a full lifecycle from detection through escalation to recovery. Two supporting classes live in the same module: - AlertMetrics — in-memory performance counters shared across all ObjAler" }, { "path": "factory-core/ObjAlertIncident.md", "title": "ObjAlertIncident - Incident Management System", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjAlertIncident - Incident Management System Overview The ObjAlertIncident module provides comprehensive incident management capabilities for the Axion platform. It enables tracking, investigation, and resolution of incidents while maintaining a complete audit trail and communication history. Class Diagram Database Schema data incident Primary incident tracking table. Column Type Description -------- ------ ------------- IncidentGuid VARCHAR(255) Unique identifier (primary key) Title VARCHAR(25" }, { "path": "factory-core/ObjApi.md", "title": "Open API Header example", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. Provides an extended class of ObjData.ObjData for managing database interactions and data structure creation, with additional functionalities for name cleaning, dictionary handling, table base generation, and complete dataset construction through table expansion and data operations. This class is designed for transforming input data into structured datasets, creatin" }, { "path": "factory-core/ObjBOP.md", "title": "ObjBOP", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-19 // : < (CLASSES END) Overview ObjBOP generates ISO 9001 compliant Business Operating Procedure documents from Axion platform definitions. A BOP combines multiple interconnected workflows, webhook endpoints, service integrations, reports, decision trees, and feature stores into a single auditable document. Architecture Docu" }, { "path": "factory-core/ObjBackup.md", "title": "ObjBackup", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjBackup The ObjBackup module provides a robust framework for creating and managing database backups. It is designed to handle backups for MariaDB/MySQL databases, allowing for flexible configuration of what to back up, where to store it, and how to manage the process. It supports backing up multiple databases from different remote connections, filtering tables, and managing the backup lifecycle. The module consists of two main classes: ObjBackup for handling a single backup operation and Backu" }, { "path": "factory-core/ObjBarcode.md", "title": "ObjBarcode", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. Represent a class for handling barcode generation and validation tasks. This class provides methods for parsing, rendering, generating, validating, and calculating check digits for barcodes. It supports both EAN-13 and UPC formats, among others. Users can work with external tools and manage barcode data effectively. Encoding used for left and right digits Left Digit" }, { "path": "factory-core/ObjCalculation.md", "title": "ObjCalculation", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjCalculation Overview ObjCalculation is the core calculation engine for the Axion platform. It loads SQL-based calculation definitions from the database and executes them against a target GUID. Calculations can perform lookups, transformations, and multi-step computations that enrich workflow context or application state. This module was extracted from factory.service/package.core/ObjServiceCalculation.py so that the calculation engine is available directly in factory.core without going throug" }, { "path": "factory-core/ObjCalendar.md", "title": "ObjCalendar", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore Automate - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. ObjCalendar Calendar service for querying and managing event schedules. Contains two classes: ObjEvent (calendar event entity) and ObjCalendar (calendar query and constraint logic). Class Diagram Class Overview - Module: factory.core/ObjCalendar.py - Inherits from: ObjData.ObjData - Tables: data events , def event types , def activity , def journey ObjEvent" }, { "path": "factory-core/ObjChannel.md", "title": "ObjChannel", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. ObjChannel ObjChannel is a Python class designed for managing and rendering email channels. It handles various aspects of email generation, including dynamic content processing, attachment handling, and integration with reporting and user management systems. Methods init (self, DB: Objects.DatabaseConnection = 0) Initializes the ObjChannel object. - Parameters: - DB" }, { "path": "factory-core/ObjChannelmail.md", "title": "ObjChannelmail", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. ObjChannelmail ObjChannelmail provides classes for managing and sending emails through defined channels, handling mailing lists, and processing email stages. Classes ChannelMail(ObjSupervisor.Supervisor) Manages individual email entries within a channel, including reading, creating, updating, and marking email status. Methods init (self, db: Objects.DatabaseConnecti" }, { "path": "factory-core/ObjConnection.md", "title": "ObjConnection`", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. ObjConnection Overview ⚠️ LEGACY MODULE - This module manages remote database connections using the table-based Def RemoteConnections approach. It may be deprecated in future versions. ObjConnection provides the legacy connection pool manager for remote database connections. It reads connection credentials from the Def RemoteConnections database table and manages co" }, { "path": "factory-core/ObjConnectionPool.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) Technocore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore. The intellectual and technical concepts contained herein are proprietary to TechnoCore and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore. ObjConnectionPool ObjConnectionPool is a production-ready, thread-safe da" }, { "path": "factory-core/ObjConnectionPool_Test_Guide.md", "title": "ObjConnectionPool Test Guide", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjConnectionPool Test Guide Date : 2025-12-14 Test File : resource.test/pytests/factory.core/test ObjConnectionPool.py Total Test Cases : 40+ tests across 10 test classes --- Test Coverage Overview 1. TestConnectionPoolBasics (6 tests) Tests fundamental pool operations Test Purpose Validates ------ --------- ----------- test pool initialization Pool creates with correct size Initial pool size = configured size test acquire connection Can acquire connection from pool Connection is valid, stats u" }, { "path": "factory-core/ObjConsole.md", "title": "ObjConsole", "factory": "factory.core", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjConsole.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-core/ObjConstants.md", "title": "ObjConstants", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjConstants Overview Centralized constants module providing system-wide configuration values, magic strings, and type mappings used throughout the Axion framework. All shared constants belong here per project convention. Constants are defined as Python class attributes with type hints, then optionally overridden via a three-tier precedence system: 1. Python class default (hardcoded in ObjConstants.py ) 2. YAML overlay ( ObjConstants.yaml — loaded at import time) 3. config.yaml override (per-pac" }, { "path": "factory-core/ObjConversation.md", "title": "ObjConversation Module", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. ObjConversation Module Overview The ObjConversation.py module implements a page-based conversational state machine for multi-channel chatbot interactions. It manages conversation definitions, page navigation, option handling, contact tracking, and intent matching across channels such as Console, Discord, WhatsApp, and Slack. The module contains two classes: 1. ObjCo" }, { "path": "factory-core/ObjData.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) Technocore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore. The intellectual and technical concepts contained herein are proprietary to TechnoCore and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore. ObjData ObjData is a foundational and versatile class within the Axion fr" }, { "path": "factory-core/ObjDataDictionary.md", "title": "Data Dictionary", "factory": "factory.core", "type": "markdown", "tags": [], "body": "Data Dictionary The data dictionary is a collection of tables that define the structure of data used in the system. def data dictionary This table defines the data dictionaries available in the system. def data dictionary field This table defines the fields within each data dictionary. // : < (CYTHON START) Cython compile cythonize -3 -a -i ObjDataDictionary.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-core/ObjDataExport.md", "title": "ObjDataExport", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. ObjDataExport Export coordinator for the dataexport service. Dynamically loads a format-specific exporter from factory.export/ and drives it through the standard OpenFile → WriteHeader → WriteData → CloseFile lifecycle. Classes ObjDataExport Orchestrates a single data export job. Attributes are populated either in init (with safe defaults) or by sql read object() re" }, { "path": "factory-core/ObjDataImport.md", "title": "ObjDataImport", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. ObjDataImport Import coordinator for the dataimport service. Dynamically loads a format-specific parser from factory.import/ and drives the full lifecycle: file detection → parse → block commit → post-SQL → workflow trigger → metrics. Classes ImportMetrics Lightweight in-process accumulator for session-level statistics (total imports, rows, elapsed time, error rate)" }, { "path": "factory-core/ObjDataModel.md", "title": "ObjDataModel — Generic Schema-Driven Data Model", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjDataModel — Generic Schema-Driven Data Model Overview ObjDataModel is a generic CRUD layer that eliminates the need for per-domain-object subclasses. Instead of creating separate classes like ObjCreditApplication , ObjCreditContract , and ObjPaymentSchedule , all domain models are configured via YAML schema definitions and managed through a single ObjDataModel class. Why ObjDataModel? Before: Each domain object required a dedicated class + YAML + hand-written SQL - ObjPerson.py + ObjPerson.ya" }, { "path": "factory-core/ObjDataModelEdit.md", "title": "ObjDataModelEdit — Data Model Lifecycle Manager", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjDataModelEdit — Data Model Lifecycle Manager Overview ObjDataModelEdit extends the Axion data layer with the ability to load, save, synchronise, diff, and validate data model YAML files against the live database. While ObjDataModel provides runtime CRUD for individual records, ObjDataModelEdit manages the model itself — its table schemas, its reference data, its version history, and its registry metadata. A data model is a named YAML file in resource.datamodels/package.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "// : < (HIRAR START) Updated : 2025-02-27 // : < (HIRAR END) Validation Type Description ----------------- ----------------------------------------------- required Makes the element required. remote Requests a resource to check the element for validity. maxlength Makes the element require a given maximum length. rangelength Makes the element require a given value range. min Makes the element require a given minimum. max Makes the element require a given maximum. range Makes the element require a" }, { "path": "factory-core/ObjRandom.md", "title": "ObjRandom - Random Number and Code Generation Utilities", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjRandom - Random Number and Code Generation Utilities (c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. Overview ObjRandom provides random number generation and unique code generation utilities for the Axion platform. It supports both standard random (for non-security purposes like load distribution) and cryptographically secure random (for security purposes like token generation). Class: ObjRandom Inherits from:" }, { "path": "factory-core/ObjRateLimit.md", "title": "ObjRateLimit - Rate Limiting and Brute Force Protection", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjRateLimit - Rate Limiting and Brute Force Protection Comprehensive rate limiting and account lockout system for authentication security. Overview ObjRateLimit provides multi-layer protection against brute force attacks and authentication abuse with per-user and per-IP rate limiting, automatic account lockout, exponential backoff, and detailed audit tracking. Features ✅ Per-user rate limiting ✅ Per-IP address rate limiting ✅ Account lockout after threshold violations ✅ Exponential backoff for " }, { "path": "factory-core/ObjReport.md", "title": "ObjReport", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CYTHON START) Cython compile cythonize -3 -a -i ObjReport.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-core/ObjReportFile.md", "title": "ObjReportFile", "factory": "factory.core", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjReportFile.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-core/ObjSSH.md", "title": "ObjSSH", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CYTHON START) Cython compile cythonize -3 -a -i ObjSSH.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-core/ObjSSO.md", "title": "ObjSSO", "factory": "factory.core", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjSSO.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-core/ObjScheduler.md", "title": "ObjScheduler", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore Automate - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. ⚡ ObjScheduler Database-driven task scheduler for the Axion platform. Uses cron expressions as the scheduling language but runs entirely in-process — it does not read or write to the system crontab. Overview Schedules are stored in the def scheduler database table. The scheduler reads those records, evaluates cron expressions using croniter , and executes d" }, { "path": "factory-core/ObjSchedulerTUI.md", "title": "ObjSchedulerTUI - Scheduler Dashboard Documentation", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjSchedulerTUI - Scheduler Dashboard Documentation Real-time terminal dashboard for monitoring the Axion scheduler service using the Rich library. Overview The Scheduler TUI provides a comprehensive, real-time view of the scheduler's operation including: - Active running tasks with duration tracking - Queued tasks with retry counts - Worker process status - Task completion statistics - Recent events (starts, completions, failures, retries) - Live performance metrics Features 📊 Statistics Panel " }, { "path": "factory-core/ObjScorecard.md", "title": "ObjScorecard", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjScorecard Overview Credit-style scoring engine. Loads variable/attribute definitions from def scorecard , reads a primary context record, evaluates each variable against the bureau/simulation data, and returns an integer score. This module was extracted from factory.service/package.core/ObjServiceScorecard.py so that the scoring engine is available directly in factory.core . The service ( ObjServiceScorecard.ObjServiceApi ) remains as a thin subclass providing the service-framework Connect / " }, { "path": "factory-core/ObjSecurityAudit.md", "title": "Scan a single host (all checks)", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. // : < (CLASSES START) Updated : 2026-03-28 // : < (CLASSES END) Overview Comprehensive security audit and penetration testing tool. Performs 26 checks across network, web, DNS, email, database, and infrastructure categories. All results auto-persist to DB with AI summaries. Audit Checks (26) Network Check Method What ------- -------- ------ Port scan audit ports() 22 common ports, SSH/FTP greeting capture OS fingerprint audit os fingerprint() nmap -O -sV se" }, { "path": "factory-core/ObjService.md", "title": "ObjService", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjService Overview Service queue engine. Loads service definitions from def service , resolves the factory module for the service type, builds payloads, executes Connect/Send, and writes results back to stage service . Inheritance Chain Processing Pipeline Key Methods Read(ServiceCode, Service) Loads service definition, resolves factory, caches. Process(service code, service, param1..param9, ...) Full service execution: payload, connect, send, update. BuildPayload(FObj) Builds payload based on " }, { "path": "factory-core/ObjServiceHeartbeat.md", "title": "ObjServiceHeartbeat", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjServiceHeartbeat Shared helpers for multi-instance MQTT-based TUI dashboards. Purpose Enables TUI dashboards to monitor all running instances of a service simultaneously, regardless of how many processes are started on different ports or hosts. Each service instance publishes a small retained MQTT heartbeat; the TUI subscribes to a wildcard topic and aggregates heartbeats from every live instance. Topic Structure - {package} — active package name (e.g. homechoice ) - {service type} — short na" }, { "path": "factory-core/ObjSignal.md", "title": "ObjSignal", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CYTHON START) Cython compile cythonize -3 -a -i ObjSignal.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-core/ObjSignalMqtt.md", "title": "ObjSignalMqtt", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjSignalMqtt Overview ObjSignalMqtt provides MQTT-based signaling for inter-process communication and event broadcasting. It extends the signal system to use MQTT as a transport layer for distributed messaging. Module : factory.core/ObjSignalMqtt.py Inherits from : ObjSignal.ObjSignal or ObjMqtt.ObjMqtt Protocol : MQTT (Message Queuing Telemetry Transport) Purpose - Broadcast signals via MQTT - Enable distributed event systems - Provide publish/subscribe messaging - Support cross-process commun" }, { "path": "factory-core/ObjSimulation.md", "title": "ObjSimulation", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjSimulation Overview ObjSimulation extends ObjData to provide simulation-specific functionality, including comprehensive table reference tracking during simulation runs. It monitors which database tables are read from or written to during calculation and workflow simulations, enabling dependency analysis and optimization. Module : factory.core/ObjSimulation.py Inherits from : ObjData.ObjData Test files : resource.test/pytests/factory.core/test ObjSimulation proxy.py , test ObjSimulation sql tr" }, { "path": "factory-core/ObjSms.md", "title": "ObjSms", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CYTHON START) Cython compile cythonize -3 -a -i ObjSms.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-core/ObjSound.md", "title": "ObjSound", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjSound Overview ObjSound manages and provides access to sound files indexed in sounds.yaml . It provides a centralized system for managing audio resources used throughout the Axion platform. Module : factory.core/ObjSound.py Inherits from : Objects.Object Configuration : factory.core/sounds.yaml Purpose - Centralize sound file management - Provide easy access to audio resources - Index and catalog available sounds - Support sound playback and retrieval Key Features 1. Sound Index Management - " }, { "path": "factory-core/ObjStatusImage.md", "title": "ObjStatusImage", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjStatusImage Overview ObjStatusImage generates status badge images for displaying system status, metrics, and indicators in visual format. Module : factory.core/ObjStatusImage.py Inherits from : Objects.Object Purpose - Generate status badge images - Create visual indicators for system status - Provide customizable badge styles - Support various image formats Key Features 1. Badge Generation - Status badges (success, warning, error) - Metric badges (counts, percentages) - Custom text and color" }, { "path": "factory-core/ObjSupervisor.md", "title": "Supervisor Class Documentation", "factory": "factory.core", "type": "markdown", "tags": [], "body": "Supervisor Class Documentation Overview The Supervisor class is a core component of the Axion framework, designed to manage and monitor system processes and services in a distributed environment. It acts as a central controller for running background tasks, implementing a robust dispatcher/worker pattern. Its primary responsibilities include: - Service Lifecycle Management : Starting, stopping, and monitoring the status of various microservices. - Task Dispatching : Reading tasks from database \"" }, { "path": "factory-core/ObjTUI.md", "title": "ObjTUI", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTUI Overview ObjTUI provides shared utilities for Rich-based terminal dashboards: theme loading, startup banners, a managed layout loop ( TUI Manager ), and two reusable stream helpers ( TuiStream , AtomicWriter ) that any TUI module can import. Module : factory.core/ObjTUI.py Dependencies : rich Exports Name Type Purpose --- --- --- can use tui() function Guard — returns False under supervisord or non-TTY stdout TuiTheme dataclass Semantic color mapping loaded from the active ObjPalette buil" }, { "path": "factory-core/ObjTemplate.md", "title": "result[\"subject\"] = \"Welcome, Sipho!\"", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-17 // : < (CLASSES END) Overview ObjTemplate manages templates stored in the database. It supports two template stores: - def template — page/report templates (legacy) - def email template — email templates with subject, body, channel, layout, and $placeholder$ resolution Email Templates Table: def email template Column Type " }, { "path": "factory-core/ObjTest.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) Technocore - All Rights Reserved. ObjTest Module The ObjTest module provides a suite of tools for generating and validating South African ID numbers, including special functions for creating and verifying test-specific IDs. This functionality is exposed through a command-line interface. Description This class inherits from ObjData and is designed to assist in software testing and development where valid-looking but identifiable test data is required. It can generate standard SA IDs, validate" }, { "path": "factory-core/ObjText.md", "title": "ObjText", "factory": "factory.core", "type": "markdown", "tags": [], "body": "// : < (HIRAR START) Updated : 2025-02-27 // : < (HIRAR END)" }, { "path": "factory-core/ObjTicket.md", "title": "ObjTicket", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTicket Core ticket system for user and internal request tracking. Purpose Orchestrates the full ticket lifecycle including status transitions, SLA deadline calculation, task management, comments, links, templates, audit trail, problem analysis, work scoring, and email notifications. Delegates to sub-modules for specialised concerns. Database Tables data ticket Column Type Description -------- ------ ------------- Guid char(50) Primary key TicketNumber int AUTO INCREMENT Human-readable number " }, { "path": "factory-core/ObjTicketComment.md", "title": "ObjTicketComment", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTicketComment Comment management for tickets. Purpose Manages comments on tickets with support for internal-only visibility and soft-delete. Accessed via ObjTicket delegation methods ( add comment , get comments ). Database Tables data ticket comment Column Type Description -------- ------ ------------- Guid char(50) Primary key TicketGuid char(50) Parent ticket reference CommentText text Comment body CommentedBy varchar(255) Who wrote the comment IsInternal char(2) Y/N - internal-only flag I" }, { "path": "factory-core/ObjTicketLink.md", "title": "ObjTicketLink", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTicketLink Link and dependency management between tickets. Purpose Manages directional links between tickets. Supports link types: BLOCKS, RELATED, DUPLICATE, CHILD. Accessed via ObjTicket delegation methods ( add link , get links ). Database Tables data ticket link Column Type Description -------- ------ ------------- Guid char(50) Primary key SourceGuid char(50) Source ticket TargetGuid char(50) Target ticket LinkType enum BLOCKS, RELATED, DUPLICATE, CHILD CreatedBy varchar(255) Who created" }, { "path": "factory-core/ObjTicketSla.md", "title": "ObjTicketSla", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTicketSla SLA (Service Level Agreement) configuration per package and priority level. Purpose Defines response and resolution time targets for tickets based on the package and priority combination. Used by ObjTicket to calculate SLA deadlines when a ticket is created. Database Table def ticket sla Column Type Description -------- ------ ------------- Package char(255) Package identifier (PK) Priority enum CRITICAL, HIGH, MEDIUM, LOW, INFO (PK) ResponseMinutes int Max minutes to first response" }, { "path": "factory-core/ObjTicketTask.md", "title": "ObjTicketTask", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTicketTask Task management for tickets in the ticket system. Purpose Each ticket can have multiple tasks that are tracked independently. Tasks have their own status lifecycle and can be assigned to individual users. This enables breaking a ticket into actionable work items. Database Table data ticket task Column Type Description -------- ------ ------------- Guid char(50) Primary key TicketGuid char(50) Parent ticket reference TaskName varchar(500) Task title Description text Task details Sta" }, { "path": "factory-core/ObjTicketTemplate.md", "title": "ObjTicketTemplate", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTicketTemplate Ticket template management with pre-defined tasks. Purpose Manages reusable ticket templates that define a standard subject, description, priority, type, and a set of tasks. When a ticket is created from a template, all template tasks are automatically added to the new ticket. Database Tables def ticket template Column Type Description -------- ------ ------------- Guid char(50) Primary key TemplateName varchar(255) Unique name per package Package char(255) Package context Subj" }, { "path": "factory-core/ObjTuiForm.md", "title": "ObjTuiForm", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTuiForm Rich-based interactive terminal form renderer. Purpose Reads form definitions from def form and def formfields (seeded by create forms from yaml ), renders interactive terminal forms using Rich and questionary, and writes collected data back to the form's BaseTable via INSERT or UPDATE. No Database Tables Uses existing def form and def formfields tables. No new schema required. Flow Basic TUI Types TUI Type Rendering ---------- ----------- STRING Prompt.ask() single-line input TEXT Pr" }, { "path": "factory-core/ObjTypes.md", "title": "ObjTypes - Type Alias System Documentation", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTypes - Type Alias System Documentation Version: 8.0 Module: factory.core/ObjTypes.py Overview ObjTypes provides a centralized type alias system for the Axion framework, improving code readability, maintainability, and type consistency. Instead of using verbose type annotations like Dict str, Any throughout the codebase, we use semantic type aliases that convey meaning and intent. Benefits - Semantic Clarity : ConfigDict is more meaningful than Dict str, Any - Single Source of Truth : Change " }, { "path": "factory-core/ObjVersionMixin.md", "title": "ObjVersionMixin", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjVersionMixin Module: factory.core/ObjVersionMixin.py Product: Axion Universal version history tracking mixin for Axion compute modules. Designed to be mixed into classes that inherit from ObjData . VERSION REGISTRY All versioned modules are registered in a central dict. The mixin resolves table names automatically based on the class hierarchy: Module main table nodes table history table name column -------- ----------- ------------- --------------- ------------- ObjDecisionSwitch def decision" }, { "path": "factory-core/ObjWebMail.md", "title": "ObjWebMail", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. ObjWebMail ObjWebMail is a Python class for sending and receiving emails. It supports SMTP for sending and POP3 for receiving. It also has features for handling HTML emails, attachments, and processing multipart messages. Methods uuid(self, args: Any) - str: Generates a short, unique identifier. - Returns: A string representing a unique identifier. Example: init (se" }, { "path": "factory-core/ObjWebhookAlert.md", "title": "c) TechnoCore - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) TechnoCore - All Rights Reserved. ObjWebhookAlert.py Overview Webhook failure alerting system for the Axion framework. This module monitors webhook execution metrics in real time and sends alerts when configurable thresholds are exceeded. It tracks failure rates, authentication failures, timeouts, and latency across all registered webhooks. Alerts can be delivered through multiple channels simultaneously: Slack, Email, PagerDuty," }, { "path": "factory-core/ObjWorkflow.md", "title": "c) TechnoCore Automate - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore Automate - All Rights Reserved. ObjWorkflow Module Overview The ObjWorkflow module is a powerful, data-driven engine responsible for orchestrating and executing complex business processes. It models these processes as Directed Acyclic Graphs (DAGs) , where each step is a node and dependencies define the directed, acyclic flow. The engine interprets workflow definitions stored in a database, manages the flow of data between steps, and integrates with various other modules to perfor" }, { "path": "factory-core/ObjWorkflow_Analysis.md", "title": "ObjWorkflow.py - Code Analysis & Improvement Suggestions", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjWorkflow.py - Code Analysis & Improvement Suggestions File : factory.core/ObjWorkflow.py Lines : 2,358 Version : 8.0 Analysis Date : 2025-12-14 --- Executive Summary ObjWorkflow.py is a critical component managing workflow orchestration in Axion. While functionally complete, the codebase exhibits several anti-patterns and areas for improvement including excessive global variable usage, inconsistent exception handling, and opportunities for refactoring to improve maintainability. Priority Leve" }, { "path": "factory-core/ObjWorkflow_Performance_Changes.md", "title": "ObjWorkflow Performance Optimizations - Implementation Summary", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjWorkflow Performance Optimizations - Implementation Summary Date : 2025-12-14 File : factory.core/ObjWorkflow.py Phases Completed : Phase 1 (Quick Wins) + Phase 2 (Medium Effort) --- Changes Implemented Phase 1: Quick Wins 1. ✅ Move node dispatch to init () (Lines 202-241) Problem : 27 node class objects instantiated every single node execution Before : After : Lines Changed : - Added lines 202-241: Node dispatch initialization in init () - Modified line 846: Comment added - Modified line 855" }, { "path": "factory-core/ObjWorkflow_Speedup_Analysis.md", "title": "ObjWorkflow Performance Optimization Analysis", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjWorkflow Performance Optimization Analysis Date : 2025-12-14 Target : factory.core/ObjWorkflow.py Current State : Functional but has significant performance bottlenecks --- Critical Performance Issues 🔴 CRITICAL: Node Dispatch Created in Loop (Lines 806-849) Current Issue: Impact: - Instantiates 27 node objects for every single node execution - If workflow has 10 nodes → 270 unnecessary object instantiations - Each instantiation calls init () , sets up references, allocates memory Solution: M" }, { "path": "factory-core/ObjWorkflow_ThreadSafety.md", "title": "ObjWorkflow Thread Safety Documentation", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjWorkflow Thread Safety Documentation Date : 2025-12-14 File : factory.core/ObjWorkflow.py Status : ✅ Thread-Safe for Concurrent Workflow Execution --- Thread Safety Guarantee ObjWorkflow is now fully thread-safe and supports: - ✅ Multiple threads executing workflows concurrently using the same Workflow instance - ✅ Multiple threads executing different workflows simultaneously - ✅ Multiple threads executing the same workflow with different contexts - ✅ Concurrent reads and writes to shared cac" }, { "path": "factory-core/Objects.md", "title": "c) TechnoCore Automate - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\") (c) TechnoCore Automate - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. The intellectual and technical concepts contained herein are proprietary to TechnoCore Automate and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore Automate. Objects Objects.py is the foundational" }, { "path": "factory-core/extend-backup/ObjBackupHandler.md", "title": "Your dump logic here", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. // : < (CLASSES START) Updated : 2026-03-27 // : < (CLASSES END) Overview Abstract base class for database backup handlers. Each database type (MariaDB, PostgreSQL, MongoDB, etc.) implements this interface. Handler Interface Method Required Description -------- ---------- ------------- dump() Yes Dump database to file(s), return paths list databases() Yes List available databases/buckets get database size() No Estimate size in bytes (default: 0) system datab" }, { "path": "factory-core/extend-backup/ObjBackupRegistry.md", "title": "Check what's registered", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. // : < (CLASSES START) Updated : 2026-03-27 // : < (CLASSES END) Overview Registry pattern for backup dump handlers, mirroring ObjNodeRegistry . Handlers self-register via decorator. Usage Registered Types Type Handler Tool ------ --------- ------ MARIADB, MYSQL ObjBackupDumpMariadb mysqldump POSTGRES ObjBackupDumpPostgres pg dump MONGO ObjBackupDumpMongo mongodump INFLUXDB ObjBackupDumpInfluxdb influx / HTTP API MSSQL ObjBackupDumpMssql sqlcmd SQLITE ObjBac" }, { "path": "factory-core/extend-data/ObjDataDDL.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) Technocore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore. The intellectual and technical concepts contained herein are proprietary to TechnoCore and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore. ObjDataDDL The ObjDataDDL class is a core component of the Axion framewor" }, { "path": "factory-core/extend-data/ObjDataKey.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) Technocore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore. The intellectual and technical concepts contained herein are proprietary to TechnoCore and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore. ObjDataKey Multi-backend key-value store manager for Axion. Supports Redi" }, { "path": "factory-core/extend-data/ObjDataMongo.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) Technocore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore. The intellectual and technical concepts contained herein are proprietary to TechnoCore and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore. ObjDataMongo The ObjDataMongo class provides a suite of methods for inter" }, { "path": "factory-core/extend-data/ObjDataSql.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) Technocore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore. The intellectual and technical concepts contained herein are proprietary to TechnoCore and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore. ObjDataSql The ObjDataSql class provides a comprehensive set of methods f" }, { "path": "factory-core/extend-delegate/ObjDebug.md", "title": "ObjDebug", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjDebug Debug and logging delegate extracted from Objects.Object . Purpose ObjDebug encapsulates all console output, MQTT log routing, progress bar, and traceback helper methods that were previously defined directly on the Object class in Objects.py . This reduces the size and complexity of Objects.py while keeping the public API unchanged. Design ObjDebug is a delegate , not a mixin or base class. It does not inherit from Object or ObjData . Instead, it receives the host Object instance as a c" }, { "path": "factory-core/extend-delegate/ObjPatch.md", "title": "ObjPatch", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjPatch Mixin class providing parameter patching and text processing for the Object class in Objects.py . Purpose ObjPatch resolves $term$ placeholders in strings by looking up values from database parameters, user attributes, package configuration, date/time functions, and system context. It is mixed into Object via Python MRO and requires no init . Methods Method Description -------- ------------- patch all(term, key, value) Simple string replacement of key with value in term patch paramBuffe" }, { "path": "factory-core/extend-delegate/ObjRaci.md", "title": "ObjRaci", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjRaci Module: factory.core/extend.delegate Type: Mixin (mixed into ObjData) What is RACI? RACI is a responsibility assignment matrix used to clarify roles and ownership for every activity in a process. Each letter represents a level of involvement: - Responsible (R) — The \"Doer.\" The person who actually performs the work to complete the task. Every task needs at least one person responsible. - Accountable (A) — The \"Owner.\" The person with final say who must ensure the task is completed correc" }, { "path": "factory-core/extend-delegate/ObjRecurringMixin.md", "title": "ObjRecurringMixin", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjRecurringMixin Generic cron-based recurring-schedule mixin for any module that inherits from ObjData . Overview Provides create, list, check-due, and cancel operations against a shared def recurring table. Each consumer module identifies itself via recurring module type (e.g. TICKET , WORKFLOW , CALCULATION ) so a single table serves all modules. Usage Table: def recurring Column Type Description -------- ------ ------------- Guid char(50) Primary key ModuleType varchar(50) Consumer identifie" }, { "path": "factory-core/extend-delegate/ObjResource.md", "title": "ObjResource", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjResource Web resource (CSS/JS) management mixin extracted from Objects.Object . Purpose ObjResource manages CSS and JavaScript resource lists for web pages. It handles CDN mapping, alias resolution (e.g. @sweetalert ), and optional minification via rjsmin . Mixed into Object so all web-facing modules inherit resource management. Design ObjResource is a mixin , not a standalone class. It expects the host class to provide: - self.ResourceCss -- list of CSS file paths/URLs - self.ResourceScript " }, { "path": "factory-core/extend-delegate/ObjSerialization.md", "title": "ObjSerialization", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjSerialization Object field injection and JSON serialization mixin extracted from Objects.Object . Purpose ObjSerialization provides methods for copying attributes between objects, encoding and decoding object state as JSON, and injecting dictionary values into object fields. Mixed into Object so all modules inherit serialization capabilities. Design ObjSerialization is a mixin , not a standalone class. It expects the host class to provide: - self.fields -- list of field names (used by inject/" }, { "path": "factory-core/extend-delegate/ObjSystem.md", "title": "ObjSystem", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjSystem Mixin class providing system-level operations for the Object class in Objects.py . Purpose ObjSystem encapsulates methods related to operating system interaction, environment detection, singleton process locking, IP address resolution, and in-memory database connections. It is mixed into Object via Python MRO and requires no init . Methods Method Description -------- ------------- system run(command) Execute a local shell command via subprocess.Popen and return output is docker() Detec" }, { "path": "factory-core/extend-edit/ObjAlertEdit.md", "title": "ObjAlertEdit", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjAlertEdit Overview ObjAlertEdit extends ObjAlert to provide YAML export/import for alert definitions. It exports all def alert rows for a given package, stripping runtime-state fields that are repopulated on each alert run. Exported files are written to local.documents/alerts/ by default. Inheritance Chain Database Tables Table Purpose --- --- def alert One row per Alert/Package — definition and thresholds Export Format Runtime-state fields stripped on export: guid , LastCheck , LastTrigger ," }, { "path": "factory-core/extend-edit/ObjApiEdit.md", "title": "ObjApiEdit", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjApiEdit Overview ObjApiEdit extends the ObjApi class to provide specialized functionality for editing and exporting API configurations, specifically designed to export webhook configurations to Insomnia REST client format. Module : factory.core/ObjApiEdit.py Inherits from : ObjApi.ObjApi Test file : resource.test/pytests/factory.core/test ObjApiEdit.py Purpose This module enables developers to: - Export webhook configurations from the Axion database to Insomnia Request Collection JSON format " }, { "path": "factory-core/extend-edit/ObjCalculationEdit.md", "title": "ObjCalculationEdit", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjCalculationEdit Overview ObjCalculationEdit extends ObjCalculation to provide YAML export functionality for calculation group configurations. It exports complete group definitions including all steps, with SQL content formatted for readability and descriptions reflowed. Exported files are written to local.documents/calculations/ by default. Inheritance Chain Database Tables Table Purpose --- --- def calculation Group metadata (presql, postsql, review notes) def calculations Individual calcula" }, { "path": "factory-core/extend-edit/ObjChannelEdit.md", "title": "ObjChannelEdit", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjChannelEdit Overview ObjChannelEdit extends ObjChannel to provide YAML export/import for channel definitions stored in def Channel . Channels control how reports are delivered — email layout, headers, footers, SMTP config, styles, etc. Unlike package-level Edit modules, ObjChannelEdit exports a single channel per file (keyed by Channel + Package ). Exported files are written to local.documents/channels/ by default. Inheritance Chain Database Tables Table Purpose --- --- def Channel One row pe" }, { "path": "factory-core/extend-edit/ObjConversationEdit.md", "title": "ObjConversationEdit Module", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. ObjConversationEdit Module Overview The ObjConversationEdit.py module provides YAML-based import and export of conversation definitions. It follows the same pattern as ObjWorkflowEdit.py , allowing conversation flows to be saved to YAML files and loaded back into the database. The module contains one class: 1. ConversationEdit -- Fetches conversation definitions fro" }, { "path": "factory-core/extend-edit/ObjDataDictionaryEdit.md", "title": "ObjDataDictionaryEdit", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjDataDictionaryEdit Overview ObjDataDictionaryEdit extends ObjDataDictionary to provide YAML export/import for data dictionary definitions. It exports the header row and all field definitions for a given DictionaryCode/Package combination. Exported files are written to local.documents/data dictionary/ by default. Inheritance Chain Database Tables Table Purpose --- --- def data dictionary One header row per DictionaryCode/Package def data dictionary field One row per field within a dictionary E" }, { "path": "factory-core/extend-edit/ObjDecisionSegmentationEdit.md", "title": "ObjDecisionSegmentationEdit", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjDecisionSegmentationEdit Module: factory.core/extend.edit/ObjDecisionSegmentationEdit.py Product: Arbiter CRUD and YAML export/import interface for versioned segmentation definitions. Extends ObjDecisionSegmentation following the same pattern as ObjDecisionSwitchEdit . Architecture The core class handles read() + evaluate() . This Edit class adds load, export, import, migration, and all CRUD operations. Methods load(segment name, package=None) - dict Load complete segment configuration from d" }, { "path": "factory-core/extend-edit/ObjDecisionSwitchEdit.md", "title": "ObjDecisionSwitchEdit", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjDecisionSwitchEdit Overview ObjDecisionSwitchEdit extends ObjDecisionSwitch to provide YAML export, simulation execution, and CRUD functionality for decision tree configurations. Decision trees define branching logic used by the workflow engine to route execution based on SQL-evaluated conditions. This module handles all simulation and management operations while ObjDecisionSwitch retains only the core evaluation logic ( read , evaluate , compute decision ). Exported files are written to loca" }, { "path": "factory-core/extend-edit/ObjEditBase.md", "title": "ObjEditBase", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjEditBase Shared mixin for all Edit modules in factory.core/extend.edit/ . Purpose Eliminates copy-paste duplication across 10 Edit files by extracting common YAML export utilities into a single cooperative mixin. Provided Utilities Module-level exports Name Description ------ ------------- LiteralString str subclass that LiteralDumper renders as YAML block scalar ( \\ ) LiteralDumper Custom yaml.SafeDumper with LiteralString support literal representer Representer function registered on Litera" }, { "path": "factory-core/extend-edit/ObjFeatureStoreEdit.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) Technocore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore. The intellectual and technical concepts contained herein are proprietary to TechnoCore and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore. ObjFeatureStoreEdit ObjFeatureStoreEdit extends ObjFeatureStore with all " }, { "path": "factory-core/extend-edit/ObjHookEdit.md", "title": "ObjHookEdit", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjHookEdit Module : factory.core/ObjHookEdit.py Extends : ObjHook.ObjHook Purpose Provides a simple load/save interface for both inbound and outbound webhooks. This module handles complete webhook configurations in single operations, automatically managing parameters and validations. ObjHookEdit is called by ObjApiEdit when saving entire API configurations that include webhook components. TechnoCore Convention Package Management : Package is determined automatically via get package() . Do NOT i" }, { "path": "factory-core/extend-edit/ObjMailEdit.md", "title": "ObjMailEdit", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjMailEdit YAML import / export for email templates stored in def email template . Round-trips one template at a time between the database and a YAML file under local.documents/email templates/ , so templates can be versioned, edited offline, and replayed back into any environment. Mixin pattern ( ObjEditBase first, primary class second): CLI Programmatic use Behaviour - export to file drops UpdateDate (DB-managed) and writes Subject , Body , and Description as YAML literal block scalars ( ) fo" }, { "path": "factory-core/extend-edit/ObjNotifyEdit.md", "title": "ObjNotifyEdit", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjNotifyEdit Overview ObjNotifyEdit extends ObjNotify to provide YAML export/import for notification channel definitions. It exports all def notify rows for a given package so notification configs can be ported between environments. Exported files are written to local.documents/notify/ by default. Inheritance Chain Database Tables Table Purpose --- --- def notify One row per NotifyCode/Package — channel routing config Export Format Package is stripped from each row since it is stored at the top" }, { "path": "factory-core/extend-edit/ObjPersonEdit.md", "title": "ObjPersonEdit", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjPersonEdit Overview ObjPersonEdit extends ObjPerson to provide YAML export/import for contact person records in data person . Used to back up, migrate, or seed person definitions across packages and environments. Unlike most Edit modules, import from data does not issue raw SQL INSERTs. It sets ObjPerson instance attributes and delegates to ObjPerson.save() (upsert keyed by PersonGuid ). Exported files are written to local.documents/persons/ by default. Inheritance Chain Database Tables Table" }, { "path": "factory-core/extend-edit/ObjScorecardEdit.md", "title": "ObjScorecardEdit", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjScorecardEdit Overview ObjScorecardEdit extends ObjScorecard to provide YAML import/export functionality for scorecard definitions. It exports all attribute rows for a given scorecard/version/package combination, and can reimport them with fresh GUIDs. Exported files are written to local.documents/scorecards/ by default. Inheritance Chain Database Tables Table Purpose --- --- def scorecard Attribute rows per scorecard/version/package Export Format Auto-generated and redundant fields are strip" }, { "path": "factory-core/extend-edit/ObjWorkflowEdit.md", "title": "c) TechnoCore - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. ObjWorkflowEdit.py Documentation ObjWorkflowEdit.py is a command-line tool for editing, analyzing, and managing workflows within the Axion framework. It provides a suite of commands to interact with workflow definitions stored in the database, allowing for creation, modification, and analysis of workflows and their components. Key Features - Workflow Analysis : Scan" }, { "path": "factory-core/extend-probe/README.md", "title": "extend.probe — Webhook Deployment Probe", "factory": "factory.core", "type": "markdown", "tags": [], "body": "extend.probe — Webhook Deployment Probe What This Is A generic webhook deployment probe system for the Axion stack. It reads def webhook deployment , fires real HTTP calls per entry using a recent payload from the source DB, validates the response, and writes results back. Built to cover LIVE and UAT environments, all packages, with TCP-level ping before each HTTP probe. --- Files ObjHook.py was updated: - Inherits (ObjHookProbeMixin, ObjApi.ObjApi) - extend.probe added to sys.path - Extracted m" }, { "path": "factory-core/extend-security/ObjSecurityLocal.md", "title": "ObjSecurityLocal", "factory": "factory.core", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. // : < (CLASSES START) Updated : 2026-03-27 // : < (CLASSES END) Overview Local OS security hardening scanner. All checks run against the local filesystem and system tools. For remote network vulnerability scanning, see ObjSecurityAudit.py . Architecture Local Checks Method What Severity -------- ------ ---------- scan fail2ban() Active IP bans per jail HIGH (5+), MEDIUM scan ssh keys() Bad permissions, excessive keys HIGH, MEDIUM scan world writable() Files" }, { "path": "factory-core/extend-ticket/ObjTicketAutoAssign.md", "title": "ObjTicketAutoAssign", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTicketAutoAssign Rule-based automatic ticket assignment mixin for ObjTicket. Overview Provides configurable rules that automatically assign newly created tickets to a specific person based on matching criteria. Rules are stored in def ticket assign rules and evaluated using a specificity-based fallback hierarchy. Fallback Hierarchy When a ticket is created without an explicit assignee, the mixin searches for a matching rule in this order: 1. Exact match -- Package + Project + Priority + Ticke" }, { "path": "factory-core/extend-ticket/ObjTicketGoogleTasks.md", "title": "ObjTicketGoogleTasks", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTicketGoogleTasks Google Tasks ticket provider for ObjTicket. Overview Routes ticket operations to Google Tasks via the Tasks API methods on ObjServiceGoogle . Uses the existing OAuth2 service account with domain-wide delegation — no separate API key needed. Google Tasks has a minimal model (title, notes, due, status), so priority is encoded as a title prefix ( P0 , P1 , etc.) and assignee/comments are appended to the notes body. Configuration In config.yaml : The https://www.googleapis.com/a" }, { "path": "factory-core/extend-ticket/ObjTicketMixin.md", "title": "ObjTicketMixin — Ticket Domain Mixins", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTicketMixin — Ticket Domain Mixins Overview The extend.ticket package provides five mixins that decompose ObjTicket's delegate-based sub-systems into composable classes. Each mixin is a plain class (no ObjData inheritance) that relies on the host class providing self.get queries() , self.escape sql() , self.sql execute() , etc. Mixins Mixin Domain YAML Key Methods --- --- --- --- ObjTicketSlaMixin SLA deadlines ObjTicketSlaMixin.yaml get response deadline() , get resolution deadline() , get e" }, { "path": "factory-core/extend-ticket/ObjTicketProvider.md", "title": "ObjTicketProvider", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTicketProvider Abstract base class and factory function for the Axion ticket provider system. Overview The ticket provider pattern decouples ticket operations from their backing store. Callers work against ObjTicketProvider and never need to know whether operations target the internal database, Asana, or both. Configuration in config.yaml determines which concrete provider is instantiated at runtime: Class Diagram Providers ObjTicketInternal All operations go to data ticket via ObjTicket . Th" }, { "path": "factory-core/extend-ticket/ObjTicketRecurringMixin.md", "title": "ObjTicketRecurringMixin", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTicketRecurringMixin Ticket-specific recurring schedule adapter built on the generic ObjRecurringMixin . Overview Provides creation, listing, checking, and cancellation of recurring ticket schedules. Uses the shared def recurring table with ModuleType = \"TICKET\" . Tickets are created from existing templates in def ticket template when their schedule is due. Delegates all cron parsing, scheduling, and table management to ObjRecurringMixin in factory.core/extend.delegate/ . Architecture Methods" }, { "path": "factory-core/extend-ticket/ObjTicketTodoist.md", "title": "ObjTicketTodoist", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTicketTodoist Todoist ticket provider for ObjTicket. Overview Routes ticket operations to Todoist via ObjServiceTodoist . Priority is mapped to Todoist priorities (1-4); status transitions are mapped to section moves within a Todoist project. Configuration In config.yaml : Status Mapping Axion Status Todoist Section ------------- ---------------- NEW New TRIAGED Triaged IN PROGRESS In Progress ON HOLD On Hold ESCALATED Escalated RESOLVED Resolved CLOSED Closed CANCELLED Cancelled Sections mus" }, { "path": "factory-core/extend-tui/ObjAiTUI.md", "title": "ObjAiTUI", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjAiTUI Multi-instance terminal UI dashboard for monitoring all ServeAI processes simultaneously. Uses MQTT heartbeats for live instance tracking alongside the existing dual-rate local Ollama and DB polls. Overview AiTUI combines three data sources: - MQTT heartbeats — subscribes to axion/+/heartbeat/ai/+ for per-instance status (hostname, port, uptime, PID). Instances stale after TuiConstants.HEARTBEAT STALE SECS (45 s). - Fast poll ( TuiConstants.AI POLL FAST SECS , default 2 s) — checks loca" }, { "path": "factory-core/extend-tui/ObjConversationTUI.md", "title": "ObjConversationTUI", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjConversationTUI Multi-instance terminal UI dashboard for monitoring all ServeConversation processes simultaneously. Uses MQTT heartbeats for live instance tracking and a slow DB poll for static configuration data. Overview ConversationTUI subscribes to MQTT topic axion/+/heartbeat/conversation/+ to receive retained heartbeats from every running ServeConversation instance. An instance is shown as stale after TuiConstants.HEARTBEAT STALE SECS (45 s). The def conversation channel distribution is" }, { "path": "factory-core/extend-tui/ObjGoTUI.md", "title": "ObjGoTUI", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjGoTUI Multi-instance terminal UI dashboard for monitoring all ServeGo short-URL/redirect processes simultaneously. Uses MQTT heartbeats for live instance tracking and a slow DB poll for static configuration data. Overview GoTUI subscribes to MQTT topic axion/+/heartbeat/go/+ to receive retained heartbeats from every running ServeGo instance. An instance is shown as stale after TuiConstants.HEARTBEAT STALE SECS (45 s). The def go table is polled separately every TuiConstants.CONFIG POLL SECS (" }, { "path": "factory-core/extend-tui/ObjImportTUI.md", "title": "ObjImportTUI", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjImportTUI Read-only terminal UI dashboard for monitoring the ServeImport service in real time. Launched as a standalone CLI command; it does not require the import service to be running. Overview ImportTUI polls three data sources every TuiConstants.IMPORT POLL SECS seconds (default 5 s): 1. Process table — uses psutil to detect whether ServeImport watch is active. 2. Filesystem — scans local.documents/ for pending files awaiting import, sorted by modification time descending. 3. Database — q" }, { "path": "factory-core/extend-tui/ObjReportTUI.md", "title": "ObjReportTUI", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjReportTUI Multi-instance terminal UI dashboard for monitoring all ServeReport processes simultaneously. Uses MQTT heartbeats for live instance tracking and a slow DB poll for static configuration data. Overview ReportTUI subscribes to MQTT topic axion/+/heartbeat/report/+ to receive retained heartbeats from every running ServeReport instance. Each instance publishes a heartbeat every TuiConstants.HEARTBEAT INTERVAL SECS (15 s). An instance is shown as stale after TuiConstants.HEARTBEAT STALE " }, { "path": "factory-core/extend-tui/ObjSchedulerMonitorTUI.md", "title": "ObjSchedulerMonitorTUI", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjSchedulerMonitorTUI Read-only terminal UI dashboard for observing the ServeScheduler service. Launched as a standalone CLI command; it does not start the scheduler — it only polls the database. Overview SchedulerMonitorTUI is distinct from ObjSchedulerTUI , which is an embedded push-based TUI that runs inside the scheduler service. This module is a DB-polling observer that works whether the scheduler service is running or not. It uses a dual poll-rate strategy: - Fast poll ( TuiConstants.SCHE" }, { "path": "factory-core/extend-tui/ObjTuiBase.md", "title": "ObjTuiBase", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjTuiBase Base class for all Axion TUI (Terminal User Interface) dashboards. Purpose Eliminates code duplication across the 12+ TUI dashboard modules by providing shared infrastructure: console initialization, layout scaffolding, live display loop, log/footer panels, start/stop lifecycle, and MQTT teardown. Class: TuiBase Class Attributes Attribute Type Description ---------------- ------ -------------------------------------- service name str Display name used in header/stop msg Instance Attri" }, { "path": "factory-core/extend-tui/ObjWebhookTUI.md", "title": "ObjWebhookTUI", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjWebhookTUI Multi-instance terminal UI dashboard for monitoring all ServeWebHook processes simultaneously. Uses MQTT heartbeats for live instance tracking and a slow DB poll for static configuration data. Overview WebhookTUI subscribes to MQTT topic axion/+/heartbeat/webhook/+ to receive retained heartbeats from every running ServeWebHook instance. An instance is shown as stale after TuiConstants.HEARTBEAT STALE SECS (45 s). The def webhook table is polled separately every TuiConstants.CONFIG " }, { "path": "factory-core/extend-tui/ObjWorkflowSimulTUI.md", "title": "ObjWorkflowSimulTUI", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjWorkflowSimulTUI Overview ObjWorkflowSimulTUI is the real-time terminal dashboard for monitoring ObjWorkflowSimul runs. It renders live progress, success rate, throughput, ETA, and a scrolling table of recent GUID results — all without making any database calls. Module : factory.workflow/package.tui/ObjWorkflowSimulTUI.py Entry class : SimulTUI Dependencies : rich , ObjTUI , ObjConstants.TuiConstants , ObjEnum.TuiLogLevel Architecture The simulation workers update the shared class-level dict " }, { "path": "factory-core/extend-tui/ObjWorkflowTUI.md", "title": "ObjWorkflowTUI", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjWorkflowTUI Read-only terminal UI dashboard for monitoring the ServeWorkflow service in real time. Launched as a standalone CLI command; it does not require the workflow service itself to be running. Overview WorkflowTUI connects to the RabbitMQ message queue and polls queue depth statistics every TuiConstants.WORKFLOW POLL SECS seconds. It renders a full-screen Rich Live layout with animated heartbeat, uptime, queue counters, a bar-chart queue status view, and a scrolling log pane. Data sour" }, { "path": "factory-core/extend-visual/ObjDecisionSwitchVisual.md", "title": "ObjDecisionSwitchVisual", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjDecisionSwitchVisual Render, visual, and export methods for decision trees. Extracted from ObjDecisionSwitch to separate core tree evaluation logic from presentation and serialisation concerns. Class Diagram ObjDecisionSwitchVisual inherits all core functionality from ObjDecisionSwitch (read, evaluate, compute decision, simulate, verify outcomes, etc.) and adds visualisation and import/export capabilities. Methods Diagram Generation Method Description --- --- diagram(direction) Generate a Mer" }, { "path": "factory-core/extend-visual/ObjFeatureStoreVisual.md", "title": "ObjFeatureStoreVisual", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjFeatureStoreVisual Visual, render, and diagram methods for the feature store. Extracted from ObjFeatureStore to separate core compute/analytics logic from presentation and diagram concerns. Class Diagram ObjFeatureStoreVisual inherits all core functionality from ObjFeatureStore (compute, analytics, lineage data, quality, usage, export methods) and adds visual/diagram capabilities. Methods Diagram Generation Method Description --- --- generate lineage mermaid(feature code, package, feature) Ge" }, { "path": "factory-core/extend-visual/ObjVisual.md", "title": "ObjVisual", "factory": "factory.core", "type": "markdown", "tags": [], "body": "ObjVisual Unified rendering module for diagrams and charts. Consolidates all diagram/chart-to-PNG rendering into a single utility class with static methods. Purpose Before ObjVisual, rendering logic was duplicated across several modules: - ObjTemplate.render mermaid contained the full Mermaid CLI rendering pipeline - ObjWorkflowVisual.visualise piper called processpiper.text2diagram.render directly - ObjDecisionSwitchVisual.generate sankey plotly built and rendered Plotly Sankey figures inline O" }, { "path": "factory-core/extend-visual/ObjWorkflowVisual.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.core", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) Technocore - All Rights Reserved. ObjWorkflowVisual Overview The WorkflowVisual class is a specialized tool for generating visual representations of workflows. It extends the base Workflow class to provide methods that can render a workflow's structure and execution path into diagrams. This is crucial for understanding, debugging, and documenting complex business processes. The class supports two main visualization formats: 1. Me" }, { "path": "factory-service/ObjServiceCommunication.md", "title": "ObjServiceCommunication", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceCommunication.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/ObjServiceStl.md", "title": "ObjServiceStl`", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. The intellectual and technical concepts contained herein are proprietary to TechnoCore and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore Automate. ObjServiceStl ObjServiceStl is a service for slicing 3D STL models into 2D SVG cross-sections suitable for laser cutti" }, { "path": "factory-service/archive/ObjServiceAnalytics.md", "title": "ObjServiceAnalytics", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceAnalytics.py // : < (CYTHON END)" }, { "path": "factory-service/archive/ObjServiceImportParser.md", "title": "ObjServiceImportParser", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceImportParser.py Updated : 2025-04-22 // : < (CYTHON END)" }, { "path": "factory-service/archive/ObjServicePublishJourney.md", "title": "ObjServicePublishJourney", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServicePublishJourney.py Updated : 2025-04-22 // : < (CYTHON END)" }, { "path": "factory-service/archive/ObjServiceQueryToImage.md", "title": "ObjServiceQueryToImage", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceQueryToImage.py Updated : 2025-04-22 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceAsana.md", "title": "Verify token and show connected user", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-04-20 // : < (CLASSES END) Overview ObjServiceAsana provides a reusable Asana REST API integration for the Axion platform. It wraps workspace, project, task, and section endpoints with authentication, rate-limit handling (429 retry), and error logging. A local def asana sync table tracks bidirectional mappings between Axion reco" }, { "path": "factory-service/package-core/ObjServiceBitbucket.md", "title": "Verify credentials and show connected repository", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-04-20 // : < (CLASSES END) Overview ObjServiceBitbucket provides a reusable Bitbucket Cloud REST API v2.0 integration for the Axion platform. It wraps repository, pull-request, pipeline, commit, and issue endpoints with HTTP Basic authentication, automatic pagination, rate-limit handling (429 retry), and error logging. A shared " }, { "path": "factory-service/package-core/ObjServiceBulksqldispatcher.md", "title": "ObjServiceBulksqldispatcher", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceBulksqldispatcher.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceCalculation.md", "title": "Imports", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. Imports The script begins by importing several libraries, including those for system functions (os, sys), handling sleep operations (time), parsing JSON (json), deep copying of objects (copy), YAML parser (yaml), SQL formatting (sqlparse), and two custom modules (ObjApi, ObjData). ObjServiceApi class: This class extends the ObjApi class found in the ObjApi module. I" }, { "path": "factory-service/package-core/ObjServiceClassification.md", "title": "ObjServiceClassification", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Reading classification rules and node hierarchies from a database. • Recursively processing these rules to classify input data. • Generating visual representations of these classification structures as Mermaid flowcharts and storing them back in the database." }, { "path": "factory-service/package-core/ObjServiceClassificationPmmlRead.md", "title": "ObjServiceClassificationPmmlRead", "factory": "factory.service", "type": "markdown", "tags": [], "body": "! Classification (resource.images/package.base/classification bpmn icon.svg \"\") PMML (Predictive Model Markup Language) is an XML-based language used to represent data mining models, including classification models. It allows different applications to share and use these models, regardless of the vendor or the specific tool used to create them. Classification models, in particular, predict categorical values, assigning data points to specific classes. Classification Models: These models predict " }, { "path": "factory-service/package-core/ObjServiceClassificationPmmlWrite.md", "title": "ObjServiceClassificationPmmlWrite", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceClassificationPmmlWrite.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceConfluence.md", "title": "Create API Token", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) Technocore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore. The intellectual and technical concepts contained herein are proprietary to TechnoCore and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore. Author : vheyn@technocore.co.za Create API Token 1. Log into Jira Software or Confluence and click your profile image and select Profile" }, { "path": "factory-service/package-core/ObjServiceCurrency.md", "title": "Show tracked rates (ZAR base)", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceCurrency fetches live exchange rates from the open.er-api.com free API. Rates are stored in data currency (latest per pair) and data currency history (time-series). Supports 166 currencies with ZAR as default base. No API key required. Rates update once daily from ECB data. API Sourc" }, { "path": "factory-service/package-core/ObjServiceDataSlice.md", "title": "ObjServiceDataSlice", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceDataSlice.py Updated : 2025-06-09 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceDecision.md", "title": "ObjServiceDecision", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceDecision.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceDecisionSwitch.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.service", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) Technocore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore. The intellectual and technical concepts contained herein are proprietary to TechnoCore and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore. ObjServiceDecisionSwitch The ObjServiceDecisionSwitch is a service class " }, { "path": "factory-service/package-core/ObjServiceDocEdit.md", "title": "ObjServiceDocEdit", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceDocEdit.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceEmailTicket.md", "title": "Process unclassified emails from bloom table", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-25 // : < (CLASSES END) Overview ObjServiceEmailTicket is a hook-based service that reads emails from bloom imap staging tables (populated by the ObjImap IMAP hook pipeline), uses an AI model to classify each message, and creates tickets for qualifying emails. Architecture Setup 1. Create a def imap hook row: 2. Configure con" }, { "path": "factory-service/package-core/ObjServiceFilefeed.md", "title": "Scan default directory", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceFilefeed scans folders for document files (.docx, .doc, .pdf), extracts text content using system tools, runs NLTK sentence tokenization and POS tagging, and stores results in bloom filefeed . Supports recursive folder scanning with first-level folder names used as client identifiers" }, { "path": "factory-service/package-core/ObjServiceGoogle.md", "title": "Verify service account credentials via Drive API", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-04-20 // : < (CLASSES END) Overview ObjServiceGoogle provides a reusable Google Workspace API integration for the Axion platform. It wraps Gmail, Google Sheets, Google Drive, and Google Calendar through OAuth2 service account credentials with domain-wide delegation. Each API service client is lazy-loaded on first use and cached " }, { "path": "factory-service/package-core/ObjServiceGuidName.md", "title": "ObjServiceGuidName", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceGuidName.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceInfobip.md", "title": "ObjServiceInfobip", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceInfobip.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceIntegration.md", "title": "ObjServiceIntegration", "factory": "factory.service", "type": "markdown", "tags": [], "body": "ObjServiceIntegration Module: factory.service/package.core Type: Abstract base class for external service integrations Overview ObjServiceIntegration provides a standard interface for syncing external service events to the Axion ticket system, RACI signoffs, and notifications. Each service subclass implements map to ticket event() to translate service-specific payloads into a standard action dict that sync to ticket() dispatches. Ticket Event Actions The map to ticket event() method must return " }, { "path": "factory-service/package-core/ObjServiceMeta.md", "title": "ObjServiceMeta", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceMeta.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceMongoBackup.md", "title": "ObjServiceMongoBackup", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceMongoBackup.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceMonitor.md", "title": "Standard collection (default mode)", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceMonitor is a workflow-facing service that delegates infrastructure monitoring to ObjMonitor.Monitor . It provides a standard process(context) entry point and typer CLI for running system data collection cycles. This service does not perform monitoring itself — it is a thin orchestrat" }, { "path": "factory-service/package-core/ObjServiceNewDevelopmentDB.md", "title": "ObjServiceNewDevelopmentDB", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceNewDevelopmentDB.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceOSM.md", "title": "Forward geocode", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceOSM provides geocoding via OpenStreetMap's Nominatim service (through the geopy library). Converts addresses to GPS coordinates and vice versa. No API key required. Rate limit: 1 request per second (enforced by Nominatim's usage policy). Methods address to geo(address) - tuple float," }, { "path": "factory-service/package-core/ObjServiceOnvif.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.service", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) Technocore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. The intellectual and technical concepts contained herein are proprietary to TechnoCore Automate and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore Automate. ObjServiceOnvif Overview ObjServiceOnvif captu" }, { "path": "factory-service/package-core/ObjServicePalette.md", "title": "Parse all Bootstrap swatches to DB", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServicePalette manages Bootstrap colour palettes and SCSS compilation. It parses swatch files for colour variables, stores them in def colour palette , and compiles SCSS templates into minified CSS using libsass. Colour resolution and palette read/write are delegated to ObjPalette in factor" }, { "path": "factory-service/package-core/ObjServicePallette.md", "title": "Components of color", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Components of color Because of the way our eyes work, a particular color can be defined using three components. We usually program colors in a computer by specifying their RGB values, which set the intensity of the red, green, and blue channels in a display. But for analyzing the perceptual attributes of a color, it’s better to think in terms of hue, saturation, and luminance channels. Hue is the component that distinguishes “different colors” in a non-technical sense. It’s property of color tha" }, { "path": "factory-service/package-core/ObjServicePublishJourney.md", "title": "ObjServicePublishJourney", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServicePublishJourney.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServicePython.md", "title": "Execute a script in sandbox (validates path)", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServicePython executes external Python scripts configured in def service . The script path is built from the service's ExternalFolder (or a default directory) plus PayloadTemplate (the script filename). Parameters are passed as safe command-line arguments via subprocess.run() . All scripts " }, { "path": "factory-service/package-core/ObjServiceQuiz.md", "title": "ObjServiceQuiz", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceQuiz.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceReference.md", "title": "Axion Service: Reference Implementation", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Axion Service: Reference Implementation 1. Overview This document provides a guide for developers on how to create new services within the Axion framework using the ObjServiceReference.py template. The reference service demonstrates the standard structure, methods, and attributes that all Axion services should implement to ensure consistency and compatibility with the workflow engine. 2. Purpose of a Standardized Service Structure Adhering to a standard structure ensures that: - Services are int" }, { "path": "factory-service/package-core/ObjServiceRss.md", "title": "Fetch a specific feed", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceRss fetches RSS/Atom feeds, parses items (title, link, description, publication date, enclosure images), and stores them in data rssitem . Multiple channels are configured in def rss and can be updated in bulk. How It Works 1. Fetch feed XML via requests.get() with User-Agent header " }, { "path": "factory-service/package-core/ObjServiceSAFPS.md", "title": "Reference search (summary)", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceSAFPS integrates with the Southern African Fraud Prevention Service (SAFPS) API to check ID numbers, contact numbers, email addresses, and bank account numbers against fraud incident databases. Supports both ReferenceSearch (summary) and DetailedObjectSearch (full incident data with " }, { "path": "factory-service/package-core/ObjServiceScorecard.md", "title": "ObjServiceScorecard", "factory": "factory.service", "type": "markdown", "tags": [], "body": "ObjServiceScorecard (c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. Overview Credit-style scoring engine. Loads variable/attribute definitions from def scorecard , reads a primary context record, evaluates each variable against the bureau/simulation data, and returns an integer score. All credit lending institutions like banks have complex credit models that use bureau and past loan performances to determine a cr" }, { "path": "factory-service/package-core/ObjServiceScreenshot.md", "title": "c) Technocore - All Rights Reserved.", "factory": "factory.service", "type": "markdown", "tags": [], "body": "! Technocore (resource.images/package.reference/admin.png \"\" ) (c) Technocore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore. The intellectual and technical concepts contained herein are proprietary to TechnoCore and dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from TechnoCore. ObjServiceScreenshot Overview The ObjServiceScreenshot service provides a" }, { "path": "factory-service/package-core/ObjServiceSegmentation.md", "title": "ObjServiceSegmentation", "factory": "factory.service", "type": "markdown", "tags": [], "body": "ObjServiceSegmentation Status: Legacy service proxy Module: factory.service/package.core/ObjServiceSegmentation.py Service API for managing and computing data segments using the legacy def segment table. The compute segment() method now delegates evaluation to ObjDecisionSegmentation.evaluate() in factory.core , making this class a thin proxy for the core engine. New segments should use ObjDecisionSegmentation directly with the DECISIONSEGMENT workflow node type. Architecture compute segment (pr" }, { "path": "factory-service/package-core/ObjServiceSlack.md", "title": "Verify bot token and show connected identity", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-04-20 // : < (CLASSES END) Overview ObjServiceSlack provides a reusable Slack Bot API integration for the Axion platform. It wraps the Slack Web API with Bearer token authentication, rate-limit handling (HTTP 429 with Retry-After), and Block Kit message formatting for rich notifications and interactive approvals. Unlike the basi" }, { "path": "factory-service/package-core/ObjServiceTest.md", "title": "ObjServiceTest", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceTest.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceTodoist.md", "title": "ObjServiceTodoist", "factory": "factory.service", "type": "markdown", "tags": [], "body": "ObjServiceTodoist Todoist REST API v2 service for task and project management. Overview Wraps the Todoist REST API with Bearer token authentication, rate-limit retry (429 handling), and local sync tracking via def todoist sync . Follows the same patterns as ObjServiceAsana . Configuration In config.yaml : API Methods Projects Method Description -------- ------------- list projects() List all projects get project(project id) Get project detail create project(name, color) Create a project Tasks Me" }, { "path": "factory-service/package-core/ObjServiceTruValidate.md", "title": "Run full FCRA verification", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceTruValidate integrates with the TransUnion TruValidate API for identity verification — PEP (Politically Exposed Persons) screening, sanctions list checking, and watchlist monitoring. All configuration (solution set name, table names, FCRA categories, bloom table names) is read from O" }, { "path": "factory-service/package-core/ObjServiceVirtual.md", "title": "ObjServiceVirtual", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore Automate - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. ObjServiceVirtual Virtual sleep service with Faker personal data, used in the VIRTUAL SIM demonstration workflow. Class Diagram Class Overview - Module: factory.service/package.core/ObjServiceVirtual.py - Inherits from: ObjApi.ObjApi - Associated YAML: ObjServiceVirtual.yaml - Table: data simulation - Service code: VIRTUAL Behaviour run workflow direct(guid" }, { "path": "factory-service/package-core/ObjServiceWaitmessage.md", "title": "ObjServiceWaitmessage", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceWaitmessage.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceWeather.md", "title": "Fetch weather for Cape Town International (default)", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceWeather retrieves current weather observations from METAR (Meteorological Aerodrome Report) stations via the pymetar library. METAR is the international standard for weather reporting at airports and weather stations worldwide. This is the core weather service using aviation-grade da" }, { "path": "factory-service/package-core/ObjServiceWhatsapp.md", "title": "ObjServiceWhatsapp", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceWhatsapp.py Updated : 2025-09-10 // : < (CYTHON END)" }, { "path": "factory-service/package-core/ObjServiceWikipedia.md", "title": "Look up a subject", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceWikipedia queries the Wikipedia API to fetch introductory text extracts for a given subject. Results are cached in the data wikipedia table to avoid redundant API calls. Used in workflows to enrich data with reference descriptions, definitions, or background context. No API key requi" }, { "path": "factory-service/package-core/ObjServiceYoutube.md", "title": "Axion Service: YouTube Audio Downloader", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Axion Service: YouTube Audio Downloader 1. Overview The ObjServiceYoutube is an Axion service designed to download the audio track from a given YouTube video URL, enrich it with metadata, and register it as a managed document within the Axion framework. It utilizes the yt-dlp library for reliable video information extraction and audio downloading, and the ObjDocument class for seamless integration with the Axion document management system. 2. Features - Audio Extraction : Downloads the best avai" }, { "path": "factory-service/package-core/ObjServiceZeroBounce.md", "title": "Validate a single email", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceZeroBounce validates email addresses via the ZeroBounce API. Returns deliverability status (valid, invalid, catch-all, abuse, etc.) and stores results using the bloom table data structure pattern for downstream workflow consumption. ZeroBounce API Endpoint Description ---------- ----" }, { "path": "factory-service/package-decisionswitch/ObjServiceSurvey.md", "title": "ObjServiceSurvey", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjSurvey.py Updated : 2024-02-17 // : < (CYTHON END)" }, { "path": "factory-service/package-farcaster/README.md", "title": "FARCASTER Tactical RPG Service", "factory": "factory.service", "type": "markdown", "tags": [], "body": "FARCASTER Tactical RPG Service Package Name: FARCASTER Module: farcaster Framework: Axion ObjService Location: factory.service/package.farcaster/ Overview FARCASTER is a turn-based tactical RPG inspired by XCOM, built as an Axion ObjService. Features include: - Grid-based movement with A pathfinding - Turn-based combat with action points - 4 character classes (Assault, Sniper, Medic, Engineer) - AI-controlled enemies - Permadeath mechanics - Campaign persistence API Endpoints All endpoints under" }, { "path": "factory-service/package-fullhouse/MIGRATION_SUMMARY.md", "title": "Shopify GraphQL Migration - Work Completed Summary", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Shopify GraphQL Migration - Work Completed Summary Date: February 7, 2026 Branch: feat/shopify Status: Phase 1 Complete - Ready for UAT Testing --- 🎯 Project Overview Successfully migrated Shopify integration from legacy REST API (2021-07) to modern GraphQL Admin API (2026-01). This provides a foundation for improved performance, reduced API calls, and future-proof integration with Shopify. ✅ Completed Work (75% of Migration) 1. Database Schema Migrations File: migration graphql 2026-01.sql - ✅ " }, { "path": "factory-service/package-fullhouse/MIGRATION_TODO.md", "title": "Shopify GraphQL Migration - Remaining Work", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Shopify GraphQL Migration - Remaining Work Completed ✅ 1. Database Schema - SQL migration file created 2. Authentication - Updated to use AccessToken 3. GraphQL Constants - All query/mutation templates added 4. GraphQL Helper Methods - Infrastructure methods added (refactored to standards) 5. DeleteProduct() - Migrated to GraphQL productDelete mutation 6. RetrieveSet() - Migrated to GraphQL product query with bloom product graphql() 7. BloomProductPrice() - Migrated to GraphQL productVariantUpda" }, { "path": "factory-service/package-fullhouse/ObjServiceCurrency.md", "title": "ObjServiceCurrency", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceCurrency.py Updated : 2024-07-26 // : < (CYTHON END)" }, { "path": "factory-service/package-fullhouse/ObjServiceDoForms.md", "title": "ObjServiceDoForms", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceDoForms.py Updated : 2024-07-26 // : < (CYTHON END)" }, { "path": "factory-service/package-fullhouse/ObjServiceFHShopify.md", "title": "ObjServiceFHShopify", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Author: vheyn@technocore.co.za Updated: 2026-04-16 --- ObjServiceFHShopify Shopify GraphQL Admin API integration for FullHouse retail. Manages product catalogue, promotions, pricing, collections, and variant management on the FullHouse Shopify store. API Version - Shopify GraphQL Admin API 2026-01 - Authentication: Access Token via X-Shopify-Access-Token header - Single endpoint: /admin/api/2026-01/graphql.json - Cost-based rate limiting (2000 points, 100/sec restore) CLI Commands Command Descri" }, { "path": "factory-service/package-fullhouse/ObjServiceFHwebsite.md", "title": "ObjServiceFHwebsite", "factory": "factory.service", "type": "markdown", "tags": [], "body": "then go to https://admin.fullhousefurniture.co.za/products" }, { "path": "factory-service/package-fullhouse/ObjServiceFilefeed.md", "title": "ObjServiceFilefeed", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceFilefeed.py Updated : 2025-04-22 // : < (CYTHON END)" }, { "path": "factory-service/package-fullhouse/ObjServiceImportParser.md", "title": "Run import for default service code", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceImportParser is a FullHouse-specific CSV file import service. It reads parser configurations from def service parser , scans directories for matching files, extracts parameters from filenames, parses CSV rows, and bulk-inserts into dynamically created database tables. Uses a staging " }, { "path": "factory-service/package-gekko/ObjServiceGoogleHome.md", "title": "ObjServiceGoogleHome", "factory": "factory.service", "type": "markdown", "tags": [], "body": "ObjServiceGoogleHome Google Home device integration for the Gekko package. Controls lights and plugs via the Google Home API and logs inbound device state change events from Google Cloud Pub/Sub to def google home events . Tables Table Purpose --- --- def google home devices Device registry — synced from Google Home graph def google home events Inbound event log from Pub/Sub Config (config.yaml → gekko.google home) Key Description --- --- client id Google OAuth 2.0 client ID client secret Google" }, { "path": "factory-service/package-gekkoridge/ObjServiceEwelink.md", "title": "config.yaml", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-19 // : < (CLASSES END) Overview ObjServiceEwelink integrates with eWeLink / Sonoff smart home devices. It uses a dual control path: - Cloud API (CoolKit v2) for device listing, status polling, and power monitoring - LAN control (sonofflan/mDNS) for on/off/toggle commands directly on the local network The cloud API is used wi" }, { "path": "factory-service/package-gekkoridge/ObjServiceFacebook.md", "title": "Scrape posts from a Facebook page", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceFacebook scrapes public Facebook page/profile posts using the facebook scraper library. It downloads post text, timestamps, and images, then stores them in the data newsfeed table via the ObjNewsFeed base class. Dependencies - facebook scraper — optional; service degrades gracefully " }, { "path": "factory-service/package-gekkoridge/ObjServiceLibreGlucose.md", "title": "ObjServiceLibreGlucose", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceLibreGlucose integrates with the LibreLinkUp API to retrieve real-time and historical glucose data from FreeStyle Libre 2 continuous glucose monitors (CGM). Data is stored in the data glucose table for reporting, alerting, and workflow consumption. The module lives in factory.service" }, { "path": "factory-service/package-gekkoridge/ObjServiceLoadshedding.md", "title": "ObjServiceLoadshedding", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceLoadshedding integrates with the EskomSePush API 2.0 to retrieve national load shedding status, area-specific schedules and upcoming events, and area search. Designed for correlation with solar/battery data to predict grid availability and optimize energy usage. The module lives in f" }, { "path": "factory-service/package-gekkoridge/ObjServiceNetwork.md", "title": "config.yaml [network section]", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-04-19 // : < (CLASSES END) Overview ObjServiceNetwork polls the MikroTik RB5009 RouterOS 7 REST API ( http://10.0.10.254 ) to capture router health, per-interface traffic counters, DHCP leases, and internet connectivity. It also determines household presence by matching DHCP leases and the ARP table against known MACs and DHCP h" }, { "path": "factory-service/package-gekkoridge/ObjServiceOpenWeather.md", "title": "Current weather conditions", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceOpenWeather integrates with the OpenWeatherMap API to retrieve current weather conditions, 5-day forecasts, air quality data, and solar-relevant cloud cover predictions. The service stores time-series snapshots in data weather for correlation with solar production (cloud cover vs PV " }, { "path": "factory-service/package-gekkoridge/ObjServiceSolarman.md", "title": "result[\"_solarman_result\"] == \"2 readings stored\"", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CLASSES START) Updated : 2026-03-16 // : < (CLASSES END) Overview ObjServiceSolarman integrates with the SolarMAN Open API (v1.1.6) to retrieve and store solar inverter and plant data from SolarMAN-connected installations. The service covers authentication, plant and device discovery, real-time and historical data retrieval, device control commands, alert mo" }, { "path": "factory-service/package-gekkoridge/ObjServiceTile.md", "title": "ObjServiceTile", "factory": "factory.service", "type": "markdown", "tags": [], "body": "ObjServiceTile Tile Bluetooth tracker location polling service. Overview Polls the Tile cloud API via the pytile library to retrieve last-known locations for all Tile devices on the account. Stores a full history snapshot in data tile location every sync cycle. API Uses https://production.tile-api.com/api/v1 — the Tile production API. Life360 acquired Tile in 2022 and shut down the consumer app and tile.com website in January 2025, but the backend API remains operational for existing integration" }, { "path": "factory-service/package-gekkoridge/ObjServiceTraccar.md", "title": "ObjServiceTraccar", "factory": "factory.service", "type": "markdown", "tags": [], "body": "ObjServiceTraccar Traccar GPS tracking platform integration. Overview Connects to a self-hosted Traccar server to poll device positions. Supports phones, tablets, and laptops. Stores position history with speed, altitude, battery, and address in data traccar position . Traccar Setup Docker Install Default login: admin / admin! Client Apps Platform App ---------- ----- Android Traccar Client (https://play.google.com/store/apps/details?id=org.traccar.client) iOS Traccar Client (https://apps.apple." }, { "path": "factory-service/package-homechoice/BUREAU_ENHANCEMENTS.md", "title": "Bureau Framework - Recommended Enhancements", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Bureau Framework - Recommended Enhancements This document outlines recommended enhancements to the Credit Bureau Routing Framework to improve reliability, performance, monitoring, and operational efficiency. Implemented Enhancements ✅ CLI Testing Tool (ObjBureauCLI.py) Comprehensive command-line interface for testing and validation. Commands : Features : - Real bureau API calls with test data - Automatic test data cleanup - Response time measurement - Raw JSON response viewing - Multi-bureau com" }, { "path": "factory-service/package-homechoice/BUREAU_FRAMEWORK.md", "title": "Credit Bureau Routing Framework", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Credit Bureau Routing Framework Overview The Credit Bureau Routing Framework provides a comprehensive, flexible system for integrating and managing multiple credit bureau providers in the Axion platform. It enables intelligent routing, load distribution, failover handling, and dynamic bureau selection without code changes. Version : Axion 8.x Package : factory.service/package.homechoice Branch : feat/hc bureau Table of Contents 1. Architecture ( architecture) 2. Core Components ( core-components" }, { "path": "factory-service/package-homechoice/ObjSErviceHCExperian_ESW.md", "title": "ObjSErviceHCExperian_ESW", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Patched for simulation mode" }, { "path": "factory-service/package-homechoice/ObjServiceBureau.md", "title": "ObjServiceBureau", "factory": "factory.service", "type": "markdown", "tags": [], "body": "ObjServiceBureau Overview Base class framework for credit bureau service integrations in the Axion platform. Provides common infrastructure for connecting to external credit bureaus, managing API calls, implementing buffer strategies, and routing between multiple bureau providers. Purpose ObjServiceBureau establishes a consistent pattern for all bureau integrations, extracting common functionality including: - Remote connection configuration from def remoteconnections - Buffer management to prev" }, { "path": "factory-service/package-homechoice/ObjServiceBureauRouter.md", "title": "ObjServiceBureauRouter", "factory": "factory.service", "type": "markdown", "tags": [], "body": "ObjServiceBureauRouter Overview Intelligent routing and strategy management system for credit bureau services. Dynamically selects bureau providers based on configurable strategies including date ranges, load distribution, failover, and dual bureau calls. Purpose The router provides centralized control over bureau selection without changing application code. Strategies can be adjusted in real-time through the def bureau strategy table to: - Distribute load across multiple bureau providers - Impl" }, { "path": "factory-service/package-homechoice/ObjServiceGBG.md", "title": "ObjServiceGBG", "factory": "factory.service", "type": "markdown", "tags": [], "body": "ObjServiceGBG Overview GBG Identity Verification and Fraud Risk Management integration for HomeChoice. Provides identity checks, document verification, fraud scoring, and AML screening through GBG's API platform. Products Product Method Purpose --------- -------- --------- ID3global verify identity() Identity data verification against SA bureaux IDscan verify document() Document image verification (ID, passport) Instinct check fraud risk() ML fraud risk scoring (0-1000) Predator screen aml() PEP" }, { "path": "factory-service/package-homechoice/ObjServiceHCExperian.md", "title": "ObjServiceHCExperian", "factory": "factory.service", "type": "markdown", "tags": [], "body": "The class primarily focuses on integrating with remote services utilizing SQL queries for retrieval and manipulation of response data. It includes support for resolving and buffering data effectively, along with SOAP-based service support for service communication. Patched for simulation" }, { "path": "factory-service/package-homechoice/ObjServiceHCExperian_LES.md", "title": "ObjServiceHCExperian_LES", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Patched for simulation." }, { "path": "factory-service/package-homechoice/ObjServiceHCExporian_NAM.md", "title": "ObjServiceHCExporian_NAM", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Patched for simulation" }, { "path": "factory-service/package-homechoice/ObjServiceHCMyData.md", "title": "ObjServiceHCMyData", "factory": "factory.service", "type": "markdown", "tags": [], "body": "ObjServiceHCMyData Overview MyData credit bureau REST API integration for the Axion platform. Implements modern REST-based credit checking using the ObjServiceBureau framework. This is a reference implementation demonstrating how to create new bureau integrations using REST APIs. It serves as a template for adding additional bureau providers. Purpose Provides credit report data from MyData bureau via REST API, including: - Consumer identity verification - Credit history and scoring - Account inf" }, { "path": "factory-service/package-homechoice/ObjServiceHCScore.md", "title": "ObjServiceHCScore", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceHCScore.py // : < (CYTHON END)" }, { "path": "factory-service/package-homechoice/ObjServiceInovo.md", "title": "ObjServiceInovo", "factory": "factory.service", "type": "markdown", "tags": [], "body": "ObjServiceInovo Overview ObjServiceInovo.py integrates Axion with the Inovo Lead/BulkUpload endpoint. It supports two main operational paths: 1. Bulk send mode : pushes regular outbound records using SQL configured in def service.payloadsql . 2. Clear queue mode : pushes removecall commands staged in environment tables: - data api batch clear command uat - data api batch clear command prod Both modes post JSON payloads to Inovo and write batch outcomes to environment-specific log tables. The ser" }, { "path": "factory-service/package-homechoice/ObjServiceXdsHome.md", "title": "ObjServiceXdsHome", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Timing: Current real 0m29.592s user 0m12.244s sys 0m1.668s Judgement COUNT missing: check this guide: \"qqPxz6XjEYsyPNFC7UZr7n\" - enquirycount COUNT missing: Y - adversecount COUNT missing: Y - deceasedstatus COUNT missing Y - disputestatus missing: Assume PARAM2 = 9 digits of the cell number, if those digits found anywhere in the payload return 1, else 0 SMS CALL = final score TO be included, ID number that is returned to be included" }, { "path": "factory-service/package-homechoice/PERSISTENT_RDG_CHANGES.md", "title": "Persistent RDG Implementation - Change Summary", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Persistent RDG Implementation - Change Summary Overview Updated the Bureau Router to use persistent RDG (Random Distribution Group) assignment instead of random routing. This ensures that the same ID number always routes to the same bureau, providing consistent user experience and stable load distribution. Key Change Before : Each bureau request generated a new random value (0-100), causing the same ID to potentially route to different bureaus on each call. After : Each ID receives a permanent R" }, { "path": "factory-service/package-homechoice/resource-experian/credentials.md", "title": "UAT credentials for NSV2.", "factory": "factory.service", "type": "markdown", "tags": [], "body": "UAT credentials for NSV2. username : 2566-technocore UAT key : 6i1hVZf5K=" }, { "path": "factory-service/package-homechoice/resource-fhscore/fhscore.md", "title": "Inputs", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Inputs Field Type Description ----- ---- ---------- CtryNo int Country number – used to determine the subscriber number and password to use for the explicit V2 call to Experian IDNumber string Customer’s ID number – used for explicit V2 call Surname string Customer’s surname – used for explicit V2 call FirstName string Customer’s first name – used for explicit V2 call Gender string Customer’s gender – used for explicit V2 call PassportFlag bool Indicates whether the customer has an RSA ID number" }, { "path": "factory-service/package-sunswept/ObjServiceCalendarConstraint.md", "title": "ObjServiceCalendarConstraint", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceCalendarConstraint.py Updated : 2025-04-22 // : < (CYTHON END)" }, { "path": "factory-service/package-sunswept/ObjServiceClientEventPlan.md", "title": "ObjServiceClientEventPlan", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceClientEventPlan.py Updated : 2025-04-22 // : < (CYTHON END)" }, { "path": "factory-service/package-sunswept/ObjServiceHami.md", "title": "ObjServiceHami", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceHami.py Updated : 2025-04-22 // : < (CYTHON END)" }, { "path": "factory-service/package-sunswept/ObjServiceMaestroOutboundCall.md", "title": "ObjServiceMaestroOutboundCall", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceMaestroOutboundCall.py Updated : 2025-04-22 // : < (CYTHON END)" }, { "path": "factory-service/package-sunswept/ObjServiceMaestroSync.md", "title": "ObjServiceMaestroSync", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceMaestroSync.py Updated : 2025-04-22 // : < (CYTHON END)" }, { "path": "factory-service/package-switchx/ObjServiceEtl.md", "title": "ObjServiceEtl", "factory": "factory.service", "type": "markdown", "tags": [], "body": "Covert the code to pep8 standards in terms of spacing and tabs. autopep8 -i ObjServiceEtl.py XML ETL Fetch Batch Please note: Batch query not configurable, hard coded sql Each row in batch processed record at a time app client submission no important guid Schemas: - switchx data:replicated data - switchxdw:reporting schema - switchxdw dev:supporting data Context Source: XML of Application Client Submissions Source-schema:switchx data Source-tables: - switchx data.application client submission --" }, { "path": "factory-service/package-switchx/ObjServiceGoogleOcr.md", "title": "ObjServiceGoogleOcr", "factory": "factory.service", "type": "markdown", "tags": [], "body": "(c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. Fields textAnchor object (TextAnchor) Optional. Provenance of the entity. Text anchor indexing into the Document.text. type string Required. Entity type from a schema e.g. Address. mentionText string Optional. Text value of the entity e.g. 1600 Amphitheatre Pkwy. mentionId string Optional. Deprecated. Use id field instead. confidence number Optional. Confidence of d" }, { "path": "factory-service/package-switchx/ObjServiceLoom.md", "title": "ObjServiceLoom", "factory": "factory.service", "type": "markdown", "tags": [], "body": "// : < (CYTHON START) Cython compile cythonize -3 -a -i ObjServiceLoom.py // : < (CYTHON END)" }, { "path": "factory-service/package-tlc/ObjServiceCmtelecom.md", "title": "ObjServiceCmtelecom", "factory": "factory.service", "type": "markdown", "tags": [], "body": "" }, { "path": "factory-deploy/ObjAudit.md", "title": "ObjAudit", "factory": "factory.deploy", "type": "markdown", "tags": [], "body": "ObjAudit Security audit module powered by Trivy. Scans dependencies, configuration files, source code, and container images for vulnerabilities and misconfigurations. Audit Modes Mode What it scans Trivy command ------ --------------- --------------- deps Python dependencies (requirements.txt) for CVEs trivy fs --scanners vuln . config Dockerfiles, Helm charts for misconfigurations trivy config resource.docker/ secrets Source code for leaked credentials trivy fs --scanners secret . image Built D" }, { "path": "factory-deploy/ObjBuild.md", "title": "ObjBuild", "factory": "factory.deploy", "type": "markdown", "tags": [], "body": "ObjBuild Build pipeline orchestrator for Axion k8s deployment. Module : factory.deploy/ObjBuild.py Extensions : factory.deploy/extend.build/ Purpose Single entry point for the full build pipeline: 1. Validate — config.yaml configured for target package, PEM keys exist 2. Compile — Cython-compile all factory modules via ObjCompile 3. Image — build Docker image via ObjBuildDocker 4. Push — push to configured registry 5. Deploy — install/upgrade Helm chart via ObjBuildHelm CLI Build Tracking Every " }, { "path": "factory-deploy/ObjConfig.md", "title": "ObjConfig", "factory": "factory.deploy", "type": "markdown", "tags": [], "body": "📌 (c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. // : < (CYTHON START) ⚙️ Cython compile cythonize -3 -a -i ObjConfig.py Updated : 2024-07-20 // : < (CYTHON END)" }, { "path": "factory-deploy/ObjDataConfig.md", "title": "ObjDataConfig", "factory": "factory.deploy", "type": "markdown", "tags": [], "body": "📌 (c) TechnoCore - All Rights Reserved. NOTICE: All information contained herein is, and remains the property of TechnoCore Automate. 📌 File purposes: 1. python3 ObjDataConfig.py EXPORTCORE To be used to update the coredb.axion logic - for example if changes have been made to sys , def , internet , meta , list , stage , track and sysdate tables NOTE the server ashpool.co.za is hardcoded as the only legitimate source for this. The steps are: export core tables to yaml(): get the structure for all" }, { "path": "factory-deploy/ObjEnvironment.md", "title": "ObjEnvironment", "factory": "factory.deploy", "type": "markdown", "tags": [], "body": "ObjEnvironment Environment infrastructure orchestrator. Module : factory.deploy/ObjEnvironment.py Extensions : factory.deploy/extend.environment/ Purpose Manages non-build, non-runtime infrastructure: - DNS — Cloudflare record creation via ObjDNSManager - Secrets — config.yaml → Infisical migration - PEM keys — encryption key upload to Infisical - Snapshots — data table versioning (ObjSnapshot) - Schema export — DB table definitions to YAML (ObjDataConfig) CLI Extensions File Purpose ------ ----" }, { "path": "factory-deploy/ObjSecretMigrate.md", "title": "ObjSecretMigrate", "factory": "factory.deploy", "type": "markdown", "tags": [], "body": "ObjSecretMigrate Migration tool for moving secrets from config.yaml into Infisical. Overview ObjSecretMigrate reads credential sections from config.yaml and pushes them to a running Infisical instance. It provides seven commands: migrate, verify, list, push-keys, delete, promote, and cache-seed. Prerequisites - Infisical running (see resource.bin/start infisical.sh ) - Machine Identity created in Infisical with Universal Auth - base.infisical.enabled: true in config.yaml - client id and client s" }, { "path": "factory-deploy/ObjSubstrate.md", "title": "ObjSubstrate", "factory": "factory.deploy", "type": "markdown", "tags": [], "body": "📌 ObjSubstrate Base Class for Infrastructure and Service Management ObjSubstrate is an abstract base class that defines a standardized interface for interacting with various types of infrastructure \"substrates.\" It is the foundation for creating controllers that manage virtual machines, containers, and even supervised processes in a unified way. The primary goal of ObjSubstrate is to provide a consistent API for common lifecycle operations, regardless of the underlying technology (e.g., Docker, " }, { "path": "factory-deploy/ObjSupervisor.md", "title": "ObjSupervisor", "factory": "factory.deploy", "type": "markdown", "tags": [], "body": "📌 ObjSupervisor Supervisor Process Management Substrate ObjSupervisor is a concrete implementation of the ObjSubstrate base class that treats processes managed by supervisord as instances. It uses the standard xmlrpc.client library to communicate with the XML-RPC API of a running supervisord instance. This class abstracts Supervisor's process management into the unified ObjSubstrate interface, allowing you to start, stop, and monitor supervised processes in the same way you would manage VMs or c" }, { "path": "factory-deploy/ObjTest.md", "title": "ObjTest — Test Runner", "factory": "factory.deploy", "type": "markdown", "tags": [], "body": "ObjTest — Test Runner Scan and run pytest files individually with parallel execution, retries, TUI dashboard, and previous-run comparison. Usage Commands run Discover and execute test files. Each file runs in an isolated subprocess ( python -m pytest