web/docs/vision.md

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 (Two-Factor, Continue Flow)

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 minimal phone input.
5. On submit, server initiates SMS verification and returns a short-lived status ticket.
6. User replies CONFIRM to protocol SMS.
7. Page polls status using ticket-bound auth.
8. On phone verification, page attempts to open protocol email compose.
9. If compose is blocked by browser gesture policy, page shows explicit fallback action.
10. After email verification completes, final UI state shows acknowledged · {token}.

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).
• secret.edut.ai: inbound designation email namespace.
• api.edut.ai: API and webhook endpoint (/secret/*, /twilio/inbound, /mailgun/inbound).
• /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
• Phone placeholder
• Waiting/confirmation state text
• acknowledged label
• Footer labels
• Full AI/accessibility context abstract

English-governing at launch:

• Privacy Policy
• Terms of Use

Identity Evolution

The two-factor designation is the pre-launch identity envelope:

• Factor 1: phone verified by SMS reply.
• Factor 2: email verified via protocol message.
• 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.

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. Two-factor designation completes through deterministic state transitions with auditable evidence.