Centurio System- & moduladokumentation
🏛️ Plattformarkitektur 🔑 Login
🏠 Alle moduler / manufacturing_execution / Udlands- og kundeservice
🚐

Udlands- og kundeservice

fieldservice manufacturing_execution 🛡️ RLS Protected

Tekniske anlægsplanlægning, dispatchbord, mobile arbejdsrapporter med foto- og digital underskrift.

Fachliche Bestimmung: Digitaliserer den mobile kundeservice. Disponenter planlægger aftaler på en visuel dispatchboard. Teknikere ser opgaver på smartphones/tabletter, optager arbejdstid og forbrugt materiale, dokumenterer skader via kamera og lader kunden underskrive direkte på touchscreen. Den færdige servicerapport arkiveres straks som PDF.

⚡ Arbejdsflow & livscyklusser

vedligeholdelse / Reparation cascade:business.maintenance.cycle

Kaskade (review_gated).

1. fieldservice
Udgifter til udenrigsarbejde / indhentning af rapport
Feltetjeneste
Aktionen: create_service_report
2. followup
Planlægning af vedligeholdelsesresultater
Aktiver
Aktionen: vedligeholdelse
3. ticket
Billet i tilfælde af mangler/forstyrrelser
Billetter
Aktionen: create_ticket

Udlandsdækning → Indregning cascade:business.work_report.billing

Kaskade (review_gated).

1. fieldservice
Udøvelse af tjenesteydelsen
Feltetjeneste
Aktionen: create_service_report
2. task
Indregning efterfølgning
Arbejdstiltag
Aktionen: create_task
3. ticket
Billet i tilfælde af mangler/forstyrrelser
Billetter
Aktionen: create_ticket

Udlandsarbejde / servicebericht cascade_target:business.fieldservice.create

Kaskade (review_gated).

1. cascade
Udlandsarbejde / servicebericht

Anvendelsesbevis: agenter for fældearbejde plan:command_field_service_agent

Kontrolleret 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

Tjenesteberetning status:service_report

Det er ikke nødvendigt at foretage overførsler her.

1. draft
Udkast til
Status <unk>udkast <unk> til servicebericht.
2. scheduled
planlægning
Status <unk>planlagt <unk> af standemaskinen servicebericht.
3. en_route
en_route
Status <unk>en_route<unk> af den statistiske maskine servicebericht.
4. on_site
on_site
Status <unk>on_site<unk> af den statistiske maskine servicebericht.
5. in_progress
in_progress
Status i_progress i_statemaskinens servicebericht.
6. completed
udført
Status <unk> færdig <unk> af standemaskine servicebericht.
7. cancelled
aflyst
Status af serviceberichtet

🗄️ Datamodeller & felt

ServiceReport service_reports RLS Aktiv
7 Feltet / Columner

Digitale servicerapporter med arbejdstimer, materialeindsats og kundesundtægter.

Feldname Data-type Det er en pligt Schlüssel Faglige betydning
id UUID Nein PK Rapportering
tenant_id UUID Nein - Kunder-ID (RLS)
report_number VARCHAR(100) Ja * - Rapportnummer
customer_id UUID Nein FK ➔ customers.id - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
technician_id UUID Nein FK ➔ users.id Udførende teknikere
customer_signature TEXT Nein - Underskrift med base64-kodering
status VARCHAR(50) Nein - Status (udkast, undertegnet, faktureret)

🔌 Startpunkter (UI'er og API'er)

Art Metode Endpunkt / vej Titel & Zweck Tilladelse
⚡ 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
Opbevarelse
Storage servicebericht samt tidspunkter og underskrift
fieldservice:write

🛡️ Reglering og overholdelse

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

  • GABD Revisioner sikre arkivering af dokumenter
  • BGB Arbejdstilladelse (§640)
Knytte moduler:
➔ workorders ➔ customers ➔ calendar ➔ finance