Skip to main content

Repositories

Phimi follows the same four-repository layout as the aidj platform. All are private repositories in the phimi-track organization.

RepositoryContentsImage
phimi-platformRust workspace: protocol, ingest, core, commands, storage, API, simulator; PostgreSQL migrations; vendor frame fixturesregistry.bitview.club/phimi/phimi-platform
phimi-uiNext.js dashboardregistry.bitview.club/phimi/phimi-ui
phimi-docsThis Docusaurus site, plus the original vendor documents in vendor/ (not published)registry.bitview.club/phimi/phimi-docs
phimi-devopsKubernetes manifests and Argo CD application for namespace phimi—

Platform crates​

CrateResponsibility
phimi-protocol0x7E framing, 0x7D escaping, XOR checksum, BCD terminal id, typed uplink/downlink messages
phimi-ingestTokio TCP server: sessions, registration/authentication, ACKs, duplicates, downlinks, Prometheus metrics
phimi-coreLocation source, plausibility, device clock, "older point never replaces the latest"
phimi-commandsV53 command texts and the command lifecycle
phimi-storageSQLx pool and embedded migrations
phimi-apiAxum REST/WebSocket API; phimi-api migrate runs migrations
phimi-simulatorVirtual V53 replaying the vendor exchanges over TCP

Release flow​

Build each repository's Dockerfile, push an immutable tag to Harbor, take the digest, and pin it in phimi-devops. Argo CD applies the change. Rolling back means reverting the digest commit.