Fix: дубли контактов при параллельных AmoCdrDaemon, CSS leak виджета, устаревшие ссылки

- bin/safe.php: flock для предотвращения параллельного запуска воркеров из cron
- bin/AmoCdrDaemon.php: flock на cdrSync — только один процесс обрабатывает CDR
- bin/AmoCdrDaemon.php: повторная проверка БД перед createContacts (race condition)
- widget/css/semantic.css: заменён полный Fomantic UI (74k строк) на минимальный
  скоупленный CSS под #miko (342 строки) — устранена утечка стилей на кнопки AmoCRM
- Обновлена ссылка на документацию wiki.mikopbx.ru → docs.mikopbx.com

Author: Alexey Portnov

bin/AmoCdrDaemon.php

@@ -277,6 +277,32 @@ private function updateActiveCalls():void
      * @return void
      */
     private function cdrSync():void
+    {
+        // Защита от параллельной обработки CDR двумя экземплярами AmoCdrDaemon
+        $lockFile = '/tmp/amo_cdr_sync.lock';
+        $lockFp = fopen($lockFile, 'w');
+        if ($lockFp === false) {
+            $this->logger->writeError('cdrSync: failed to open lock file');
+            return;
+        }
+        if (!flock($lockFp, LOCK_EX | LOCK_NB)) {
+            $this->logger->writeInfo('cdrSync is locked by another process, skip this iteration');
+            fclose($lockFp);
+            return;
+        }
+        try {
+            $this->cdrSyncInternal();
+        } finally {
+            flock($lockFp, LOCK_UN);
+            fclose($lockFp);
+        }
+    }
+
+    /**
+     * Внутренняя логика синхронизации CDR (защищена file lock в cdrSync).
+     * @return void
+     */
+    private function cdrSyncInternal():void
     {
         $oldOffset = $this->offset;
         $this->cdrRows = [];
@@ -1188,6 +1214,50 @@ private function createContacts(&$calls):void
         if(empty($this->newContacts)){
             return;
         }
+
+        // Повторная проверка БД: контакт мог быть создан другим процессом между
+        // prepareDataCreatingEntities() и этим моментом
+        $phonesToCheck = array_keys($this->newContacts);
+        $freshData = ConnectorDb::invoke('getContactsData', [$phonesToCheck]);
+        if (is_array($freshData)) {
+            foreach ($freshData as $phoneId => $data) {
+                if (!empty($data['contactId'])) {
+                    $this->logger->writeInfo("Contact already exists for $phoneId (id:{$data['contactId']}), skip create");
+                    $contactId = intval($data['contactId']);
+                    // Привязываем существующий контакт к связанным сущностям
+                    if (isset($this->newLeads[$phoneId])) {
+                        $this->newLeads[$phoneId]['_embedded']['contacts'][] = [
+                            'id' => $contactId,
+                            'is_main' => true
+                        ];
+                    }
+                    if (isset($this->newUnsorted[$phoneId])) {
+                        $this->newUnsorted[$phoneId]['_embedded']['contacts'][] = [
+                            'id' => $contactId,
+                        ];
+                    }
+                    if (isset($this->newTasks[$phoneId])) {
+                        $this->newTasks[$phoneId]['entity_id'] = $contactId;
+                        $this->newTasks[$phoneId]['entity_type'] = 'contact';
+                    }
+                    if (isset($this->incompleteAnswered[$phoneId])) {
+                        $this->incompleteAnswered[$phoneId]['client'] = $contactId;
+                    }
+                    if (isset($calls[$phoneId])) {
+                        foreach ($calls[$phoneId] as &$call) {
+                            $call['entity_id'] = $contactId;
+                        }
+                        unset($call);
+                    }
+                    unset($this->newContacts[$phoneId]);
+                }
+            }
+        }
+
+        if(empty($this->newContacts)){
+            return;
+        }
+
         $contactsData = [
             'add' => []
         ];

bin/safe.php

@@ -29,6 +29,18 @@
 if(!$moduleEnable){
     exit(1);
 }
+
+// Защита от параллельного запуска нескольких экземпляров safe.php (cron race condition)
+$lockFile = '/tmp/amo_safe.lock';
+$lockFp = fopen($lockFile, 'w');
+if ($lockFp === false || !flock($lockFp, LOCK_EX | LOCK_NB)) {
+    // Другой экземпляр safe.php уже работает
+    if ($lockFp !== false) {
+        fclose($lockFp);
+    }
+    exit(0);
+}
+
 $conf = new AmoCrmConf();
 $workers = $conf->getModuleWorkers();
 foreach ($workers as $workerData) {
@@ -67,3 +79,6 @@
         }
     }
 }
+
+flock($lockFp, LOCK_UN);
+fclose($lockFp);

sites/other/widget-desc.html

@@ -32,7 +32,7 @@
             <li>Вызов абонента АТС двойным кликом в панели управления вызовами</li>
             <li>Пропущенные вызовы попадают в неразобранное</li>
         </ul>
-        <a href="https://wiki.mikopbx.ru/module-amo-crm">Инструкции по настройке</a>
+        <a href="https://docs.mikopbx.com/mikopbx/modules/miko/amocrm">Инструкции по настройке</a>
     </div>
 </article>