Documentația sistemului

🔍

🏛️ Arhitectura de platformă 🔑 Login

🧰

Comisioane de lucru & Werkstatt

workorders manufacturing_execution 🛡️ RLS Protected

Ofertele de producție și de lucru, etapele de lucru, determinarea necesităților de materiale (BOM) și înregistrarea timpului.

Fachliche Bestimmung: Coordonarea execuției fizice în un atelier de producție și construcție. Se generează automat din ofertă în cazul acceptării ofertelor. Previzi posițiile de comandă și nevoile de liste de bucăți (în care tranzacțiile de pe linie sunt excluse în mod explicit de nevoile interne de materiale). Permite înregistrarea temporală, progresul în stadiu și transferul la facturare.

⚡ Fluxuri de lucru (11) 🗄️ Modele de date & câmpuri (2) 🔌 Puncte de inițiere (UI & API) (54) 🛡️ Reglementări și respectare

⚡ Fluxuri de lucru

Încadrarea în funcționare a contractelor `workorder_execution`

De la planificarea de pregătire şi fabricare până la acceptare.

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

Planul de înființare

comandă este disponibil, resursele şi termenele sunt disponibile.

Aktionen: Verificarea rezervelor de materiale

2. IN_PROGRESS

În executare

angajat începe prelucrarea și înregistrează orele de lucru.

Aktionen: Înregistrarea timpului

3. QUALITY_CHECK

Controlul calității

Examinarea finală conform normelor de producție sau criteriilor clienților.

Aktionen: Depozitează protocoloul de verificare

4. COMPLETED

Încheiat

În cazul în care se aplică dispozițiile prevăzute la articolul 1 alineatul (1) litera (a) din Regulamentul (CE) nr.

Aktionen: Închiderea facturării

Ordonanța de utilizare: agent de lucru suplimentar `plan:command_extra_work_agent`

Plan durabil verificat (durable_plan), inițiativă: 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

Ordonanța de utilizare: agent de documentare a site-ului `plan:command_site_documentation_agent`

Plan durabil verificat (durable_plan), inițiativă: 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

Ordonanța de utilizare: agent de captare a timpului `plan:command_time_capture_agent`

Plan durabil verificat (durable_plan), inițiativă: 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

Ordonanța de utilizare: agent de muncă necalificat `plan:command_unbilled_work_agent`

Plan durabil verificat (durable_plan), inițiativă: 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

Instrucțiune de utilizare: agent de finalizare a lucrărilor `plan:command_work_completion_agent`

Plan durabil verificat (durable_plan), inițiativă: 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

Instrucțiune de utilizare: ordin de lucru `plan:command_workorder_crud_subagent`

Plan durabil verificat (durable_plan), inițiativă: 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

Ordonanța de utilizare: ordin general de lucru `plan:command_workorder_general_agent`

Plan durabil verificat (durable_plan), inițiativă: 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

Încheierea unei misiuni `plan:unbilled_check`

Plan durabil verificat (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

O comisioane de lucru declarată în stare de execuție `plan:work_completed`

Plan durabil verificat (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

În cazul în care: `status:work_order`

În cazul în care se aplică o metodă de verificare a situaţiei, se poate observa o metodă de verificare a situaţiei.

1. draft

proiect

Statutul <unk>proiectului <unk> de mașină de stare <unk>GT14_0__.

2. scheduled

programat

Statutul <unk>schemă <unk> mașinii de stare GT14_0__.

3. active

activ

Statutul <unk>active<unk> al mașinii de stare comandă.

4. waiting_customer

waiting_customer

Statutul <unk>waiting_customer<unk> al mașinii de stare comandă.

5. waiting_vendor

waiting_vendor

Statutul <unk>waiting_vendor<unk> al mașinii de stare comandă.

6. completed

completate

Statutul <unk>complet<unk> al mașinii de stare comandă.

7. approved

aprobate

Statutul <unk>aprobat<unk> al mașinii de stare <unk>GT14_0__.

8. invoiced

facturat

Statutul <unk>invoicat<unk> al mașinii de stare comandă.

9. cancelled

anulate

Statutul <unk>cancelat<unk> al mașinii de stare GT14_0__.

🗄️ Modele de date & câmpuri

WorkLogs work_logs RLS Aktiv

16 Câmpuri / coloane

Tabelle work_logs

Feldname	Tip de date	Obligatoriu	Schlüssel	Importanța profesională
`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 Câmpuri / coloane

Tabelle work_orders

Feldname	Tip de date	Obligatoriu	Schlüssel	Importanța profesională
`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

🔌 Puncte de inițiere (UI & API)

Art	Metoda	Punctul de încheiere / traseul	Titel & Zweck	Asigurarea
⚡ 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`	personal 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`	decide 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`	Oamenilor de afaceri Lista tuturor comenzilor de muncitori și de montaj	`workorders:read`
⚡ REST API	PATCH	`/api/v1/workorders/{id}/status`	Modificarea statutului Continuă să schimbi statutul de comandă	`workorders:write`

🛡️ Reglementări și respectare

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

Legea privind timpul de muncă (obligatie de documentare)
Învățământul de învățământ superior

Module legate:

➔ finance ➔ projects ➔ fieldservice ➔ assembly