Systémová a modulová dokumentácia

🔍

🏛️ Architektúra platformy 🔑 Login

📘

Prístroje a zariadenia

assets manufacturing_execution 🛡️ RLS Protected

Systémy a prevádzkové prostriedky <unk> procesná a API dokumentácia odvodená z kódu.

Fachliche Bestimmung: Prípravky a prevádzkové prostriedky <unk> procesná a API dokumentácia odvodená z kódu. Obsahuje všetky registrované procesy, schopnosti, stavebné stroje, API a tabuľky pre simulácie a preskúmanie.

⚡ Pracovné postupy a životné cykly (10) 🗄️ Modely údajov & Felder (2) 🔌 Úvodné body (UI & API) (37) 🛡️ Regulatory & Compliance

⚡ Pracovné postupy a životné cykly

údržba / Úprava `cascade:business.maintenance.cycle`

Kaskade (review_gated).

1. fieldservice

Údaje o činnostiach v oblasti zahraničnej služby / vyhľadávanie

servis

Aktionen: create_service_report

2. followup

Plánovanie údržby

aktíva

Aktionen: údržba.plán

3. ticket

Výška výšky

lístky

Aktionen: create_ticket

Plánovanie údržby/údržby `cascade_target:business.maintenance.followup`

Kaskade (review_gated).

1. cascade

Plánovanie údržby/údržby

Použitie: agent pre zachytávanie aktív `plan:command_asset_capture_agent`

Kontrolovaný trvalý plán (durable_plan), začiatok: manual_command.

1. asset_capture_agent

asset_capture_agent

{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "asset_capture_agent", "condition_fact": null}

Aktionen: asset_capture_agent

Použitie: subgentu `plan:command_asset_crud_subagent`

Kontrolovaný trvalý plán (durable_plan), začiatok: manual_command.

1. asset_crud_subagent

asset_crud_subagent

{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "asset_crud_subagent", "condition_fact": null}

Aktionen: asset_crud_subagent

Použitie: generálny zástupca `plan:command_asset_general_agent`

Kontrolovaný trvalý plán (durable_plan), začiatok: manual_command.

1. asset_general_agent

asset_general_agent

{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "asset_general_agent", "condition_fact": null}

Aktionen: asset_general_agent

Použitie: údržba `plan:command_maintenance_agent`

Kontrolovaný trvalý plán (durable_plan), začiatok: manual_command.

1. maintenance_agent

maintenance_agent

{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "maintenance_agent", "condition_fact": null}

Aktionen: maintenance_agent

Použitie: správca správy o údržbe `plan:command_maintenance_report_agent`

Kontrolovaný trvalý plán (durable_plan), začiatok: manual_command.

1. maintenance_report_agent

maintenance_report_agent

{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "maintenance_report_agent", "condition_fact": null}

Aktionen: maintenance_report_agent

Použitie: agent histórie služieb `plan:command_service_history_agent`

Kontrolovaný trvalý plán (durable_plan), začiatok: manual_command.

1. service_history_agent

service_history_agent

{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "service_history_agent", "condition_fact": null}

Aktionen: service_history_agent

V prípade potreby sa použije aj článok 6 ods. 1 písm. a) CRR. `plan:maintenance_check`

Zkontrolovaný trvalý plán (durable_plan), začiatok: domain_event.

1. maintenance_agent

maintenance_agent

{"key": "step_0", "label": "Wartungstermine pruefen", "adapter": "agent.execute", "agent": "maintenance_agent", "condition_fact": null}

Aktionen: maintenance_agent

☐ V prípade potreby `status:asset`

Pozorovateľné stave (only observable_only).

1. active

aktívny

Status <unk>active<unk> stavového stroja zariadenie.

2. on_hire

on_hire

Status <unk>on_hire<unk> stavebného zariadenia zariadenie.

3. in_repair

in_repair

Status <unk>in_repair<unk> stavu zariadenia zariadenie.

4. inactive

Neaktívny

Status <unk>inactive<unk> stavu stroj zariadenie.

5. defective

defektné

Status <unk>defektívny<unk> stavebného stroja zariadenie.

6. disposed

Upravený

Status <unk>disponed<unk> stavového stroja zariadenie.

🗄️ Modely údajov & Felder

AssetEvents asset_events RLS Aktiv

13 Poľy / stĺpce

Tabelle asset_events

Feldname	Typ údajov	Povinnosť	Schlüssel	Využitie
`asset_id`	`UUID`	Ja *	FK ➔ assets.id	Feld asset_id
`event_type`	`VARCHAR(48)`	Ja *	-	Feld event_type
`work_order_id`	`UUID`	Nein	FK ➔ work_orders.id	Feld work_order_id
`project_id`	`UUID`	Nein	FK ➔ projects.id	Feld project_id
`document_id`	`UUID`	Nein	FK ➔ documents.id	Feld document_id
`occurred_at`	`DATETIME`	Ja *	-	Feld occurred_at
`description`	`TEXT`	Nein	-	Feld description
`idempotency_key`	`VARCHAR(128)`	Nein	-	Feld idempotency_key
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at
`metadata`	`JSONB`	Ja *	-	Feld metadata

Assets assets RLS Aktiv

47 Poľy / stĺpce

Tabelle assets

Feldname	Typ údajov	Povinnosť	Schlüssel	Využitie
`asset_number`	`VARCHAR(32)`	Ja *	-	Feld asset_number
`parent_asset_id`	`UUID`	Nein	FK ➔ assets.id	Feld parent_asset_id
`customer_id`	`UUID`	Nein	FK ➔ customers.id	Feld customer_id
`project_id`	`UUID`	Nein	FK ➔ projects.id	Feld project_id
`location_id`	`UUID`	Nein	FK ➔ locations.id	Feld location_id
`assigned_to`	`UUID`	Nein	FK ➔ users.id	Feld assigned_to
`product_id`	`UUID`	Nein	FK ➔ products.id	Feld product_id
`asset_type`	`VARCHAR(128)`	Nein	-	Feld asset_type
`manufacturer`	`VARCHAR(128)`	Nein	-	Feld manufacturer
`model`	`VARCHAR(128)`	Nein	-	Feld model
`serial_number`	`VARCHAR(128)`	Nein	-	Feld serial_number
`installation_date`	`DATE`	Nein	-	Feld installation_date
`purchase_date`	`DATE`	Nein	-	Feld purchase_date
`purchase_price`	`NUMERIC(12, 2)`	Nein	-	Feld purchase_price
`warranty_until`	`DATE`	Nein	-	Feld warranty_until
`next_service_date`	`DATE`	Nein	-	Feld next_service_date
`asset_account_code`	`VARCHAR(32)`	Nein	-	Feld asset_account_code
`depreciation_account_code`	`VARCHAR(32)`	Nein	-	Feld depreciation_account_code
`disposal_income_account_code`	`VARCHAR(32)`	Nein	-	Feld disposal_income_account_code
`lifecycle_state`	`VARCHAR(48)`	Ja *	-	Feld lifecycle_state
`commissioned_at`	`DATE`	Nein	-	Feld commissioned_at
`decommissioned_at`	`DATE`	Nein	-	Feld decommissioned_at
`approved_at`	`DATETIME`	Nein	-	Feld approved_at
`approved_by`	`UUID`	Nein	FK ➔ users.id	Feld approved_by
`maintenance_interval_value`	`INTEGER`	Nein	-	Feld maintenance_interval_value
`maintenance_interval_unit`	`VARCHAR(48)`	Nein	-	Feld maintenance_interval_unit
`maintenance_contract`	`VARCHAR(256)`	Nein	-	Feld maintenance_contract
`ownership`	`VARCHAR(16)`	Ja *	-	Feld ownership
`owner_customer_id`	`UUID`	Nein	FK ➔ customers.id	Feld owner_customer_id
`customer_contact_id`	`UUID`	Nein	FK ➔ contacts.id	Feld customer_contact_id
`contract_id`	`UUID`	Nein	FK ➔ contracts.id	Feld contract_id
`status`	`VARCHAR(48)`	Ja *	-	Feld status
`condition_grade`	`VARCHAR(1)`	Nein	-	Feld condition_grade
`adr_certified`	`BOOLEAN`	Ja *	-	Feld adr_certified
`is_rentable`	`BOOLEAN`	Ja *	-	Feld is_rentable
`description`	`TEXT`	Nein	-	Feld description
`category_data`	`JSONB`	Ja *	-	Feld category_data
`detection_confidence`	`NUMERIC(4, 3)`	Nein	-	Feld detection_confidence
`id`	`UUID`	Nein	PK	Feld id
`tenant_id`	`UUID`	Ja *	FK ➔ organizations.id	Feld tenant_id
`created_at`	`DATETIME`	Ja *	-	Feld created_at
`updated_at`	`DATETIME`	Ja *	-	Feld updated_at
`created_by`	`UUID`	Nein	-	Feld created_by
`updated_by`	`UUID`	Nein	-	Feld updated_by
`source_type`	`VARCHAR(32)`	Nein	-	Feld source_type
`source_id`	`UUID`	Nein	-	Feld source_id
`metadata`	`JSONB`	Ja *	-	Feld metadata

🔌 Úvodné body (UI & API)

Art	Metód	Koniec / cesta	Titel & Zweck	Uprava
⚡ REST API	DELETE	`/api/v1/assets/{asset_id}`	delete_asset Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	DELETE	`/api/v1/assets/{asset_id}/components/{component_id}`	remove_component Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	GET	`/api/v1/assets`	list_assets Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/api/v1/assets/autocomplete`	asset_autocomplete Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/api/v1/assets/maintenance/due`	list_due_maintenance Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/api/v1/assets/stats`	asset_stats Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/api/v1/assets/{asset_id}`	get_asset Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/api/v1/assets/{asset_id}/accessories`	asset_accessories Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/api/v1/assets/{asset_id}/compatible-parts`	asset_compatible_parts Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/api/v1/assets/{asset_id}/components`	list_components Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/api/v1/assets/{asset_id}/documents`	list_asset_documents Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/api/v1/assets/{asset_id}/events`	list_asset_events Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/assets`	assets_page Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/assets/new`	asset_create_page Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/assets/{asset_id}`	asset_detail_page Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/portal/{slug}/anlagen`	assets_page Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	GET	`/portal/{slug}/anlagen/{asset_id}`	asset_detail_page Semantic binding: inventory_only; mutation=False	`assets`
⚡ REST API	PATCH	`/api/v1/assets/{asset_id}`	update_asset Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets`	create_asset_manual Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/import`	import_assets_csv Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/trigger-maintenance-check`	trigger_maintenance_check Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/{asset_id}/approve`	approve_asset Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/{asset_id}/assign`	assign_asset Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/{asset_id}/commission`	commission_asset Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/{asset_id}/components`	add_component Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/{asset_id}/create-work-order`	create_asset_work_order Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/{asset_id}/decommission`	decommission_asset Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/{asset_id}/documents`	upload_asset_document Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/{asset_id}/documents/{document_id}`	link_document Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/{asset_id}/events`	create_asset_event Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/{asset_id}/maintenance`	record_maintenance Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/{asset_id}/photo`	upload_asset_photo Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/{asset_id}/relocate`	relocate_asset Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/api/v1/assets/{asset_id}/review`	review_asset Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/portal/{slug}/anlagen/melden`	asset_report_submit Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	POST	`/portal/{slug}/anlagen/{asset_id}/zuordnen`	asset_assign Semantic binding: operator_surface; mutation=True	`assets`
⚡ REST API	PUT	`/api/v1/assets/{asset_id}/maintenance-plan`	set_maintenance_plan Semantic binding: operator_surface; mutation=True	`assets`

🛡️ Regulatory & Compliance

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

Prehľadateľnosť
Zároveň sa môže použiť aj pre výpočet na účely výpočtu hodnoty.