Unicode repair
This commit is contained in:
parent
2b8eff58ac
commit
e264750187
49 changed files with 107 additions and 107 deletions
2
SRV/docs/_build/markdown/api/config/cors.md
vendored
2
SRV/docs/_build/markdown/api/config/cors.md
vendored
|
|
@ -4,7 +4,7 @@
|
|||
|
||||
Модуль инкапсулирует добавление middleware CORSMiddleware со списком
|
||||
разрешённых источников (origins), характерных для локальной разработки и
|
||||
типовых портов фронтенда (например, Vite/React на 5173/5174, dev‑серверы).
|
||||
типовых портов фронтенда (например, Vite/React на 5173/5174, dev-серверы).
|
||||
|
||||
Использование:
|
||||
: cors_config = CORSMiddlewareConfig(app)
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@
|
|||
|
||||
Bases: `object`
|
||||
|
||||
Утилита для безопасного выполнения CLI‑команд.
|
||||
Утилита для безопасного выполнения CLI-команд.
|
||||
|
||||
Назначение:
|
||||
: Инкапсулирует вызов subprocess.run и приводит результат к удобному
|
||||
|
|
|
|||
|
|
@ -4,18 +4,18 @@
|
|||
|
||||
Назначение:
|
||||
|
||||
- Обнаружение активных узлов в пределах сетей хоста путём широковещательных ARP‑запросов от имени выбранного интерфейса.
|
||||
- Обнаружение активных узлов в пределах сетей хоста путём широковещательных ARP-запросов от имени выбранного интерфейса.
|
||||
- Помощь сервисам более высокого уровня (например, IPService) при проверке занятости адресов перед применением конфигураций.
|
||||
|
||||
Особенности реализации:
|
||||
|
||||
- Определяет подключённые сети интерфейса через netifaces и строит CIDR для сканирования.
|
||||
- Формирует ARP‑пакеты с помощью scapy (Ether/ARP) и отправляет их с таймаутом.
|
||||
- Формирует ARP-пакеты с помощью scapy (Ether/ARP) и отправляет их с таймаутом.
|
||||
- Добавляет локальный адрес интерфейса в результирующий список клиентов.
|
||||
|
||||
Требования/ограничения:
|
||||
|
||||
- Для отправки ARP‑кадров могут потребоваться повышенные привилегии или capability на сырой сокет.
|
||||
- Для отправки ARP-кадров могут потребоваться повышенные привилегии или capability на сырой сокет.
|
||||
|
||||
### *class* services.arp_service.NetworkScanner(interface=None, translations: Translations = Depends(translations_dependency))
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# Connect Service
|
||||
|
||||
Сервис управления подключениями Wi‑Fi через nmcli.
|
||||
Сервис управления подключениями Wi-Fi через nmcli.
|
||||
|
||||
Назначение:
|
||||
|
||||
|
|
@ -8,7 +8,7 @@
|
|||
|
||||
Поведение:
|
||||
|
||||
- Автоматически определяет активный Wi‑Fi‑интерфейс.
|
||||
- Автоматически определяет активный Wi-Fi-интерфейс.
|
||||
- Валидирует наличие SSID в листинге перед подключением и интерпретирует частые ошибки nmcli (неверный пароль, отсутствующая сеть и т.п.).
|
||||
|
||||
Ограничения:
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# Firewalld Service
|
||||
|
||||
Сервис для управления firewalld через D‑Bus.
|
||||
Сервис для управления firewalld через D-Bus.
|
||||
|
||||
Назначение:
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# IP Service
|
||||
|
||||
Сервис проверки и применения IP‑настроек через NetworkManager (D‑Bus).
|
||||
Сервис проверки и применения IP-настроек через NetworkManager (D-Bus).
|
||||
|
||||
Назначение:
|
||||
|
||||
|
|
@ -9,7 +9,7 @@
|
|||
|
||||
Требования/ограничения:
|
||||
|
||||
- Доступ к системной шине D‑Bus и права на изменения сетевых профилей.
|
||||
- Доступ к системной шине D-Bus и права на изменения сетевых профилей.
|
||||
- Структура входных данных должна соответствовать схеме ipv4_updates для корректного обновления вложенных полей у профиля.
|
||||
|
||||
### *class* services.ip_service.IPService
|
||||
|
|
|
|||
|
|
@ -1,15 +1,15 @@
|
|||
# Network Service
|
||||
|
||||
Сервис чтения сетевого состояния через NetworkManager (D‑Bus).
|
||||
Сервис чтения сетевого состояния через NetworkManager (D-Bus).
|
||||
|
||||
Назначение:
|
||||
|
||||
- Предоставляет асинхронные методы для сборки унифицированных моделей сетевых интерфейсов (Ethernet/Wi‑Fi), их IP‑конфигураций, а также получения имени хоста. Используется API‑слоем для визуализации и управления.
|
||||
- Предоставляет асинхронные методы для сборки унифицированных моделей сетевых интерфейсов (Ethernet/Wi-Fi), их IP-конфигураций, а также получения имени хоста. Используется API-слоем для визуализации и управления.
|
||||
|
||||
Особенности:
|
||||
|
||||
- Фильтрация loopback и явно неактивных интерфейсов.
|
||||
- Адаптация данных D‑Bus в pydantic‑модели (NetworkInterface, WiFiDevice, NetworkInterfacesContainer).
|
||||
- Адаптация данных D-Bus в pydantic-модели (NetworkInterface, WiFiDevice, NetworkInterfacesContainer).
|
||||
|
||||
### *class* services.network_service.NetworkService(translations: Translations = Depends(translations_dependency))
|
||||
|
||||
|
|
|
|||
|
|
@ -9,7 +9,7 @@ Bases: `object`
|
|||
Источники данных:
|
||||
: - MacLookup: сопоставление префикса MAC (OUI) с названием производителя.
|
||||
- DNS: gethostbyaddr с малым таймаутом для обратного разрешения имени.
|
||||
- NetBIOS (nbtscan): опрос сегмента сети для извлечения NetBIOS‑имён.
|
||||
- NetBIOS (nbtscan): опрос сегмента сети для извлечения NetBIOS-имён.
|
||||
|
||||
Политика кэширования:
|
||||
: - Результаты get_vendor кэшируются с помощью functools.lru_cache.
|
||||
|
|
@ -67,7 +67,7 @@ Bases: `object`
|
|||
|
||||
Политика очистки:
|
||||
|
||||
- Метод \_clean_old_devices удаляет оффлайн‑устройства, не наблюдавшиеся более 7 дней,
|
||||
- Метод \_clean_old_devices удаляет оффлайн-устройства, не наблюдавшиеся более 7 дней,
|
||||
чтобы поддерживать актуальность списка.
|
||||
|
||||
#### get_subnet_file(subnet: str) → Path
|
||||
|
|
@ -116,7 +116,7 @@ Bases: `object`
|
|||
|
||||
Назначение:
|
||||
: Обнаруживает активные устройства в локальной сети, отправляя широковещательные
|
||||
ARP‑запросы по указанной подсети и собирая ответы (IP, MAC).
|
||||
ARP-запросы по указанной подсети и собирая ответы (IP, MAC).
|
||||
|
||||
Детали реализации:
|
||||
: - Использует scapy (Ether + ARP) для генерации пакетов и srp для
|
||||
|
|
@ -152,7 +152,7 @@ Bases: `object`
|
|||
Класс для сканирования открытых портов на устройствах.
|
||||
|
||||
Назначение:
|
||||
: Плейсхолдер для будущего функционала активного сканирования TCP/UDP‑портов
|
||||
: Плейсхолдер для будущего функционала активного сканирования TCP/UDP-портов
|
||||
у обнаруженных узлов. В текущей версии возвращает пустой список.
|
||||
|
||||
План развития:
|
||||
|
|
@ -189,8 +189,8 @@ Bases: `object`
|
|||
: 1. Определение подсети (вручную или авто по интерфейсу).
|
||||
2. Загрузка ранее сохранённых устройств подсети.
|
||||
3. Добавление локального устройства (если принадлежит подсети).
|
||||
4. ARP‑сканирование и параллельная обработка узлов (обогащение данных).
|
||||
5. Маркировка оффлайн‑узлов из кэша, не встреченных в текущем скане.
|
||||
4. ARP-сканирование и параллельная обработка узлов (обогащение данных).
|
||||
5. Маркировка оффлайн-узлов из кэша, не встреченных в текущем скане.
|
||||
6. Сортировка по IP и сохранение объединённого списка в JSON.
|
||||
|
||||
#### add_note(mac: str, note: str, translations: Translations) → Tuple[bool, Tuple[str, Dict] | None]
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@
|
|||
|
||||
Bases: `object`
|
||||
|
||||
Сервис для сканирования текущих Wi‑Fi точек доступа и заметок.
|
||||
Сервис для сканирования текущих Wi-Fi точек доступа и заметок.
|
||||
|
||||
Источники данных:
|
||||
: - pywifi для базового сканирования и получения списка AP.
|
||||
|
|
@ -40,7 +40,7 @@ Bases: `object`
|
|||
|
||||
Bases: `object`
|
||||
|
||||
Класс для хранения данных о Wi‑Fi сетях и их заметках по SSID.
|
||||
Класс для хранения данных о Wi-Fi сетях и их заметках по SSID.
|
||||
|
||||
Формат:
|
||||
: {
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ Bases: `object`
|
|||
где важна минимальная зависимость от внешних сервисов.
|
||||
|
||||
Формат данных:
|
||||
: JSON‑структура вида:
|
||||
: JSON-структура вида:
|
||||
{
|
||||
<br/>
|
||||
> “users”: [
|
||||
|
|
|
|||
|
|
@ -9,7 +9,7 @@ Bases: `object`
|
|||
Назначение:
|
||||
: Лёгкое файловое хранилище для сессионных токенов, сопоставленных с
|
||||
client_id (например, IP клиента). Предназначено для сред без БД и
|
||||
persistent‑кэшей. Обеспечивает базовые операции и авто‑очистку протухших
|
||||
persistent-кэшей. Обеспечивает базовые операции и авто-очистку протухших
|
||||
сессий.
|
||||
|
||||
Формат данных:
|
||||
|
|
|
|||
4
SRV/docs/_build/markdown/api/utils/i18n.md
vendored
4
SRV/docs/_build/markdown/api/utils/i18n.md
vendored
|
|
@ -4,8 +4,8 @@
|
|||
|
||||
Содержимое модуля:
|
||||
: - get_translations(): фабрика зависимости FastAPI, считывающая локаль из
|
||||
query‑параметра locale, cookie locale или заголовка Accept-Language
|
||||
(по приоритету), с дефолтом ru. Возвращает функцию‑зависимость, которая
|
||||
query-параметра locale, cookie locale или заголовка Accept-Language
|
||||
(по приоритету), с дефолтом ru. Возвращает функцию-зависимость, которая
|
||||
подгружает babel.support.Translations из каталога SRV/locales.
|
||||
- \_(): удобная обёртка для получения перевода строки с использованием
|
||||
текущей локали (или дефолтного ru, если контекст запроса не передан).
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue