From bfaadd556cc3f8a3ebd7b65bd1b3921846f4ad4b Mon Sep 17 00:00:00 2001
From: Ivan Gerasimov <ivandivan2909@gmail.com>
Date: Sun, 27 Sep 2026 23:41:15 +0300
Subject: [PATCH] =?UTF-8?q?lct-51:=20=D0=B3=D0=BE=D0=BB=D0=BE=D1=81=D0=BE?=
 =?UTF-8?q?=D0=B2=D0=BE=D0=B9=20=D0=BC=D0=B0=D1=80=D1=88=D1=80=D1=83=D1=82?=
 =?UTF-8?q?=20=D0=94=D0=94=D0=A1=20=E2=80=94=20=D0=B2=D1=8B=D1=88=D0=B5?=
 =?UTF-8?q?=D1=81=D1=82=D0=BE=D1=8F=D1=89=D0=B8=D0=B9=20=D0=BD=D0=B0=D1=87?=
 =?UTF-8?q?=D0=B0=D0=BB=D1=8C=D0=BD=D0=B8=D0=BA=20=D1=87=D0=B5=D1=80=D0=B5?=
 =?UTF-8?q?=D0=B7=20WebRTC=206103=20=D1=81=20=D0=B7=D0=B0=D0=BF=D0=B8?=
 =?UTF-8?q?=D1=81=D1=8C=D1=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .env.example                           |  1 +
 Makefile                               |  2 +-
 docker-compose.sip.yml                 |  1 +
 frontend/src/features/sip/SipPhone.tsx | 13 ++++++++++++-
 frontend/src/pages/dds/Dds.tsx         |  6 ++++--
 frontend/src/pages/phone/Phone.tsx     | 19 ++++++++++++++++---
 sip/entrypoint.sh                      |  7 +++++--
 sip/extensions.conf                    |  7 ++++---
 sip/pjsip.conf.template                | 19 +++++++++++++++++++
 9 files changed, 63 insertions(+), 12 deletions(-)

diff --git a/.env.example b/.env.example
index 486bd1a..1b64d3b 100644
--- a/.env.example
+++ b/.env.example
@@ -25,6 +25,7 @@ SIP_6002_PASSWORD=
 SIP_6003_PASSWORD=
 SIP_6101_PASSWORD=
 SIP_6102_PASSWORD=
+SIP_6103_PASSWORD=
 # IP/DNS сервера, который WebRTC-клиенты видят в локальной сети. При запуске
 # только на той же машине оставьте 127.0.0.1; RTP-порты должны отображаться 1:1.
 SIP_EXTERNAL_MEDIA_ADDRESS=127.0.0.1
diff --git a/Makefile b/Makefile
index ca17c3b..58e5f4c 100644
--- a/Makefile
+++ b/Makefile
@@ -47,7 +47,7 @@ sip: ## Собрать и поднять локальный Asterisk SIP/VoIP
 offline-sip: ## Поднять SIP из уже собранного образа без сети
 	$(COMPOSE) -f docker-compose.yml -f docker-compose.sip.yml up --pull never --no-build -d sip
 
-sip-credentials: ## Показать локальные пароли софтфонов 6001–6003 и WebRTC 6101–6102
+sip-credentials: ## Показать локальные пароли софтфонов 6001–6003 и WebRTC 6101–6103
 	$(COMPOSE) -f docker-compose.yml -f docker-compose.sip.yml exec -T sip cat /var/lib/lct-sip/credentials.env
 
 sip-test: ## Проверить регистрацию, звонок, RTP и задержку (args="--rtp-host-offset 1000")
diff --git a/docker-compose.sip.yml b/docker-compose.sip.yml
index 25f5160..79d23e6 100644
--- a/docker-compose.sip.yml
+++ b/docker-compose.sip.yml
@@ -9,6 +9,7 @@ services:
       SIP_6003_PASSWORD: ${SIP_6003_PASSWORD:-}
       SIP_6101_PASSWORD: ${SIP_6101_PASSWORD:-}
       SIP_6102_PASSWORD: ${SIP_6102_PASSWORD:-}
+      SIP_6103_PASSWORD: ${SIP_6103_PASSWORD:-}
       SIP_EXTERNAL_MEDIA_ADDRESS: ${SIP_EXTERNAL_MEDIA_ADDRESS:-127.0.0.1}
       SIP_RTP_START: ${SIP_RTP_START:-10000}
       SIP_RTP_END: ${SIP_RTP_END:-10099}
diff --git a/frontend/src/features/sip/SipPhone.tsx b/frontend/src/features/sip/SipPhone.tsx
index 74e506b..4e68a1d 100644
--- a/frontend/src/features/sip/SipPhone.tsx
+++ b/frontend/src/features/sip/SipPhone.tsx
@@ -12,12 +12,19 @@ const LABEL: Record<SipStatus, string> = {
   error: "ошибка",
 };
 
+/** Абонент быстрого набора: пульт ДДС звонит бригаде и начальнику одной кнопкой. */
+export interface SipContact {
+  label: string;
+  number: string;
+}
+
 export function SipPhone({
-  defaultExtension = "6101", defaultTarget = "6102", title = "Локальный SIP/WebRTC",
+  defaultExtension = "6101", defaultTarget = "6102", title = "Локальный SIP/WebRTC", contacts = [],
 }: {
   defaultExtension?: string;
   defaultTarget?: string;
   title?: string;
+  contacts?: SipContact[];
 }) {
   const phone = useSipPhone();
   const [extension, setExtension] = useState(defaultExtension);
@@ -46,6 +53,10 @@ export function SipPhone({
       <label>Номер собеседника<input aria-label="Номер SIP собеседника" inputMode="numeric" value={target}
         disabled={inCall} onChange={(event) => setTarget(event.target.value)} /></label>
       {phone.status === "registered" && <button type="button" onClick={() => phone.dial(target)}>Позвонить</button>}
+      {phone.status === "registered" && contacts.map((contact) => <button type="button" key={contact.number}
+        onClick={() => { setTarget(contact.number); phone.dial(contact.number); }}>
+        Позвонить: {contact.label} · {contact.number}
+      </button>)}
       {phone.status === "incoming" && <button type="button" className="sip-answer" onClick={phone.answer}>Ответить · {phone.peer}</button>}
       {inCall && phone.status !== "incoming" && <span>{phone.peer || target}</span>}
       {inCall && <button type="button" className="sip-hangup" onClick={phone.hangup}>Завершить</button>}
diff --git a/frontend/src/pages/dds/Dds.tsx b/frontend/src/pages/dds/Dds.tsx
index 59267b6..fbe6e47 100644
--- a/frontend/src/pages/dds/Dds.tsx
+++ b/frontend/src/pages/dds/Dds.tsx
@@ -604,9 +604,11 @@ export function Dds() {
     </div><aside className="dds-right">
       {pane === "phone" && <section className="dds-panel dds-phone"><div className="dds-panel-title"><h2>IP-телефон</h2><span>SIP/WebRTC + учебный протокол</span></div>
         <Suspense fallback={<p className="dds-hint">Загружаем IP-телефон…</p>}>
-          <SipPhone defaultExtension="6101" defaultTarget="6102" title="Реальный локальный канал ДДС" />
+          <SipPhone defaultExtension="6101" defaultTarget="6102" title="Реальный локальный канал ДДС"
+            contacts={[{ label: "старший группы", number: "6102" },
+              { label: "вышестоящий начальник", number: "6103" }]} />
         </Suspense>
-        <p className="dds-hint">На втором рабочем месте откройте <a href="/phone" target="_blank" rel="noreferrer">телефон старшего группы</a> и зарегистрируйте 6102. Пароли 6101/6102 выдаёт локальный администратор командой <code>make sip-credentials</code>.</p>
+        <p className="dds-hint">На втором рабочем месте откройте <a href="/phone" target="_blank" rel="noreferrer">телефон старшего группы</a> (6102); преподаватель в роли вышестоящего начальника — <a href="/phone?role=superior" target="_blank" rel="noreferrer">телефон 6103</a>. Пароли 6101–6103 выдаёт локальный администратор командой <code>make sip-credentials</code>.</p>
         <h3 className="dds-protocol-title">Учебный протокол доклада</h3>
         <p className="dds-hint">Связь используется при необходимости. Разговор и учебный доклад сохраняются в журнале, но не блокируют изменение статуса.</p>
         <label htmlFor="dds-crew">Дежурная бригада</label>
diff --git a/frontend/src/pages/phone/Phone.tsx b/frontend/src/pages/phone/Phone.tsx
index bf767b0..cff22a4 100644
--- a/frontend/src/pages/phone/Phone.tsx
+++ b/frontend/src/pages/phone/Phone.tsx
@@ -1,9 +1,22 @@
 import { SipPhone } from "@/features/sip/SipPhone";
 
+// Второе рабочее место голосовой связи ДДС. Старший группы — по умолчанию;
+// вышестоящего начальника (?role=superior) играет преподаватель: это
+// обязательный маршрут по ответу заказчика (П.7).
+const ROLES = {
+  crew: { title: "Телефон старшего группы", extension: "6102", heading: "IP-телефон старшего группы" },
+  superior: { title: "Телефон вышестоящего начальника", extension: "6103", heading: "IP-телефон вышестоящего начальника" },
+} as const;
+
 export function Phone() {
+  const role = new URLSearchParams(window.location.search).get("role") === "superior" ? "superior" : "crew";
+  const { title, extension, heading } = ROLES[role];
   return <main className="page phone-page">
-    <h1>IP-телефон старшего группы</h1>
-    <p>Откройте этот экран на втором рабочем месте, зарегистрируйте номер 6102 и примите вызов ДДС 6101.</p>
-    <SipPhone defaultExtension="6102" defaultTarget="6101" title="Телефон старшего группы" />
+    <h1>{heading}</h1>
+    <p>Откройте этот экран на втором рабочем месте, зарегистрируйте номер {extension} и примите вызов ДДС 6101.</p>
+    <SipPhone key={role} defaultExtension={extension} defaultTarget="6101" title={title} />
+    <p className="ref">{role === "crew"
+      ? <>Роль вышестоящего начальника — <a href="/phone?role=superior">телефон 6103</a>.</>
+      : <>Роль старшего группы — <a href="/phone">телефон 6102</a>.</>}</p>
   </main>;
 }
diff --git a/sip/entrypoint.sh b/sip/entrypoint.sh
index b5bcfca..32ab598 100644
--- a/sip/entrypoint.sh
+++ b/sip/entrypoint.sh
@@ -10,6 +10,7 @@ override_6002=${SIP_6002_PASSWORD:-}
 override_6003=${SIP_6003_PASSWORD:-}
 override_6101=${SIP_6101_PASSWORD:-}
 override_6102=${SIP_6102_PASSWORD:-}
+override_6103=${SIP_6103_PASSWORD:-}
 if [ -s "$credentials" ]; then
     # Файл содержит только сгенерированные hex-значения без shell-конструкций.
     . "$credentials"
@@ -19,6 +20,7 @@ SIP_6002_PASSWORD=${override_6002:-${SIP_6002_PASSWORD:-$(openssl rand -hex 16)}
 SIP_6003_PASSWORD=${override_6003:-${SIP_6003_PASSWORD:-$(openssl rand -hex 16)}}
 SIP_6101_PASSWORD=${override_6101:-${SIP_6101_PASSWORD:-$(openssl rand -hex 16)}}
 SIP_6102_PASSWORD=${override_6102:-${SIP_6102_PASSWORD:-$(openssl rand -hex 16)}}
+SIP_6103_PASSWORD=${override_6103:-${SIP_6103_PASSWORD:-$(openssl rand -hex 16)}}
 SIP_EXTERNAL_MEDIA_ADDRESS=${SIP_EXTERNAL_MEDIA_ADDRESS:-127.0.0.1}
 SIP_RTP_START=${SIP_RTP_START:-10000}
 SIP_RTP_END=${SIP_RTP_END:-10099}
@@ -36,12 +38,13 @@ SIP_6002_PASSWORD=$SIP_6002_PASSWORD
 SIP_6003_PASSWORD=$SIP_6003_PASSWORD
 SIP_6101_PASSWORD=$SIP_6101_PASSWORD
 SIP_6102_PASSWORD=$SIP_6102_PASSWORD
+SIP_6103_PASSWORD=$SIP_6103_PASSWORD
 EOF
 chmod 600 "$credentials"
 
-export SIP_6001_PASSWORD SIP_6002_PASSWORD SIP_6003_PASSWORD SIP_6101_PASSWORD SIP_6102_PASSWORD SIP_EXTERNAL_MEDIA_ADDRESS
+export SIP_6001_PASSWORD SIP_6002_PASSWORD SIP_6003_PASSWORD SIP_6101_PASSWORD SIP_6102_PASSWORD SIP_6103_PASSWORD SIP_EXTERNAL_MEDIA_ADDRESS
 export SIP_RTP_START SIP_RTP_END
-envsubst '${SIP_6001_PASSWORD} ${SIP_6002_PASSWORD} ${SIP_6003_PASSWORD} ${SIP_6101_PASSWORD} ${SIP_6102_PASSWORD} ${SIP_EXTERNAL_MEDIA_ADDRESS}' \
+envsubst '${SIP_6001_PASSWORD} ${SIP_6002_PASSWORD} ${SIP_6003_PASSWORD} ${SIP_6101_PASSWORD} ${SIP_6102_PASSWORD} ${SIP_6103_PASSWORD} ${SIP_EXTERNAL_MEDIA_ADDRESS}' \
     < /opt/lct-sip/pjsip.conf.template > /etc/asterisk/pjsip.conf
 chmod 640 /etc/asterisk/pjsip.conf
 chown root:asterisk /etc/asterisk/pjsip.conf
diff --git a/sip/extensions.conf b/sip/extensions.conf
index 1d68ff5..0c2373c 100644
--- a/sip/extensions.conf
+++ b/sip/extensions.conf
@@ -12,9 +12,10 @@ exten => _600[1-3],1,NoOp(LCT training call ${CALLERID(num)} -> ${EXTEN})
  same => n,StopMixMonitor()
  same => n,Hangup()
 
-; 6101/6102 — браузерные WebRTC-абоненты. Тот же учебный контекст и запись,
-; но отдельные endpoints не ломают обычные UDP/TCP-софтфоны 6001–6003.
-exten => _610[1-2],1,NoOp(LCT WebRTC training call ${CALLERID(num)} -> ${EXTEN})
+; 6101–6103 — браузерные WebRTC-абоненты: ДДС, старший группы, вышестоящий
+; начальник. Тот же учебный контекст и запись, но отдельные endpoints не ломают
+; обычные UDP/TCP-софтфоны 6001–6003.
+exten => _610[1-3],1,NoOp(LCT WebRTC training call ${CALLERID(num)} -> ${EXTEN})
  same => n,Set(RECORDING_FILE=${STRFTIME(${EPOCH},UTC,%Y%m%d-%H%M%S)}-${CALLERID(num)}-${EXTEN}-${UNIQUEID})
  same => n,MixMonitor(/recordings/${RECORDING_FILE}.wav,b)
  same => n,Dial(PJSIP/${EXTEN},30)
diff --git a/sip/pjsip.conf.template b/sip/pjsip.conf.template
index b75f5f0..6bd35df 100644
--- a/sip/pjsip.conf.template
+++ b/sip/pjsip.conf.template
@@ -157,3 +157,22 @@ type=aor
 max_contacts=2
 remove_existing=yes
 qualify_frequency=0
+
+; Вышестоящий начальник ДДС: роль играет преподаватель со страницы
+; /phone?role=superior. Обязательный голосовой маршрут по ответу заказчика (П.7).
+[6103](webrtc-endpoint)
+auth=6103-auth
+aors=6103
+callerid=Веб вышестоящий начальник <6103>
+
+[6103-auth]
+type=auth
+auth_type=userpass
+username=6103
+password=${SIP_6103_PASSWORD}
+
+[6103]
+type=aor
+max_contacts=2
+remove_existing=yes
+qualify_frequency=0