svsta / agura-alarm · Mos.Hub

.
├── .clinerules/            # Правила и регламент разработки
├── app/                    # Android-приложение (Kotlin, Jetpack Compose)
│   └── src/main/java/com/agura/alarm/   # Исходный код
│       ├── data/           # Слой данных (модели, репозитории, сеть)
│       ├── domain/         # Бизнес-логика (use cases, политики, матчинг, sync)
│       │   └── sync/       # Декомпозиция mergeFeed: чистые решатели (этап P2c)
│       ├── service/        # Фоновые сервисы (WifiListenerService и др.)
│       ├── ui/             # Пользовательский интерфейс (Compose)
│       └── util/           # Утилиты (ConnectionChecker, IpResolver, LogManager и др.)
├── server/                 # Серверная часть (PHP 8.1 REST API, только ленивые скрипты)
│   ├── config/             # Конфигурация (в репо только example, реальный файл — секрет)
│   ├── data/               # Хранилище данных (группы, источники)
│   ├── index.php           # Маршрутизатор REST API и ленивый опрос источников
│   ├── public/             # Точка входа веб-сервера (index.php — прокси)
│   ├── src/                # PHP-модули (vk_gateway, source_gateway, cleanup, …)
│   ├── tests/              # Серверные тесты (запускаются вручную)
│   └── README.md           # Обзор серверной части
├── gateway/                # Python-шлюз MAX (UDP-мост между PHP-сервером и мессенджером MAX)
├── gradle/                 # Обёртка Gradle (wrapper)
├── docs/                   # Документация проекта
│   ├── ARCHITECTURE.md     # Архитектура и бизнес-логика
│   ├── LOCAL_PROTOCOL.md   # Протокол Unicast Mesh
│   ├── API_SPEC.md         # Детальная спецификация REST API
│   ├── TESTING.md          # Инструкции по тестированию
│   ├── TROUBLESHOOTING.md  # Диагностика проблем
│   ├── SECRETS.md          # Работа с секретами и ключами
│   ├── BACKLOG.md          # Бэклог развития
│   ├── manuals/            # Руководства (презентации, пользователь, админ)
│   ├── examples/           # Примеры (channels_example.toml)
│   ├── images/             # Графика (логотип, скриншоты, соц-превью)
│   └── videos/             # Демонстрационное видео
├── LICENSE.md              # Лицензия на ПО (некоммерческое использование)
├── LICENSE-DOCS.md         # Лицензия на документацию (CC BY-NC 4.0)
└── README.md               # Обзор проекта и навигация