Skip to content
How Taiga works · Evolve your software

The code already exists.
December will not wait.

December is approaching. Dispatch works, but delivery windows are missing. Import the system, find what could block the change, and carry the next release all the way to production.

North Pole Logistics · Illustrative projectKeep what works. Deliver what is next.
tai.ga
North Pole DispatchIllustrative project
LearnDeliverOperate
01Import

Before adding delivery windows, open the code.

Delivery teamNorth Pole DispatchImport codebaseIllustrative project

Import codebase

Linked repository

north-pole / dispatch

main

Start analysis

Choose Import codebase when creating the project; link a repository before analysis.

src/routes/search.ts
src/dispatch/capacity.ts
src/db/schema.ts
infra/service.tf

From repository evidence to a reviewable backlog

  1. Code-derived documents
  2. Repository scans
  3. Policy assessment
  4. Initial backlog
Ready to review

Each proposed repair cites its recorded findings or policy gaps.

You link · Taiga analyzes

Before adding delivery windows, the team needs to know how Dispatch works today. The import reveals the existing routes, data and infrastructure the change must preserve.

The import continues when you leave the page. Review its interpretation and proposed work before choosing what enters the queue.

02Understand

Find the route the new feature must preserve.

Delivery teamNorth Pole DispatchProject documentsIllustrative project

Project documents

Reality v1 · a17c042

Dispatch capacity

Each route has a fixed capacity. The current application assigns a route, but has no delivery-window booking.

src/dispatch/capacity.ts · lines 12–28
Refresh this document
Taiga derives · you review

The source-linked document shows how dispatch works today. The team records what delivery windows must preserve before extending the system.

The record stays derived from code; it is refreshed rather than edited by hand.

03Audit

The team chooses to fix this risk first.

Delivery teamNorth Pole DispatchMaintainingIllustrative project

Maintaining

osv-scannergitleaksopengrepcheckov
Findings
High

SQL query constructed from request text

opengrep · insecure code

src/routes/search.ts:24Fix this finding
Policies · Example organization policy
1 breached controlSEC-04

Use parameterized database queries.

Recorded source

src/routes/search.ts:24 · a17c042

Scanners find · policies give context

Maintaining finds request text used as SQL and cites the published parameterized-query control. The team prioritizes this existing risk before releasing delivery windows.

This is a cited breach of one control. Controls without recorded evidence are not declared compliant.

04Prioritize

The evidence becomes a queue you control.

Delivery teamNorth Pole DispatchInitiativesIllustrative project

Initiatives

Initial backlog · generated from import evidence

Line runningOne active initiative per project
Build1
  1. FIX-07Parameterize dispatch search

    Source: SEC-04 · src/routes/search.ts:24

    Planning
Queue1
  1. INIT-08Book a delivery window

    Business request · WINDOW-01

Todo0

No initiatives

Backlog0

No initiatives

Build on its own by default · enabledMerge review · a person must approve

Taiga proposes · you prioritize

The initial backlog cites the findings and policy gaps it addresses. The team queues the search repair first, then the delivery-window feature. One initiative runs at a time.

Import generates the backlog. Your priorities decide what enters the queue; this example builds automatically and requires human merge review.

05Fix

Fix the search query.

Delivery teamNorth Pole DispatchRemediation initiativeIllustrative project

Remediation initiative

Parameterize dispatch search

  1. 1Planning
  2. 2Building
  3. 3Your review
Before
db.query(`SELECT * FROM routes WHERE name = '${query}'`);
After
db.query('SELECT * FROM routes WHERE name = $1', [query]);

Search treats input as data

PR #42 · Reviewed and merged
Queue plans · Taiga builds · you review

The queued repair is planned against the repository, then built under the project’s autonomy setting. The reviewer checks the parameterized query before merging it.

Build on its own is enabled here. Required reviews and branch protections still govern the merge.

06Verify fix

The finding has to disappear from the scan.

Delivery teamNorth Pole DispatchFinding verificationIllustrative project

Finding verification

Open · a17c042src/routes/search.ts:24
Re-scan after the fix
Resolved · b28d153

Same rule. Same file. Pattern no longer detected.

Re-scan verifies

The finding stays open until the scan checks the corrected file. When the same rule no longer detects it, the finding resolves.

A passing build alone does not resolve a finding. A failed scan does not count as clean.

07Initiative

Now the queue reaches the business change.

Delivery teamNorth Pole DispatchInitiative · next in the queueIllustrative project

Initiative · next in the queue

INIT-08

Book a delivery window

Let dispatchers reserve an available delivery window for a route. A full window must reject the booking.

  • Reserve an available window.
  • Reject a full window without changing capacity.
  • Keep existing route identifiers and assignments.
Reality documentsProject instructionsPublished policies

WINDOW-01 · Never overbook a window

You define the change

The search repair has merged. The next queued initiative can proceed: reserve delivery windows without overbooking, keeping the existing route identifiers and database.

The queue advances after the previous pull request merges. Its deployment and verification records remain separate.

08Plan

A reservation needs one transaction.

Delivery teamNorth Pole DispatchInitiative planIllustrative project

Initiative plan

Illustrative implementation plan

Booking table
Atomic capacity check
Booking API
Dispatch window picker
Boundary tests

Keep PostgreSQL. Reserve capacity in the same transaction as the booking.

Existing code + project instructions + acceptance criteria

Two requests for the final space: only one succeeds.

Taiga proposes · you inspect

The plan connects a small schema addition, an atomic reservation, the API, the interface and boundary tests.

This is the example app’s architecture, not a Taiga API.

09Develop

A full window must stay full.

Delivery teamNorth Pole DispatchRunIllustrative project

Run

feat/delivery-windows
BuildingHardeningCI checks
BEGIN;
UPDATE delivery_windows
SET reserved = reserved + 1
WHERE id = $1 AND reserved < capacity
RETURNING id;
-- Insert booking only if a row returned.
COMMIT;

Full window accepted a booking

Full window rejected · capacity unchanged

Final space: one request accepted · one rejected

Illustrative code and test results

Taiga builds and checks

The first implementation accepts a booking it should reject. The run corrects capacity handling and repeats the tests, including two competing requests for the final space.

These are illustrative run results, not an executed customer delivery.

10Review

The change is ready to inspect.

Delivery teamNorth Pole DispatchPull requestIllustrative project

Pull request

PR #43

Add delivery-window booking

  • Plan and acceptance criteria
  • Code and migration
  • Tests and recorded run
Human review completeMerge to the configured branch

Branch protections and configured review rules still apply.

You review and merge

The pull request brings the change, migration and verification record together. The reviewer checks the work before merge.

Repository protections and selected automation settings govern the real merge.

11Deploy

One change, through to production.

Delivery teamNorth Pole DispatchDeploymentsIllustrative project

Deployments

What is running in each environment, and the deployments that got it there.

DevelopmentCurrent
Delivery windowsc39e264main · GitHub Actions
ProductionCurrent
Delivery windowsc39e264main · GitHub Actions
HistoryInsights
VersionEnvironmentResult
c39e264ProductionSucceeded
c39e264DevelopmentSucceeded

Your configured pipeline deploys. Taiga brings its reported versions, environments and history into the project.

Your pipeline deploys · Taiga tracks

The configured pipeline takes the merged change through development checks and production approval. Taiga shows the connected deployment record.

Production is an outcome in this fictional story. The app below runs only in your browser.

12Operate

The release becomes a system you can watch.

Delivery teamNorth Pole DispatchMonitoringIllustrative project

Monitoring

ProductionLast 30 days
AvailabilityRespondingSample URL checks · production
ExperienceLearning baselineThe beacon is receiving samples. More traffic is needed for a baseline.
API errorsWaiting for enough API callsInstall the browser beacon to collect experience signals.
p95Waiting for enough API callsInstall the browser beacon to collect experience signals.
Response time184 ms
Illustrative 30-day history
Next initiative

The team uses runtime evidence to choose what to improve next.

Illustrative records and measurements. No live systems are connected.

Taiga observes · Your team decides

Availability checks and browser signals keep the running environment visible. The team can inspect the release and use the evidence to decide what comes next.

Illustrative monitoring. URL checks require a configured public URL; browser signals require the installed beacon. New samples are still learning a baseline.

Production in the story · interactive example

The next dispatch has a window.

The existing route is still here. Now a dispatcher can reserve a delivery window without overbooking it.

North Pole DispatchWinter operations
Ready for dispatch
Route

NP-042 · Rovaniemi

240 parcels · existing route

Delivery windows · new in this release

Delivery window

Delivery window

Booking record

No window reserved yet.

Browser-only demo. Fictional data; no backend, deployment, real identity or persistent storage.

North Pole Dispatch is an illustrative project. Repository files, findings, policies, commits and run results are examples, not customer evidence.

After release

Configured URL checks, browser signals from the installed beacon and repository sweeps inform the next decision. A deployment record alone does not establish application health.