arthexis 0.1.21

Power & Energy Infrastructure

Arthexis Constellation

Purpose

Arthexis Constellation is a narrative-driven Django-based software suite that centralizes tools for managing electric vehicle charging infrastructure and orchestrating energy-related products and services.

Current Features

• Compatible with the Open Charge Point Protocol (OCPP) 1.6 central system, handling:
  • Lifecycle & sessions
    • BootNotification
    • Heartbeat
    • StatusNotification
    • StartTransaction
    • StopTransaction
  • Access & metering
    • Authorize
    • MeterValues
  • Maintenance & firmware
    • DiagnosticsStatusNotification
    • FirmwareStatusNotification
• API integration with Odoo, syncing:
  • Employee credentials via res.users
  • Product catalog lookups via product.product
• Runs on Windows 11 and Ubuntu 22.04 LTS
• Tested for the Raspberry Pi 4 Model B

Project under rapid active and open development.

Role Architecture

Arthexis Constellation ships in four node roles tailored to different deployment scenarios.

Role	Description & Common Features
Terminal	Single-User Research & Development Features: GUI Toast
Control	Single-Device Testing & Special Task Appliances Features: AP Public Wi-Fi, Celery Queue, GUI Toast, LCD Screen, NGINX Server, RFID Scanner
Satellite	Multi-Device Edge, Network & Data Acquisition Features: AP Router, Celery Queue, NGINX Server, RFID Scanner
Watchtower	Multi-User Cloud & Orchestration Features: Celery Queue, NGINX Server

Quick Guide

1. Clone

• Linux: open a terminal and run git clone https://github.com/arthexis/arthexis.git.
• Windows: open PowerShell or Git Bash and run the same command.

2. Start and stop

Terminal nodes can start directly with the scripts below without installing; Control, Satellite, and Watchtower roles require installation first. Both approaches listen on http://localhost:8000/ by default.

• VS Code

  • Open the folder and go to the Run and Debug panel (Ctrl+Shift+D).
  • Select the Run Server (or Debug Server) configuration.
  • Press the green start button. Stop the server with the red square button (Shift+F5).

• Shell

  • Linux: run ./start.sh and stop with ./stop.sh.
  • Windows: run start.bat and stop with Ctrl+C.

3. Install and upgrade

• Linux:

  • Run ./install.sh with a node role flag:
    • --terminal – default when unspecified and recommended if you're unsure. Terminal nodes can also use the start/stop scripts above without installing.
    • --control – prepares the single-device testing appliance.
    • --satellite – configures the edge data acquisition node.
    • --constellation – enables the multi-user orchestration stack.
  • Use ./install.sh --help to list every available flag if you need to customize the node beyond the role defaults.
  • Upgrade with ./upgrade.sh.

• Windows:

  • Run install.bat to install (Terminal role) and upgrade.bat to upgrade.
  • Installation is not required to start in Terminal mode (the default).

4. Administration

Visit http://localhost:8000/admin/ for the Django admin and http://localhost:8000/admindocs/ for the admindocs. Use --port with the start scripts or installer when you need to expose a different port.

Sigils

Sigils are bracketed tokens such as [ENV.SMTP_PASSWORD] that Arthexis expands at runtime. They make it possible to reference configuration secrets, system metadata, or records stored in other apps without duplicating values across the project.

Syntax at a glance

• [PREFIX.KEY] — returns a field or attribute. Hyphens and casing are normalized automatically.
• [PREFIX=IDENTIFIER.FIELD] — selects a specific record by primary key or any unique field.
• [PREFIX:FIELD=VALUE.ATTRIBUTE] — filters by a custom field instead of the primary key.
• [PREFIX.FIELD=[OTHER.SIGIL]] — nests sigils so the value after = resolves before the outer token.
• [PREFIX] — for entity prefixes, returns the serialized object in JSON; for configuration prefixes, resolves to an empty string when the key is missing.

The platform ships with three configuration prefixes:

• ENV reads environment variables.
• CONF reads Django settings.
• SYS exposes computed system information such as build metadata.

Additional prefixes are defined through Sigil Roots, which map a short code (for example ROLE, ODOO, or USER) to a Django model. You can review them from Admin → Sigil Builder (/admin/sigil-builder/), where a test console is also available.

Unknown prefixes remain in place (e.g. [UNKNOWN.VALUE]) and are logged. When the optional gway CLI is installed, the resolver will attempt to delegate unresolved tokens to it before falling back to the original text.

Support

Contact us at [e-mail] or visit our web page for professional services and commercial support.

Project Guidelines

• AGENTS – operating handbook for repository workflows, testing, and release management.
• DESIGN – visual, UX, and branding guidance that all interfaces must follow.

About Me

"What, you want to know about me too? Well, I enjoy developing software, role-playing games, long walks on the beach and a fourth secret thing." --Arthexis