От текста к архитектуре: освоение VPasCode от Visual Paradigm для Agile-команд

@startuml

class Library {
  - name: String
  - address: String
  - phone: String
  + addMember(member: Member): void
  + removeMember(memberId: String): void
  + addItem(item: LibraryItem): void
  + removeItem(itemId: String): void
  + lendItem(memberId: String, itemId: String): boolean
  + returnItem(itemId: String): boolean
}

class LibraryItem {
  # itemId: String
  # title: String
  # publisher: String
  # publicationYear: int
  # isAvailable: boolean
  + getDetails(): String
  + setAvailability(status: boolean): void
}

abstract class Book {
  - isbn: String
  - author: String
  - pageCount: int
  + getAuthor(): String
}

class EBook {
  - fileSizeMB: double
  - format: String
  - downloadUrl: String
  + download(): void
}

class PrintedBook {
  - shelfLocation: String
  - condition: String
  + getShelfLocation(): String
}

class Magazine {
  - issueNumber: int
  - volumeNumber: int
  - coverDate: Date
}

class DVD {
  - durationMinutes: int
  - director: String
  - language: String
  - subtitlesAvailable: boolean
}

class Member {
  - memberId: String
  - name: String
  - email: String
  - phone: String
  - membershipDate: Date
  + borrowItem(item: LibraryItem): boolean
  + returnItem(item: LibraryItem): boolean
  + getBorrowedItems(): List
}

class BorrowingRecord {
  - recordId: String
  - borrowDate: Date
  - dueDate: Date
  - returnDate: Date
  - isOverdue(): boolean
  - calculateFine(): double
}

class Fine {
  - fineId: String
  - amount: double
  - issueDate: Date
  - isPaid: boolean
  + payFine(): void
}

class Librarian {
  - staffId: String
  - department: String
  + processBorrowing(member: Member, item: LibraryItem): void
  + processReturn(item: LibraryItem): void
  + generateReport(): void
  + manageInventory(): void
}

' Отношения наследования
LibraryItem <|-- Book
LibraryItem <|-- Magazine
LibraryItem <|-- DVD
Book <|-- EBook
Book <|-- PrintedBook 

' Композиция и агрегация 

Library "1" -- "many" Member : имеет >
Library "1" -- "many" LibraryItem : содержит >
Library "1" -- "many" Librarian : нанимает >

Member "1" -- "many" BorrowingRecord : имеет >
BorrowingRecord "1" -- "1..*" LibraryItem : ссылается на >
BorrowingRecord "1" -- "0..*" Fine : генерирует >

' Ассоциация
Librarian --> BorrowingRecord : управляет >
Member --> BorrowingRecord : создает >

note top of Library : Центральная система, управляющаяnучастниками, элементами и выдачей
note right of LibraryItem : Абстрактный базовый классnдля всех библиотечных материалов
@enduml

@startuml
' Заголовок
title Снятие наличных в банкомате - Диаграмма последовательности

' Актеры и участники
actor Клиент как C
participant "Банкомат" как ATM
participant "Банковская система" как BS
database "Счет клиента" как DB

' Последовательность
C -> ATM : Вставить карту
ATM -> ATM : Считать детали карты
ATM -> C : Запросить PIN-код
C -> ATM : Ввести PIN-код
ATM -> BS : Проверить карту и PIN-код
BS -> DB : Проверить учетные данные
DB --> BS : Результат проверки

alt Неверный PIN-код
    BS --> ATM : Неверный PIN-код
    ATM -> C : Неверный PIN-код, попробуйте снова
    note right: После 3 неудачных попытокnкарта удерживается
else Верный PIN-код
    BS --> ATM : Верный PIN-код
    ATM -> C : Показать главное меню
    C -> ATM : Выбрать снятие наличных
    ATM -> C : Запросить сумму
    C -> ATM : Ввести сумму
    ATM -> BS : Проверить баланс и лимит
    BS -> DB : Запросить баланс
    DB --> BS : Текущий баланс
    
    alt Недостаточно средств
        BS --> ATM : Недостаточно средств
        ATM -> C : Транзакция отклоненаn(Показать баланс)
        C -> ATM : Отменить транзакцию
        ATM -> C : Вернуть карту
    else Достаточно средств
        BS --> ATM : Одобрено
        ATM -> ATM : Выдать наличные
        ATM -> C : Выдать наличные
        C -> ATM : Взять наличные
        ATM -> BS : Подтвердить выдачу наличных
        BS -> DB : Списать средства и записать транзакцию
        DB --> BS : Обновление завершено
        BS --> ATM : Транзакция завершена
        ATM -> C : Распечатать чек
        alt Запрошен чек
            C -> ATM : Взять чек
        else Чек не нужен
            C -> ATM : Отказаться от чека
        end
        ATM -> C : Вернуть карту
        C -> ATM : Взять карту
    end
end

ATM -> C : Спасибо / Конец транзакции

@enduml

@startuml InsuranceClaimSystem

start

:Застрахованное лицо подает претензию;
:Претензия регистрируется в системе;

if (Действителен ли полис и активен?) then (да)
  :Назначить претензию страховому урегулировщику;
  :Уведомить урегулировщика о новой претензии;
else (нет)
  :Отправить отказ застрахованному лицу;
  :Записать причину: Полис неактивен/недействителен;
  stop
endif

:Урегулировщик проверяет поданные документы;

if (Все ли необходимые документы представлены?) then (да)
  :Урегулировщик инициирует проверку претензии;
else (нет)
  :Запросить недостающие документы у застрахованного лица;
  :Дождаться дополнительных документов;
  :Повторно проверить документы;
  note right
    Система ожидает
    ответа застрахованного лица
  end note
  -> обратно к «Урегулировщик проверяет поданные документы»;
endif

:Урегулировщик расследует претензию;
:При необходимости связаться со свидетелями/экспертами;
:Оценить сумму ущерба/потерь;

if (Претензия действительна согласно условиям полиса?) then (да)
  :Рассчитать одобренную сумму;
  :Применить франшизу, если применимо;
else (нет)
  :Отправить отказ с указанием причины;
  :Записать решение в системе;
  stop
endif

:Сформировать предложение о урегулировании;
:Отправить предложение о урегулировании застрахованному лицу;

:Застрахованное лицо рассматривает предложение;

if (Принимает ли застрахованное лицо предложение?) then (да)
  :Обработать платеж;
  :Обновить статус претензии на «Урегулировано»;
  :Отправить подтверждение застрахованному лицу;
  :Записать детали закрытия;
else (нет)
  :Передать на разрешение спора;
  :Вести переговоры об урегулировании;
  :Обновить предложение;
  -> обратно к «Отправить предложение о урегулировании застрахованному лицу»;
endif

stop

@enduml

@startuml SmokeDetectionSystem

title Диаграмма состояний - Система обнаружения дыма

[*] --> PowerOff

state PowerOff {
    [*] --> NoPower
    NoPower : Устройство выключено
    NoPower --> PowerOn : Нажата кнопка питания
}

state PowerOn {
    [*] --> Standby
    Standby : Система готова
    Standby --> SelfCheck : Периодическая самопроверка (каждые 24 часа)
    Standby --> Monitoring : Начало мониторинга (датчик активен)
    
    state SelfCheck {
        [*] --> TestingSensors
        TestingSensors --> TestPass : Все датчики в порядке
        TestingSensors --> TestFail : Обнаружена ошибка датчика
        TestPass --> Standby : Возврат в режим ожидания
        TestFail --> ErrorState : Сообщение об ошибке
    }
    
    state Monitoring {
        [*] --> NoSmoke
        NoSmoke : Нормальная работа
        NoSmoke --> SmokeDetected : Уровень дыма > порога
        NoSmoke --> LowBattery : Низкий заряд батареи (беспроводной)
        LowBattery --> NoSmoke : Батарея заменена
        
        state SmokeDetected {
            [*] --> InitialAlert
            InitialAlert --> ConfirmedSmoke : Дым сохраняется > 5 сек
            InitialAlert --> FalseAlarm : Дым исчез < 5 сек FalseAlarm --> NoSmoke : Сброс
            ConfirmedSmoke --> AlarmActive
        }
        
        state AlarmActive {
            [*] --> SoundAlarm : Активация сирены и света
            SoundAlarm --> SendNotification : Уведомление панели управления / приложения
            SendNotification --> WaitForReset
            WaitForReset --> AlarmActive : Дым все еще присутствует
            WaitForReset --> ResetSystem : Нажата кнопка сброса
            ResetSystem --> NoSmoke : Система сбрасывается
        }
    }
}

state ErrorState {
    [*] --> FaultIndicator : Мигание индикатора ошибки
    FaultIndicator --> PowerOff : Требуется ручная перезагрузка
}

PowerOn --> ErrorState : Сбой самопроверки
ErrorState --> PowerOff : Перезагрузка

PowerOff --> [*] : Система отключена / батарея извлечена

@enduml

@startuml CourierSystem

title Система доставки - Диаграмма компонентов

' === Компоненты ===
component "Приложение клиента" as CustomerApp
component "Мобильное приложение курьера" as CourierApp
component "Веб-панель администратора" as AdminWeb

component "API-шлюз" as ApiGateway

component "Сервис заказов" as OrderService
component "Сервис диспетчеризации" as DispatchService
component "Сервис отслеживания" as TrackingService
component "Сервис оплаты" as PaymentService
component "Сервис уведомлений" as NotificationService
component "Сервис пользователей" as UserService

component "Очередь сообщенийn(RabbitMQ/Kafka)" as MessageQueue
component "Кэш Redis" as RedisCache

database "База данных PostgreSQL" as SQLDB
database "MongoDBn(Логи/История отслеживания)" as MongoLogs

' === Интерфейсы / Порты ===
CustomerApp --> ApiGateway : "REST / WebSocket"
CourierApp --> ApiGateway : "REST / WebSocket"
AdminWeb --> ApiGateway : "REST"

ApiGateway --> OrderService
ApiGateway --> TrackingService
ApiGateway --> PaymentService
ApiGateway --> UserService

' === Зависимости сервисов ===
OrderService --> DispatchService : "gRPC / REST"
OrderService --> PaymentService
OrderService --> NotificationService
OrderService --> SQLDB : "JDBC"
OrderService --> RedisCache : "Кэш"

DispatchService --> MessageQueue : "Публикация событий"
DispatchService --> CourierApp : "Push через API-шлюз"
DispatchService --> SQLDB

TrackingService --> MessageQueue : "Подписка на обновления местоположения"
TrackingService --> MongoLogs : "Запись истории отслеживания"
TrackingService --> RedisCache : "Кэш текущего местоположения"

PaymentService --> SQLDB
PaymentService --> NotificationService

NotificationService --> MessageQueue : "Потребление уведомлений"
NotificationService --> CustomerApp : "Push через API-шлюз"

UserService --> SQLDB
UserService --> RedisCache

' === Примечания ===
note right of OrderService
  Обработка создания посылки,
  ценообразования и статуса заказа
end note

note right of DispatchService
  Сопоставление заказов с курьерами,
  оптимизация маршрутов
end note

note bottom of MessageQueue
  Асинхронные события: order_created,
  location_updated,
  delivery_status_changed
end note

@enduml

@startuml
node "AWS Cloud Route53" as DNS

node "VPC (10.0.0.0/16)" {
  node "Публичная подсеть" {
    artifact "Балансировщик нагрузки NGINX" as ALB
  }
  
  node "Кластер частной подсети" {
    node "Экземпляр EC2 1" {
      component "Node.js API [Под 1]" as Pod1
    }
    node "Экземпляр EC2 2" {
      component "Node.js API [Под 2]" as Pod2
    }
  }
  
  node "Подсеть баз данных" {
    database "Amazon RDS (Multi-AZ Aurora)" as Aurora
  }
}

DNS --> ALB : Разрешение трафика
ALB --> Pod1 : Балансировка по кругу
ALB --> Pod2
Pod1 --> Aurora : Пул соединений
Pod2 --> Aurora
@enduml

@startuml Internet Browser Sample
!include <archimate/Archimate>

title Пример Archimate - Интернет-браузер

'LAYOUT_AS_SKETCH()
'LAYOUT_LEFT_RIGHT()
'LAYOUT_TOP_DOWN()

Grouping(business, "Бизнес"){
  Business_Object(businessObject, "Бизнес-объект")
  Business_Process(someBusinessProcess,"Некоторый бизнес-процесс")
  Business_Service(itSupportService, "IT-поддержка для бизнеса (Сервис приложения)")
}

Grouping(application, "Приложение"){
  Application_DataObject(dataObject, "Данные веб-страницы n 'на лету'")
  Application_Function(webpageBehaviour, "Поведение веб-страницы")
  Application_Component(ActivePartWebPage, "Активная часть веб-страницы n 'на лету'")
}

Grouping(technology, "Технологии"){
  Technology_Artifact(inMemoryItem,"в памяти / 'на лету' html/javascript")
  Technology_Service(internetBrowser, "Общий интернет-браузер и плагин")
  Technology_Service(internetBrowserPlugin, "Некоторый плагин интернет-браузера")
  Technology_Service(webServer, "Некоторый веб-сервер")
}


Rel_Flow_Left(someBusinessProcess, businessObject, "")
Rel_Serving_Up(itSupportService, someBusinessProcess, "")
Rel_Specialization_Up(webpageBehaviour, itSupportService, "")
Rel_Flow_Right(dataObject, webpageBehaviour, "")
Rel_Specialization_Up(dataObject, businessObject, "")
Rel_Assignment_Left(ActivePartWebPage, webpageBehaviour, "")
Rel_Specialization_Up(inMemoryItem, dataObject, "")
Rel_Realization_Up(inMemoryItem, ActivePartWebPage, "")
Rel_Specialization_Right(inMemoryItem,internetBrowser, "")
Rel_Serving_Up(internetBrowser, webpageBehaviour, "")
Rel_Serving_Up(internetBrowserPlugin, webpageBehaviour, "")
Rel_Aggregation_Right(internetBrowser, internetBrowserPlugin, "")
Rel_Access_Up(webServer, inMemoryItem, "")
Rel_Serving_Up(webServer, internetBrowser, "")

@enduml

@startuml

entity "Клиент" as customer {
  * customer_id : UUID <>
  --
  * first_name : VARCHAR(50)
  * last_name : VARCHAR(50)
  * email : VARCHAR(100) <>
  * phone : VARCHAR(20)
  * loyalty_points : INT
  * registration_date : TIMESTAMP
}

entity "Фильм" as movie {
  * movie_id : UUID <>
  --
  * title : VARCHAR(200)
  * description : TEXT
  * duration_minutes : INT
  * genre : VARCHAR(50)
  * release_date : DATE
  * rating : VARCHAR(10)
}

entity "Кинотеатр" as theater {
  * theater_id : UUID <>
  --
  * theater_name : VARCHAR(100)
  * total_seats : INT
  * seat_layout : JSON
}

entity "Показ" as show {
  * show_id : UUID <>
  --
  * movie_id : UUID <>
  * theater_id : UUID <>
  * show_time : TIMESTAMP
  * end_time : TIMESTAMP
  * language : VARCHAR(50)
  * subtitle : BOOLEAN
  * price_regular : DECIMAL(10,2)
  * price_vip : DECIMAL(10,2)
}

entity "Место" as seat {
  * seat_id : UUID <>
  --
  * theater_id : UUID <>
  * row_label : CHAR(2)
  * seat_number : INT
  * seat_type : VARCHAR(20)
  * is_accessible : BOOLEAN
}

entity "Бронирование" as booking {
  * booking_id : UUID <>
  --
  * customer_id : UUID <>
  * show_id : UUID <>
  * booking_time : TIMESTAMP
  * total_amount : DECIMAL(10,2)
  * status : VARCHAR(20)
  * payment_method : VARCHAR(30)
  * transaction_id : VARCHAR(100)
}

entity "Бронь места" as booking_seat {
  * booking_id : UUID <<FK,PK>>
  * seat_id : UUID <<FK,PK>>
  --
  * ticket_price : DECIMAL(10,2)
  * discount_applied : DECIMAL(10,2)
}

entity "Оплата" as payment {
  * payment_id : UUID <>
  --
  * booking_id : UUID <>
  * amount : DECIMAL(10,2)
  * payment_date : TIMESTAMP
  * payment_status : VARCHAR(20)
  * payment_gateway : VARCHAR(30)
  * gateway_reference : VARCHAR(200)
}

entity "Отзыв" as review {
  * review_id : UUID <>
  --
  * customer_id : UUID <>
  * movie_id : UUID <>
  * rating : INT
  * comment : TEXT
  * review_date : TIMESTAMP
}

' Отношения
customer ||--o{ booking : "создаёт"
movie ||--o{ show : "расписан как"
theater ||--o{ show : "проводит"
show ||--o{ booking : "имеет"
booking ||--|{ booking_seat : "содержит"
seat ||--o{ booking_seat : "назначен для"
booking ||--|| payment : "имеет"
customer ||--o{ review : "пишет"
movie ||--o{ review : "получает"

note right of booking : Статус: ОЖИДАЕТСЯ, ПОДТВЕРЖДЕНО, ОТМЕНЕНО, ИСТЕКЛО
note left of seat : тип_места: ОБЫЧНОЕ, VIP, ДЛЯ ПАР
note right of payment : статус_оплаты: ОЖИДАЕТСЯ, УСПЕШНО, ОШИБКА, ВОЗВРАЩЕНО

@enduml

flowchart TD
    A[Почувствовали недомогание или нужна медицинская консультация] --> B{Это экстренный случай?}

    B -->|Да| C[Вызовите скорую помощь или обратитесь в приёмное отделение]
    B -->|Нет| D[Запишитесь на приём к врачу]

    D --> E[Посетите приём]
    E --> F[Оценка врача]

    F --> G{Диагноз поставлен?}

    G -->|Да| H[План лечения]
    G -->|Нет| I[Назначьте анализы]

    I --> J[Получите результаты анализов]
    J --> F

    H --> K[Следуйте плану лечения]
    K --> L{Симптомы улучшились?}

    L -->|Да| M[Выздоровление / Плановое наблюдение]
    L -->|Нет| N[Вернитесь к врачу]
    N --> F

graph UndirectedSpanningTree {
    fontname="Helvetica,Arial,sans-serif"
    label="Топология магистральной инфраструктуры сетевой топологии дата-центра в виде сетки"
    labelloc="b"
    fontsize=14
    
    node [fontname="Helvetica,Arial,sans-serif", shape=circle, style=filled, color="#475569", fillcolor="#f1f5f9", width=0.8, fixedsize=true]
    edge [color="#94a3b8", penwidth=2.5]
    
    SwitchAlpha  [label="SW_A", fillcolor="#cbd5e1"]
    SwitchBeta   [label="SW_B", fillcolor="#cbd5e1"]
    Node1        [label="Host_01"]
    Node2        [label="Host_02"]
    Node3        [label="Host_03"]
    Node4        [label="Host_04"]
    
    SwitchAlpha -- SwitchBeta [label=" Магистральный канал", weight=5]
    SwitchAlpha -- Node1
    SwitchAlpha -- Node2
    SwitchBeta -- Node3
    SwitchBeta -- Node4
    Node1 -- Node2 [style=dashed, color="#cbd5e1", label=" Резервное соединение"]
}