How thevladbog/markiro works
Markiro is an offline-first Chestny ZNAK production platform. Its main workflow spans office configuration, line-side scanning and aggregation, local journaling with eventual synchronization, server-side traceability and inventory, and external regulatory exchange. The graph also preserves the documented kiosk, signer, labeling, billing, and SaaS capabilities. Relationships between product surfaces and infrastructure come from the README; source excerpts provide only limited internal implementation evidence, so unsampled internal links are omitted.
Main entry points: app.module.ts NestJS API · app.tsx Admin cabinet · App.tsx Line station · SyncEngine.kt Handheld workflows
Components 24
Product surfaces
- Admin cabinet
apps/admin/src/app.tsx - Line station
apps/station/src/App.tsx - Pickup kiosk
apps/kiosk/src/App.tsx - Signer agent
apps/signer/src/App.tsx - Handheld workflows
apps/handheld/app/src/main/kotlin/app/markiro/handheld/core/sync/SyncEngine.kt
Production workflows
- Product catalog
apps/admin/src/pages/catalog - Shifts and scanning
apps/api/src/modules/shifts - Boxes and SSCC
apps/api/src/modules/boxes - Inventory workflows
apps/api/src/modules/inventories - Label templates
apps/admin/src/pages/labels - Employee pickup
apps/admin/src/pages/pickup
Platform services
- NestJS API
apps/api/src/app.module.ts - Authentication
apps/api/src/auth/auth.module.ts - Code-status ingest
apps/api/src/modules/chz-code-statuses/chz-code-status-ingest.service.ts - National catalog import
apps/api/src/modules/national-catalog
SaaS and billing
- Billing and offers
apps/api/src/modules/billing - Billing profiles
apps/api/src/modules/billing-profiles/billing-profiles.service.ts - SaaS operator panel
apps/saas-admin/src/app.tsx
State and integrations
- PostgreSQL
packages/db/src/client.ts - Station local journal
apps/station/src/lib/mirror.ts - Handheld local database
apps/handheld/app/src/main/kotlin/app/markiro/handheld/core/storage/HandheldDatabase.kt
Other components
- Factory operators
- Chestny ZNAK True API
- CommerceML / 1C
Connections 25
- Factory operators → Admin cabinet: configures
README.md - Factory operators → Line station: scans production
README.md - Factory operators → Pickup kiosk: collects orders
README.md - Admin cabinet → NestJS API: uses
README.md - Pickup kiosk → NestJS API: uses
README.md - Line station → NestJS API: syncs when connected
README.md - Line station → Station local journal: journals locally
README.md - Handheld workflows → NestJS API: synchronizes
- Handheld workflows → Handheld local database: stores offline work
apps/handheld/app/src/main/kotlin/app/markiro/handheld/core/sync/SyncEngine.kt - Signer agent → NestJS API: provides True API token
README.md - NestJS API → PostgreSQL: reads and writes
README.md - NestJS API → Chestny ZNAK True API: integrates
README.md - NestJS API → CommerceML / 1C: exchanges data
README.md - Admin cabinet → Product catalog: manages products
README.md - Admin cabinet → Shifts and scanning: manages shifts
README.md - Admin cabinet → Boxes and SSCC: manages boxes
README.md - Admin cabinet → Inventory workflows: manages inventory
README.md - Admin cabinet → Label templates: edits templates
README.md - Admin cabinet → Employee pickup: audits pickup
README.md - NestJS API → Authentication: enforces identity
- NestJS API → Code-status ingest: ingests status data
apps/api/src/modules/chz-code-statuses/chz-code-status-ingest.service.ts - NestJS API → National catalog import: supports imports
apps/api/src/modules/national-catalog/national-catalog-import-preview.service.ts - NestJS API → Billing and offers: serves billing
README.md - Billing and offers → Billing profiles: uses seller policy
apps/api/src/modules/platform-offers/offer-preview.service.ts - SaaS operator panel → NestJS API: uses