IDTA Submodel Editor Documentation

This documentation site is the canonical reference for features, configuration, and API behavior.

For quick onboarding and local run commands, start with the repository README: - Repository README

Start Here

• New to the project: read Features Overview
• Configuring environments: Configuration Reference
• Integrating programmatically: API Endpoints Reference
• Reviewing supported model elements: Element Types

Feature Guides

• Smart Mapper
• Magic Import
• Template Operations
• Passport Mode
• Semantic Lookup
• PCF Calculator
• Dataspace Publishing
• PLC4X Bridge

Reference Guides

• Configuration Reference
• API Endpoints Reference
• Element Types
• Review Playbook

Operational Notes

• Swagger UI (/api/docs) is available when backend ENV != production.
• Mnestix browser is exposed at http://localhost:3001 when using the dataspace profile.
• Running the auth compose profile adds Keycloak, but authentication is only enforced when OIDC is enabled in backend configuration.
• Keycloak maps to host port 8081 by default (KEYCLOAK_HOST_PORT), so auth profile can run with frontend.

CI and Automation

• CI pipeline: ci.yml
• Scheduled/manual E2E pipeline: e2e-tests.yml
• Fixture refresh workflow: fixtures-refresh.yml
• Docs build/deploy workflow: docs.yml