Een praktische, stap-voor-stap handleiding voor het dagelijks gebruik van East Agile Tracker. Dit is de gebruikershandleiding; voor de conceptuele achtergrond zie Agile-ontwikkeling en Extreme Programming.
Account
Section titled “Account”Aanmelden en inloggen
Section titled “Aanmelden en inloggen”Open de app en je komt op de marketingpagina terecht. Kies Sign up om een account aan te maken, of Sign in als je er al een hebt.
- Sign up vraagt om je naam, e-mailadres, initialen en een wachtwoord. Je initialen vormen de basis van je avatar totdat je een afbeelding uploadt.
- Sign in vraagt om het e-mailadres en wachtwoord waarmee je je hebt geregistreerd. Een succesvolle aanmelding brengt je naar je projectlijst.
- Als je je wachtwoord vergeet, gebruik dan Forgot password op het inlogscherm. Je ontvangt een e-mail met een reset-link; de link is eenmalig te gebruiken en verloopt na één uur.
Sessies worden bijgehouden met een token. Uitloggen maakt het token onmiddellijk ongeldig op het apparaat waarvan je je hebt afgemeld.
Accountinstellingen
Section titled “Accountinstellingen”Je account bereik je via het avatarmenu rechtsboven in de app-shell. De accountinstellingen omvatten:
- Profiel — je naam, initialen en avatarafbeelding. Wijzigingen worden direct in de hele app toegepast.
- Wachtwoord — wijzig je wachtwoord door het huidige en een nieuw wachtwoord op te geven.
- E-mail — je inlogadres. Bij sommige deployments is opnieuw verifiëren vereist wanneer je dit wijzigt.
Beveiliging
Section titled “Beveiliging”Het beveiligingsgedeelte bundelt de instellingen die je account beschermen:
- Actieve sessies — elk apparaat met een levend token verschijnt hier. Trek elk apparaat in dat je niet herkent; intrekken dwingt een nieuwe aanmelding af op dat apparaat.
- Wachtwoordwijzigingen loggen je andere sessies bewust uit, zodat een gestolen laptop geen voet aan de grond houdt nadat je het wachtwoord roteert.
Sessies en refresh-tokens
Section titled “Sessies en refresh-tokens”Een succesvolle aanmelding geeft twee tokens uit: een kortlevend access-token en een langerlevend refresh-token. De app wisselt het refresh-token op de achtergrond stilletjes om voor een nieuw access-token, zodat je ingelogd blijft zonder je wachtwoord opnieuw in te voeren. Uitloggen trekt beide in. Als een refresh-token wordt gebruikt nadat het is ingetrokken, wordt elke sessie in die familie ongeldig gemaakt — een maatregel om diefstal te detecteren.
Facturatie
Section titled “Facturatie”Facturatie is per account georganiseerd. Het facturatiescherm toont je huidige abonnement, verbruik ten opzichte van een eventueel quotum, en een geschiedenis van facturen. Van abonnement wisselen gaat direct in; downgrades die de limieten van het nieuwe abonnement overschrijden, vragen je eerst je verbruik te verlagen. Facturen zijn als pdf beschikbaar vanaf hetzelfde scherm.
Organisaties
Section titled “Organisaties”Een organisatie groepeert accounts en projecten onder één administratieve paraplu, wat de manier is waarop teams groter dan één account hun werk structureren.
Van organisatie wisselen
Section titled “Van organisatie wisselen”Als je tot meer dan één organisatie behoort, brengt de organisatiewisselaar in de bovenbalk je tussen organisaties. Je projectlijst, leden en facturatiecontext volgen allemaal de actieve organisatie.
Een organisatie beheren (admin)
Section titled “Een organisatie beheren (admin)”Organisatiebeheerders krijgen een admingedeelte voor organisatiebrede instellingen: de naam en branding van de organisatie, de ledenlijst over alle projecten heen, en de facturatierelatie. Adminhandelingen worden geaudit.
Een lid verwijderen
Section titled “Een lid verwijderen”Een lid uit een organisatie verwijderen trekt hun toegang in tot elk project dat aan die organisatie toebehoort. Hun geschreven geschiedenis (stories, opmerkingen) blijft behouden voor continuïteit; alleen de toegang wordt ingetrokken.
Projecten
Section titled “Projecten”Een project aanmaken
Section titled “Een project aanmaken”Vanuit de projectlijst vraagt Create project om een naam en enkele standaardwaarden. Een nieuw project begint met een zinvolle iteratielengte en een lege backlog, klaar voor stories.
Projectinstellingen
Section titled “Projectinstellingen”Open een project en gebruik de instellingen om het volgende te beheren:
- Naam en beschrijving.
- Iteratielengte — het aantal weken per iteratie (1–4). Dit stuurt de velocityberekening en de iteratiemarkeringen op het board aan.
- Puntenschaal — de schattingsschaal die voor stories wordt gebruikt (zie Punten).
- Startdag — de weekdag waarop je iteraties beginnen.
- Velocitystrategie — hoe het systeem de toekomstige capaciteit voorspelt (een gemiddelde van recente iteraties, of een handmatige override).
Leden en uitnodigingen
Section titled “Leden en uitnodigingen”Projecten worden gedeeld door mensen ervoor uit te nodigen:
- Nodig een lid uit via e-mail vanuit de ledenlijst van het project. Ze ontvangen een e-mail met een uitnodigingslink.
- Totdat ze accepteren, is de uitnodiging pending; je kunt deze intrekken.
- Elk lid heeft een rol: owner, member of viewer. Owners beheren het project; members doen het dagelijkse werk; viewers hebben alleen-lezen toegang.
- Een lid verwijderen trekt hun toegang tot dat project in, maar behoudt hun geschreven geschiedenis.
Stories
Section titled “Stories”Stories zijn de werkeenheid. Elke story draagt een type, een status, een schatting (soms), een owner en een positie in je backlog.
Een story aanmaken
Section titled “Een story aanmaken”De snelste weg is de knop Add story bovenaan elke boardkolom. Geef het een titel en je hebt een story; al het andere kan later worden ingevuld vanuit het detailpaneel.
- Titel is het enige verplichte veld.
- Type staat standaard op feature, maar je kunt het wijzigen (zie de types hieronder).
- Nieuwe stories belanden in de icebox of bovenaan je backlog, afhankelijk van de kolom waaruit je ze hebt toegevoegd.
Features schatten
Section titled “Features schatten”Features dragen een puntenschatting afkomstig van de schaal van je project. Klik op de puntenregeling op een featurekaart (of in het detailpaneel) en kies een waarde. Bugs en chores nemen standaard geen punten; releases nooit.
Status laten vorderen
Section titled “Status laten vorderen”Stories doorlopen statussen naarmate het werk vordert. De kaart toont de volgende zinvolle actie als knop:
- Features en bugs: unstarted → started → finished → delivered → accepted (of rejected, wat de story terugzet naar started).
- Chores: unstarted → started → accepted.
- Releases: unstarted → accepted (een release is een mijlpaalmarkering, geen bouwbaar werk).
De knoppen bieden altijd alleen geldige overgangen aan, zodat je een story niet kunt verplaatsen naar een plek waar dat niet is toegestaan.
Detailpaneel
Section titled “Detailpaneel”Klik op een storykaart om het detailpaneel te openen. Hiervandaan kun je elk veld bewerken: titel, beschrijving, type, schatting, owner, requester, labels, taken en opmerkingen. Wijzigingen worden opgeslagen terwijl je ze maakt.
Opmerkingen
Section titled “Opmerkingen”Het detailpaneel huisvest een opmerkingenthread. Opmerkingen ondersteunen @-mentions van projectleden, die een melding krijgen; een opmerking met alleen een emoji registreert als een lichtgewicht reactie.
Bijlagen
Section titled “Bijlagen”Voeg bestanden aan een story toe door ze op het detailpaneel te slepen of door de bijlageregeling te gebruiken. Afbeeldingen worden inline weergegeven; andere types verschijnen als downloadlinks.
Labels
Section titled “Labels”Labels zijn gekleurde tags die tot een project beperkt zijn. Pas er een willekeurig aantal toe op een story; klik op een label om het board te filteren tot stories die het dragen.
Blockers, links, reviews
Section titled “Blockers, links, reviews”- Blockers registreren wat een story tegenhoudt, als vrije tekst; markeer ze als opgelost wanneer ze zijn verholpen.
- Links verbinden gerelateerde stories.
- Reviews leggen goedkeuring vast (bijvoorbeeld QA of design) op stories die dat nodig hebben.
Splits een story op in een checklist van taken. Vink ze af naarmate je vordert; de kaart toont de voortgang van de taken in één oogopslag.
Storyveldreferentie
Section titled “Storyveldreferentie”Elk veld op het story-detailpaneel, wat het doet en hoe het zich gedraagt. Dit weerspiegelt de inline [?] helphints in de app.
Status
Section titled “Status”De positie van de story in zijn workflow. Aangestuurd door de statusknoppen, niet rechtstreeks bewerkt. Geldige overgangen hangen af van het storytype (zie Status laten vorderen). De status bepaalt in welke boardkolom de story zit.
Iteratie
Section titled “Iteratie”Tot welke iteratie de story behoort. Backlog- en iceboxstories hebben geen iteratie; gestarte stories worden automatisch in de huidige iteratie getrokken. Het systeem wijst iteraties toe op basis van velocity — dit stel je doorgaans niet met de hand in.
Owners
Section titled “Owners”De mensen die het werk doen. Een story kan meerdere owners hebben; hun avatars stapelen op de kaart. Onderscheiden van de requester, die erom heeft gevraagd.
Storytype
Section titled “Storytype”Een van feature, bug, chore of release. Bepaalt of de story punten neemt en welke statusworkflow hij volgt. Het type halverwege wijzigen kan een schatting wissen (chores en releases dragen geen punten).
Prioriteit
Section titled “Prioriteit”Een optionele rangschikkingsvlag (bijvoorbeeld P0–P3) wanneer het project prioriteiten inschakelt. Onafhankelijk van de backlogvolgorde; een story met hoge prioriteit kan nog steeds laag in de backlog staan totdat je hem verplaatst.
Punten
Section titled “Punten”De omvangsschatting. Afkomstig van de geconfigureerde schaal van het project (bijvoorbeeld Fibonacci 0/1/2/3/5/8). Alleen features nemen standaard punten; het project kan zo worden ingesteld dat ook bugs en chores punten mogen nemen. Velocity is de som van geaccepteerde punten per iteratie.
Requester
Section titled “Requester”De persoon die om de story heeft gevraagd. Standaard de maker van de story; wijzig dit om de aanvraag toe te schrijven aan degene van wie hij kwam. Onderscheiden van owners, die het werk doen.
Labels
Section titled “Labels”Vrij-vormige gekleurde tags, beperkt tot het project. Een story kan er vele dragen. Labels sturen epics aan (een label bekeken als een hoeveelheid werk) en boardfiltering.
Blockers
Section titled “Blockers”Vrije-tekstnotities over wat de story tegenhoudt, elk met een vlag opgelost/onopgelost. Onopgeloste blockers verschijnen op de kaart zodat belemmeringen zichtbaar zijn.
Beschrijving
Section titled “Beschrijving”De inhoud van de story — het detail achter de titel. Ondersteunt Markdown en @-mentions. Hier staan de acceptatiecriteria en de context.
Bulkacties
Section titled “Bulkacties”Selecteer meerdere stories (Shift- of Cmd/Ctrl-klik) om er gezamenlijk op te handelen: status wijzigen, labels instellen, naar een iteratie verplaatsen, of verwijderen. Bulkacties respecteren dezelfde overgangsregels als bewerkingen op één story.
Het board
Section titled “Het board”Het board is het belangrijkste werkoppervlak. Het is een set naast elkaar geplaatste panelen die je kunt tonen, verbergen en herschikken.
Configureerbare panelen — selectievakjes in de zijbalk
Section titled “Configureerbare panelen — selectievakjes in de zijbalk”De zijbalk bevat een selectievakje per paneel. Vink een paneel aan om het te tonen, vink het uit om het te verbergen. Je selectie blijft behouden per project, per browser.
Aangepaste filterpanelen
Section titled “Aangepaste filterpanelen”Naast de ingebouwde panelen kun je aangepaste panelen maken die door een filter worden ondersteund, zodat een paneel precies de selectie stories toont die voor jou van belang is (bijvoorbeeld “alle bugs die aan mij zijn toegewezen”). Aangepaste panelen gedragen zich als elk ander paneel op het board.
Zoeken
Section titled “Zoeken”Het zoekvak filtert het zichtbare board tot stories die overeenkomen met je zoekopdracht — titel, label, type, enzovoort. Wis het om het volledige board te herstellen.
Chip voor huidige iteratie
Section titled “Chip voor huidige iteratie”Een chip markeert de huidige iteratie zodat je het werk van vandaag snel terugvindt tussen de kolommen.
Iteraties
Section titled “Iteraties”Een iteratie is een venster van werk met vaste lengte (de iteratielengte van je project). Het systeem vult iteraties vooruit op basis van je velocity, zodat het board altijd een realistisch plan voor de nabije toekomst toont. Geaccepteerde punten worden per iteratie opgeteld om het velocitygemiddelde aan te sturen.
Releases
Section titled “Releases”Een release is een mijlpaalmarkering in de backlog. Stories erboven behoren tot die release; de eigen status van de release is simpelweg unstarted of accepted. Gebruik releases om verzendpunten te markeren en het werk daartussen te groeperen.
Analytics
Section titled “Analytics”Het analyticsgedeelte visualiseert de gezondheid van het project: velocity in de tijd, burn-up/burn-down, cyclustijd, en de samenstelling van de huidige iteratie. Gebruik het om trends te ontdekken — een afnemende velocity, een groeiende icebox — en om capaciteit te plannen. De cijfers zijn afgeleid van dezelfde data over geaccepteerde punten die het board gebruikt.
Agents
Section titled “Agents”Agents zijn niet-menselijke deelnemers — automatiseringen, bots of AI-assistenten — die via de API in een project handelen. Ze verschijnen naast mensen, maar worden beheerd via keys in plaats van uitnodigingen.
Een agent aan een project toevoegen
Section titled “Een agent aan een project toevoegen”Voeg een agent toe vanuit het ledengedeelte van het project. Je geeft hem een naam en een rol (member of viewer), en het systeem munt een agent key — een token dat de automatisering gebruikt om te authenticeren. Een agent kan nooit owner zijn.
Wat agents kunnen doen
Section titled “Wat agents kunnen doen”Een agent handelt met de rechten van zijn rol, precies als een persoon met die rol. Een agent met de rol member kan stories aanmaken en bewerken; een agent met de rol viewer kan alleen lezen. Elke handeling die een agent verricht, wordt eraan toegeschreven in het auditlog.
Agent keys beheren
Section titled “Agent keys beheren”Agent keys worden vermeld in het agentgedeelte van het project. Je kunt aanvullende keys munten, ze een naam geven voor hun doel, en elke key onmiddellijk intrekken. Een key intrekken stopt de automatisering die hem gebruikt direct.
Agents met de API gebruiken
Section titled “Agents met de API gebruiken”Een agent authenticeert door zijn key in de X-TrackerToken-header te versturen, precies zoals het token van een persoon zou worden verstuurd. Van daaruit roept hij dezelfde /api/v1/…-endpoints aan die in de API-gids zijn gedocumenteerd. De rol van de agent bepaalt wat die aanroepen kunnen doen.
Importeren uit andere trackers
Section titled “Importeren uit andere trackers”Als je van een ander tool afkomstig bent, accepteert het importgedeelte data van veelvoorkomende trackers (bijvoorbeeld Pivotal Tracker, Jira, Asana). Je koppelt hun velden aan die van Tracker, en stories, statussen en labels komen mee over. Controleer het resultaat voordat je het definitief maakt.
Thema’s
Section titled “Thema’s”Tracker wordt geleverd met meerdere visuele thema’s. Kies er een uit de themawisselaar; je keuze wordt onthouden in de browser. Thema’s veranderen alleen het uiterlijk — nooit het gedrag.
De app is in vele talen vertaald. Kies de jouwe uit de taalwisselaar; de keuze blijft behouden in de browser. Van taal wisselen verandert nooit je data — alleen de tekst van de interface.
Sneltoetsen
Section titled “Sneltoetsen”Veelvoorkomende acties hebben sneltoetsen — zoeken openen, een story aanmaken, navigeren op het board. De sneltoetshulp is in de app beschikbaar; kijk naar de toetsenbordhint in de interface.
Self-hosting
Section titled “Self-hosting”East Agile Tracker kan self-hosted worden. De operationele details — omgevingsvariabelen, databaseopzet, deploymentvormen — staan in de ontwikkelaarsdocumentatie in plaats van in deze gebruikershandleiding.