Projecten

Bouw een project vanuit een offerte, lees de status, vink checks af en leg kosten en meerwerk vast.

Technische naslag per actie. Voor gewoon gebruik heb je dit niet nodig. Begin bij Wat kan Claude in Ops Grid?.

Een project is eenmalig werk met een deadline. Het bestaat uit geordende fasen met elk één verantwoordelijke lead, en geordende checks met elk precies één eigenaar. De status wordt nooit ingetypt. De server berekent de kleur uit de deadlines: groen "Op schema", oranje "Let op" (80% van de deadlinetijd is verstreken) en rood "Achter" (de deadline is verstreken). Projecten zijn lijsten, geen canvas, dus er komt geen layout aan te pas.

ops_grid_list_projects

Geen parameters. Geeft per actief project terug: eigenaar, statuskleur, de volgende open check met eigenaar en vervaldatum, werkelijk vs. effectief budget en openstaand meerwerk. Daarnaast het aantal open checks per persoon deze week. Roep dit eerst aan, zodat je geen dubbel project maakt.

ops_grid_get_project

project_idstring (uuid)verplicht

Het project.

Geeft de kop, statuskleur met tempo, alle fasen met lead en checks (eigenaar, deadline, due_at, lopende timer, kleur) en de recente historie. Neem kleuren en vervaldata over zoals ze terugkomen. Budget en contactgegevens van de klant ziet alleen een beheerder van de werkruimte.

ops_grid_create_project

namestringverplicht

Projectnaam.

client_referencestringverplicht

Idempotentiesleutel; gebruik het offertenummer.

owner_emailstringverplicht

Eigenaar (lid van de werkruimte).

customerobject

{ name?, address?, email? }.

starts_ondate

YYYY-MM-DD.

deadline_atdatetime

ISO 8601 met offset.

budget_amountnumber

Basisbudget, zonder meerwerk.

phasesarrayverplicht

Elke fase is { name, lead_email, starts_on?, ends_on?, definition_of_done?, checks: [...] }. Een check is { title, owner_email?, deadline?, notes?, sop_title?, visible_to_customer? }. Zonder owner_email is de lead van de fase de eigenaar.

Deadlines per check

none: geen deadline.
hard met at: een vast moment.
relative met amount en unit (hours, calendar_days of working_days): telt vanaf het moment dat de vorige check is afgevinkt. Werkdagen zijn ma–vr (Europe/Amsterdam).

Hetzelfde client_reference nog eens sturen geeft hetzelfde project_id terug met duplicate: true.

Een onbekend e-mailadres bij een eigenaar of lead geeft 422, en er wordt niets aangemaakt.
Een onbekende sop_title geeft alleen een waarschuwing: de check wordt aangemaakt zonder gekoppelde SOP.

Het volledige voorbeeld staat op de Engelse pagina.

ops_grid_create_project_from_template

Neemt template_project_id of template_name, plus name, owner_email, starts_on en client_reference. Fasen, checks, eigenaren en deadlines worden gekopieerd. Afvinkingen, kosten, meerwerk en klantgegevens nooit. Harde deadlines schuiven evenveel dagen op als de startdatum; relatieve blijven hetzelfde.

ops_grid_complete_check

check_id uit ops_grid_get_project. Vinkt de check af als de ingelogde gebruiker, met een tijdstip van de server en completed_via = mcp. Alleen de eigenaar van de check of een beheerder van de werkruimte mag dit. Vraag bevestiging voordat je voor iemand anders afvinkt.

ops_grid_add_cost_line

Kostenregel op een project: project_id, description, planned_amount en/of actual_amount, optioneel check_id en incurred_on.

ops_grid_create_change_order

Meerwerk op een project: project_id, title, amount (incl. btw), optioneel description en extra_days, en status draft (standaard) of sent (de klant ziet het en kan akkoord geven). Alleen goedgekeurd meerwerk verhoogt het effectieve budget.