| Предыдущая версия справа и слеваПредыдущая версия | |
| sharixopen:knowledge:reference:tz_map [2026/10/17 10:53] – [sharixknowledge] approved package sx_knowledge_api_open | sharixopen:knowledge:reference:tz_map [2026/10/17 20:51] (текущий) – [sharixknowledge] approved package sx_knowledge_api_open |
|---|
| ====== Как переносить структуру TZ в базу знаний ====== | <sharix-knowledge-meta> |
| | { |
| | "id": "ShariXKnowledgeTZMap", |
| | "page": "sharixopen:knowledge:reference:tz_map", |
| | "area": "open", |
| | "type": "reference", |
| | "title": "Карта архитектурных решений Open", |
| | "status": "review", |
| | "schema_version": 1, |
| | "relations": { |
| | "related_to": [ |
| | "ShariXKnowledgeOpenKnowledgeFoundationStart", |
| | "ShariXKnowledgeOpenKnowledgeArchitectureSystemlayers", |
| | "ShariXKnowledgeOpenKnowledgeDomainStart", |
| | "ShariXKnowledgeOpenKnowledgeDevelopmentPractice", |
| | "ShariXKnowledgeOpenKnowledgeOnboardingStart", |
| | "ShariXKnowledgeOpenKnowledgeOperationsRunbook" |
| | ] |
| | }, |
| | "extensions": { |
| | "taxonomy": { |
| | "domain": "reference", |
| | "lifecycle": "unspecified", |
| | "parents": [ |
| | "ShariXKnowledgeOpenKnowledgeStart" |
| | ], |
| | "terms": [] |
| | }, |
| | "glossary": [] |
| | }, |
| | "content_sha256": "3e02867078a2f5f06260b829ee87b3dbdc03c1bf87d058295a4b7e97e4cf070f", |
| | "schema": 1 |
| | } |
| | </sharix-knowledge-meta> |
| | ====== Карта архитектурных решений Open ====== |
| | ~~NOCACHE~~ |
| |
| **Область:** Open. **Состояние документа:** проект для обсуждения (review). | ===== Где находится правило ===== |
| | * Состав, границы и зависимости: архитектурная модель. |
| | * Состояния заказа и события: доменные контракты. |
| | * Действия над сервисом: процедура и проверочный сценарий. |
| | * Эксплуатационная операция: health, конфигурация и отказ. |
| | * Создание сервиса: onboarding и раздельность проектного/фактического состояния. |
| | ===== Принцип ===== |
| | В каждой теме содержится сам контракт, его ограничение и связанные понятия. Страницы не требуют обращения к параллельному комплекту документации. |
| |
| ===== Принцип переноса ===== | ===== Детальные правила ===== |
| TZ — исходный документ проектирования и исторических решений, а не автоматически достоверная текущая wiki. Одна большая статья TZ может стать несколькими связанными, устойчивыми страницами. **Не копируйте целиком** внутренние материалы в публичную wiki. | * [[sharixopen:knowledge:foundation:start|ShariX Open: система знаний и архитектурные правила]] |
| | * [[sharixopen:knowledge:architecture:system_layers|Слои архитектуры и разделение ответственности]] |
| | * [[sharixopen:knowledge:domain:start|Доменная модель заказов и исполнения]] |
| | * [[sharixopen:knowledge:development:practice|Разработка Open: обязательные правила]] |
| | * [[sharixopen:knowledge:onboarding:start|Создание сервиса и первый запуск]] |
| | * [[sharixopen:knowledge:operations:runbook|Эксплуатация Open и наблюдаемость]] |
| |
| ^ Исходные документы TZ ^ Куда переносить в wiki ^ | |
| | ''00-architecture-overview.md'', ''01-domain-model.md'', ''05-model-ownership-matrix.md'' | [[sharixopen:knowledge:architecture:start|Архитектура]] и [[sharixopen:knowledge:modules:start|Модули]] | | |
| | ''02-api-and-extension-contracts.md'', ''11-external-integrations.md'' | [[sharixopen:knowledge:integrations:start|Интеграции]]; закрытые сведения — в Joint/Platform | | |
| | ''04-example-scenarios.md'' | [[sharixopen:knowledge:scenarios:start|Сценарии]] и [[sharixopen:knowledge:processes:start|Процессы]] | | |
| | ''15-ui-regression-xmpp-notifications-mobile-plan.md'', ''46-service-projects-guidance-graph-ui.md'' | [[sharixopen:knowledge:design:start|Дизайн и интерфейсы]]; только публичные фрагменты | | |
| | ''17-repository-operations-and-source-bundles.md'', ''CODING_POLICY.md'' | [[sharixopen:knowledge:development:start|Разработка]] | | |
| | ''migration/implementation-order.md'', ''23-post-stage9-implementation-roadmap.md'' | [[sharixopen:knowledge:roadmap:start|Планы]] | | |
| | ''migration/*implementation-status.md'' | [[sharixopen:knowledge:implementation:start|Реализация]] после проверки актуальных исходников | | |
| | ''12-requirements-permissions-runtime.md'' и инструкции конфигурации | [[sharixopen:knowledge:operations:start|Эксплуатация]], [[sharixopen:knowledge:configuration:start|Настройка]] после очистки закрытых данных | | |
| |
| ===== Поэтапное наполнение ===== | |
| - Извлечь понятия, документы и связи; разнести по категориям. | |
| - Определить ''area'' для **каждого фрагмента**, а не одного большого файла. | |
| - Проверить источники, реализацию и разрешение на публикацию. | |
| - Добавить стабильные страницы без суффиксов версий и связать их с разделами. | |
| - Сформировать отдельные ZIP по областям и отдать на модерацию. | |
| |
| * [[sharixopen:knowledge:standards:bundles|Точный архив]]. | |
| * [[sharixopen:knowledge:glossary:start|Термины]]. | |
| |
| |
| ===== Навигация ===== | |
| * [[sharixopen:knowledge:start|Общий каталог ShariX]]. | |
| * [[sharixopen:knowledge:architecture:start|Архитектура проекта ShariX]]. | |
| * [[sharixopen:knowledge:standards:start|Стандарты базы знаний]]. | |
| |
| ===== Примеры переноса проектной модели в статьи ===== | |
| * [[sharixopen:knowledge:architecture:layers|Архитектурные уровни (по TZ 00)]] | |
| * [[sharixopen:knowledge:architecture:domain_concepts|Концептуальные сущности (TZ 01)]] | |
| * [[sharixopen:knowledge:modules:ownership|Матрица владения модулями (TZ 05/07)]] | |
| * [[sharixopen:knowledge:processes:workflow_example|Описание бизнес-процесса (TZ 04)]] | |
| * [[sharixopen:knowledge:scenarios:service_use_case|Пользовательский сценарий (TZ 04)]] | |
| * [[sharixopen:knowledge:development:repository_flow|Правила разработки (TZ 17)]] | |
| |
| Все шесть статей — **обобщение проектных материалов**, без утверждения, что все элементы введены в эксплуатацию. Фактическое состояние требует отдельной проверки реализации. | |
| |
| ~~NOCACHE~~ | |
| ~~SHARIX_KNOWLEDGE_RELATED~~ | ~~SHARIX_KNOWLEDGE_RELATED~~ |
| |
