De twee varianten
| Tier 1, de lichte variant | Tier 2, de uitgebreide variant |
|---|
| Wat | één app bij Cloudflare met eigen servercode, database en bestandsopslag | Cloudflare voor de app en de inlog, Supabase voor de database |
| Voor | lichte apps, websites, experimenteren | veel gegevens, rechten per gebruiker tot op de regel, koppelingen met andere systemen |
Begrippen
| Begrip | In gewone taal |
|---|
| GitHub | waar de code van elke app staat, met alle eerdere versies; ook de plek van de controles en de beheer-repo |
| Repo | een map op GitHub met code: één per app, plus de beheer-repo |
| Beheer-repo | de repo die voor elke nieuwe app hosting, inlog en database klaarzet en vastlegt wie bij welke app mag; jullie bouwers regelen daar zelf wie bij welke app mag |
| Beheerserver | optioneel: een server met Claude Code, ingelogd op de accounts van jullie bedrijf, om na de overdracht zelf de inrichting aan te passen; hij staat op een account van jullie, Stage Two richt hem in, alleen jullie owner kan erbij, en de kosten bij de hostingpartij zijn voor jullie rekening |
| Overdracht | het einde van het project, hetzelfde moment als de oplevering: daarna beheren jullie de omgeving zelf en kan het abonnement ingaan |
| Template | het startpunt voor elke nieuwe app, met de controles en afspraken erin |
| Plugin | de uitbreiding voor Claude Code met de vaste werkwijze van Stage Two: het gereedschap op de laptop |
| Pull request | een voorstel tot wijziging: daar draaien de controles en staat de proefversie, en met één knop gaat het live |
| GitHub App | een koppeling op GitHub met beperkte rechten; hij staat in jullie organisatie en jullie kunnen hem altijd zelf verwijderen; stopt het abonnement, dan haalt Stage Two hem zelf weg |
| Dependabot | de dienst van GitHub die in elke app updates van de npm-pakketten voorstelt, als pull request |
| npm-pakketten | de software-onderdelen van anderen waar een app op draait |
| SLA | een afspraak over beschikbaarheid en reactietijden; die biedt Stage Two niet |
| MIT | een open licentie, waaronder eerdere versies van template en plugin zijn uitgebracht; die blijven MIT |
Hoe een nieuwe versie binnenkomt
De GitHub-organisatie van jullie bedrijf heeft een openbare kopie van plugin en template, zodat de laptops van de bouwers ze zonder extra inlog ophalen. Zolang het abonnement loopt:
- past Stage Two een nieuwe versie eerst toe op de eigen apps van Stage Two;
- zet Stage Two die in de twee kopieën, via de GitHub App
stagetwo-levering. Die heeft alleen schrijfrecht op die twee kopieën en niet op jullie apps. De app staat in jullie organisatie; Stage Two installeert hem bij de start namens jullie, op alleen de twee kopieën, en jullie kunnen hem altijd zelf verwijderen. Stopt het abonnement, dan haalt Stage Two hem zelf weg; - werkt de plugin op de laptops van de bouwers zichzelf bij uit die kopie. Dat is het gereedschap; de apps veranderen daardoor niet. De plugin is wel software van Stage Two die met de rechten van de bouwer draait: wie het account van Stage Two of de sleutel van de GitHub App in handen krijgt, zou zo code op die laptops kunnen laten draaien. Stage Two beveiligt zijn account met tweestapsverificatie, bewaart de sleutel afgeschermd en levert alleen versies die Stage Two eerst op de eigen apps heeft toegepast. Wie dat risico niet wil, zet het automatisch bijwerken uit en werkt de plugin zelf bij; Stage Two legt uit hoe;
- meldt Claude Code bij het openen van een app dat er een nieuwe versie is. Met
/stagetwo-tier1:updaten of /stagetwo-tier2:updaten zet de plugin per app een pull request klaar, langs dezelfde controles. Een bouwer keurt het goed als de controles groen zijn, of laat het liggen.
De beheer-repo krijgt alleen een nieuwe versie als dat nodig is, op verzoek: de owner van jullie GitHub-organisatie geeft Stage Two daarvoor, alleen op de beheer-repo en niet op de apps, tijdelijk toegang en haalt die daarna weer weg. Dat valt binnen het abonnement. Verder heeft Stage Two na de overdracht geen persoonlijk account en geen beheerrechten in jullie GitHub-organisatie of bij de platforms, tenzij jullie dat willen; die toegang kunnen jullie altijd zelf intrekken.
Los daarvan stelt Dependabot in elke app updates van de npm-pakketten voor, de software-onderdelen waar de app op draait, ook zonder abonnement. De versies van de GitHub-workflows, de controles zelf, komen met een nieuwe versie van de template; alleen een beveiligingsupdate kan Dependabot tussendoor voorstellen. Wie opzegt, gaat van de lijst voor nieuwe versies; de kopieën blijven op de laatste versie staan.
Een nieuwe app starten
Een bouwer typt in Claude Code /stagetwo-tier1:nieuwe-app of /stagetwo-tier2:nieuwe-app. De beheer-repo zet daarna hosting, inlog en database voor die app klaar.
Waar het in de voorwaarden staat
| Afspraak | Algemene voorwaarden |
|---|
| Bedrag en ingangsdatum van het abonnement staan in de offerte, en die gaat voor | artikel 2.6 |
| Bij begeleiding bouwen jullie zelf | artikel 4.11 |
| Geen aansprakelijkheid voor wat met AI wordt gebouwd; zelf testen | artikel 5 |
| Geen garantie op beschikbaarheid, foutmeldingen zonder toezegging | artikelen 7.1 en 7.2 |
| Back-ups maken en testen jullie zelf | artikel 8.7 |
| Accounts op naam van jullie bedrijf, beheer door Stage Two tijdens het project; een dienst die Stage Two tijdelijk zelf afneemt, staat in de offerte | artikel 9.2 |
| Wat voor jullie is gemaakt gaat na betaling over; gebruiksrecht op de werkwijze | artikelen 13.1 en 13.2 |
| Alleen directe schade, en het maximum | artikelen 16.1 en 16.2 |
| Opzeggen met een opzegtermijn van één kalendermaand | artikel 18.3 |
| Bij de overdracht haalt Stage Two zijn toegang weg, tenzij jullie schriftelijk vragen die te laten bestaan | artikelen 18.6 en 21.3 |
| Na de overdracht liggen beheer en werking bij jullie | artikel 18.7 |
| Het abonnement: wat het levert en wat niet, zonder dat Stage Two toegang tot jullie apps nodig heeft, en wat na opzeggen blijft | artikel 21 |