Centurio System- og moduldokumentasjon
🏛️ Plattformarkittektur 🔑 Login
🏠 Alle moduler / manufacturing_execution / Utlands- og kundeservice
🚐

Utlands- og kundeservice

fieldservice manufacturing_execution 🛡️ RLS Protected

Teknisk bruksplanlegging, dispatchboard, mobile arbeidsrapporter med fotodokumentasjon og digital signatur.

Fachliche Bestimmung: Digitaliserer mobil kundeservice. Disponenter planlegger datoer på en visuell dispatchboard. Teknikere ser oppgaver på smartphones/tabletter, oppdager arbeidstid og brukt materiale, dokumenterer skader via kamera og la kunden signere direkte på berøringsskjermen. Den ferdige servicerapporten arkiveres umiddelbart som PDF.

⚡ Arbeidsstrømme og livssykluser

vedlikehold / Reparasjon cascade:business.maintenance.cycle

Kaskade (review_gated).

1. fieldservice
Utøvelse av utlandsarbeid / rapportering
felttjeneste
Aktionen: create_service_report
2. followup
Planlegging av vedlikehold
eiendeler
Aktionen: vedlikehold
3. ticket
Billet i mangel/forstyrrelse
Billetter
Aktionen: create_ticket

Utvendig tjeneste → avregning cascade:business.work_report.billing

Kaskade (review_gated).

1. fieldservice
Utøvelse av tjenesteytring / tjenesterapport
felttjeneste
Aktionen: create_service_report
2. task
Utregning etterfølgelse
oppgaver
Aktionen: create_task
3. ticket
Billet i mangel/forstyrrelse
Billetter
Aktionen: create_ticket

Utlands tjeneste / servicebericht cascade_target:business.fieldservice.create

Kaskade (review_gated).

1. cascade
Utlands tjeneste / servicebericht

Brukeroppgave: Field Service Agent plan:command_field_service_agent

Kontrollert varig 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

Tilsyn status:service_report

Observativ tilstand (observativ_only).

1. draft
utkast
Status <unk>utkast <unk> av standmaskinen servicebericht.
2. scheduled
planlagte
Status <unk>planlagt <unk> av standmaskinen servicebericht.
3. en_route
en_route
Status <unk>en_route<unk> av statusmaskinen servicebericht.
4. on_site
on_site
Status på stedet av statusmaskin servicebericht.
5. in_progress
in_progress
Status i_progress i_statusmaskin servicebericht.
6. completed
fullført
Status <unk> fullført <unk> av standemaskinen servicebericht.
7. cancelled
avlyst
Status <unk>annulert<unk> av standasjin servicebericht.

🗄️ Datamodeller & felt

ServiceReport service_reports RLS Aktiv
7 Feltet / kolonne

Digitale tjenesterapporter med arbeidstid, bruk av materialer og kundens underskrift.

Feldname Data-type Tiltak Schlüssel Spesialdekst
id UUID Nein PK Rapport-ID
tenant_id UUID Nein - Klant-ID (RLS)
report_number VARCHAR(100) Ja * - Rapportnummer
customer_id UUID Nein FK ➔ customers.id -
technician_id UUID Nein FK ➔ users.id Utførende teknikere
customer_signature TEXT Nein - Underskrift med base64-kodering
status VARCHAR(50) Nein - Status (utkast, signert, fakturert)

🔌 Startpunkter (UI og API)

Art Metode Endpunkt / vei Titel & Zweck Tillatelse
⚡ 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
Lagre rapport
Lagre servicebericht samt tidspunkter og underskrift
fieldservice:write

🛡️ Reglering og etterlevelse

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

  • GBS-revisjoner
  • BGB Arbeidstillatelse (§640)
Kopplede moduler:
➔ workorders ➔ customers ➔ calendar ➔ finance