Repository navigation
Architecture
This is the maintained architecture map. Product contracts and implementation
references are linked below; development backlog and superseded checkpoints live
outside the repositories in the workspace's agent-work/ directory.
| Owner | Responsibilities | Interfaces |
|---|---|---|
| TS server | TACTIC objects, Search, permissions, commands/transactions, project databases, repository and plugin/template operations | Native pyasm/tactic, XML-RPC, HTTP API and editor routes |
| TS web client | Browser interaction, view rendering, drafts and request lifecycle | Vue and its server transport; no direct database writes |
| TH desktop client | Native QML interaction, client objects, local files, queues and desktop integrations |
tactic_handler_api, thlib, existing TACTIC SDK and native controllers |
| Shared Tactic Frame | Portable UI descriptions and state rules | Independent copies of ordinary JavaScript modules, rendered by each product's house controls |
Handler Server is TH's local integration/router service. It is not the Stream
TACTIC database server. Likewise, Handler's Python SObject wrappers are not the
server's pyasm.search.SObject objects. Sharing search keys does not make method
signatures, return shapes, thread ownership or lifecycle interchangeable.
src/pyasm/common, search, biz, security and command retain the original
core responsibilities. src/tactic_stream/server owns HTTP/API dispatch, startup
and process monitoring. The server must not import the legacy reference checkout
or Handler. Runtime resources live under config, compatibility and web.
Project code, SearchType namespace and database are distinct identities. SearchType/SObject/Schema/Pipeline and the native registry define the model; there is no parallel application-specific Asset/Task model. Database differences belong to Sql/DbResource/DatabaseImpl and vendor implementations. Commands own permissions, transactions, hooks and effects; direct SQL is not a substitute.
Result cards count snapshot contexts through native grouped Search queries for code/id and typed search_code/search_id relationships. They retain project, row permission and retirement filters without loading version histories. Specialized graph relationships keep the native related-object path. Static emoji font data is served without gzip: its embedded PNG glyphs already compress well; other eligible text and font assets retain negotiated compression.
Use the core model,
agent model and
current schema references.
Original TACTIC schema catalogues explain provenance; live metadata determines
what is installed. Excluded pyasm.prod imports must not be restored from old
examples; project settings use pyasm.biz.ProjectSetting.
WidgetConfig/WidgetConfigView resolve original XML definitions and layers at runtime. Keep raw stored values, display cells and unsaved drafts distinct. Preserve unknown XML, comments, repeated elements, explicit empties and revisions. Support for declarative options does not imply execution of arbitrary legacy Python/JavaScript widgets. Reject unsupported contracts explicitly.
The modern UI description is independent of Vue's version. Existing legacy HTML contracts remain a separate compatibility boundary; do not silently return JSON where a client expects HTML. Read configuration and UI references and the table contract for the relevant operation.
Follow the shared UI contract. Shared modules own
structure, layout and state rules; native QML and Vue controls own rendering and
input. Domain controllers and server commands keep their current responsibilities.
TH and TS ship separate copies and build independently; neither imports the
other checkout at runtime. Compare copies with
tools/sync_tactic_frame.py --handler-root <handler-checkout> --check.
Shared controls live in frontend/src/controls; domain features live together in
frontend/src/features. App.vue hosts the web application. Controls do not own
API requests or know project/type identities. One screen owns its drafts and
request lifecycle; asynchronous results must not overwrite a newer selection.
Use shared themes, translations, icons, modal-window behavior and scrollbars.
Product help and localization remain EN/RU; server-defined labels remain data.
frontend/src/features/windows/windowPages.js maps supported window kinds to
existing screen owners. The common window host supplies Open in separate page;
it does not clone DOM, embed the workspace in an iframe or reimplement commands.
App.vue authenticates and reads accessible projects before opening the owner,
skipping workspace restoration, search queries and workspace persistence.
Handler already uses native top-level windows; this browser host is TS-specific.
Addresses use /projects/<code>/?window=<kind>&context=<public JSON> (or / for
system context). The public descriptor contains only data for reopening the
owner; keep tickets, provider credentials, uploaded blobs and unsaved drafts out
of it. A random, short-lived launch identifier establishes a BroadcastChannel
handoff of ephemeral data, without window.opener. It is removed after handoff.
The receiver checks account, project and window kind, then uses its own current
credentials. Project access and administrative authority come from fresh server
responses. Session storage changes invalidate detached owners after logout or
account replacement. A page address never grants authorization.
To add a working window, register its existing open owner, supply windowContext
(or a page callback in v-window) and keep its native close/dirty/revision guards.
Public route values must be JSON data below 8 KiB and reopening must not execute
a write. state is ephemeral; use the owner's restoreWindowContext only for
supported drafts. Do not replay quick duplicate, check-in, script execution or
other actions when restoring a URL. Owner-dependent confirmations and cell/value
pickers do not detach. Unsupported dirty or busy state must reject detaching,
leaving the original intact. Existing persisted Messages and Script Editor drafts
remain owned by those features. No Electron process or privileges are introduced.
frontend/tests/window_pages.mjs runs against an isolated authenticated server
and compiled bundle: Messages handoff/draft/reload, existing utility/editor pages,
no workspace queries/storage changes, invalid routes/projects, and session exit.
window_types.mjs checks ordinary window controls and owner lifecycle.
OPERATIONS.md describes Stream server calls. TH references describe Handler's object API, background execution and native object/file semantics. Select the intended execution environment before choosing an operation.
The administrator-agent entry point is START.md, followed by the domain model and task-specific operations/recipes. This is a compact knowledge pack, not an installed AI/MCP service. The host supplies tools, authentication and authorization. Common durable draft/apply orchestration and an isolated generated-code runner are not implemented by those documents. Required security/execution boundaries are recorded in AGENTS.md.
Verify actual calls, permissions, errors, revision conflicts and transaction/file effects, not just registrations or matching signatures. Shared UI verification requires real Qt/browser input and paired geometry/appearance at the same data, theme, language, scale and size. Frame reports must match current source hashes.
Use the relevant tools/frame_* harness and frontend scenario, then the
platform gate. Backend changes need
the relevant isolated integration checks; delivery requires independent bundles
and its own installation/upgrade/recovery qualification. A historical report or
passing unit test is not a claim of full UI, Windows or PostgreSQL acceptance.
TACTIC-Stream · Releases · Issues · English · Русский
English
- Home
- Installation
- Feature tour
- User guide
- Assistant
- Dashboards
- Knowledge Base
- Synology DSM
- Demo projects
Русский
- Главная
- Установка
- Обзор возможностей
- Руководство пользователя
- Помощник
- Дашборды
- База знаний
- Synology DSM
- Демо-проекты
Development / Разработка