Every product with a published durable application journey.
Stateful systems · operating model planner
Design the journey that survives the request.
Select any journey-bearing Mappls product and receive its exact state-ownership boundary, aggregates, actors, lifecycle blueprints, runnable apps, source contracts, eight implementation controls, and production release gates.
132 states and 140 guarded transitions.
Detection and recovery remain part of the contract.
Runnable, downloadable evidence for every selected track.
Three state boundaries
Attribute every state to the system that owns it.
A stateless Mappls call can participate in a durable application journey. A provider-stateful product still does not replace your business aggregate, audit, or reconciliation model.
Provider + application state
Mappls exposes durable resources. Mirror provider identity and evidence while retaining an independent business lifecycle.
Hybrid state boundary
Request/response calculations coexist with sessions, workspaces, releases, or reviews. Persist both boundaries explicitly.
Application-owned journey
The Mappls boundary is stateless; consent, selection, inspection, and publication state belongs to the application.
Capture & Feedback
Capture & Feedback combines request/response capabilities with durable sessions, workspaces, releases, reviews, or agent runs. Persist the business journey independently from any one provider response.
- Aggregates
- feedback report · location capture attempt · place contribution
- Platforms
- Android · iOS
- Authentication boundary
- SDK entitlement and user consent
- Credential rule
- The planner accepts no credential, token, secret, precise location, media, or provider resource identifier.
Complete coverage matrix
Nine products. No hidden state ownership.
Every row resolves to complete journey, sample, tutorial, contract, and source evidence where the corpus establishes it.
Search & Placesaddress verification
Application-owned journey1 blueprints1 verified apps9 states · 11 transitions
4 failure plans2 contracts · 1 guides
18 tutorials
Routes & Navigationincident · navigation session · trip itinerary · route planning session
Hybrid state boundary4 blueprints3 verified apps27 states · 31 transitions
17 failure plans6 contracts · 10 guides
16 tutorials
InTouch Telematicstrip · geofence case · geofence draft
Provider + application state3 blueprints3 verified apps18 states · 18 transitions
12 failure plans11 contracts · 10 guides
9 tutorials
Workmatetask
Provider + application state1 blueprints1 verified apps8 states · 8 transitions
4 failure plans5 contracts · 2 guides
5 tutorials
GIS & Analyticsanalysis run
Hybrid state boundary1 blueprints1 verified apps7 states · 6 transitions
4 failure plans0 contracts · 3 guides
3 tutorials
App Widgets & Deep Linkswidget selection session · remote visual inspection
Application-owned journey2 blueprints2 verified apps17 states · 19 transitions
11 failure plans0 contracts · 7 guides
7 tutorials
Offline & Automotivedevice release
Provider + application state1 blueprints1 verified apps7 states · 7 transitions
4 failure plans0 contracts · 0 guides
3 tutorials
AI & Locationagent run · vision evidence case
Hybrid state boundary2 blueprints2 verified apps15 states · 14 transitions
10 failure plans7 contracts · 3 guides
3 tutorials
Capture & Feedbackfeedback report · location capture attempt · place contribution
Hybrid state boundary3 blueprints2 verified apps24 states · 26 transitions
14 failure plans2 contracts · 9 guides
6 tutorials
Eight implementation controls
Build the control plane around the API.
Each layer asks one design question, defines the implementation boundary, and names the proof required before production.
Identity and aggregate boundary
Use stable business and provider identifiers for feedback report, location capture attempt, place contribution; never infer identity from display text or the latest coordinates.
Actor authority
Authorize every command against the named journey actors: Contributor, Host application, Mappls Feedback Kit, Provider adapter, Operations reviewer, Application user, Platform adapter, Evidence reviewer, Mappls Location Capture SDK, Mappls hosted widget and search. Persist the attributable actor, tenant, purpose, and policy decision.
Commands and concurrency
Require a command idempotency key and expected aggregate version. Cache the canonical result, reject key reuse with different intent, and reconcile ambiguous timeouts before retry.
Evidence and durable records
Persist immutable receipts and revisions around these catalog records: Feedback report, Submission revision, Provider attempt, Review decision, Capture attempt, Normalized location evidence, Audit and outbox, Contribution aggregate, Widget attempt, Publication evidence. Keep event time, receipt time, source identity, hashes, and retention policy separate.
Events and side effects
Commit aggregate state, audit, and a transactional outbox together. Sign deliveries, bound retries, dead-letter exhaustions, and preserve delivery attempts without changing business history.
Recovery and reconciliation
Treat timeouts as unknown outcomes, poll or consume authoritative evidence, compare versions, append a reconciliation decision, and use compensation instead of destructive history edits.
Privacy and human control
Minimize precise location and media, scope retention, redact derived data deliberately, and require attributable approval for dispatch, publication, access, closure, and destructive change where consequential.
Operations and release
Expose state age, source freshness, stuck commands, retries, reconciliation lag, outbox depth, terminal outcomes, and per-aggregate audit. Roll out behind explicit acceptance gates.
Selected lifecycle evidence
Capture & Feedback: every published aggregate.
Open the detailed state machine or run the linked full-stack reference application. Empty contract or guide collections remain visible as evidence boundaries—not invitations to invent behavior.
iOS feedback report and review
Open one feedback UI generation, normalize a bounded report candidate, commit an application submission, reconcile provider acknowledgement separately, review evidence, and close only with an attributable resolution.
- States
- 9
- Transitions
- 9
- Failures
- 4
- Signals
- 7
Consent-bound location capture evidence
Initialize and configure an entitled Location Capture SDK, acquire a bounded single or subscribed fix, preserve accuracy and timing as evidence, review weak results, and stop every native resource deterministically.
- States
- 8
- Transitions
- 9
- Failures
- 5
- Signals
- 8
Governed place contribution and publication
Embed the credential-free Add a Place surface, record what the user reports, reconcile independently, and call a place published only when durable provider-backed evidence exists.
- States
- 7
- Transitions
- 8
- Failures
- 5
- Signals
- 8
Implementation evidence
Start with exact contracts, then follow the journey.
2 endpoint contracts, 9 repository guides, 6 tutorials, 10 real-world solution blueprints, and 2 verified apps support this selected track.