Documentation Index
Start Here

Documentation Index

Landing page and reading-order guide for the API Workbench Pro documentation suite; links every other document and explains who each is for.

docs/DOC_INDEX.md
all

API Workbench Pro — Documentation Index


What is API Workbench Pro?

API Workbench Pro is an offline-first API integration workbench that covers the entire API
lifecycle — import → design → mock → map → run → govern → ship-readiness — inside a single
browser app. There is no backend, no account system and no sync service: every byte of your
workspace data lives in your own browser's localStorage. The vendor never receives it and has no
technical means to.

That single architectural choice is the product's flagship promise: **zero-egress, GDPR by
architecture**. Your specs, endpoints, mappings, runs, traces and audit log generate zero outbound
network traffic; the only times the app touches the network are three explicit, user-initiated flows
(a live request you Send, a spec you import from a URL, and a webhook you configured for a
scheduled run).

  • Live app: <https://api-workbench-pro.lovable.app/>
  • In-app help center: the Documentation Center at /docs renders this same documentation
    • Internal codename in the code: ApiBox (you will see apibox.* storage keys).

    New here? Jump to Start here — by persona for the fastest path to
    being productive in your role.


    The documentation set

    Thirteen Markdown documents make up the help center. Every one is grounded in the real routes,
    entities and code of API Workbench Pro (v0.9.0, with the v0.9.1 Readiness Platform Guide added on
    top); verified facts are kept separate from inferred ones, and each document cross-links the others. The in-app Documentation Center (/docs) discovers and
    renders these files; the Help Menu masterfile is the machine-readable
    manifest that drives the in-app menu.

    Newest addition (v0.9.1): the Readiness Platform Guide documents the
    now ten-dimension Readiness Scorecard and the four dedicated readiness pages (API Inventory,
    Resilience Lab, Agent Readiness, Compatibility Matrix) added since the v0.9.0 wave.

    #DocumentAudienceSummary
    1Documentation Index (this page)EveryoneThe landing page: what the product is, the full doc table, per-persona start paths, and pointers to /docs and the masterfile.
    2Business System ReferenceProduct, engineering, operations, supportThe big-picture reference: what the product is, the value proposition, the module map, and how the lifecycle stages fit together as one system.
    3User ManualEnd users, support, operationsEnd-to-end, operational walkthrough of the app — the shell (sidebar, command palette Ctrl/Cmd+K, g-key chords, theme, tour), every Workspace/Modeling/Runtime screen, and how to actually do each task.
    4Process FlowsProduct, operations, support, engineeringThe core end-to-end processes (import, design→scenario→run, mapping→review→lock, schema-change→CI gate, spec-watch→notify, readiness→PDF, gateway smoke, scheduled runs, evidence bundle, encrypted export, role/lock denial) as Mermaid flows with prose.
    5Navigation TreeSupport, product, engineeringThe complete route map — every sidebar group, label and path, plus detail and public routes — as a navigable tree.
    6Technical ArchitectureEngineering, architecture, security, devopsTech stack, the offline-first/SSR architecture, the store and persistence model, the src/lib/checks engine contract, and local development.
    7Feature CatalogProduct, support, engineeringOne reference section per route/module (what it is, who it's for, how to use it, what it persists), covering every screen in the navigation — including the Readiness Scorecard and the five check modules.
    8Role Permission MatrixProduct, support, security, engineeringThe four roles (owner/editor/operator/viewer), the persona mapping, impersonation, production locks, mapping reviews, and the append-only audit log.
    9Data Flow & Entity ReferenceEngineering, data, productThe domain entity model (src/domain/types.ts), where state lives (apibox.state.v5 + awp.* keys), the exactly-three outbound flows, and end-to-end data journeys.
    10Change Intelligence AppendixEngineering, product, QA, supportFeature-evolution timeline (0.7.0 → 0.9.0), recurring bug classes, fragile/migration-sensitive areas, and the "do-not-rebreak" knowledge mined from the changelog and lessons file.
    11Help Menu MasterfileFrontend, engineering, docs systemThe machine-readable manifest that drives the in-app help menu: every document with its metadata, plus navigation/feature/process/role/entity indexes.
    12Documentation Generation ReportMaintainers, engineeringProvenance of this documentation set: scope analyzed, documents generated, Mermaid coverage, confidence assessment, evidence gaps, and recommendations.
    13Readiness Platform GuideTech Leads/Owners, designers, engineers, ops, securityDeep-dive on the ten-dimension Readiness Scorecard (how the weighted score and ship/caution/blocked verdict are computed) and the four dedicated readiness pages — API Inventory, Resilience Lab, Agent Readiness, Compatibility Matrix — with per-dimension rules and a step-by-step readiness workflow.

    The Readiness Scorecard (/readiness) — now ten dimensions — and its dedicated check
    surfaces (Governance & Lint, Security Posture, Trace Readiness, Drift Radar, Validation Engine,
    API Inventory, Resilience Lab, Agent Readiness, Compatibility Matrix) are covered end-to-end in the
    Readiness Platform Guide and enumerated in the
    Feature Catalog; their end-to-end flows are in
    Process Flows and their data/engine contract in
    Technical Architecture.

    Pre-existing provenance docs (preserved, cross-linked — not part of the numbered help set):
    ARCHITECTURE.md, GDPR.md,
    trust/security-overview.md,
    trust/DPA-template.md. These are the source-of-truth provenance pages a
    security or procurement reviewer reads; the help-center docs cross-link them and never duplicate
    them.


    Start here — by persona

    API Workbench Pro is role-aware. You set your active role by impersonation in Settings
    (/settings); each persona has a default role (see Role Permission Matrix).
    Below is the fastest productive path for each.

    API Designer (default role: editor)

    You import specs and shape endpoints, schemas and scenarios.

    1. User Manual → the shell + the API Catalog & Import (/catalog, /import)
      • Process Flows Import OpenAPI and *Endpoint design → scenarios →
        • Feature CatalogData Packs (/data-packs), Scenarios
          • Feature Catalog → run a Governance & Lint (/governance) pass on your

            Integration Engineer (default role: editor)

            You wire APIs together with field mappings and run scenario suites.

            1. User ManualAPI Explorer (/api-explorer) and Mapping Studio
              • Process Flows Mapping build → review → production lock and *Schema
                • Feature CatalogMapping Reviews (/mapping-reviews), Prevalidation
                  • Change Intelligence Appendix → understand which modules a spec

                    Ops / SRE (default role: operator)

                    You run, schedule, smoke-test and monitor — but cannot change locked production mappings.

                    1. Feature CatalogEnvironments (/environments), Gateway Smoke
                      • Process Flows Gateway export → smoke and *Scheduled run tick →
                        • Feature CatalogDrift Radar (/drift-radar) and
                          • Role Permission Matrix → what production locks deny you and why.

                          Tech Lead / Owner (default role: owner)

                          You own production locks, govern reviews, and decide what ships.

                          1. Feature Catalog → the Readiness Scorecard (/readiness) and its
                            • Change Intelligence Appendix → the change-intelligence loop and
                              • Process Flows Mapping → review → lock and Readiness check → PDF.
                              • Role Permission Matrix and GDPR.md → governance model

                                Auditor / Viewer (default role: viewer)

                                You inspect, verify and export evidence — read-only.

                                1. Feature CatalogAudit Log (/audit), Trust Center (/trust).
                                2. Process Flows Evidence bundle export (audit-grade).
                                3. GDPR.md and trust/security-overview.md → the
                                  • Data Flow & Entity Reference → verify the zero-egress claim

                                    Procurement / Security reviewer

                                    You assess risk before adoption.

                                    1. GDPR.md → GDPR Art. 5 / 25 / 32 mapped to architectural answers.
                                    2. ARCHITECTURE.md → the exactly-three outbound flows and the route map.
                                    3. trust/security-overview.md and trust/DPA-template.md.
                                    4. Data Flow & Entity Reference → the verifiable storage-key

                                      The whole app at a glance

                                      The navigation groups every route. Use this as a map; each module has a full section in the
                                      Feature Catalog, and the complete route tree is in
                                      Navigation Tree.

                                      Diagram (Mermaid) — renders on GitHub
                                      flowchart TD
                                        subgraph WS[Workspace]
                                          O["/ Overview"]
                                          CAT["/catalog · Import"]
                                          EXP["/api-explorer"]
                                          GQL["/graphql"]
                                          RT["/realtime"]
                                          TMF["/tmf"]
                                        end
                                        subgraph MOD[Modeling]
                                          DP["/data-packs"]
                                          SC["/scenarios"]
                                          MAP["/mappings"]
                                          MR["/mapping-reviews"]
                                          ERR["/errors"]
                                          SD["/schema-diff"]
                                        end
                                        subgraph RUN[Runtime]
                                          ENVR["/environments"]
                                          PRE["/prevalidation"]
                                          EXEC["/execution"]
                                          GS["/gateway-smoke"]
                                          CI["/ci-gate"]
                                          SCH["/schedules"]
                                          MF["/mock-forge"]
                                        end
                                        subgraph INTEL[Intelligence]
                                          INS["/insights"]
                                          CHI["/change-intelligence"]
                                          OAI["/openai"]
                                          AEX["/explorer"]
                                        end
                                        subgraph RDY[Readiness]
                                          RScore["/readiness"]
                                          GOV["/governance"]
                                          SECP["/security-posture"]
                                          TR["/trace-readiness"]
                                          DR["/drift-radar"]
                                          VE["/validation-engine"]
                                          INV["/api-inventory"]
                                          RL["/resilience-lab"]
                                          AR["/agent-readiness"]
                                          CM["/compatibility-matrix"]
                                        end
                                        subgraph GOVN[Governance]
                                          AUD["/audit"]
                                          TRUST["/trust"]
                                          ENT["/enterprise"]
                                          SET["/settings"]
                                          HELP["/help · /docs"]
                                        end
                                        WS --> MOD --> RUN --> RDY
                                        RUN --> INTEL
                                        RDY --> GOVN

                                      *Diagram: the navigation groups (Workspace, Modeling, Runtime, Intelligence, Readiness, Governance)
                                      and the rough left-to-right lifecycle flow. Detail routes (/api/$apiId,
                                      /api/$apiId/endpoint/$endpointId, advanced /import) and the public, full-bleed routes
                                      (/welcome, /pricing) sit outside these groups.*


                                      Where to read these docs

                                      • In the app: open the Documentation Center at /docs — it renders this exact docs
                                        • In the repo / on GitHub: browse the docs/ folder. Start with this index, then follow
                                          • Programmatically: the Help Menu masterfile lists every document

                                            To learn how this documentation system is wired and how to extend it, see
                                            docs/README.md.

                                            API Workbench Pro · v0.9.0 · offline-first documentation Back to top