v0.5.5
Example document / build (push) Has been cancelled
Python application / build (push) Has been cancelled

Update Promt
Updata to-do
This commit is contained in:
2026-09-19 13:59:55 +03:00
parent 5fb5010571
commit 7fc112e2ce
50 changed files with 3305 additions and 3829 deletions
@@ -0,0 +1,115 @@
# Собственно-научный стиль отчёта по практикам
Справочник для модели: как писать текст отчёта, чтобы он проходил проверку преподавателя по содержанию, а не только `--check` по разметке. Извлечено из типовых замечаний к отчётам ПАЦО / проектным практикам.
---
## 1. Подстиль
Текст отчёта — **собственно-научный подстиль** русского научного стиля (как в отчёте о НИР, ГОСТ 7.32). Это не публицистика, не консультантский слайд и не набор тезисов.
Допустимо: безличные конструкции, термины, факты, ссылки, причинно-следственные формулировки («обусловлено», «определяется», «характеризуется»).
Недопустимо:
| Запрещённый приём | Пример | Как заменить |
|-------------------|--------|--------------|
| Метафора и давление | «ручная проверка давит на маржу» | «трудоёмкость ручной проверки комплектов увеличивает операционные издержки» |
| Разговорный вектор | «социальные факторы тянут к…» | «в социальной среде наблюдается спрос на…» |
| Лозунг с “зато” | «платформа усложняется, зато сведения можно сверять автоматически» | «развитие программных интерфейсов реестров создаёт возможность автоматической сверки сведений» |
| Живая разговорность | «экосистема растёт», «общество тянет массу группы», «нет смысла в отделе» | нейтральная констатация факта |
| Тезисная рубка | «Экономические факторы — спрос. Социальные — Госключ. Технологические — облако.» | связные абзацы, каждый фактор раскрыт предложением |
| Мета про сдачу | «сформирована характеристика объекта» | содержание объекта, а не факт выполнения пункта |
Проверка абзаца: его можно поставить в отчёт о НИР без ощущения статьи или презентации. Если нет — переписать.
«Живой голос» из `voice-human.md` означает конкретику и отсутствие мета-чеклиста модели. Он **не** означает публицистические глаголы и антитезы.
---
## 2. Заголовки пунктов практики
Если задание называет пункт «Характеристика объекта исследования» — заголовок раздела:
```markdown
# 1 Характеристика объекта исследования
```
**Нельзя** писать `# Практическая работа 1 …` и `# Практическая работа №1. …`, если руководитель прямо потребовал убрать слова «Практическая работа» из названия пункта.
Профиль `PIS_custom` в `--check` как раз требует «Практическая работа №N. …». Для отчётов ПАЦО с нумерованными пунктами задания собирай документ как `--type practice` (или `coursework`), а не `PIS_custom`.
---
## 3. Подпункты
Не дроби один пункт задания на искусственные `##` («Юридический статус», «Специфика», «Организационная модель» и т. п.), если преподаватель запретил лишние подразделы.
Один пункт задания = один H1 (или один нумерованный раздел). Смена темы внутри пункта — новый абзац, а не новый заголовок. Рисунок и таблица сами членят текст.
Подразделы `##` оставляй только если их явно требует бланк задания или профиль `--check` (цель / ход / выводы в `PIS_custom`; фиксированные `## 2.1` в АПИД).
---
## 4. Полное наименование, затем сокращение
При **первом** появлении в тексте:
1. полное официальное наименование;
2. затем сокращение или аббревиатура в скобках, при необходимости с «далее —».
```text
Акционерное общество «Производственная фирма «СКБ Контур» (далее — АО «ПФ «СКБ Контур») является акционерным обществом частной формы собственности…
электронный документооборот (ЭДО)
удостоверяющий центр (УЦ)
машиночитаемая доверенность (МЧД)
```
Дальше по тексту — только принятое сокращение. Не начинай документ с аббревиатуры, которую ещё не ввели. Не вводи одно и то же сокращение дважды.
---
## 5. Таблица реквизитов
Реквизиты юридического лица (наименование, ИНН, ОГРН, адрес, директор, капитал) **не оформлять таблицей «Реквизит / Значение»**. Значимые сведения из такой таблицы переносятся в связный абзац.
Таблицу оставляй там, где сравниваются однородные ряды: коды ОКВЭД, динамика показателей по годам, сопоставление конкурентов. Таблица из одной строки данных не нужна.
---
## 6. Ссылки на источники
Несколько источников на одно утверждение — **одной скобкой**:
| Нельзя | Надо |
|--------|------|
| `[1], [2]` | `[1, 2]` |
| `[2], [5]` | `[2, 5]` |
| `[1], [2], [5]` | `[1, 2, 5]` |
| `[6], [7]` | `[6, 7]` |
Одиночная ссылка `[1]` допустима. Форма с страницами: `[2, c. 21-25]`. Во введении и заключении ссылок нет.
---
## 7. Границы пункта задания
Факт относится к тому пункту, которому он принадлежит.
- Характеристика **объекта**: статус, виды деятельности, оргмодель, карта верхнего уровня, макро- и микросреда, масштаб.
- Нельзя в характеристике объекта разворачивать узкое место процесса, параметры оптимизации, «рост заявок упирается в ручную проверку» — это пункт про предмет / процесс (практика 2 и далее).
- В пункте про процесс не повторять заново всю справку об объекте.
---
## 8. Критический разбор до сдачи
На текущем принятом этапе достаточно формальной комплектности. **В последующих практиках** студент до загрузки файла сам разбирает представляемый фрагмент проектного решения:
1. Все ли обязательные артефакты пункта на месте и читаемы.
2. Согласованы ли объект, оргмодель, карта и текст процесса.
3. Нет ли публицистики, лишних подразделов, таблиц-дублей текста.
4. Выдержана ли иерархия на оргсхеме (см. `org-hierarchy.md`).
5. Не попал ли материал не в свой пункт.
Модель, которая готовит следующую практику, проводит этот разбор молча и правит текст **до** выдачи файла. Не вставляй в отчёт фразу «проведён критический анализ».