Sistemas & modulju dokumentacija

🔍

🏛️ Platformas arhitektūra 🔑 Login

🧰

Darbības uzdevumi & Werkstatt

workorders manufacturing_execution 🛡️ RLS Protected

Izstrādājumu un darba statusa uzdevumi, darba posmi, materiāla vajadzību noteikšana (BOM) un laika noteikšana.

Fachliche Bestimmung: Koordinē fizisko izpildi darbnīcā, ražošanā un būvniecības vietā. Apņēmuma saņemšanas gadījumā tiek automātiski radīts no piedāvājums.

⚡ Darbības plūsmas un dzīves cikļi (11) 🗄️ Datu modeļi & laukumi (2) 🔌 Izstādes punkti (UI un API) (54) 🛡️ Regulators & atbilstība

⚡ Darbības plūsmas un dzīves cikļi

Darbības valsts uzdevumu izpilde `workorder_execution`

No plānoto pasūtījums līdz darba sagatavošanai un ražošanai līdz pieņemšanai.

stateDiagram-v2 [*] --> SCHEDULED: Aus Angebot konvertiert SCHEDULED --> IN_PROGRESS: Techniker startet Arbeit IN_PROGRESS --> QUALITY_CHECK: Montage beendet QUALITY_CHECK --> COMPLETED: Abnahme erfolgt COMPLETED --> [*]: Übergabe an Schlussrechnung

1. SCHEDULED

Plānots

pasūtījums ir pieejams, resursus un termiņus ir pieejami.

Aktionen: Materiāla rezerves pārbaude

2. IN_PROGRESS

Izpildes

darbinieks sāk apstrādi un saskaita darba laiku.

Aktionen: Pārskata laiks

3. QUALITY_CHECK

Kvalitātes kontrole

Katrs no šiem kritērijiem ir atkarīgs no konkrēta uzņēmuma normu un klienta kritēriju.

Aktionen: Pārbaudes protokolu deponēšana

4. COMPLETED

Atklāts

Ja tas ir nepieciešams, tas ir nepieciešams, lai nodrošinātu, ka:

Aktionen: Izvadīt fakturēšanu

Uzraudzības iestāde `plan:command_extra_work_agent`

Pārbaudēts durabls plan (durabls_plan), sākums: manuals_command.

1. extra_work_agent

extra_work_agent

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

Aktionen: extra_work_agent

Uzraudzības iestāde: `plan:command_site_documentation_agent`

Pārbaudēts durabls plan (durabls_plan), sākums: manuals_command.

1. site_documentation_agent

site_documentation_agent

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

Aktionen: site_documentation_agent

lietotāja norādījums: laika aizturēšanas līdzeklis `plan:command_time_capture_agent`

Pārbaudēts durabls plan (durabls_plan), sākums: manuals_command.

1. time_capture_agent

time_capture_agent

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

Aktionen: time_capture_agent

Izmantošanas instrukcija: neaptverts darba pārstāvis `plan:command_unbilled_work_agent`

Pārbaudēts durabls plan (durabls_plan), sākums: manuals_command.

1. unbilled_work_agent

unbilled_work_agent

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

Aktionen: unbilled_work_agent

Uzrakstības: darba pabeigšanas pārstāvis `plan:command_work_completion_agent`

Pārbaudēts durabls plan (durabls_plan), sākums: manuals_command.

1. work_completion_agent

work_completion_agent

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

Aktionen: work_completion_agent

lietotāja norādījums: darba kārtība `plan:command_workorder_crud_subagent`

Pārbaudēts durabls plan (durabls_plan), sākums: manuals_command.

1. workorder_crud_subagent

workorder_crud_subagent

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

Aktionen: workorder_crud_subagent

Izmantošanas instrukcija: darba kārtības ģenerāldirektorat `plan:command_workorder_general_agent`

Pārbaudēts durabls plan (durabls_plan), sākums: manuals_command.

1. workorder_general_agent

workorder_general_agent

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

Aktionen: workorder_general_agent

Darbības uzdevums pabeigts `plan:unbilled_check`

Pārbaudēts ilgtspējīgs plāns (durable_plan), start: domain_event.

1. unbilled_work_agent

unbilled_work_agent

{"key": "step_0", "label": "Nicht abgerechnete Stunden finden", "adapter": "agent.execute", "agent": "unbilled_work_agent", "condition_fact": null}

Aktionen: unbilled_work_agent

Darbības uzdevums, kas paziņots par pabeigtu `plan:work_completed`

Pārbaudēts ilgtspējīgs plāns (durable_plan), start: domain_event.

1. extra_work_agent

extra_work_agent

{"key": "step_0", "label": "Zusatzleistungen erkennen", "adapter": "agent.execute", "agent": "extra_work_agent", "condition_fact": null}

Aktionen: extra_work_agent

2. service_history_agent

service_history_agent

{"key": "step_1", "label": "Wartungseintrag fuer Anlage", "adapter": "agent.execute", "agent": "service_history_agent", "condition_fact": "asset_id"}

Aktionen: service_history_agent

3. billing_agent

billing_agent

{"key": "step_2", "label": "Rechnungsentwurf erstellen", "adapter": "agent.execute", "agent": "billing_agent", "condition_fact": "billable"}

Aktionen: billing_agent

<unk>GT14_0 `status:work_order`

Apskatāma stāvokļa mašīna (apskatāma tikai).

1. draft

projektu

Statuss <unk>izraksts <unk> statuss GT14_0__.

2. scheduled

paredzētas

Statuss <unk>sākts <unk> stāvokļa mašīna pasūtījums.

3. active

aktīvs

Statuss <unk>aktīvs <unk> statussmasinas pasūtījums.

4. waiting_customer

waiting_customer

Statuss <unk>waiting_customer<unk> stāvokļa mašīna pasūtījums.

5. waiting_vendor

waiting_vendor

Statuss <unk>waiting_vendor<unk> stāvokļa mašīnas pasūtījums.

6. completed

pabeigta

Statuss <unk>lvots<unk> stāvokļa mašīna pasūtījums.

7. approved

apstiprināts

Statuss <unk>apstiprināts <unk> stāvokļa mašīna pasūtījums.

8. invoiced

fakturēti

Statuss <unk>izveidots <unk> stāvokļa mašīna pasūtījums.

9. cancelled

atcelts

Statuss <unk> atcelts <unk> statuss GT14_0__.

🗄️ Datu modeļi & laukumi

WorkLogs work_logs RLS Aktiv

16 Šķiet, ka tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai ir atkarīgs no tā, vai ir atkarīgs no tā, vai ir atkarīgs no tā, vai ir atkarīgs no tā vai ir no tā.

Tabelle work_logs

Feldname	Datums	Atbalsts	Schlüssel	Īpaša nozīme
`work_order_id`	`UUID`	Nein	FK ➔ work_orders.id	Feld work_order_id
`project_id`	`UUID`	Nein	FK ➔ projects.id	Feld project_id
`user_id`	`UUID`	Nein	FK ➔ users.id	Feld user_id
`started_at`	`DATETIME`	Nein	-	Feld started_at
`ended_at`	`DATETIME`	Nein	-	Feld ended_at
`duration_minutes`	`INTEGER`	Ja *	-	Feld duration_minutes
`description`	`TEXT`	Nein	-	Feld description
`billable`	`BOOLEAN`	Ja *	-	Feld billable
`hourly_rate`	`NUMERIC(14, 2)`	Nein	-	Feld hourly_rate
`source`	`VARCHAR(48)`	Ja *	-	Feld source
`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

WorkOrders work_orders RLS Aktiv

55 Šķiet, ka tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai tas ir atkarīgs no tā, vai ir atkarīgs no tā, vai ir atkarīgs no tā, vai ir atkarīgs no tā, vai ir atkarīgs no tā vai ir no tā.

Tabelle work_orders

Feldname	Datums	Atbalsts	Schlüssel	Īpaša nozīme
`work_order_number`	`VARCHAR(32)`	Ja *	-	Feld work_order_number
`project_id`	`UUID`	Nein	FK ➔ projects.id	Feld project_id
`customer_id`	`UUID`	Nein	FK ➔ customers.id	Feld customer_id
`asset_id`	`UUID`	Nein	FK ➔ assets.id	Feld asset_id
`location_id`	`UUID`	Nein	FK ➔ locations.id	Feld location_id
`title`	`VARCHAR(255)`	Ja *	-	Feld title
`description`	`TEXT`	Nein	-	Feld description
`order_type`	`VARCHAR(32)`	Ja *	-	Feld order_type
`priority`	`VARCHAR(16)`	Ja *	-	Feld priority
`contract_id`	`UUID`	Nein	-	Feld contract_id
`ticket_id`	`UUID`	Nein	FK ➔ tickets.id	Feld ticket_id
`status`	`VARCHAR(48)`	Ja *	-	Feld status
`scheduled_start`	`DATETIME`	Nein	-	Feld scheduled_start
`scheduled_end`	`DATETIME`	Nein	-	Feld scheduled_end
`started_at`	`DATETIME`	Nein	-	Feld started_at
`completed_at`	`DATETIME`	Nein	-	Feld completed_at
`assigned_user_id`	`UUID`	Nein	FK ➔ users.id	Feld assigned_user_id
`customer_signature_document_id`	`UUID`	Nein	FK ➔ documents.id	Feld customer_signature_document_id
`completion_summary`	`TEXT`	Nein	-	Feld completion_summary
`billable`	`BOOLEAN`	Ja *	-	Feld billable
`currency`	`VARCHAR(3)`	Ja *	-	Feld currency
`subtotal`	`NUMERIC(14, 2)`	Ja *	-	Feld subtotal
`tax_total`	`NUMERIC(14, 2)`	Ja *	-	Feld tax_total
`total`	`NUMERIC(14, 2)`	Ja *	-	Feld total
`invoice_policy`	`VARCHAR(12)`	Ja *	-	Feld invoice_policy
`invoice_status`	`VARCHAR(12)`	Ja *	-	Feld invoice_status
`invoice_customer_id`	`UUID`	Nein	FK ➔ customers.id	Feld invoice_customer_id
`payment_terms`	`VARCHAR(128)`	Nein	-	Feld payment_terms
`payment_term_code`	`VARCHAR(32)`	Nein	-	Feld payment_term_code
`payment_term_days`	`INTEGER`	Nein	-	Feld payment_term_days
`skonto_days`	`INTEGER`	Nein	-	Feld skonto_days
`skonto_percent`	`NUMERIC(5, 2)`	Nein	-	Feld skonto_percent
`customer_reference`	`VARCHAR(128)`	Nein	-	Feld customer_reference
`cost_center`	`VARCHAR(64)`	Nein	-	Feld cost_center
`cost_object`	`VARCHAR(64)`	Nein	-	Feld cost_object
`tax_exemption_reason`	`VARCHAR(255)`	Nein	-	Feld tax_exemption_reason
`prepayment_percent`	`NUMERIC(5, 2)`	Nein	-	Feld prepayment_percent
`invoice_note`	`TEXT`	Nein	-	Feld invoice_note
`delivery_address`	`TEXT`	Nein	-	Feld delivery_address
`delivery_method`	`VARCHAR(64)`	Nein	-	Feld delivery_method
`delivery_note`	`TEXT`	Nein	-	Feld delivery_note
`incoterm`	`VARCHAR(16)`	Nein	-	Feld incoterm
`incoterm_place`	`VARCHAR(128)`	Nein	-	Feld incoterm_place
`carrier`	`VARCHAR(128)`	Nein	-	Feld carrier
`tracking_number`	`VARCHAR(128)`	Nein	-	Feld tracking_number
`semantic_attributes`	`JSONB`	Nein	-	Feld semantic_attributes
`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

🔌 Izstādes punkti (UI un API)

Art	Metodes	Galvenā vieta / ceļš	Titel & Zweck	Attaisnošana
⚡ REST API	DELETE	`/api/v1/workorders/{work_order_id}/items/{item_id}`	delete_workorder_item Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	GET	`/api/v1/extra-work/projects/{project_id}/open`	list_open_for_project Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/jobflow/projects/{project_id}/flow`	project_flow Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/jobflow/reports/{report_id}/briefing`	visit_briefing Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/jobflow/reports/{report_id}/flow`	report_flow Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/jobflow/staff`	personāls Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/jobflow/work-orders/{work_order_id}/dossier/download`	download_latest_dossier Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/jobflow/work-orders/{work_order_id}/dossier/versions`	dossier_versions Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/jobflow/work-orders/{work_order_id}/dossier/{document_id}`	download_dossier_version Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/jobflow/work-orders/{work_order_id}/flow`	work_order_flow Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/workorders`	list_workorders Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/workorders/stats`	workorder_stats Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/workorders/{work_order_id}`	get_workorder Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/workorders/{work_order_id}/compatible-parts`	workorder_compatible_parts Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/workorders/{work_order_id}/delivery-note.pdf`	work_order_delivery_note Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/workorders/{work_order_id}/invoicing`	order_invoicing_overview Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/workorders/{work_order_id}/items`	list_workorder_items Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/workorders/{work_order_id}/logs`	list_worklogs Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/workorders/{work_order_id}/material-requirements`	list_material_requirements Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/api/v1/workorders/{work_order_id}/materials`	list_materials Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/portal/{slug}/auftraege`	workorders_page Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/workorders`	workorders_page Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/workorders/new`	workorders_new_page Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/workorders/{work_order_id}`	workorder_detail_page Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	GET	`/workorders/{work_order_id}/edit`	workorder_detail_page Semantic binding: inventory_only; mutation=False	`workorders`
⚡ REST API	PATCH	`/api/v1/workorders/{work_order_id}`	update_workorder Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	PATCH	`/api/v1/workorders/{work_order_id}/items/{item_id}`	update_workorder_item Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/extra-work/{candidate_id}/decide`	Lēmums Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/extra-work/{candidate_id}/invoiced`	mark_invoiced Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/extra-work/{candidate_id}/quote`	create_change_quote Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/jobflow/projects/{project_id}/manager`	assign_project_manager Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/jobflow/projects/{project_id}/status`	set_project_status Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/jobflow/reports/{report_id}/create-order`	create_order_for_visit Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/jobflow/reports/{report_id}/schedule`	schedule_report Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/jobflow/work-orders/{work_order_id}/assign`	assign_work_order Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/jobflow/work-orders/{work_order_id}/dossier`	create_dossier Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/jobflow/work-orders/{work_order_id}/plan-visit`	plan_visit Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/jobflow/work-orders/{work_order_id}/start`	start_work_order Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/workorders`	create_workorder Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/workorders/{work_order_id}/complete`	complete_workorder Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/workorders/{work_order_id}/create-invoice`	create_invoice_from_workorder Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/workorders/{work_order_id}/documents`	upload_workorder_document Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/workorders/{work_order_id}/invoice`	create_order_invoice Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/workorders/{work_order_id}/items`	add_workorder_item Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/workorders/{work_order_id}/logs`	add_worklog Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/workorders/{work_order_id}/material-requirements`	add_material_requirement Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/workorders/{work_order_id}/material-requirements/{requirement_id}/purchase`	purchase_material_requirement Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/workorders/{work_order_id}/material-requirements/{requirement_id}/reserve`	reserve_material_requirement Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/workorders/{work_order_id}/materials`	consume_material Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	POST	`/api/v1/workorders/{work_order_id}/signature`	save_signature Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	PUT	`/api/v1/workorders/{work_order_id}/invoice-settings`	save_invoice_settings Semantic binding: operator_surface; mutation=True	`workorders`
⚡ REST API	PUT	`/api/v1/workorders/{work_order_id}/items/{item_id}/delivered`	set_item_delivered Semantic binding: operator_surface; mutation=True	`workorders`
🖥️ WEB-UI	GET	`/auftraege`	Pieprasījuma pārskats Visas darbnīcas un montajstrādes	`workorders:read`
⚡ REST API	PATCH	`/api/v1/workorders/{id}/status`	Izmainīt statusu Pievērsuma statuss	`workorders:write`

🛡️ Regulators & atbilstība

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

Darba laika likums (ArbZG dokumentācijas obligācija)
Mērķis:

Saistītie moduli:

➔ finance ➔ projects ➔ fieldservice ➔ assembly