wArchi

Frontend SPA for architectural modeling workflows: managing models, notations, visual styles, and versioned entities.

Русская версия:

Features

• Notation editor on top of Papirus canvas (selection, transforms, auto-layout)
• JSON import/export for notation data
• Component and relation style customization
• Custom node shapes with dedicated outline editor
• Tags, custom attributes, and relation rules editor
• Versioned models and notations
• Built-in documentation section (
  /docs
  ) with guides, hotkeys, FAQ, and changelog
• Wiki section (
  /wiki
  ) for entity-linked documentation pages
• Blue/green deployment support via Helm and
  deploy.sh

Tech Stack

• Vue 3 (
  <script setup>
  , Composition API)
• TypeScript (strict mode)
• Vite
• Vue Router 5
• Vitest

Requirements

• Node.js 18+
• npm 9+
• Papirus NPM package (
  @ngroznykh/papirus
  )

Quick Start

App runs on

and proxies

/api/*

to backend.

NPM Scripts

Deployment (

deploy.sh

)

supports two modes:

• Legacy: recreates release
• Blue/Green: deploys inactive color, verifies readiness, optionally switches traffic

Main environment flags:

Examples:

Environment Variables

Configured via

:

Architecture Notes

• State management uses composables (no global store)
• API layer is based on typed
  ApiResult<T>
  wrappers
• Entities are versioned and grouped by name
• Notation editor uses Papirus rendering engine

Documentation

• In-app documentation section:
  /docs
  (overview, models, notations, diagrams, types, shapes, hotkeys, FAQ, changelog)
• Entity wiki section:
  /wiki
  (model, notation, type, and shape linked pages)
• Documentation content source:
  src/features/docs/content/*.md
• Technical plans and implementation notes:
  docs/*.md

Open Source Readiness

For public release preparation, see:

• CONTRIBUTING.md
• SECURITY.md
• CODE_OF_CONDUCT.md

License

This project uses dual licensing:

• AGPL-3.0-or-later
  for open-source usage
• Commercial license for proprietary/closed-source commercial usage

See:

• LICENSE
• LICENSE_COMMERCIAL.md