Centurio Dokumentazzjoni tas-sistema u tal-moduli
🏛️ Arkitettura tal-pjattaforma 🔑 Login
🏠 Il-Moduli kollha / manufacturing_execution / Servizz tal-Affarijiet Barranin
🚐

Servizz tal-Affarijiet Barranin

fieldservice manufacturing_execution 🛡️ RLS Protected

L-użu tal-apparat tal-istampar, il-bord ta' dispaċċ, ir-rapporti tal-ħidma mobbli b'dokumentazzjoni bil-fotosignatura u s-sinatura diġitali.

Fachliche Bestimmung: Id-diġitalizzazzjoni tas-servizz tal-klijenti mobbli. Id-disponenti jippjanaw l-appuntamenti fuq bord ta' dispatch viżwali. It-tekniki jaraw l-appuntamenti fuq smartphones/tablets, jikkaptaw il-ħin tax-xogħol u l-materjal użat, iddokumentaw id-dannu permezz ta' kamera u jħallu lill-klijent jiffirma direttament fuq l-iskrin tat-tand. Ir-rapport tas-servizz lest jiġi arkivat immedjatament bħala PDF.

⚡ 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

Servizz estern → Kontabilità cascade:business.work_report.billing

L-użu tal-enerġija

1. fieldservice
Implimentazzjoni tal-Artikolu 3 (2) (b)
servizz fil-qasam
Aktionen: create_service_report
2. task
It-trażmissjoni tal-kontijiet
l-impjiegi
Aktionen: create_task
3. ticket
Il-klijent għandu jkollu l-ebda kunsiderazzjoni tal-klijent.
biljetti
Aktionen: create_ticket

Servizz estern / rapport ta' servizz cascade_target:business.fieldservice.create

L-użu tal-enerġija

1. cascade
Servizz estern / rapport ta' servizz

Ordni għall-użu: aġent tas-servizz tas-sħab plan:command_field_service_agent

Geprüfter Durable-Plan (durable_plan), Start: manual_command.

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

Rapport tas-servizz status:service_report

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

1. draft
l-abbozz
Statut <unk>abbozz <unk> tal-istatus tas-sistema tas-servizz.
2. scheduled
skedati
Statut <unk>sjaġġut <unk> tal-istatus tal-magna b'servizz.
3. en_route
en_route
Statut <unk>en_route<unk> tal-istatus tal-magna tas-servizz.
4. on_site
on_site
Statut <unk>on_site<unk> tas-servizz tal-magna tal-istat.
5. in_progress
in_progress
Statut <unk>in_progress<unk> tal-istatus tal-magna tas-servizzbericht.
6. completed
kompluta
Statut <unk>completed<unk> tal-istatus tal-magna servicebericht.
7. cancelled
ikkanċellati
Statut <unk>annullat<unk> tal-istatus tal-magna

🗄️ Modelli tad-dejta & Felder

ServiceReport service_reports RLS Aktiv
7 Il-kamps / il-kolla

Rapporti diġitali tas-servizz b'ħinijiet ta' xogħol, implimentazzjoni tal-materjali u sinatura tal-klijent.

Feldname Tip ta' data Obbligu Schlüssel L-importanza professjonali
id UUID Nein PK Id ta' rapport
tenant_id UUID Nein - Id-dinjità tal-klijent (RLS)
report_number VARCHAR(100) Ja * - Numru tar-rapport
customer_id UUID Nein FK ➔ customers.id klijent
technician_id UUID Nein FK ➔ users.id Tekniki li jwettqu
customer_signature TEXT Nein - Tiskrizzjoni kkoda Base64
status VARCHAR(50) Nein - Stat (abbozz, faturat, fatturat)

🔌 Punti ta' Bidu (UI & API)

Art Il-metodu Punti ta ' tmiem / pjaċċ Titel & Zweck L-eżenzjoni
⚡ REST API DELETE /api/v1/field-service/reports/{report_id}/time-entries/{entry_id}
delete_time_entry
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API GET /api/v1/field-service/checklist-templates
list_checklist_templates
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /api/v1/field-service/checklist-templates/{template_id}
get_checklist_template
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /api/v1/field-service/dispatch
dispatch_board
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /api/v1/field-service/my-reports
list_my_reports
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /api/v1/field-service/reports
list_reports
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /api/v1/field-service/reports/{report_id}
get_report
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /api/v1/field-service/reports/{report_id}/materials
list_materials
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /api/v1/field-service/reports/{report_id}/pdf
download_pdf
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /api/v1/field-service/reports/{report_id}/photos
list_photos
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /api/v1/field-service/reports/{report_id}/time-entries
list_time_entries
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /api/v1/field-service/reports/{report_id}/timer
get_timer
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /api/v1/field-service/timesheet
timesheet_csv
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /api/v1/field-service/timesheet/pdf
timesheet_pdf
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /aussendienst
fieldservice_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /aussendienst/dispatch
fieldservice_dispatch_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /aussendienst/meine-einsaetze
fieldservice_meine_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /aussendienst/neu
fieldservice_new_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /aussendienst/new
fieldservice_new_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /aussendienst/verwaltung
fieldservice_management_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /aussendienst/{report_id}
fieldservice_detail_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /aussendienst/{report_id}/edit
fieldservice_detail_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /fieldservice
fieldservice_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /fieldservice/dispatch
fieldservice_dispatch_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /fieldservice/meine
fieldservice_meine_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /fieldservice/new
fieldservice_new_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /fieldservice/verwaltung
fieldservice_management_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /portal/{slug}/serviceberichte
service_reports_page
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API GET /portal/{slug}/serviceberichte/{report_id}/pdf
service_report_pdf_download
Semantic binding: inventory_only; mutation=False
fieldservice
⚡ REST API PATCH /api/v1/field-service/reports/{report_id}
update_report
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/checklist-templates
create_checklist_template
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports
create_report
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/assign
assign_technician
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/cancel
cancel_report
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/complete
complete_report
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/complete-validated
complete_report_validated
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/documents
upload_report_document
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/email-pdf
email_pdf
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/escalate-ticket
escalate_report_to_ticket
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/material-pick
prepare_material_pick
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/materials
add_material
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/photos
upload_photo
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/signature
add_signature
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/status
update_status
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/status-validated
update_status_validated
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/time-entries
add_time_entry
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/timer/discard
discard_timer
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/timer/start
start_timer
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/field-service/reports/{report_id}/timer/stop
stop_timer
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API PUT /api/v1/field-service/reports/{report_id}/acceptance
update_acceptance
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API PUT /api/v1/field-service/reports/{report_id}/checklist
update_checklist
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API PUT /api/v1/field-service/reports/{report_id}/summary
update_summary
Semantic binding: operator_surface; mutation=True
fieldservice
⚡ REST API POST /api/v1/fieldservice/reports
Żomm ir-rapport
Storja tas-servizz b'data u sinjali
fieldservice:write

🛡️ Regolatorji u konformità

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

  • Reviżjoni tal-GBDArkivament ta' dokumenti sigura
  • BGB Kontrazzjonijiet ta' xogħol (§640)
Moduli marbuta:
➔ workorders ➔ customers ➔ calendar ➔ finance