Some checks failed
rust-ci / checks (push) Has been cancelled
- Rust workspace: 7 library crates, icenetd CLI, icenet-city (Slint GUI) - Sim: fix false Delivered after a route cut, derive traffic class from payload size, per-link airtime slots (link capacity, queueing) - Docs: single docs/STATUS.md for all figures, remove v0.2/egui leftovers, drop unimplemented seed claims, uncheck store-and-forward - License: LGPL-3.0-or-later (LICENSE, LICENSES/GPL-3.0.txt)
73 lines
5.5 KiB
Markdown
73 lines
5.5 KiB
Markdown
# ICE-NET · Research + Rust Workspace · v0.4
|
||
|
||
> **Статус: архитектура + стартовый код для локальных экспериментов.** Не развёрнутый
|
||
> сетевой протокол, не готовая криптосистема и не проверенная RF-симуляция.
|
||
> Срез исследования: **13 ноября 2026 года**. Язык документации: русский;
|
||
> публичные Rust API и технические комментарии — на английском.
|
||
> Актуальные цифры и состояние: [docs/STATUS.md](docs/STATUS.md).
|
||
|
||
> **Вдохновение.** Идея вдохновлена «Сетью» (the Net) из киберпанка — образом
|
||
> глобальной сети поверх разнородных каналов и устройств, которая не принадлежит
|
||
> одной корпорации. Это художественное вдохновение: проект не связан с
|
||
> правообладателями киберпанк-произведений и ничего из них не воспроизводит.
|
||
|
||
Репозиторий: <https://git.wihuk.pro/boba/ICE-NET.git>
|
||
Лицензия: **LGPL-3.0-or-later** — см. [LICENSE](LICENSE) и [LICENSES/](LICENSES/GPL-3.0.txt).
|
||
|
||
ICE-NET — проект независимой сети: идентичность устройства отдельно от транспорта,
|
||
медленные радиоканалы преимущественно для объявления доступности и малых сообщений,
|
||
большие данные — только по подходящим быстрым каналам, при отсутствии пути — очередь.
|
||
|
||
## 🧭 Путь чтения
|
||
|
||
1. [Статус: что проверено и что нет](docs/STATUS.md) и [TODO: план по этапам](TODO.md) — **начни здесь**.
|
||
**[Полный кликабельный индекс всех Markdown-файлов](docs/INDEX.md).**
|
||
2. [Правила разработки и ограничение 250/4](RULES.md).
|
||
3. [Аудит зависимостей](docs/build/dependencies.md) и [лицензия Slint](docs/build/slint_license.md).
|
||
4. [Архитектура](docs/architecture/overview.md) и [граф зависимостей крейтов](docs/architecture/crates.md).
|
||
5. [Интерактивная модель города](docs/simulator/city_editor.md) и [сценарии](docs/simulator/scenarios.md).
|
||
6. [Исследование Reticulum](docs/research/reticulum.md), [Meshtastic](docs/research/meshtastic.md),
|
||
[наш пробел/гипотеза](docs/research/gaps.md), [лицензии](docs/research/licensing.md).
|
||
7. [Руководство Arch Linux](docs/guides/quickstart.md), [команды CI](docs/guides/testing.md).
|
||
8. [Ревизия 0.1 → 0.3](docs/review/revision.md) и [открытые решения](docs/review/questions.md).
|
||
9. [Архив всех исходных Markdown](archive/README.md), [ссылки исследований](docs/SOURCES.md).
|
||
|
||
## Каталоги
|
||
|
||
| Путь | Роль |
|
||
| --- | --- |
|
||
| `workspace/crates/` | библиотеки на Rust без зависимости от GUI |
|
||
| `workspace/apps/icenet-city/` | нативный визуальный городской эмулятор (Slint 1.18.1, software rendering) |
|
||
| `workspace/apps/icenetd/` | CLI (`route`/`send`/`sim`/`policy`/`wire`, UDP `serve`/`send-udp`); daemon позже |
|
||
| `workspace/tools/` | автоматическая проверка структуры 250/4 и тестов |
|
||
| `docs/` | актуальные решения, симулятор, безопасность, исследования |
|
||
| `archive/` | полный исходный исследовательский пакет 0.1, не выброшен |
|
||
|
||
## Минимальный путь без железа
|
||
|
||
```bash
|
||
cd workspace
|
||
python3 tools/check_layout.py
|
||
cargo fmt --all -- --check
|
||
cargo test -p icenet-sim -p icenet-routing
|
||
cargo run -p icenet-city
|
||
```
|
||
|
||
Что именно проверено (тесты, fmt, clippy, замеры) и что **не** проверено — только в
|
||
[docs/STATUS.md](docs/STATUS.md).
|
||
|
||
## Что специально НЕ обещаем
|
||
|
||
- Глобальное покрытие, бесплатные вышки или «высокую скорость по LoRa».
|
||
- Совместимость с Reticulum/Meshtastic на уровне wire-протоколов.
|
||
- Подтверждённую безопасность: исходные криптографические примитивы пока **не реализованы**.
|
||
- Что модель города физически достоверно предсказывает радиопокрытие.
|
||
- Что ICE-NET уже лучше существующих решений: это проверяемая гипотеза.
|
||
|
||
## Зависимости
|
||
|
||
- Core-библиотеки: **0 внешних crates** (7 внутренних крейтов — границы проекта).
|
||
- GUI: `slint` + `slint-build` (build-time), версия и число записей lock — в [STATUS](docs/STATUS.md).
|
||
- `default-features = false` не гарантирует меньше транзитивных зависимостей.
|
||
|
||
Подробности и контрольный список: [dependencies.md](docs/build/dependencies.md).
|