How tilitronic/poetry-platform works
This monorepo appears to support a poetry authoring platform: a browser-based studio, an editor engine, phonetic/stress analysis, and visualizers. The principal workflow is authoring text in the studio and passing document changes through the editor engine; analysis workers are present as a separate capability. Source excerpts establish the editor’s tokenization and state handling, but do not establish how the studio wires the editor, workers, or visualizers together. The API and analytics packages are included as distinct backend capabilities; their broader runtime connections are not shown.
Main entry points: Orchestrator.ts Editor Orchestrator · VisualizerContainer.vue Visualizer Container · bootstrap.ts Worker Bootstrap · App.vue Studio App
Components 25
Author Studio
- Studio App
apps/author-studio/src/App.vue - Studio Routes
apps/author-studio/src/router/routes.ts - Authoring Page
apps/author-studio/src/pages/IndexPage.vue - Text Editor
apps/author-studio/src/components/OpusTextEditor/OpusTextEditor.vue - Visualizer Container
apps/author-studio/src/components/VisualizerContainer/VisualizerContainer.vue - Worker Bootstrap
apps/author-studio/src/workers/bootstrap.ts
Editor Engine
- Editor Orchestrator
packages/editor-engine/src/orchestrator/Orchestrator.ts - Editor View
packages/editor-engine/src/view/OpusEditorView.ts - Command Bus
packages/editor-engine/src/orchestrator/command-bus.ts - Poetry State
packages/editor-engine/src/state/PoetryState.ts - Tokenizer
packages/editor-engine/src/tokenizer/tokenizer.ts - Formatting Filter
packages/editor-engine/src/view/opusFormattingFilter.ts
Text Analysis
- Stress Worker
apps/author-studio/src/workers/w1-stress.ts - Phonetics Worker
apps/author-studio/src/workers/w2-phonetics.ts - Phonetics Core
packages/phonetics-core/src/engine/ipa.ts - Atlas Loader
packages/phonetics-core/src/atlas/load-atlas.ts
Visualization
- Interactive Visualizer
packages/visualizer-2d/src/interactive/index.ts - SSR Visualizer
packages/visualizer-2d/src/ssr/index.ts - 3D Visualizer
packages/visualizer-3d/src/index.ts
Backend Services
- API Auth
apps/api-server/app/core/auth.py - Postgres Access
apps/api-server/app/db/postgres.py - Analytics Scheduler
packages/analytics-pipeline/src/daemon/cron.py - Analytics Unit Of Work
packages/analytics-pipeline/src/db/uow.py - Analytics Calculation
packages/analytics-pipeline/src/core/numpy_calc.py
Other components
- Author
Connections 12
- Author → Studio App: uses
- Studio App → Studio Routes: renders routes
- Studio Routes → Authoring Page: routes to
- Editor Orchestrator → Poetry State: updates state
- Editor Orchestrator → Command Bus: creates
- Editor Orchestrator → Tokenizer: tokenizes changes
- Worker Bootstrap → Stress Worker: initializes
- Worker Bootstrap → Phonetics Worker: initializes
- Phonetics Worker → Atlas Loader: loads atlas
- Visualizer Container → Interactive Visualizer: may use
- Visualizer Container → 3D Visualizer: may use
- Analytics Scheduler → Analytics Calculation: schedules