Skip to content

Web documentation v0.1#99

Open
Nick-Mur wants to merge 35 commits intoaimclub:mainfrom
Nick-Mur:docs/v3
Open

Web documentation v0.1#99
Nick-Mur wants to merge 35 commits intoaimclub:mainfrom
Nick-Mur:docs/v3

Conversation

@Nick-Mur
Copy link
Copy Markdown

No description provided.

Comment thread docs/source/guidebook/advanced.md Outdated
Comment thread docs/source/guidebook/advanced.md Outdated
* **SS (Start–Start)**: `S(B) ≥ S(A) + лаг`.
* **FF (Finish–Finish)**: `F(B) ≥ F(A) + лаг`.
* **IFS (Inseparable Finish–Start)**: неразрывная FS — B сразу после A без разрывов; узлы образуют слитную цепочку.
* **FFS (LagFinishStart)**: поточная связь; потомок стартует после выполнения предком части объёма, равной лагу.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

поточная связь?

Comment thread docs/source/guidebook/advanced.md Outdated

* **Лаг** — сдвиг ограничения:

* Для FS/SS/FF — числовой сдвиг во времени (обычно `0`). Знак: `>0` — задержка, `<0` — «лид».
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ничего не понятно...

Comment thread docs/source/guidebook/advanced.md Outdated
* **Лаг** — сдвиг ограничения:

* Для FS/SS/FF — числовой сдвиг во времени (обычно `0`). Знак: `>0` — задержка, `<0` — «лид».
* Для FFS — лаг в единицах объёма предка (например, км). Движок делит работу на стадии; старт потомка — после стадии
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

В данном случае должен быть приведён пример, так как понятие лага для планировщика - часть понятия связи.

Лаг - это "длина связи". В случае с FS лаг - минимальная временная задержка между финишем родителя и стартом потомка. Например, если мы имеем родителя с финишем x, то ограничение на минимальное время старта потомка, накладываемое данной FS связью, будет равно x + lag.

В FFS написано вроде бы нормально... но только если знаешь, о чем говоришь. Тут нужна картинка и детальное пояснение того, какой физический (в реальном проекте) смысл данной связи и как работает реструктуризация FFS.

Comment thread docs/source/guidebook/advanced.md Outdated

> «Что за задача и что ей нужно».

* **WorkerReq** — требование к ресурсу: `kind`, `min_count`, `max_count`, `volume` (норма для расчёта длительности).
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Не пояснены поля

Comment thread docs/source/guidebook/intro.md Outdated
* **Сложные ограничения и ресурсы**
— учёт предшествования и альтернативных маршрутов, параллельных/альтернативных ресурсов, сменных календарей,
навыков/квалификаций (skills), окон доступности, ограничений мощностей, переналадок/переконфигураций и логистических
задержек.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Это вообще... без комментариев

Comment thread docs/source/guidebook/intro.md Outdated
— пересчёт расписания при изменении входных данных (WorkGraph, ресурсы Contractor, дедлайны, веса критериев) за счёт
модульного SchedulingPipeline (пайплайн построен из независимых, заменяемых шагов) и настраиваемых оценщиков
времени/ресурсов. Поддерживается автоматическое перепланирование «на лету» при задержках, сбоях, изменении ресурсов,
приоритетов или поступлении новых работ.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

убрать

Comment thread docs/source/guidebook/intro.md Outdated
— устойчив к крупным графам (порядка **2 000–10 000** работ) при поиске качественных решений.

* **Адаптация под домен**
— возможность подключать свои парсеры, модели оценки времени/ресурсов, критерии качества и политики диспетчеризации.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Свои парсеры подключать нельзя. Строго говоря, у нас всего три парсера - для графа, для подрядчиков и для истории планирования. И у них фиксированный формат.

Comment thread docs/source/guidebook/intro.md Outdated
- *HEFT/HEFTBetween* — жадные эвристики *Heterogeneous Earliest Finish Time*, минимизирующие время завершения.

> HEFT/HEFTBetween — метод планирования, который идёт по задачам и назначает каждую туда, где она закончится
быстрее всего, учитывая зависимости и разную скорость ресурсов.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Продублировано описание HEFT/HEFTBetween

Comment thread docs/source/guidebook/quickstart.md Outdated
.finish()[0])

print(f"Project duration: {project.schedule.execution_time}")
```
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Очень жаль, но этот пример не заработает. В графе 6 типов ресурсов, а у подрядчика - всего один.

@StannisMod StannisMod self-requested a review October 6, 2025 06:19
@StannisMod StannisMod changed the title Веб руководство по SAMPO Web documentation v0.1 Oct 6, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants