Architecture map →
ANTZ · OPERATIONS
Context pack Basic version

Antz Operations architecture

19 Nov 2026

What this is

Whole-system architecture for Antz operations: Inventory, warehouses, sites, assets, GRC, Helpdesk, maintenance, work orders, procurement, approvals, tasks. A vision only, never built / missing status.

Briefs

Files

FileWhatStatus
architecture.htmlThe mapBasic version
gen_architecture.pyBuilds the mapcurrent
ARCHITECTURE.mdFull written vision, D1–D10current
bounded-contexts.htmlCard sortearlier
system-flow.htmlGRC-style flowchartearlier
system-map.htmlFour-view pagerejected
sop.cssShared stylesrequired
council/2026-11-19-visuals/, council/2026-11-19-warmth/Visual councilsdone

Preview: ops-architecture, port 3037.

Settled

#Decision
D1A breakdown is always an incident first
D2One Approvals inbox per person
D3Spare parts are stock, issued to work orders, costed to the asset
D4Built places get a place asset
D5Checked-out asset custody is a person or a place
D6Asking a store is an item request, never a ticket
D7GRC risk is findings only
D8Mismatched invoice is flagged, not blocked
D9Many cost centres per department
D10Tasks is its own module; AMC / warranty / licence are alerts; My work is one screen

Working rules

Open

Module pages

Inventory · Procurement · Finance · Helpdesk · Maintenance · Assets · GRC · Tasks · Approvals · Foundations

Inventory

Last updated 19 Nov 2026. Paths are under Studio/projects/.

On the map

The backbone (the only dark navy header), with 14 parts:

Also:

Binding decisions

Design work

PathWhatStatus
Antz/design-tab-library/Projects/Inventory-v1/Tablet (834×1194), look-up only: products, stock by store, reorder level, variants, batch and expiry, "Request this". Receiving, issuing, transfers and reorder stay on the web23 Oct
Antz/design-tab-library/Projects/Item-requests-v1/Item requests tablet module, a modules page, an Antz Home landing, masters views (no README)22 Oct
Antz/procurement/Procure-v1/ #/inventoryStock report and inventory section14 Oct
Antz/kitchen-diet/Kitchen research—

Code knowledge (atlas capabilities.md; Kitchen SRC-KI / KA / KB-20261118, Antz SRC-AM / AW-20261118; all "not deepened")

Settled

Open

Procurement

Last updated 19 Nov 2026. Paths are under Studio/projects/.

On the map

Money domain (soft navy).

Binding decisions

Design work

PathWhatStatus
Antz/procurement/project.jsonTimeline from concept (May) to offline portal, Procure-v1, v2, v3 and web lite"build", 30 Oct
Antz/procurement/00-concept/ (brief.md, Procurement-PRD.pdf)PRD draft v0.1: request → quote → review → order → invoice → delivery9 May
Antz/procurement/Procure-v1/ (README, HANDOFF, DECISIONS.md)Clickable prototype (Help Desk tablet, Procurement tablet and web), Phase 1 / 2 switch; local at localhost:8789/Procure-v1/Phase 1 built 14 Oct; nothing committed
Antz/procurement/procurement-v2/ + design-baseline/Offline portal v1.37 restyled to "Design system v0", with a logic guard16 Oct
Antz/procurement/procure-web-lite/V3 screens for requester, approver, procurement team and finance; live: https://procure-web-lite.vercel.app23 Oct; inventory and store screens not built
Antz/procurement/docs/Review packs (budgets read; others not opened)—

Code knowledge

Kitchen only (CAP-kitchen-procurement, SRC-KA / KB): /procurement/*, procurement items, vendors, rate card, forecast, weekly and monthly plans. Antz mobile and web have none.

Settled (Procure-v1 DECISIONS.md)

Open

Finance

Last updated 19 Nov 2026. Paths are under Studio/projects/.

On the map

Money domain (soft navy).

Binding decisions

Design work

PathWhatStatus
Antz/procurement/bill-desk-lite/ (docs/framing.md, DECISIONS.md, docs/context-pack.md)Delivery note → invoice → Finance, with browser storage; seed from Kitchen delivery notes 1–15 Oct; port 3021; repo Sourav-Tambe/Procurement_BilldeskGRN build deployed 5 Nov
Antz/procurement/finance-setup-lite/Budget heads, sites, staged releases (50/25/25), commitment ledger; port 3022; council outputs and open questionsbuilt 2 Nov, awaiting review
Antz/procurement/budgets-demo/Budgets rebuilt in the Antz shell, current and next financial year; port 3023—
Antz/procurement/docs/budgets-review-3/Decisions and open questions; budgets admin spec21 Oct

Code knowledge

Kitchen only (CAP-invoices-reconciliation): receipt reconciliation, invoices, vehicle reconciliation. Antz has pharmacy purchase invoices. No Antz finance or budget capability exists.

Settled

Open

Helpdesk

Last updated 19 Nov 2026. Paths are under Studio/projects/.

On the map

Work domain (teal).

Binding decisions

Design work

PathWhatStatus
Antz/helpdesk/case_study.md, project.jsonRequirements: 7 statuses, department and zoo cost limits, 48 h revert window"requirements", updated 2 May 2026; design pending
Antz/helpdesk/flows/type-a-with-costing/, type-b-without-costing/The two department-type flows (v0001–v0002); the 7 generic IT flows are archived—
Antz/helpdesk/docs/reference_frappe_helpdesk.mdStudy of Frappe Helpdesk14 Aug 2026
Antz/procurement/helpdesk-only/Help Desk lite prototype: list, search, filters, form, detail, settings; from Figma VPKybj9jCMEQKKPynTu7ZoHub entry help-desk/requests-list-detail-new-request; Phase 1 built 14 Oct

Code knowledge (atlas Meta/atlas/modules/help-desk.md)

Settled

Open

Maintenance

Last updated 19 Nov 2026. Paths are under Studio/projects/.

On the map

Work domain (teal).

Binding decisions

Design work

There is no Maintenance project of its own. It lives inside Asset Management.

PathWhat
Antz/asset-management/flows/maintenance-wo/, flows/ticket-wo/Maintenance-to-work-order and ticket-to-work-order flows
Antz/asset-management/research/flows/F03-maintenance-to-workorder.mdResearch flow (17 Jul 2026)
Antz/asset-management/research/patterns/P05-work-order-model.mdWork order model pattern; evidence E05–E08
Antz/asset-management/docs/antz-asset-prd/Antz_Asset_Management_Entities_StateMachines.mdPRD state machines (listed, not read)
operations-architecture/ARCHITECTURE.md §3.2, F1, F2Plan, visit, work order and task records; reactive and preventive flows

Code knowledge (atlas Meta/atlas/modules/asset-management.md, SRC-AW-20261118)

Settled

Open

Assets

Last updated 19 Nov 2026. Paths are under Studio/projects/.

On the map

Work domain (teal).

Binding decisions

Design work

PathWhatStatus
Antz/asset-management/ (project.json, case_study.md)PRD v1: 28 entities, 12 state machines, 36 screens, 10 flowsPRD published 20 Apr 2026
Antz/asset-management/docs/antz-asset-prd/PRD, IA, UX flows, entities and state machines, ideation decisions, doctrine resolutions—
Antz/asset-management/docs/antz-asset-ui-prototype/, ui-host/antz-asset-ui/Static HTML prototype, about 196 screensApr 2026
Antz/asset-management/research/Design research built on EZO17 Jul 2026
Antz/asset-management-build/Build plan (waves), data model, spec copies; Figma 679IijiM9ZvnmAdMSNOyrJ ("asset-with-design-system")—
Antz/asset-management-build-research/Phase 1 scope: register, custody, transfer, missing/found; maintenance, tickets, audit and requests deferred28 Jun 2026

Code knowledge (atlas Meta/atlas/modules/asset-management.md)

Settled

Open

GRC

Last updated 19 Nov 2026. Paths are under Studio/projects/.

On the map

Assurance domain (green).

Binding decisions

Rules (Define)

Checks and audits (Verify)

Incidents (Report)

Compliance (Prove)

Tasks

Last updated 19 Nov 2026. Paths are under Studio/projects/.

On the map

People domain (orange). Orange is used only for what a person does today.

Tasks box, above Inventory:

My work band (one screen): my tasks · your turn (tickets, work orders, PRs, GRNs, invoices) · my approvals · my alerts.

Binding decisions

Design work

PathWhatStatus
Antz/task-management/docs/Antz_Task_Management_PRD_v2.0.mdPRD: 22 screens, 5 state machines, 17 notifications, 10 flowsPRD v2, 20 Apr 2026
Antz/task-management/task-management-ui/Hi-fi: V1 frozen in v1/; V2 composer v2.html; four listing / detail lines (list.html, list-v2.html, list-v3.html, detail-v2.html); card galleries; tab.html tablet planv1 complete, 22–24 Sep; Untitled UI since 21 Sep
Figma VPKybj9jCMEQKKPynTu7Zo (sections 4097:50701, 4387:96273, 4428:97059), 3ThgDnFwHu9F3ie1zlPgwWTasks screens and draft—
Antz/design-tab-library/Projects/Antz-Home/Home with My work and approval widgets23 Oct

Code knowledge

There is no tasks module in the atlas.

Settled (PRD §14)

Open

Approvals

Last updated 19 Nov 2026. Paths are under Studio/projects/.

On the map

A shared engine band at the top: one inbox · approval policy · amount bands · steps and decisions · delegation. "My approvals" is part of the My work screen.

Binding decisions

Design work

PathWhat
Antz/procurement/Procure-v1/DECISIONS.mdProcurement approvals A1–A14; Help Desk T17 / T18
Antz/helpdesk/case_study.mdHelp Desk department and zoo cost limits (requirements stage)
Antz/design-tab-library/Projects/Antz-Home/Home approval widgets: pending, queue, priority, pipeline (grep only)
Task PRD screen A1Approvals queue, with stuck rejections

There is no approvals project of its own.

Code knowledge (atlas, SRC-AM / AW-20261118)

Settled

Open (conflicts with the target, inferred)

Foundations

Last updated 19 Nov 2026. Paths are under Studio/projects/.

On the map

Four bands at the bottom ("Foundations"), shared by every system:

Binding decisions

People & Permissions

Sites & Places

Vendors

Masters