platform-admin/boc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
9e4ebeea1aa4679ca00b951fdc58d376419ce821
boc/docs/design/foundations/FOUNDATIONS-v1.0.md
T
Bernt edf1e6e0d6 docs: Foundation Freeze v1.0 complete + Experience Audit + Core Principle Check 
- FOUNDATIONS-v1.0.md updated:
  - Added Landvex Core Principle and Design Constitution to frozen foundations
  - Added Core Principle Rules to invariants (2.4)
  - Reordered component priority: Modal, Search, Map Panel, Navigation, Table, Data Grid
  - Reflects business value: search and maps are central to Landvex

- EXPERIENCE_AUDIT.md (v1.0, LOCKED):
  - Four questions for every screen:
    1. Can purpose be understood in 3 seconds?
    2. Is 'Reality → Decision' visible?
    3. Is it obvious what the user should do?
    4. Does everything contribute to the decision?
  - Three-second rule levels with verification method
  - Audit process: select screens → apply questions → prioritize fixes → verify
  - Example audit format
  - Core Principle Check for RFCs: 4 questions before approval

- COMPONENT_TEMPLATE.md updated:
  - Added Core Principle section to template
  - Requires: decision support, cognitive load reduction, 3-second understanding

- RFC_DEFINITION_OF_DONE.md updated:
  - Added Core Principle as criterion #2 (was 12 criteria, now 13)
  - Exit criteria: must pass all 13

Rationale: Freeze foundation with Core Principle as highest authority.
Experience audit ensures all screens support decision-making.
Core Principle Check prevents components that don't serve the user.
Business-value prioritization: search and maps before tables.
2026-07-02 11:28:08 +00:00

4.9 KiB
Raw Blame History

FOUNDATIONS v1.0 — FROZEN

Stable Platform for Landvex Design System Components
Version 1.0
Status FROZEN
Date 2026-07-02
Scope All Landvex & quiXzoom products

1. SCOPE

What Is Included

Foundation Document Version Status
Landvex Core Principle LANDVEX_CORE_PRINCIPLE.md 1.0 ✅ Frozen
Design Constitution LANDVEX_DESIGN_CONSTITUTION.md 1.0 ✅ Frozen
Motion System MOTION_SYSTEM.md 1.0 ✅ Frozen
AI Design Principles AI_DESIGN_PRINCIPLES.md 1.0 ✅ Frozen
Semantic Color System SEMANTIC_COLOR_SYSTEM.md 1.0 ✅ Frozen
Grid & Elevation GRID_ELEVATION.md 1.0 ✅ Frozen
Typography LANDVEX_DESIGN_SPECIFICATION.md §3 1.0 ✅ Frozen
RFC Component Template COMPONENT_TEMPLATE.md 1.0 ✅ Frozen
Definition of Done RFC_DEFINITION_OF_DONE.md 1.0 ✅ Frozen

Reference Components (v1.0)

Component Document Maturity
Button RFC-001-Button.md 82%
Input RFC-002-Input.md 83%
Select RFC-003-Select.md 83%
Card RFC-004-Card.md 83%

2. INVARIANTS

These rules MUST NOT be violated by any component built on Foundations v1.0.

2.1 Token Rules

  • MUST use semantic color tokens (color.{category}.{role})
  • MUST NOT reference primitive colors (blue-500, gray-900) from components
  • MUST NOT hardcode values
  • MUST use intention-based motion tokens (duration-{intent})

2.2 Component Rules

  • MUST follow COMPONENT_TEMPLATE.md structure
  • MUST include Cognitive Purpose, Interaction Contract, Failure Behaviour
  • MUST include Accessibility Contract and AI Contract
  • MUST pass all 12 Definition of Done criteria

2.3 Accessibility Rules

  • MUST meet WCAG 2.1 AA
  • MUST include keyboard navigation
  • MUST include screen reader support
  • MUST include reduced motion fallback

2.4 Core Principle Rules

  • MUST support "From Reality → Decision" flow
  • MUST be understandable in 3 seconds (what), 10 seconds (process), 60 seconds (value)
  • MUST reduce cognitive load for decision-making
  • MUST answer: "What decision does this help the user make?"

2.5 AI Rules

  • MUST include AI Contract (when AI chooses this component)
  • MUST document anti-patterns
  • MUST verify against document hierarchy

3. CHANGE POLICY

After Freeze

Change Type Allowed Process
New component ✅ RFC + Compliance Matrix update
Component variant ✅ RFC update
Component bug fix ✅ Patch version
New foundation concept ❌ Requires Foundations v2.0 RFC
Foundation modification ❌ Requires Foundations v2.0 RFC
Foundation addition ❌ Requires Foundations v2.0 RFC

Versioning

Version Meaning
1.0.x Patch: bug fixes, clarifications
1.x.0 Minor: new components, no foundation changes
2.0.0 Major: new foundation concepts, breaking changes

4. COMPATIBILITY

Foundation Versions

Foundation Version Frozen Date
Core Principle 1.0 2026-07-02
Design Constitution 1.0 2026-07-02
Motion 1.0 2026-07-02
Semantic Colors 1.0 2026-07-02
Grid 1.0 2026-07-02
Elevation 1.0 2026-07-02
Typography 1.0 2026-07-02
RFC Template 1.0 2026-07-02

Component Compatibility

Component Requires Foundations
Button v1.0 Foundations v1.0
Input v1.0 Foundations v1.0
Select v1.0 Foundations v1.0
Card v1.0 Foundations v1.0
Modal v1.0 Foundations v1.0
Navigation v1.0 Foundations v1.0
Table v1.0 Foundations v1.0
Map Panel v1.0 Foundations v1.0

5. NEXT STEPS

Components v1.x (Next Wave)

Priority Component Status
1 Modal ⏳ Not started
2 Search ⏳ Not started
3 Map Panel ⏳ Not started
4 Navigation ⏳ Not started
5 Table ⏳ Not started
6 Data Grid ⏳ Not started

Future Foundations

Version Trigger Estimated
v2.0 New platform (e.g., native mobile), new accessibility standard, major rebrand Unknown

ÄNDRINGSHISTORIA

Version Datum Beskrivning
1.0 2026-07-02 Initial freeze: Core Principle, Design Constitution, Motion, AI Principles, Semantic Colors, Grid, Elevation, Typography, RFC Template, Definition of Done

STATUS

FROZEN

  • No new foundation concepts without v2.0 RFC
  • No foundation modifications without v2.0 RFC
  • Components can be added freely within v1.x
Reference in New Issue View Git Blame Copy Permalink