Koppeling
Linear en Plandeck
Plandeck synchroniseert een Linear-project alleen-lezen naar een planning. Het werk leeft in Linear; de planning erover heen, met afhankelijkheden, kritieke pad, bezetting en de doorrekening over meerdere teams, leeft in Plandeck. Elke wijziging in Linear komt als voorstel binnen dat de planner toepast of afwijst. Plandeck schrijft nooit terug naar Linear.
Waarvoor je hem gebruikt
- Een programma of PI-planning over meerdere Linear-teams heen doorrekenen, met de afhankelijkheden tussen de teams.
- Linear-werk naast niet-agile werk plannen: leveringen, vergunningen, opleverdatums en partijen die geen sprint kennen.
- Stakeholders laten meekijken en de voortgang bijhouden zonder dat iemand in Linear hoeft te werken.
Wat je nodig hebt
- Een Plandeck-organisatie waarin je eigenaar of planner bent. De koppeling is inbegrepen in het projectdagmodel, het planner-tarief en het Organisatie-abonnement.
- Een Linear-werkruimte met een persoonlijke API-sleutel met leesrechten.
- Optioneel: rechten om in Linear een webhook aan te maken, voor wijzigingen die direct binnenkomen.
Installatie in vier stappen
- 1
Maak een API-sleutel aan in Linear
Ga in Linear naar Settings → API en maak een Personal API key aan. Leesrechten volstaan: Plandeck schrijft nooit naar Linear. Bewaar de sleutel even; je plakt hem in de volgende stap in Plandeck.
- 2
Voeg de bron toe in Plandeck
Open in Plandeck Koppelingen → Linear (sync) en kies Bron toevoegen. Geef de bron een naam en plak de API-sleutel. Plandeck test de sleutel eerst en slaat hem daarna versleuteld op; je ziet hem alleen nog gemaskeerd. Direct na het opslaan toont Plandeck éénmalig een webhook-URL en een secret.
- 3
Maak de webhook aan in Linear
Ga in Linear naar Settings → API → Webhooks en maak een nieuwe webhook aan met de URL en het secret uit stap 2, voor de resource Issues. Vanaf dat moment komt elke statuswijziging in Linear als voorstel in Plandeck binnen. Zonder webhook werkt de koppeling ook: je haalt wijzigingen dan handmatig op.
- 4
Koppel een project
Open het Plandeck-project dat de planning over het Linear-werk heen wordt en kies in de werkbalk Importeren → Synchroniseren met Linear. Kies de bron en het Linear-project, stel de mapping in en bekijk het voorbeeld: per rij zie je wat er nieuw is en welke aannames zijn gedaan. Pas na bevestigen wordt er iets aangemaakt.
Bij elke volgende synchronisatie kies je opnieuw Synchroniseren met Linear; het voorbeeld toont dan per rij of hij nieuw, gewijzigd, ongewijzigd of niet meer in de bron is.
Wat er gesynchroniseerd wordt
| Linear | Plandeck | Toelichting |
|---|---|---|
| Issue | Taak | De titel wordt de taaknaam, desgewenst met de identifier ervoor (PLA-12 · …). |
| Issue met sub-issues | Groep | Eén niveau diep; de groep krijgt de looptijd van zijn taken. |
| Team | Waarde op de dimensie | Bij de projectinstelling Teams; anders een categorie. Per team hernoembaar of uit te sluiten. |
| Cycle | Periode op het raster | Bij een sprint-, iteratie- of cyclusraster; de eerste sync stelt het raster in op de cycles. |
| Estimate | Duur in werkdagen | Standaard één punt = één werkdag, instelbaar. Zonder estimate geldt een standaardduur, gemarkeerd in het voorbeeld. |
| Due date | Einddatum | De start volgt uit de duur. Zonder datum staat de taak aan het begin van zijn cycle of op de projectstart. |
| Blocked by | Afhankelijkheid | Einde-start, alleen tussen issues in hetzelfde project. |
| Project milestone | Mijlpaal | Alleen mijlpalen met een datum. |
| State | Voortgang | Done wordt 100%, gestart een instelbaar percentage. Plandeck verzint nooit een afrondingsmoment. |
Wijzigingen komen als voorstellen
Een wijziging in Linear past nooit stilzwijgend je planning aan. Via de webhook, of bij een volgende synchronisatie, verschijnt hij als item Externe bron in de review van het project, met een link naar het issue. De planner ziet vooraf het effect op einddatum, kosten en voortgang en kiest toepassen of afwijzen.
- Status gewijzigdvoorstel om de voortgang aan te passen
- Andere cyclevoorstel om de taak naar die periode te verplaatsen
- Andere estimatevoorstel om de duur aan te passen
- Issue verwijderdvoorstel om de taak te markeren als "niet meer in bron"
Bij een her-sync volgen naam, groep, team, categorie en afhankelijkheden de bron. Datums volgen de bron alleen zolang je ze in Plandeck niet zelf hebt verplaatst. Een issue dat uit Linear verdwijnt wordt niet verwijderd maar gemarkeerd; jij beslist wat ermee gebeurt.
Beveiliging en gegevens
- Alleen lezen: Plandeck doet geen enkele schrijvende aanroep naar Linear.
- De API-sleutel wordt versleuteld opgeslagen en alleen gemaskeerd getoond; verwijderen kan altijd. De taken blijven dan staan, met hun verwijzing naar het issue.
- Inkomende webhooks worden gecontroleerd op de handtekening van Linear; ongeldige leveringen worden geweigerd en gelogd. Elke levering wordt maximaal één keer verwerkt.
- Plandeck haalt titels, teams, cycles, estimates, datums, statussen en blokkeringen op; beschrijvingen en opmerkingen uit Linear worden niet opgehaald of opgeslagen.
- Hosting in de Europese Unie, onder de privacyverklaring van Plandeck.
Beperkingen
- Geen terugschrijven naar Linear; dat is een productkeuze, geen tijdelijke beperking.
- Aanmelden met een persoonlijke API-sleutel; OAuth volgt later.
- Sub-issues één niveau diep; assignees worden geen resources in Plandeck.
- Nieuwe issues komen binnen bij een volgende synchronisatie, niet via de webhook.
- Een voorstel wordt nooit automatisch toegepast; de planner beslist.
Hulp nodig?
De handleiding in Plandeck heeft een eigen hoofdstuk over de Linear-koppeling, en de handleiding-assistent beantwoordt vragen erover. Kom je er niet uit, stel je vraag dan via het contactformulier.