The Stable Baseline
Axion 8 — the current development branch. Meridian introduced thread-safe database connections, connection pooling, multi-backend key-value stores, and the factory pattern architecture. All active feature work targets this branch.
Branch: develop | Status: active development | Pages: 2488
Axion is organised into discrete factory modules, each handling a specific domain. Core functionality is implemented as Obj* classes with companion .md documentation and .yaml configuration.
| Factory | Description |
|---|---|
| factory.core | Fundamental shared components — ObjData, ObjWorkflow, ObjConnection, ConfigIni. Compiled to .so via Cython for performance. |
| factory.service | Business service implementations — calculations, classifications, external API integrations, per-package customisations. |
| factory.deploy | Deployment tooling — Docker builds, Helm charts, K3s runners, Cython compilation, wiki generation. |
| factory.report | Report generation — HTML/PDF output, per-package report modules, CSS-to-YAML templates. |
| factory.web | Web server components — form handling, PWA support, Caddy integration. |
| factory.ai | AI/ML integrations — LLM, image generation, time-series, OpenCV. |
| factory.conversation | Chat and messaging — Discord, WhatsApp, Console bots. |
| factory.field | Form field definitions — 120+ field types with per-field YAML. |
| factory.export | Data export — CSV, JSON, YAML, Excel, Markdown formats. |
| factory.import | Data import handlers — file parsing, validation, transformation. |
| factory.text | Text processing — template expansion, variable substitution, regex processing. |
| factory.webhook | Webhook handlers — Bitbucket, payment providers, external integrations. |
| factory.workflow | Workflow definitions — step orchestration, async execution, scheduler. |
| factory.sms | SMS integration — provider abstraction, template messaging. |
| factory.pages | Page templates — layout components, navigation, themed rendering. |
| Service | Port | Description |
|---|---|---|
| ServeReport | 9400 | Report generation and PDF rendering |
| ServeWebsite | 9000 | Web frontend and form handling |
| ServeWorkflow | — | Workflow orchestration engine |
| ServeWebHook | 9500 | Webhook handlers for external integrations |
| ServeConversation | 9550 | Chat and messaging service |
| ServeImport | — | Data import processing |
| ServeMqtt | — | MQTT message handling |
| ServeSms | — | SMS integration service |
| Section | Docs | API | Schema |
|---|---|---|---|
| Ai | 18 | 21 | 2 |
| Conversation | 11 | 14 | 3 |
| Core | 190 | 219 | 76 |
| Deploy | 18 | 31 | 6 |
| Export | 18 | 20 | 0 |
| Field | 126 | 127 | 0 |
| Import | 19 | 19 | 0 |
| Pages | 12 | 13 | 0 |
| Report | 294 | 295 | 4 |
| Service | 98 | 163 | 43 |
| Sms | 18 | 20 | 0 |
| Text | 100 | 104 | 0 |
| Web | 17 | 19 | 5 |
| Webhook | 17 | 13 | 0 |
| Workflow | 41 | 44 | 0 |
| Notes | 230 | 0 | 0 |
| Total | 1227 | 1122 | 139 |
| Component | Technology |
|---|---|
| Language | Python 3.12+ |
| Web Framework | FastAPI / Uvicorn |
| Database | MariaDB, MSSQL, SQLite, MongoDB, InfluxDB |
| Caching | Redis |
| Messaging | RabbitMQ, MQTT (Mosquitto) |
| Containers | Docker, K3s (Kubernetes) |
| Registry | Harbor v2.12 with Trivy scanning |
| Compilation | Cython (.so) with ccache |
| Ci Cd | Bitbucket webhooks, pipeline LXC |
| Auth | Keycloak federated SSO |
| Monitoring | InfluxDB, OpenObserve, MQTT logging |
| Testing | pytest (Python), Jest (JavaScript) |
| Linting | ruff, mypy, ESLint |
| Docs | Wiki.js, ObjWiki auto-generation |
Python (pytest) — target coverage: 85%
JavaScript (Jest) — 73 tests
python3 -m venv dev-env
source dev-env/bin/activate
pip install uv
uv pip install -r resource.config/requirements.txt
./run_tests.sh
pytest resource.test/pytests/ -v
python ServeReport.py
python ServeWebsite.py
python ServeWorkflow.py
python factory.deploy/ObjBuild.py pipeline homechoice --notify raci
python factory.deploy/ObjWiki.py build
| Package | Description |
|---|---|
| HomeChoice | Collections strategy, credit scoring, and customer management for HomeChoice. |
| Full House | Retail product management, Shopify integration, and prospecting workflows. |
| FinChoice | Financial services batch processing and collections. |
| Gekko Ridge | Google Home integration and smart device connectivity. |
| Sunswept | Guest preferences, spa management, and wellness programme scheduling. |
| SwitchX | Data insights platform with GeoJSON mapping and analytics. |
| Codex | Document and content management with SMS template strategies. |
| TechnoCore | Internal platform, branding, and product documentation. |
| Intelect | Back office architecture and data systems integration. |
| OmBank | Banking architecture and systems design. |
| Reference | Reference implementation and workflow templates. |
| TLC Worldwide | Loyalty and rewards marketing platform. |
| Neuron | Neural network and AI-driven analytics. |
| Chartwell | Data visualization and charting platform. |
| Two Mountains | Custom deployment package. |
| UDEC | University deployment and management. |
Compiled by ObjWiki v2.0 on 2026-05-03 08:30 from develop