106 lines
3.6 KiB
Markdown
106 lines
3.6 KiB
Markdown
# 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.
|