Dokumentazzjoni tas-sistema u tal-moduli

🔍

🏛️ Arkitettura tal-pjattaforma 🔑 Login

📘

Apparat u mezzi ta' tħaddim

assets manufacturing_execution 🛡️ RLS Protected

L-impjanti u l-mezzi ta' ħidma <unk> Dokumentazzjoni tal-proċess u tal-API derivata mill-kodiċi.

Fachliche Bestimmung: L-impjanti u l-mezzi ta' ħidma <unk> Dokumentarità tal-proċess u tal-API derivat mill-kodiċi.

⚡ Flussi ta' xogħol u ċikli ta' ħajja (10) 🗄️ Modelli tad-dejta & Felder (2) 🔌 Punti ta' Bidu (UI & API) (37) 🛡️ Regolatorji u konformità

⚡ Flussi ta' xogħol u ċikli ta' ħajja

manutenzjoni / Tnaqqis `cascade:business.maintenance.cycle`

L-użu tal-enerġija

1. fieldservice

L-użu ta' servizz ta' barra / irrapportar

servizz fil-qasam

Aktionen: create_service_report

2. followup

Pjanijiet ta' manutenzjoni

Aktiva

Aktionen: l-is-sistema ta' manutenzjoni

3. ticket

Il-klijent għandu jkollu l-ebda kunsiderazzjoni tal-klijent.

biljetti

Aktionen: create_ticket

Pjanijiet ta' manutenzjoni/ta' manutenzjoni `cascade_target:business.maintenance.followup`

L-użu tal-enerġija

1. cascade

Pjanijiet ta' manutenzjoni/ta' manutenzjoni

L-ordni tal-utent: Aġent tal-qbid tal-assi `plan:command_asset_capture_agent`

Geprüfter Durable-Plan (durable_plan), Start: 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

Ordni għall-użu: asset raw subagent `plan:command_asset_crud_subagent`

Geprüfter Durable-Plan (durable_plan), Start: 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

Ordni għall-użu: Aġent Ġenerali tal-assi `plan:command_asset_general_agent`

Geprüfter Durable-Plan (durable_plan), Start: 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

L-użu tal-prodott `plan:command_maintenance_agent`

Geprüfter Durable-Plan (durable_plan), Start: 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

L-użu ta' l-informazzjoni `plan:command_maintenance_report_agent`

Geprüfter Durable-Plan (durable_plan), Start: 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

L-ordni tal-utent: Aġent tal-istorja tas-servizz `plan:command_service_history_agent`

Geprüfter Durable-Plan (durable_plan), Start: 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

F'dan il-każ, il-valur tal-impjant għandu jkun inqas minn EUR 500. `plan:maintenance_check`

Geprüfter Durable-Plan (durable_plan), Start: 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

assi `status:asset`

L-użu tal-apparat tal-istatus osservattiv (observable_only) ma jkunx obbligat.

1. active

attiv

Statut <unk>attiv<unk> tal-magna tal-istat assi.

2. on_hire

on_hire

Statut <unk>on_hire<unk> tal-magna tal-istat assi.

3. in_repair

in_repair

Stat <unk>in_repair<unk> tal-magna tal-istat assi.

4. inactive

Inattiv

Statut <unk>inaattiv<unk> tal-magna tal-istat assi.

5. defective

difettużi

Statut <unk>defective<unk> tal-magna tal-istatus assi.

6. disposed

li jintrema

Statut <unk>disponibbli <unk> tal-magna tal-istat assi.

🗄️ Modelli tad-dejta & Felder

AssetEvents asset_events RLS Aktiv

13 Il-kamps / il-kolla

Tabelle asset_events

Feldname	Tip ta' data	Obbligu	Schlüssel	L-importanza professjonali
`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 Il-kamps / il-kolla

Tabelle assets

Feldname	Tip ta' data	Obbligu	Schlüssel	L-importanza professjonali
`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

🔌 Punti ta' Bidu (UI & API)

Art	Il-metodu	Punti ta ' tmiem / pjaċċ	Titel & Zweck	L-eżenzjoni
⚡ 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`

🛡️ Regolatorji u konformità

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

L-impriża għandha tinvestiga l-impriża.
Il-konnessjoni tal-konnessjoni