ICE-NET/README.md
loki5512344 2e61688eb3
Some checks failed
rust-ci / checks (push) Has been cancelled
Initial import: ICE-NET research docs and Rust workspace (v0.4)
- 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)
2026-11-13 12:28:48 +01:00

73 lines
5.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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).