Centurio System- & Moduldokumentation (CH)
🏛️ Plattform-Architektur 🔑 Login
🏠 Alli Modul / manufacturing_execution / Projekte & Baustellen
📘

Projekte & Baustellen

projects manufacturing_execution 🛡️ RLS Protected

Projekte & Baustellen — aus Code abgeleitete Prozess- und API-Dokumentation.

Fachliche Bestimmung: Projekte & Baustellen — aus Code abgeleitete Prozess- und API-Dokumentation. Erfasst alle registrierten Prozesse, Capabilities, Zustandsmaschinen, APIs und Tabellen für Simulationen und Reviews.

⚡ Workflows & Läbenszykle

Kundenauftrag → Warenausgang cascade:business.customer_order.fulfill

Kaskade (review_gated).

1. issue
Warenausgang als Entwurf buchen
inventory
Aktionen: stock.issue.create
2. tour
Auslieferungstour einplanen
logistics
Aktionen: create_tour
3. project
Projekt / Kostenstelle zuordnen
projects
Aktionen: link_project
4. task
Auftrag ausführen / abrechnen
tasks
Aktionen: create_task

Auftragsbestätigung prüfen cascade:business.order_confirmation.check

Kaskade (review_gated).

1. match
AB ↔ Bestellung abgleichen
purchasing
Aktionen: order_confirmation.match
2. project
Projekt / Kostenstelle zuordnen
projects
Aktionen: link_project
3. task
Liefertermin / Preise überwachen
tasks
Aktionen: create_task

Eingangsrechnung → Abrechnung cascade:business.supplier_invoice.p2p

Kaskade (review_gated).

1. booking
Buchungssatz erstellen
accounting
Aktionen: accounting.entry
2. project
Projektkosten verbuchen
projects
Aktionen: link_project
3. task
Frist / Skonto überwachen
tasks
Aktionen: create_task

Projekt / Kostenstelle zuordnen cascade_target:business.project.link

Kaskade (review_gated).

1. cascade
Projekt / Kostenstelle zuordnen

Benutzerbefehl: project crud subagent plan:command_project_crud_subagent

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

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

Projekt status:project

Beobachtbare Zustandsmaschine (observable_only). Übergänge hier nicht erzwungen — siehe Service-Validierung.

1. draft
draft
Status «draft» der Zustandsmaschine Projekt.
2. active
active
Status «active» der Zustandsmaschine Projekt.
3. on_hold
on_hold
Status «on_hold» der Zustandsmaschine Projekt.
4. completed
completed
Status «completed» der Zustandsmaschine Projekt.
5. cancelled
cancelled
Status «cancelled» der Zustandsmaschine Projekt.
6. archived
archived
Status «archived» der Zustandsmaschine Projekt.

🗄️ Datemodell & Fälder

ProjectMeasurementLines project_measurement_lines RLS Aktiv
15 Fälder / Spalte

Tabelle project_measurement_lines

Feldname Datetyp Pflicht Schlüssel Fachlichi Bedütig
measurement_id UUID Ja * FK ➔ project_measurements.id Feld measurement_id
quote_item_id UUID Nein FK ➔ quote_items.id Feld quote_item_id
pos_number VARCHAR(32) Ja * - Feld pos_number
description VARCHAR(255) Ja * - Feld description
formula VARCHAR(255) Nein - Feld formula
quantity_period NUMERIC(12, 3) Ja * - Feld quantity_period
quantity_cumulative NUMERIC(12, 3) Ja * - Feld quantity_cumulative
unit VARCHAR(16) Ja * - Feld unit
unit_price NUMERIC(14, 2) Ja * - Feld unit_price
total_net_cumulative NUMERIC(14, 2) Ja * - Feld total_net_cumulative
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
ProjectMeasurements project_measurements RLS Aktiv
17 Fälder / Spalte

Tabelle project_measurements

Feldname Datetyp Pflicht Schlüssel Fachlichi Bedütig
project_id UUID Ja * FK ➔ projects.id Feld project_id
quote_id UUID Nein FK ➔ quotes.id Feld quote_id
measurement_number VARCHAR(64) Ja * - Feld measurement_number
measurement_date DATE Ja * - Feld measurement_date
status VARCHAR(48) Ja * - Feld status
approved_by VARCHAR(255) Nein - Feld approved_by
approved_at DATETIME Nein - Feld approved_at
notes TEXT Nein - Feld notes
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
ProjectMilestones project_milestones RLS Aktiv
18 Fälder / Spalte

Tabelle project_milestones

Feldname Datetyp Pflicht Schlüssel Fachlichi Bedütig
project_id UUID Ja * FK ➔ projects.id Feld project_id
name VARCHAR(255) Ja * - Feld name
due_date DATE Nein - Feld due_date
sort INTEGER Ja * - Feld sort
status VARCHAR(16) Ja * - Feld status
reached_at DATETIME Nein - Feld reached_at
reached_by UUID Nein - Feld reached_by
predecessor_id UUID Nein FK ➔ project_milestones.id Feld predecessor_id
notes TEXT Nein - Feld notes
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
ProjectRateCards project_rate_cards RLS Aktiv
16 Fälder / Spalte

Tabelle project_rate_cards

Feldname Datetyp Pflicht Schlüssel Fachlichi Bedütig
project_id UUID Nein FK ➔ projects.id Feld project_id
customer_id UUID Nein FK ➔ customers.id Feld customer_id
role_name VARCHAR(64) Ja * - Feld role_name
hourly_rate NUMERIC(14, 2) Ja * - Feld hourly_rate
currency VARCHAR(3) Ja * - Feld currency
valid_from DATE Nein - Feld valid_from
valid_until DATE Nein - Feld valid_until
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
ProjectTimeEntries project_time_entries RLS Aktiv
24 Fälder / Spalte

Tabelle project_time_entries

Feldname Datetyp Pflicht Schlüssel Fachlichi Bedütig
project_id UUID Ja * FK ➔ projects.id Feld project_id
user_id UUID Ja * FK ➔ users.id Feld user_id
ticket_id UUID Nein FK ➔ tickets.id Feld ticket_id
invoice_id UUID Nein FK ➔ invoices.id Feld invoice_id
entry_date DATE Ja * - Feld entry_date
duration_minutes INTEGER Ja * - Feld duration_minutes
rounded_minutes INTEGER Ja * - Feld rounded_minutes
activity_description TEXT Ja * - Feld activity_description
internal_notes TEXT Nein - Feld internal_notes
is_billable BOOLEAN Ja * - Feld is_billable
hourly_rate NUMERIC(14, 2) Ja * - Feld hourly_rate
total_amount_net NUMERIC(14, 2) Ja * - Feld total_amount_net
billing_status VARCHAR(48) Ja * - Feld billing_status
approved_by UUID Nein FK ➔ users.id Feld approved_by
approved_at DATETIME Nein - Feld approved_at
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
Projects projects RLS Aktiv
41 Fälder / Spalte

Tabelle projects

Feldname Datetyp Pflicht Schlüssel Fachlichi Bedütig
project_number VARCHAR(32) Ja * - Feld project_number
name VARCHAR(255) Ja * - Feld name
contract_id UUID Nein - Feld contract_id
parent_id UUID Nein FK ➔ projects.id Feld parent_id
customer_id UUID Nein FK ➔ customers.id Feld customer_id
supplier_id UUID Nein FK ➔ suppliers.id Feld supplier_id
partner_type VARCHAR(32) Ja * - Feld partner_type
status VARCHAR(48) Ja * - Feld status
description TEXT Nein - Feld description
street VARCHAR(255) Nein - Feld street
postal_code VARCHAR(16) Nein - Feld postal_code
city VARCHAR(128) Nein - Feld city
country_code VARCHAR(2) Nein - Feld country_code
latitude NUMERIC(9, 6) Nein - Feld latitude
longitude NUMERIC(9, 6) Nein - Feld longitude
trade VARCHAR(64) Nein - Feld trade
manager_user_id UUID Nein FK ➔ users.id Feld manager_user_id
site_contact_name VARCHAR(255) Nein - Feld site_contact_name
site_contact_phone VARCHAR(64) Nein - Feld site_contact_phone
access_notes TEXT Nein - Feld access_notes
planned_start DATE Nein - Feld planned_start
planned_end DATE Nein - Feld planned_end
actual_start DATE Nein - Feld actual_start
actual_end DATE Nein - Feld actual_end
quoted_value NUMERIC(14, 2) Nein - Feld quoted_value
estimated_cost NUMERIC(14, 2) Nein - Feld estimated_cost
estimated_hours NUMERIC(14, 4) Nein - Feld estimated_hours
estimated_labor_cost NUMERIC(14, 2) Nein - Feld estimated_labor_cost
estimated_material_cost NUMERIC(14, 2) Nein - Feld estimated_material_cost
currency VARCHAR(3) Ja * - Feld currency
tags ARRAY Ja * - Feld tags
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
deleted_at DATETIME Nein - Feld deleted_at

🔌 Iistigspünkt (UI & APIs)

Art Method Endpunkt / Pfad Titel & Zweck Berächtigig
⚡ REST API DELETE /api/v1/projects/{project_id}
delete_project
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API GET /api/v1/projects
list_projects
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /api/v1/projects/{project_id}
get_project
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /api/v1/projects/{project_id}/budget-status
get_budget_status
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /api/v1/projects/{project_id}/measurements
list_measurements
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /api/v1/projects/{project_id}/measurements/{measurement_id}
get_measurement
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /api/v1/projects/{project_id}/milestones
list_milestones
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /api/v1/projects/{project_id}/rate-cards
list_rate_cards
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /api/v1/projects/{project_id}/subprojects
list_subprojects
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /api/v1/projects/{project_id}/summary
get_project_summary
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /api/v1/projects/{project_id}/time-entries
list_time_entries
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /api/v1/projects/{project_id}/workorders
list_project_workorders
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /portal/{slug}/projekte
projects_page
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /projects
projects_page
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /projects/new
project_create_page
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /projects/{project_id}
project_detail_page
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API GET /projects/{project_id}/edit
project_detail_page
Semantic binding: inventory_only; mutation=False
projects
⚡ REST API PATCH /api/v1/projects/{project_id}
update_project
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects
create_project
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/materials
book_project_material
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/measurements
create_measurement
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/measurements/{measurement_id}/approve
approve_measurement
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/measurements/{measurement_id}/create-cumulative-invoice
create_cumulative_invoice
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/measurements/{measurement_id}/create-final-invoice
create_vob_final_invoice
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/measurements/{measurement_id}/lines
add_measurement_lines
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/milestones
add_milestone
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/milestones/{milestone_id}/reach
reach_milestone
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/milestones/{milestone_id}/unreach
unreach_milestone
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/rate-cards
create_rate_card
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/subprojects
create_subproject
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/time-entries
log_time
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/time-entries/approve
approve_time_entries
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/time-entries/invoice
generate_tm_invoice
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/worklogs
record_project_worklog
Semantic binding: operator_surface; mutation=True
projects
⚡ REST API POST /api/v1/projects/{project_id}/workorders
create_project_workorder
Semantic binding: operator_surface; mutation=True
projects

🛡️ Regulatorie & Compliance

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

  • GoBD Nachvollziehbarkeit
  • Mandanten-Isolation (PostgreSQL RLS)