Social
| Term | Definition | Authority |
|---|---|---|
| activity | A feed record capturing that a member performed a verb on an object. Activity is append-only and drives the public social feed. | social.elonn.local |
| circle | A derived set of members reachable from a given member through shared private community co-membership. Circles are computed by traversal; they are not stored as tables and are not manually managed by members. | social.elonn.local |
| community | A named, visibility-scoped group of members. Communities are the primary organizational unit of the social layer and the mechanism that creates inner circle relationships. | social.elonn.local |
| conversation | A titled, threaded discussion anchored to a visibility scope. Conversations are the primary social object for group discourse. Every conversation has a creator, a visibility setting, and zero or more replies. | social.elonn.local |
| discovery | The traversal of circle reach, built from private community co-membership. Discovery determines which members and Social objects are reachable at each circle depth. | social.elonn.local |
| event | A scheduled social gathering with a title, optional time bounds, visibility, and an attached conversation. Events have participants who RSVP and can link to communities. | social.elonn.local |
| message | An open one-to-one member communication outside Social context. Messages live in two-participant threads owned by messages.elonn.local. |
messages.elonn.local |
| notification | An alert delivered to a specific member about something that happened and is relevant to them. Notifications are targeted and recipient-scoped, unlike activity which is feed-oriented. | social.elonn.local |
| presence | A member's real-time availability signal. Presence records the member's current status, availability, and the runtime they are using. | social.elonn.local |
| profile | A member's social-layer identity. Profile is distinct from the API identity record — it is the social representation of a member, authored by that member for the social context. | social.elonn.local |
| relationship | An explicit, directional record from one member to another expressing a social stance. Currently only the block type is supported. |
social.elonn.local |
| reply | A post added to an existing conversation or event by any member who can view it. Replies extend a conversation or event's discussion. They do not create new threads or branches. | social.elonn.local |
| social-dm | A private one-to-one communication initiated from Social context. Social DMs belong to social.elonn.local because their meaning comes from profiles, conversations, communities, events, replies, presence, activity, circles, discovery, or relationship rules. |
social.elonn.local |
| visibility | The access scope of a social object. Visibility determines which members can see a given conversation, community, event, presence record, or activity entry. | social.elonn.local |
Spatial
| Term | Definition | Authority |
|---|---|---|
| action | An executable interaction exposed by an object or surface. Actions connect user intent to service behavior. | varies — executed by service |
| anchor | The placement mode of a world object, determining whether it belongs to the personal carry layer or the shared field layer. | world.elonn.local |
| block | A structured content region within a surface. Blocks organize objects, cards, controls, and findings into logical groups. | world.elonn.local |
| card | A visual presentation wrapper for an object within a block. A card is presentation-only — the object exists independently of its card representation. | web.elonn.local |
| carry | Objects anchored to a member and carried with them through the world. The carry layer is personal and persistent — it moves with the member, not with the field. | world.elonn.local |
| deck | A navigable ordered collection of surfaces within a region. A deck represents movement through contextual space. | world.elonn.local |
| field | The shared spatial panorama visible to all members of the world. Field objects are placed at coordinates within the field and are not attached to any individual member. | maps.elonn.local |
| finding | A candidate informational result discovered or computed by Find. A finding is not yet normalized runtime content. | find.elonn.local |
| marker | A visual point-of-interest placed at a position in the field. Markers are authored by the maps service and rendered by the web runtime. | maps.elonn.local |
| navigation | The model governing how a member moves through runtime space. Navigation in Elonn is spatial — movement between surfaces and regions, not traversal of a document or menu hierarchy. | world.elonn.local |
| object | A renderable entity within a block, originating from a service. Objects are the data primitives the surface system presents. | varies — always qualified by service |
| panel | A content surface loaded inside a surface by a runtime via content_source.url when content_source.kind is runtime_panel. Panels are the rendering target for service content within the carry layer. |
world.elonn.local |
| region | A persistent spatial zone within a runtime. Regions divide the runtime into distinct spatial zones with different interaction characteristics and anchor behaviors. | world.elonn.local |
| surface-object | Normalized, runtime-safe content carried by a Surface. | surface.elonn.local |
| surface | A persistent interactive container around service-backed or runtime-backed content. A surface preserves identity and runtime state as it moves between stacked, docked, detached, shared, and field-anchored placements. | surface.elonn.local |
| window | An independently managed spatial container with z-order, resizing, overlap, focus management, and independent lifecycle. | world.elonn.local |
Surface System
| Term | Definition | Authority |
|---|---|---|
| dock | An attached stack region that follows the runtime viewport or user. A dock can contain a carry stack or shortcuts into surfaces. | surface.elonn.local |
| field placement | A spatially anchored placement for a surface. Field placement allows a surface to appear at a real-world or world-field anchor without changing surface identity. | surface.elonn.local |
| stack | An ordered collection of surfaces with one focus surface. A stack is a presentation organizer; it does not own the surfaces it contains. | surface.elonn.local |
| viewport | The visible presentation region for a stack. A viewport may be a web DOM region, Android overlay region, or XR spatial region. | runtime-specific |
Service
| Term | Definition | Authority |
|---|---|---|
| api | The identity and authentication authority for all Elonn services. Owns members, sessions, and tokens. All services validate identity by calling the API service. | api.elonn.local |
| contract | The named, versioned agreement that defines a World model, runtime payload, or service payload and its behavior. Runtime contracts tell runtimes what primitives, capabilities, services, actions, controls, and objects they can expect. | world.elonn.local |
| find | The search and discovery service. Find owns query records, findings (search results), and heads (classifications). It is distinct from the social discovery graph. | find.elonn.local |
| maps | The spatial data service. Maps is the authority for field layout, field width, and markers. It provides the shared visual environment that all members inhabit. | maps.elonn.local |
| runtime | A complete executable presentation environment. Runtimes consume translated World contracts. They are responsible for rendering, input handling, lifecycle, performance, accessibility implementation, and platform adaptation. | world.elonn.local |
| service | An independently deployed Elonn application boundary with its own routes, data ownership, and domain logic. | varies |
| social | The social object authority. Social owns conversations, communities, events, profiles, presence, activity, notifications, relationships, circles, discovery graph behavior, and Social DMs. | social.elonn.local |
| time | The calendar and scheduling service. Time owns calendars and time events. It accepts ingested events from the social service to mirror them as calendar entries. | time.elonn.local |
| translation | Server-side conversion of a discovered resource into a normalized Surface Object. Surface owns translation. Find discovers resources; runtimes render the result and never translate source formats themselves. | surface.elonn.local |
| translator | A platform component that converts the canonical World model into a runtime-specific contract for a declared capability class. | world.elonn.local |
| web | The browser runtime application. Web renders the world contract, executes the carry and field layers, and delivers the full Elonn experience in a browser. | web.elonn.local |
| world | The composition and aggregation service. World assembles identity, maps, social, messages, and time data into the canonical World model and translated runtime contracts consumed by runtimes. World is also the product noun for the whole experience. | world.elonn.local |
Identity
| Term | Definition | Authority |
|---|---|---|
| member | A person with a registered account in the Elonn identity system. Members are the human actors across all services. The API service is the single authority for membership. | api.elonn.local |
| session | A bounded interaction context. "Session" alone is ambiguous across services and must always be qualified. | varies — always qualify |
| token | A credential issued by the API service after successful authentication. Tokens identify the authenticated member across all service calls. | api.elonn.local |