web/docs/vision.md

113 lines
4.0 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 (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. Post-mint success reveals `download your platform` links immediately.
10. Member communication occurs through the app after wallet sign-in (native notification channel).
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 and membership quote/confirm.
- `/privacy` and `/terms`: legal pages (English authoritative).
- Production catalog and checkout surfaces are launcher-app channels, not public web pages.
## 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)
- Delivery channel: app install + wallet sign-in
- 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.