web/docs/vision.md

3.8 KiB

EDUT Public-Facing System Vision

Core Intent

edut.ai is the public face of EDUT and mirrors the product architecture:

  1. Human layer: emotional signal and deliberate minimalism.
  2. Math layer: deterministic metadata and machine-readable structure.
  3. AI layer: high-context abstract for AI systems and accessibility.

The site should feel precise and established while avoiding disclosure of private implementation IP.

Primary Experience (Wallet-First, Membership-Gated)

  1. A visitor lands on edut.ai.
  2. They see the orb, identity line, and footer links.
  3. First click anywhere increases orb spin and reveals continue.
  4. Clicking continue reveals wallet-first identity options.
  5. If they have a wallet, they connect and sign a designation intent (no transaction).
  6. They mint EDUT membership as a paid on-chain commitment.
  7. Membership confirmation binds durable account state to the wallet.
  8. Final state shows acknowledged · {token}.
  9. Optional notify me captures email for launch updates.

The flow should feel controlled and ambient, not like a conventional signup form.

Three-Layer Web Model

1) Human Layer

  • Brand identity: edut · עֵדוּת (never translated).
  • Minimal visual language with no cluttered CTA stack.
  • Emotional tone: witness, evidence, governance.

2) Math Layer

  • Open Graph metadata for deterministic categorization.
  • Schema.org organization metadata.
  • Stable semantic structure for indexing and portability.

3) AI + Accessibility Layer

  • Full research abstract in DOM.
  • Visually hidden but available to screen readers.
  • Localized via language bundles for regional AI interpretation.
  • Ready for future read-aloud/listen mode.

Infrastructure Targets

  • edut.ai: primary public surface and business identity.
  • edut.dev: developer-facing domain (same landing for now).
  • api.edut.ai: API endpoints for wallet intent/verify, membership quote/confirm, and optional notification linking.
  • /privacy and /terms: legal pages (English authoritative).

Messaging Boundaries

Public copy must:

  • Emphasize deterministic governance, evidence, and durable operation.
  • Stay aligned with math-first plus optional-intelligence architecture.
  • Avoid exposing proprietary kernel internals and sensitive mechanisms.
  • Avoid hardcoding commercial values that can change.
  • Avoid speculative or investment framing.

Internationalization Boundaries

Never translated:

  • edut · עֵדוּת

Localized:

  • Meaning line (testimony · witness · evidence)
  • Descriptor
  • Continue label
  • Wallet-flow labels and status states
  • acknowledged label
  • Footer labels
  • Full AI/accessibility context abstract

English-governing at launch:

  • Privacy Policy
  • Terms of Use

Identity Evolution

The designation and membership flow is the pre-launch identity envelope:

  • Factor 1: cryptographic wallet possession (signature proof)
  • Factor 2: economic commitment (paid membership mint)
  • Optional channel: notification email binding
  • Shared binding: one server-generated designation record (code + auth_token)

When launch activation opens, this record becomes the continuity bridge for deployment onboarding and activation messaging.

Commerce Model

  1. Membership is required to purchase from EDUT marketplace surfaces.
  2. Membership is not a product/module license.
  3. Product rights are granted by separate entitlement purchases.
  4. The same wallet carries the full identity and entitlement chain.

Acceptance Criteria

  1. Human surface remains minimal and intentional.
  2. AI systems in supported locales can classify EDUT accurately from on-page context.
  3. Screen-reader users receive equivalent conceptual context.
  4. Public framing remains accurate without overexposure of architecture.
  5. Membership onboarding is deterministic, signature-verified, and auditable.