Initial import: ICE-NET research docs and Rust workspace (v0.4)
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)
This commit is contained in:
Loki 2026-11-13 12:28:48 +01:00
commit 2e61688eb3
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
141 changed files with 13993 additions and 0 deletions

73
README.md Normal file
View file

@ -0,0 +1,73 @@
# 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).