web/docs/vision.md

89 lines
2.8 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
1. A visitor lands on `edut.ai`.
2. They see only the globe, identity line, and meaning line.
3. They click anywhere.
4. The globe accelerates and a pre-filled protocol-style email opens.
5. The recipient is a timestamp address (`{timestamp}@secret.edut.ai`).
6. They send it and receive a designation confirmation with auth token.
7. At launch, the same designation receives a follow-up changing classification from `OBSERVER` to `OPERATOR` with status `ACTIVE`.
The interaction is intended to feel like protocol registration, not a marketing funnel.
## 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`: webhook endpoint for inbound processing.
- `/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
- `acknowledged` label
- Footer labels
- Full AI/accessibility context abstract
English-governing at launch:
- Privacy Policy
- Terms of Use
## 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.