Documentazione dei sistemi e dei moduli

🔍

🏛️ Architettura della piattaforma 🔑 Login

📘

Apparecchi e mezzi di gestione

assets manufacturing_execution 🛡️ RLS Protected

Applicazioni e mezzi di gestione <unk> documentazione processuale e API derivata dal codice.

Fachliche Bestimmung: Anlagen & Betriebsmittel <unk> documentazione processuale e API derivata dal codice.

⚡ Flussi di lavoro e cicli di vita (10) 🗄️ Modelli di dati (2) 🔌 Punto di partenza (UI & API) (37) 🛡️ Regolamentazione e conformità

⚡ Flussi di lavoro e cicli di vita

manutenzione / Riparazione `cascade:business.maintenance.cycle`

Cascade (review_gated).

1. fieldservice

Importo di servizi esteri

Servizio di campo

Aktionen: create_service_report

2. followup

Pianificazione della manutenzione

attività

Aktionen: manutenzione.orario

3. ticket

Billett per difetti/disordini

biglietti

Aktionen: create_ticket

Pianificazione di successione di manutenzione/riparazione `cascade_target:business.maintenance.followup`

Cascade (review_gated).

1. cascade

Pianificazione di successione di manutenzione/riparazione

Ordine d'uso: agente di cattura degli asset `plan:command_asset_capture_agent`

Controllato piano duraturo (durable_plan), inizio: manual_command.

1. asset_capture_agent

asset_capture_agent

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Aktionen: asset_capture_agent

Ordine d'uso: asset crude subagente `plan:command_asset_crud_subagent`

Controllato piano duraturo (durable_plan), inizio: manual_command.

1. asset_crud_subagent

asset_crud_subagent

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Aktionen: asset_crud_subagent

Ordine d'uso: agente generale `plan:command_asset_general_agent`

Controllato piano duraturo (durable_plan), inizio: manual_command.

1. asset_general_agent

asset_general_agent

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Aktionen: asset_general_agent

Ordine d'uso: agente di manutenzione `plan:command_maintenance_agent`

Controllato piano duraturo (durable_plan), inizio: manual_command.

1. maintenance_agent

maintenance_agent

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Aktionen: maintenance_agent

Ordine d'uso: agente di manutenzione `plan:command_maintenance_report_agent`

Controllato piano duraturo (durable_plan), inizio: manual_command.

1. maintenance_report_agent

maintenance_report_agent

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Aktionen: maintenance_report_agent

Ordine d'uso: agente storico di servizio `plan:command_service_history_agent`

Controllato piano duraturo (durable_plan), inizio: manual_command.

1. service_history_agent

service_history_agent

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Aktionen: service_history_agent

Evento di impianti `plan:maintenance_check`

Consigli di controllo (durable_plan), start: domain_event.

1. maintenance_agent

maintenance_agent

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Aktionen: maintenance_agent

- il numero di persone `status:asset`

La macchina in stato di osservazione (solo osservabile) non è obbligatoria.

1. active

Attivo

Statuto <unk>active<unk> della macchina di stato impianto.

2. on_hire

on_hire

Statuto della macchina di stato impianto.

3. in_repair

in_repair

Status <unk>in_repair<unk> della macchina in stato impianto.

4. inactive

inattivo

Statuto <unk>inactive<unk> della macchina di stato impianto.

5. defective

difettosi

Statuto <unk>defective<unk> della macchina di stato impianto.

6. disposed

di cui

Statuto della macchina di stato impianto.

🗄️ Modelli di dati

AssetEvents asset_events RLS Aktiv

13 Feltri / colonne

Tabelle asset_events

Feldname	Tipo di dati	Dati	Schlüssel	Importanza professionale
`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 Feltri / colonne

Tabelle assets

Feldname	Tipo di dati	Dati	Schlüssel	Importanza professionale
`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

🔌 Punto di partenza (UI & API)

Art	Metodo	Punto finale / percorso	Titel & Zweck	Il diritto
⚡ 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`

🛡️ Regolamentazione e conformità

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

Capacità di verifica
Isolazione dei clienti (PostgreSQL RLS)