feat: atxpi — server power & console manager (core, CLI, deploy)

- core/hardware: драйверы real (atxctl/pyserial) + mock, ATXPI_DRIVER
- core/power, console, mock: операции питания и RS232-консоли
- cli/atxpi: status/on/off/reset/cycle/console (stdlib, без deps)
- install.sh: one-shot curl|bash, идемпотентный, хост-агностичный
- deploy: systemd-юнит, шаблон env, update.sh
- README, AGENTS.md: документация и проектные решения
- AGENTS.md и доки очищены от внутренних хостов/адресов (публичный репо)

atxpi/deploy/atxpi.env.example

@@ -0,0 +1,18 @@
+# atxpi — пример локальной конфигурации.
+# Реальный файл: /etc/atxpi/atxpi.env (создаётся install.sh, права 0600).
+# Копируй/меняй здесь значения под своё устройство — этот файл НЕ коммитится.
+
+# Драйвер железа: real | mock
+ATXPI_DRIVER=real
+
+# RS232-консоль сервера
+SERIAL_PORT=/dev/ttyUSB0
+SERIAL_BAUD=115200
+
+# Служебный токен для REST-API и браузерного интерфейса (генерируется при установке).
+# Задай свой — длинная случайная строка.
+ATXPI_WEB_TOKEN=change-me
+
+# Куда биндится сервис (host:port). Ограничь VPN/LAN, не оставляй 0.0.0.0 в открытом доступе.
+ATXPI_BIND_HOST=0.0.0.0
+ATXPI_BIND_PORT=8443

atxpi/deploy/systemd/atxpi.service

@@ -0,0 +1,25 @@
+[Unit]
+Description=atxpi — server power & console manager
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=@USER@
+Group=@USER@
+WorkingDirectory=@TARGET@/atxpi
+EnvironmentFile=/etc/atxpi/atxpi.env
+ExecStart=@TARGET@/atxpi/venv/bin/uvicorn atxpi.webui.server:app --host @BIND_HOST@ --port @BIND_PORT@
+Restart=always
+RestartSec=3
+Umask=0077
+# безопасность: не даём раскрывать переменные окружения сервиса
+NoNewPrivileges=true
+ProtectSystem=full
+ProtectHome=true
+PrivateTmp=true
+# доступ к железу: I2C (expander) и ttyUSB0 (консоль)
+ReadWritePaths=/etc/atxpi
+
+[Install]
+WantedBy=multi-user.target

atxpi/deploy/update.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+# atxpi — обновление до последней версии (идемпотентно).
+# Использование: sudo bash /opt/arm/update.sh
+set -euo pipefail
+
+ATXPI_TARGET="${ATXPI_TARGET:-/opt/arm}"
+APP_DIR="$ATXPI_TARGET/atxpi"
+
+log() { echo -e "\e[1;32m[atxpi]\e[0m $*"; }
+
+[ -d "$ATXPI_TARGET/.git" ] || { echo "Нет репозитория в $ATXPI_TARGET — сначала install.sh"; exit 1; }
+
+log "git pull..."
+git -C "$ATXPI_TARGET" pull --ff-only
+
+log "Обновляю зависимости..."
+"$APP_DIR/venv/bin/pip" install -q -r "$APP_DIR/requirements.txt"
+
+log "Перезапускаю сервис..."
+systemctl restart atxpi.service
+
+log "Готово: $(systemctl is-active atxpi.service) $(systemctl show atxpi.service -p ActiveEnterTimestamp --value)"