Dokumentazzjoni tas-sistema u tal-moduli

🔍

🏛️ Arkitettura tal-pjattaforma 🔑 Login

🧰

In-nefqa tal-persunal

workorders manufacturing_execution 🛡️ RLS Protected

L-ispejjeż tal-produzzjoni u l-istabbiltà tal-impjiegi, il-passi tax-xogħol, l-identifikazzjoni tal-ħtiġijiet tal-materjali (BOM) u l-ġbir tal-ħin.

Fachliche Bestimmung: L-impriża tal-art li tkun qed tiffranka l-impriża tal-art li tkun qed tiffranka l-impriża tal-art li tkun qed tiffranka l-impriża tal-art.

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

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

L-istruttura tal-impjiegi `workorder_execution`

Mill-pjanar ordni sal-preparazzjoni u l-manifattura tax-xogħol sal-adozzjoni.

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

Il-pjan ta' implimentazzjoni

Il-Kummissjoni għandha tikkunsidra li l-miżuri li ġejjin għandhom jiġu implimentati:

Aktionen: Iċċekkja r-riżervazzjoni tal-materjal

2. IN_PROGRESS

F'implimentazzjoni

impjegat jibda l-ipproċessar u jikkunsidra ż-żminijiet tax-xogħol.

Aktionen: Ħadd tal-ħin

3. QUALITY_CHECK

Kontroll tal-kwalità

L-eżami finali skont l-istandards tal-impriża jew il-kriterji tal-klijent.

Aktionen: Depożitu ta' protokoll ta' verifika

4. COMPLETED

Ftit

ordni imwaħħla, ir-rapport lura għal proġett u l-kontijiet.

Aktionen: Il-fatturazzjoni tiġi esklużi

L-ordni tal-utent: Aġent ta' xogħol addizzjonali `plan:command_extra_work_agent`

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

L-ordni tal-utent: Aġent ta' dokumentazzjoni tas-sit `plan:command_site_documentation_agent`

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

L-użu tal-informazzjoni `plan:command_time_capture_agent`

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

L-ordni għall-użu: aġent tax-xogħol bla taħriġ `plan:command_unbilled_work_agent`

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

L-ordni tal-utent: Aġent tat-tlestija tax-xogħol `plan:command_work_completion_agent`

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

L-użu ta' l-istruzzjonijiet: `plan:command_workorder_crud_subagent`

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

L-ordni tal-utent: ordni ġenerali ta' xogħol `plan:command_workorder_general_agent`

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

In-negozju konkluż `plan:unbilled_check`

Geprüfter Durable-Plan (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

In-numru ta' impjieg irrapportat bħala fermat `plan:work_completed`

Geprüfter Durable-Plan (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

ordni `status:work_order`

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

1. draft

l-abbozz

Statut <unk>abbozz <unk> tal-magna tal-istat ordni.

2. scheduled

skedati

Statut <unk>sjaġġut <unk> tal-magna tal-istat ordni.

3. active

attiv

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

4. waiting_customer

waiting_customer

Statut <unk>waiting_customer<unk> tal-magna tal-istat ordni.

5. waiting_vendor

waiting_vendor

Statut <unk>waiting_vendor<unk> tal-magna tal-istat ordni.

6. completed

kompluta

Stat <unk> komplet<unk> tal-magna tal-istat ordni.

7. approved

approvati

Statut <unk>approved<unk> tal-magna tal-istat ordni.

8. invoiced

fatturati

Statut <unk>invoikat<unk> tal-magna tal-istat ordni.

9. cancelled

ikkanċellati

Stat <unk>Cancelled<unk> tal-magna tal-istat ordni.

🗄️ Modelli tad-dejta & Felder

WorkLogs work_logs RLS Aktiv

16 Il-kamps / il-kolla

Tabelle work_logs

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

Tabelle work_orders

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

🔌 Punti ta' Bidu (UI & API)

Art	Il-metodu	Punti ta ' tmiem / pjaċċ	Titel & Zweck	L-eżenzjoni
⚡ 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`	l-persunal 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`	jiddeċiedi 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`	Il-lista tal-ordnijiet Lista ta' kuntratti kollha ta' ħanut tal-għamla u ta' montage	`workorders:read`
⚡ REST API	PATCH	`/api/v1/workorders/{id}/status`	Biddil il- stat Ikklikkja fuq Statut tal-Kenja	`workorders:write`

🛡️ Regolatorji u konformità

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

Arbeitszeitgesetz (ArbZG Dokumentationspflicht)
L-impjieg tal-ħaddiem

Moduli marbuta:

➔ finance ➔ projects ➔ fieldservice ➔ assembly