avm/state-corp-backend

Fork 0

Files

Aleksandr Meshchriakov 8ed3e1175c

CI/CD Pipeline / Code Quality Checks (push) Failing after 5m5s

Details

CI/CD Pipeline / Run Tests (push) Failing after 5m5s

Details

CI/CD Pipeline / Build Docker Images (push) Has been skipped

Details

CI/CD Pipeline / Push to Gitea Registry (push) Has been skipped

Details

CI/CD Pipeline / Deploy to Server (push) Has been skipped

Details

Add initial implementations for forms and organization apps with serializers, factories, and admin configurations

2026-02-17 09:26:08 +01:00

137 KiB

Raw Permalink Blame History

ТЕХНИЧЕСКОЕ ОПИСАНИЕ ПРОГРАММНОГО КОМПЛЕКСА УЧЁТА И ОБРАБОТКИ ОТЧЁТНЫХ ФОРМ ГОСКОРПОРАЦИЙ (STATE CORP BACKEND)

Версия документа: 1.0
Статус: Утверждённая редакция
Дата разработки: 09.02.2026

Настоящее техническое описание устанавливает назначение, состав, структуру, программно‑технологические решения и правила эксплуатации программного комплекса State Corp Backend, а также требования к форматам входных данных. Документ предназначен для заказчика, эксплуатирующих подразделений и команд сопровождения.

СОДЕРЖАНИЕ

Общие сведения о программном обеспечении
Описание программной реализации моделей информационного обмена и сбора данных
Программно-технологические решения по систематизации и обработке данных
Структура базы данных
Архитектура программного интерфейса (API)
Механизмы обеспечения надёжности и отказоустойчивости
Порядок развёртывания и испытаний
Заключение
Приложение А (обязательное). Форматы входных Excel-шаблонов
Приложение Б (рекомендуемое). Примеры входных файлов
Приложение В (справочное). Справочник показателей

1. ОБЩИЕ СВЕДЕНИЯ О ПРОГРАММНОМ ОБЕСПЕЧЕНИИ

1.1. Назначение системы

Программный комплекс State Corp Backend предназначен для централизованного приёма, валидации, систематизации и хранения отчётных данных, предоставляемых предприятиями в рамках форм Ф‑1…Ф‑6. Система обеспечивает полный цикл работы с данными: от загрузки исходных файлов Excel до предоставления унифицированного API для дальнейшей аналитики и интеграции с внешними контурами.

Ключевая особенность решения — ориентация на достоверность и воспроизводимость результата. Каждый пакет данных получает идентификатор загрузки (load_batch), что позволяет однозначно прослеживать происхождение и последовательность изменений, формировать регистры контроля, проводить сверку и повторные выгрузки при необходимости.

Система рассчитана на эксплуатацию в корпоративном и ведомственном контуре. Реализованы стандартизированные механизмы журналирования, фоновой обработки, контроля целостности и унифицированной выдачи ошибок, а также предусмотрены инструменты мониторинга (health‑check, readiness/liveness probes), необходимые для промышленной эксплуатации и оркестрации.

1.2. Используемый технологический стек

Разработка выполнена на базе устойчивого и зрелого стека, обеспечивающего надёжность, масштабируемость и соответствие требованиям безопасности и сопровождения:

Компонент	Версия	Назначение
Операционная система	Astra Linux 1.8 / Linux x86_64	Целевой контур эксплуатации и сопровождения
Язык программирования	Python 3.11.2	Основной язык серверной логики
Веб-фреймворк	Django 3.2.25	ORM, маршрутизация, управление приложением
REST API	Django REST Framework 3.14.0	Реализация REST интерфейса
СУБД	PostgreSQL 15.10	Реляционное хранение и транзакционность
Очередь задач	Celery 5.3.6	Асинхронная обработка больших загрузок
Брокер / кэш	Redis 7.x	Хранилище задач и кеширование
Веб-сервер	Apache 2.4.57	Обслуживание HTTP/HTTPS трафика
WSGI	Gunicorn 21.2.0	Исполнение Python‑приложения
Документация API	drf-yasg 1.21.10	Swagger/OpenAPI спецификация
Excel‑парсинг	openpyxl 3.1.5	Потоковое чтение Excel (.xlsx)

Выбор компонентов обусловлен их стабильностью, широким использованием в промышленной эксплуатации и высокой готовностью к сопровождению в корпоративных контурах.

1.3. Библиотеки для обработки и валидации данных

Библиотека / модуль	Версия	Назначение
openpyxl	3.1.5	Потоковый парсинг Excel, чтение больших файлов
pandas	2.0.3	Аналитические преобразования (по необходимости)
django-filter	23.5	Стандартизованная фильтрация в API
djangorestframework-simplejwt	5.3.1	JWT‑аутентификация
django-redis	5.4.0	Кэш и синхронизация фоновых задач
celery / django-celery-results	5.3.6 / 2.5.1	Управление задачами и хранение результатов
drf-yasg	1.21.10	Генерация OpenAPI и Swagger UI

1.4. Термины и сокращения

Термин	Определение
Форма Ф‑1…Ф‑6	Утверждённые отчётные формы предприятий
`load_batch`	Идентификатор пакета загрузки данных
Парсер	Программный модуль обработки Excel‑файла
TrackedTask	Базовый класс Celery‑задач с отслеживанием прогресса
BackgroundJob	Модель статусов фоновых задач

2. ОПИСАНИЕ ПРОГРАММНОЙ РЕАЛИЗАЦИИ МОДЕЛЕЙ ИНФОРМАЦИОННОГО ОБМЕНА И СБОРА ДАННЫХ

2.1. Архитектура подсистемы загрузки и парсинга

Подсистема загрузки данных построена по модульному принципу. Для каждой формы отчётности предусмотрен отдельный парсер, использующий общий базовый механизм BaseExcelParser. Такой подход обеспечивает единый стандарт обработки данных, снижает стоимость сопровождения и позволяет расширять систему новыми формами без пересмотра архитектуры.

Общий поток обработки:

Пользователь загружает Excel‑файл через API.
Для небольших файлов выполняется синхронная обработка, для крупных файлов — постановка задачи в очередь Celery.
Базовый парсер читает Excel в потоковом режиме (read_only=True).
Выполняется построчная валидация и нормализация полей (ИНН, ОГРН, КПП, ОКПО).
Создаются или обновляются справочные записи организаций.
Формируется набор записей формы с привязкой к load_batch.

Фрагмент базового парсера, демонстрирующий ключевую механику обработки:

class BaseExcelParser(ABC, Generic[T]):
    def parse(self, file: UploadedFile | BytesIO) -> ParseResult:
        batch_id = self.get_next_batch_id()
        result = ParseResult(batch_id=batch_id)

        try:
            self._load_workbook(file)
            self._column_mappings = self.get_column_mappings()

            for row_num in range(self.DATA_START_ROW, self._sheet.max_row + 1):
                row_data = self._parse_row(row_num)

                if row_data is None:
                    continue

                errors = self._validate_row(row_data)
                if errors:
                    result.errors.append(
                        RowValidationError(
                            row=row_num,
                            inn=row_data.inn,
                            kpp=row_data.kpp,
                            organization_name=row_data.organization_name,
                            errors=errors,
                        )
                    )
                    result.skipped_count += 1
                    continue

                try:
                    self.create_record(row_data, batch_id)
                    result.loaded_count += 1
                except Exception as e:
                    logger.exception(f"Ошибка создания записи для строки {row_num}")
                    result.errors.append(
                        RowValidationError(
                            row=row_num,
                            inn=row_data.inn,
                            kpp=row_data.kpp,
                            organization_name=row_data.organization_name,
                            errors=[FieldError(field="__all__", message=str(e))],
                        )
                    )
                    result.skipped_count += 1
        finally:
            if self._workbook:
                self._workbook.close()

        return result

2.2. Алгоритмы загрузки данных по ключевым формам

2.2.1. Форма Ф‑1 (выпуск продукции)

Форма Ф‑1 содержит производственные показатели: объёмы военной и гражданской продукции, НИОКР, кадровые показатели. Маппинг колонок задаётся декларативно и соответствует утверждённому шаблону Excel.

class FormF1Parser(BaseExcelParser[FormF1Record]):
    def get_column_mappings(self) -> list[ColumnMapping]:
        return [
            ColumnMapping(4, "Выпуск военной продукции (факт.)", "military_output_actual", field_type="decimal"),
            ColumnMapping(5, "Военная на внутренний рынок (факт.)", "military_domestic_actual", field_type="decimal"),
            ColumnMapping(6, "Военная на экспорт (факт.)", "military_export_actual", field_type="decimal"),
            ColumnMapping(7, "Выпуск гражданской продукции (факт.)", "civilian_output_actual", field_type="decimal"),
            ColumnMapping(8, "Гражданская на внутренний рынок (факт.)", "civilian_domestic_actual", field_type="decimal"),
            ColumnMapping(9, "Гражданская на экспорт (факт.)", "civilian_export_actual", field_type="decimal"),
            ColumnMapping(10, "Высокотехнологичная продукция (факт.)", "hightech_output_actual", field_type="decimal"),
            ColumnMapping(11, "Высокотехнологичная на внутренний рынок (факт.)", "hightech_domestic_actual", field_type="decimal"),
            ColumnMapping(12, "Высокотехнологичная на экспорт (факт.)", "hightech_export_actual", field_type="decimal"),
            ColumnMapping(13, "Объём НИОКР (факт.)", "rd_volume_actual", field_type="decimal"),
            ColumnMapping(14, "НИОКР в интересах обороны (факт.)", "rd_defense_actual", field_type="decimal"),
        ]

2.2.2. Форма Ф‑2 (бухгалтерский баланс)

Форма Ф‑2 — наиболее объёмная по структуре. Для крупных файлов применяется фоновая обработка, исключающая тайм‑ауты на стороне клиента.

@shared_task(bind=True, base=TrackedTask)
def process_form_f2_file(self, file_content: bytes, file_name: str) -> dict:
    from io import BytesIO

    file_io = BytesIO(file_content)
    parser = FormF2Parser()
    result = parser.parse(file_io)

    return result.to_dict()

2.2.3. Формы Ф‑5 и Ф‑6 (оборудование)

Формы Ф‑5 и Ф‑6 ориентированы на детальную и агрегированную инвентаризацию оборудования. В системе предусмотрены типы полей bool, date, decimal, что обеспечивает корректную интерпретацию признаков и дат ввода в эксплуатацию.

2.3. Механизмы контроля качества и безопасной загрузки

2.3.1. Валидация ключевых идентификаторов

Стандартные проверки реализованы на уровне базового парсера и исключают попадание некорректных идентификаторов в БД:

def validate_inn(value: str | None) -> tuple[bool, str]:
    if not value:
        return False, "ИНН обязателен"

    cleaned = re.sub(r"\D", "", str(value))

    if len(cleaned) not in (10, 12):
        return False, f"ИНН должен содержать 10 или 12 цифр, получено {len(cleaned)}"

    return True, ""

2.3.2. Идентификация пакетов и прослеживаемость

Каждая загрузка формирует уникальный load_batch. Это позволяет вести историю, сравнивать данные по периодам, быстро изолировать ошибочный пакет и выполнять повторную обработку.

2.3.3. Фоновая обработка и контроль прогресса

Для тяжёлых файлов используется TrackedTask, автоматически создающий записи BackgroundJob и позволяющий пользователю получать прогресс в API:

class TrackedTask(TimedTask):
    def before_start(self, task_id, args, kwargs):
        super().before_start(task_id, args, kwargs)
        from apps.core.services import BackgroundJobService

        user_id = kwargs.get("user_id")
        BackgroundJobService.create_job(
            task_id=task_id,
            task_name=self.name,
            user_id=user_id,
            meta={"args": str(args)[:500], "kwargs": str(kwargs)[:500]},
        )

        job = BackgroundJobService.get_by_task_id(task_id)
        job.mark_started()

3. ПРОГРАММНО-ТЕХНОЛОГИЧЕСКИЕ РЕШЕНИЯ ПО СИСТЕМАТИЗАЦИИ И ОБРАБОТКЕ ДАННЫХ

3.1. Слой хранения данных (База данных)

3.1.1. СУБД PostgreSQL

В качестве центра хранения используется PostgreSQL 15.10. Выбор обусловлен следующими факторами:

поддержка ACID‑транзакций и строгой целостности данных;
эффективная индексация и масштабируемость при росте объёма отчётных записей;
возможности резервного копирования и репликации;
подтверждённая стабильность в промышленной эксплуатации.

3.1.2. Проектирование моделей данных и миксины

Слой моделей построен вокруг набора типовых миксинов (apps.core.mixins), которые стандартизируют общие поля и поведение. Это обеспечивает единый формат аудита и упрощает поддержку.

class TimestampMixin(models.Model):
    created_at = models.DateTimeField(
        _("создано"),
        auto_now_add=True,
        db_index=True,
        help_text=_("Дата и время создания записи"),
    )
    updated_at = models.DateTimeField(
        _("обновлено"),
        auto_now=True,
        help_text=_("Дата и время последнего обновления"),
    )

    class Meta:
        abstract = True

3.2. Сервисный слой и бизнес-логика

Сервисный слой реализует унифицированный интерфейс CRUD и массовых операций. Это позволяет централизовать бизнес‑правила и переиспользовать их в API и фоновых задачах.

class BaseService(Generic[M]):
    model: type[M]

    @classmethod
    def get_queryset(cls) -> QuerySet[M]:
        return cls.model.objects.all()

    @classmethod
    @transaction.atomic
    def create(cls, **kwargs: Any) -> M:
        return cls.model.objects.create(**kwargs)

    @classmethod
    @transaction.atomic
    def update(cls, instance: M, **kwargs: Any) -> M:
        for field, value in kwargs.items():
            setattr(instance, field, value)
        update_fields = set(kwargs.keys())
        if hasattr(instance, "updated_at"):
            update_fields.add("updated_at")
        instance.save(update_fields=list(update_fields))
        return instance

Дополнительно реализован миксин массовых операций для оптимизации загрузки больших массивов данных:

class BulkOperationsMixin:
    @classmethod
    @transaction.atomic
    def bulk_create_chunked(
        cls,
        instances: list,
        *,
        chunk_size: int = 500,
        ignore_conflicts: bool = False,
        update_conflicts: bool = False,
        update_fields: list[str] | None = None,
        unique_fields: list[str] | None = None,
    ) -> int:
        total_created = 0
        for i in range(0, len(instances), chunk_size):
            chunk = instances[i : i + chunk_size]
            created = cls.model.objects.bulk_create(chunk, ignore_conflicts=ignore_conflicts)
            total_created += len(created)
        return total_created

4. СТРУКТУРА БАЗЫ ДАННЫХ

4.1. Общие сведения о схеме данных

База данных формируется по нормализованной схеме, где справочник организаций вынесен в отдельную сущность, а все формы отчётности используют внешнюю связь. Такая структура обеспечивает консистентность, минимизирует дублирование и упрощает ведение справочной информации.

4.1.1. Перечень таблиц базы данных

№	Имя таблицы	Назначение	Источник данных	Примерный объём
1	`organization_organization`	Справочник организаций	Все формы	десятки тысяч
2	`form_1_formf1record`	Ф‑1: выпуск продукции	Excel‑формы	десятки тысяч
3	`form_2_formf2record`	Ф‑2: бухгалтерский баланс	Excel‑формы	десятки тысяч
4	`form_3_formf3record`	Ф‑3: кадры и оборудование	Excel‑формы	десятки тысяч
5	`form_4_formf4record`	Ф‑4: сводные финансы	Excel‑формы	десятки тысяч
6	`form_5_formf5record`	Ф‑5: инвентаризация оборудования	Excel‑формы	сотни тысяч
7	`form_6_formf6record`	Ф‑6: возрастная структура	Excel‑формы	десятки тысяч
8	`core_backgroundjob`	Статусы фоновых задач	Системные	тысячи
9	`users`	Учётные записи пользователей	Системные	сотни
10	`profiles`	Профили пользователей	Системные	сотни

4.1.2. Общие правила именования

Элемент	Конвенция	Пример
Таблицы	`{app_label}_{model}`	`form_2_formf2record`
Первичные ключи	`id` типа UUID	`id UUID PRIMARY KEY`
Внешние ключи	`{entity}_id`	`organization_id`
Временные метки	`created_at`, `updated_at`	`created_at TIMESTAMP WITH TIME ZONE`
Индексы	`{table}_{fields}_idx`	`form_1_form_organiz_f99cbd_idx`

4.1.3. Типовые поля

Поле	Тип	Описание
`id`	UUID	Уникальный идентификатор записи
`created_at`	TIMESTAMP	Дата и время создания
`updated_at`	TIMESTAMP	Дата и время обновления
`load_batch`	INTEGER	Идентификатор пакета загрузки
`organization_id`	UUID	Ссылка на организацию

4.2. Таблица `organization_organization`

Назначение: централизованный справочник организаций. Используется всеми формами отчётности и исключает дублирование данных.

Источник данных: формы Ф‑1…Ф‑6 (автоматическое создание/обновление по ИНН).

4.2.1. Полный перечень полей

Поле	Тип	Ограничения	Описание
`id`	UUID	PK	Уникальный идентификатор
`name`	VARCHAR(500)	NOT NULL, INDEX	Наименование организации
`inn`	VARCHAR(12)	UNIQUE, INDEX	ИНН
`ogrn`	VARCHAR(15)	INDEX	ОГРН
`kpp`	VARCHAR(9)	—	КПП
`okpo`	VARCHAR(20)	—	ОКПО
`created_at`	TIMESTAMP	INDEX	Дата создания
`updated_at`	TIMESTAMP	—	Дата обновления

4.2.2. Модель (фрагмент кода)

class Organization(TimestampMixin, models.Model):
    id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
    name = models.CharField(max_length=500, db_index=True)
    inn = models.CharField(max_length=12, unique=True, db_index=True)
    ogrn = models.CharField(max_length=15, db_index=True, blank=True, default="")
    kpp = models.CharField(max_length=9, blank=True, default="")
    okpo = models.CharField(max_length=20, blank=True, default="")

4.3. Таблица `form_1_formf1record`

Назначение: хранение показателей формы Ф‑1 (выпуск продукции, НИОКР, кадры).

4.3.1. Полный перечень полей

Поле	Тип	Описание
`id`	UUID	Уникальный идентификатор записи
`organization_id`	UUID (FK)	Организация
`load_batch`	INTEGER	Пакет загрузки
`military_output_actual`	DECIMAL(20,2)	Выпуск военной продукции (факт. цены)
`military_domestic_actual`	DECIMAL(20,2)	Военная продукция на внутренний рынок (факт.)
`military_export_actual`	DECIMAL(20,2)	Военная продукция на экспорт (факт.)
`civilian_output_actual`	DECIMAL(20,2)	Выпуск гражданской продукции (факт. цены)
`civilian_domestic_actual`	DECIMAL(20,2)	Гражданская продукция на внутренний рынок (факт.)
`civilian_export_actual`	DECIMAL(20,2)	Гражданская продукция на экспорт (факт.)
`hightech_output_actual`	DECIMAL(20,2)	Высокотехнологичная продукция (факт. цены)
`hightech_domestic_actual`	DECIMAL(20,2)	Высокотехнологичная продукция на внутренний рынок (факт.)
`hightech_export_actual`	DECIMAL(20,2)	Высокотехнологичная продукция на экспорт (факт.)
`rd_volume_actual`	DECIMAL(20,2)	Объём НИОКР (факт. цены)
`rd_defense_actual`	DECIMAL(20,2)	НИОКР в интересах обороны (факт.)
`military_output_fixed`	DECIMAL(20,2)	Выпуск военной продукции (фикс. цены)
`military_domestic_fixed`	DECIMAL(20,2)	Военная продукция на внутренний рынок (фикс.)
`military_export_fixed`	DECIMAL(20,2)	Военная продукция на экспорт (фикс.)
`civilian_output_fixed`	DECIMAL(20,2)	Выпуск гражданской продукции (фикс. цены)
`civilian_domestic_fixed`	DECIMAL(20,2)	Гражданская продукция на внутренний рынок (фикс.)
`civilian_export_fixed`	DECIMAL(20,2)	Гражданская продукция на экспорт (фикс.)
`hightech_output_fixed`	DECIMAL(20,2)	Высокотехнологичная продукция (фикс. цены)
`hightech_domestic_fixed`	DECIMAL(20,2)	Высокотехнологичная продукция на внутренний рынок (фикс.)
`hightech_export_fixed`	DECIMAL(20,2)	Высокотехнологичная продукция на экспорт (фикс.)
`rd_volume_fixed`	DECIMAL(20,2)	Объём НИОКР (фикс. цены)
`rd_defense_fixed`	DECIMAL(20,2)	НИОКР в интересах обороны (фикс.)
`avg_employees`	DECIMAL(12,2)	Средняя численность работников
`avg_payroll_employees`	DECIMAL(12,2)	Среднесписочная численность работников
`payroll_fund`	DECIMAL(20,2)	Фонд начисленной заработной платы
`salary_arrears`	DECIMAL(20,2)	Просроченная задолженность по зарплате
`created_at`	TIMESTAMP	Дата и время создания
`updated_at`	TIMESTAMP	Дата и время обновления

4.4. Таблица `form_2_formf2record`

Назначение: бухгалтерский баланс, финансовые результаты и производные показатели.

4.4.1. Полный перечень полей

Поле	Тип	Описание
`id`	UUID	Уникальный идентификатор записи
`organization_id`	UUID (FK)	Организация
`load_batch`	INTEGER	Пакет загрузки
`intangible_assets`	DECIMAL(20,2)	Нематериальные активы
`rd_results`	DECIMAL(20,2)	Результаты исследований и разработок
`intangible_search_assets`	DECIMAL(20,2)	Нематериальные поисковые активы
`tangible_search_assets`	DECIMAL(20,2)	Материальные поисковые активы
`fixed_assets`	DECIMAL(20,2)	Основные средства
`profitable_investments`	DECIMAL(20,2)	Доходные вложения в материальные ценности
`financial_investments_non_current`	DECIMAL(20,2)	Финансовые вложения (внеоборотные)
`deferred_tax_assets`	DECIMAL(20,2)	Отложенные налоговые активы
`other_non_current_assets`	DECIMAL(20,2)	Прочие внеоборотные активы
`total_non_current_assets`	DECIMAL(20,2)	Итого внеоборотные активы
`inventories`	DECIMAL(20,2)	Запасы
`vat_on_acquired_assets`	DECIMAL(20,2)	НДС по приобретённым ценностям
`receivables`	DECIMAL(20,2)	Дебиторская задолженность
`financial_investments_current`	DECIMAL(20,2)	Финансовые вложения (оборотные)
`cash_and_equivalents`	DECIMAL(20,2)	Денежные средства и эквиваленты
`other_current_assets`	DECIMAL(20,2)	Прочие оборотные активы
`total_current_assets`	DECIMAL(20,2)	Итого оборотные активы
`total_assets`	DECIMAL(20,2)	Баланс (актив)
`authorized_capital`	DECIMAL(20,2)	Уставный капитал
`own_shares_bought_back`	DECIMAL(20,2)	Собственные акции, выкупленные у акционеров
`revaluation_of_non_current_assets`	DECIMAL(20,2)	Переоценка внеоборотных активов
`additional_capital`	DECIMAL(20,2)	Добавочный капитал
`reserve_capital`	DECIMAL(20,2)	Резервный капитал
`retained_earnings`	DECIMAL(20,2)	Нераспределённая прибыль
`total_equity`	DECIMAL(20,2)	Итого капитал и резервы
`borrowings_non_current`	DECIMAL(20,2)	Заёмные средства (долгосрочные)
`deferred_tax_liabilities`	DECIMAL(20,2)	Отложенные налоговые обязательства
`estimated_liabilities_non_current`	DECIMAL(20,2)	Оценочные обязательства (долгосрочные)
`other_liabilities_non_current`	DECIMAL(20,2)	Прочие обязательства (долгосрочные)
`total_non_current_liabilities`	DECIMAL(20,2)	Итого долгосрочные обязательства
`borrowings_current`	DECIMAL(20,2)	Заёмные средства (краткосрочные)
`payables`	DECIMAL(20,2)	Кредиторская задолженность
`deferred_income`	DECIMAL(20,2)	Доходы будущих периодов
`estimated_liabilities_current`	DECIMAL(20,2)	Оценочные обязательства (краткосрочные)
`other_liabilities_current`	DECIMAL(20,2)	Прочие обязательства (краткосрочные)
`total_current_liabilities`	DECIMAL(20,2)	Итого краткосрочные обязательства
`total_liabilities`	DECIMAL(20,2)	Баланс (пассив)
`revenue`	DECIMAL(20,2)	Выручка
`cost_of_sales`	DECIMAL(20,2)	Себестоимость продаж
`gross_profit`	DECIMAL(20,2)	Валовая прибыль
`selling_expenses`	DECIMAL(20,2)	Коммерческие расходы
`administrative_expenses`	DECIMAL(20,2)	Управленческие расходы
`profit_from_sales`	DECIMAL(20,2)	Прибыль от продаж
`interest_receivable`	DECIMAL(20,2)	Проценты к получению
`interest_payable`	DECIMAL(20,2)	Проценты к уплате
`other_income`	DECIMAL(20,2)	Прочие доходы
`other_expenses`	DECIMAL(20,2)	Прочие расходы
`profit_before_tax`	DECIMAL(20,2)	Прибыль до налогообложения
`income_tax`	DECIMAL(20,2)	Текущий налог на прибыль
`net_profit`	DECIMAL(20,2)	Чистая прибыль
`ebitda`	DECIMAL(20,2)	EBITDA
`depreciation`	DECIMAL(20,2)	Амортизация
`working_capital`	DECIMAL(20,2)	Оборотный капитал
`net_debt`	DECIMAL(20,2)	Чистый долг
`total_assets_prev`	DECIMAL(20,2)	Баланс (актив) — прошлый период
`total_liabilities_prev`	DECIMAL(20,2)	Баланс (пассив) — прошлый период
`revenue_prev`	DECIMAL(20,2)	Выручка — прошлый период
`net_profit_prev`	DECIMAL(20,2)	Чистая прибыль — прошлый период
`created_at`	TIMESTAMP	Дата и время создания
`updated_at`	TIMESTAMP	Дата и время обновления

4.5. Таблица `form_3_formf3record`

Назначение: кадровые показатели и оборудование по категориям.

4.5.1. Полный перечень полей

Поле	Тип	Описание
`id`	UUID	Уникальный идентификатор записи
`organization_id`	UUID (FK)	Организация
`load_batch`	INTEGER	Пакет загрузки
`avg_employees`	DECIMAL(12,2)	Средняя численность работников
`production_workers`	DECIMAL(12,2)	Производственный персонал
`engineering_workers`	DECIMAL(12,2)	Инженерно‑технические работники
`administrative_workers`	DECIMAL(12,2)	Административный персонал
`total_equipment`	INTEGER	Всего оборудования
`domestic_equipment`	INTEGER	Отечественное оборудование
`imported_equipment`	INTEGER	Импортное оборудование
`equipment_age_under_5`	INTEGER	Оборудование до 5 лет
`equipment_age_5_10`	INTEGER	Оборудование 5‑10 лет
`equipment_age_10_15`	INTEGER	Оборудование 10‑15 лет
`equipment_age_15_20`	INTEGER	Оборудование 15‑20 лет
`equipment_age_over_20`	INTEGER	Оборудование свыше 20 лет
`physical_wear_percent`	DECIMAL(5,2)	Физический износ, %
`utilization_rate`	DECIMAL(5,2)	Коэффициент загрузки
`avg_shift_work`	DECIMAL(5,2)	Средняя сменность работы
`equipment_needed`	INTEGER	Потребность в оборудовании
`workers_needed`	INTEGER	Потребность в кадрах
`created_at`	TIMESTAMP	Дата и время создания
`updated_at`	TIMESTAMP	Дата и время обновления

4.6. Таблица `form_4_formf4record`

Назначение: агрегированные финансовые показатели (РСБУ/МСФО, EBITDA, долговая нагрузка).

4.6.1. Полный перечень полей

Поле	Тип	Описание
`id`	UUID	Уникальный идентификатор записи
`organization_id`	UUID (FK)	Организация
`load_batch`	INTEGER	Пакет загрузки
`revenue_rsbu`	DECIMAL(20,2)	Выручка (РСБУ)
`revenue_ifrs`	DECIMAL(20,2)	Выручка (МСФО)
`revenue_prev_rsbu`	DECIMAL(20,2)	Выручка прошлого года (РСБУ)
`revenue_prev_ifrs`	DECIMAL(20,2)	Выручка прошлого года (МСФО)
`net_profit_rsbu`	DECIMAL(20,2)	Чистая прибыль (РСБУ)
`net_profit_ifrs`	DECIMAL(20,2)	Чистая прибыль (МСФО)
`gross_profit_rsbu`	DECIMAL(20,2)	Валовая прибыль (РСБУ)
`operating_profit_rsbu`	DECIMAL(20,2)	Операционная прибыль (РСБУ)
`ebitda_rsbu`	DECIMAL(20,2)	EBITDA (РСБУ)
`ebitda_ifrs`	DECIMAL(20,2)	EBITDA (МСФО)
`loans_rsbu`	DECIMAL(20,2)	Кредиты и займы (РСБУ)
`loans_ifrs`	DECIMAL(20,2)	Кредиты и займы (МСФО)
`net_debt_rsbu`	DECIMAL(20,2)	Чистый долг (РСБУ)
`net_debt_ifrs`	DECIMAL(20,2)	Чистый долг (МСФО)
`debt_to_ebitda`	DECIMAL(10,2)	Долг/EBITDA
`total_assets_rsbu`	DECIMAL(20,2)	Активы (РСБУ)
`total_assets_ifrs`	DECIMAL(20,2)	Активы (МСФО)
`equity_rsbu`	DECIMAL(20,2)	Собственный капитал (РСБУ)
`equity_ifrs`	DECIMAL(20,2)	Собственный капитал (МСФО)
`roe`	DECIMAL(10,2)	Рентабельность собственного капитала (ROE)
`roa`	DECIMAL(10,2)	Рентабельность активов (ROA)
`ros`	DECIMAL(10,2)	Рентабельность продаж (ROS)
`capex`	DECIMAL(20,2)	Капитальные затраты (CAPEX)
`rd_expenses`	DECIMAL(20,2)	Затраты на НИОКР
`dividends_paid`	DECIMAL(20,2)	Выплаченные дивиденды
`dividend_yield`	DECIMAL(10,2)	Дивидендная доходность
`created_at`	TIMESTAMP	Дата и время создания
`updated_at`	TIMESTAMP	Дата и время обновления

4.7. Таблица `form_5_formf5record`

Назначение: детальная инвентаризация оборудования по каждой единице.

4.7.1. Полный перечень полей

Поле	Тип	Описание
`id`	UUID	Уникальный идентификатор записи
`organization_id`	UUID (FK)	Организация
`load_batch`	INTEGER	Пакет загрузки
`equipment_id`	VARCHAR(50)	Идентификационный код
`inventory_number`	VARCHAR(50)	Инвентарный номер
`name`	VARCHAR(500)	Наименование оборудования
`model`	VARCHAR(200)	Модель
`manufacturer`	VARCHAR(300)	Производитель
`country_origin`	VARCHAR(100)	Страна происхождения
`is_domestic`	BOOLEAN	Отечественное производство
`year_manufacture`	INTEGER	Год выпуска
`has_cnc`	BOOLEAN	Наличие ЧПУ
`equipment_type`	VARCHAR(200)	Тип оборудования
`equipment_category`	VARCHAR(200)	Категория оборудования
`commissioning_date`	DATE	Дата ввода в эксплуатацию
`location`	VARCHAR(300)	Местонахождение
`production_site`	VARCHAR(200)	Производственный участок
`utilization_rate`	DECIMAL(5,2)	Коэффициент использования
`physical_wear_percent`	DECIMAL(5,2)	Фактический износ, %
`is_operational`	BOOLEAN	В рабочем состоянии
`requires_repair`	BOOLEAN	Требует ремонта
`requires_replacement`	BOOLEAN	Требует замены
`initial_cost`	DECIMAL(20,2)	Первоначальная стоимость
`residual_value`	DECIMAL(20,2)	Остаточная стоимость
`notes`	TEXT	Примечания
`created_at`	TIMESTAMP	Дата и время создания
`updated_at`	TIMESTAMP	Дата и время обновления

4.8. Таблица `form_6_formf6record`

Назначение: сводная возрастная структура оборудования по категориям.

4.8.1. Полный перечень полей

Поле	Тип	Описание
`id`	UUID	Уникальный идентификатор записи
`organization_id`	UUID (FK)	Организация
`load_batch`	INTEGER	Пакет загрузки
`row_code`	VARCHAR(20)	Код строки
`category`	VARCHAR(200)	Категория оборудования
`total_equipment`	INTEGER	Всего оборудования
`domestic_equipment`	INTEGER	Отечественное оборудование
`imported_equipment`	INTEGER	Импортное оборудование
`age_under_5`	INTEGER	До 5 лет
`age_5_10`	INTEGER	5‑10 лет
`age_10_15`	INTEGER	10‑15 лет
`age_15_20`	INTEGER	15‑20 лет
`age_over_20`	INTEGER	Свыше 20 лет
`cnc_total`	INTEGER	С ЧПУ всего
`cnc_under_5`	INTEGER	С ЧПУ до 5 лет
`cnc_5_10`	INTEGER	С ЧПУ 5‑10 лет
`cnc_10_15`	INTEGER	С ЧПУ 10‑15 лет
`cnc_15_20`	INTEGER	С ЧПУ 15‑20 лет
`cnc_over_20`	INTEGER	С ЧПУ свыше 20 лет
`avg_shift_work`	DECIMAL(5,2)	Средняя сменность работы
`utilization_rate`	DECIMAL(5,2)	Коэффициент загрузки
`physical_wear_percent`	DECIMAL(5,2)	Физический износ, %
`workplaces_without_equipment`	INTEGER	Рабочие места без оборудования
`equipment_to_replace`	INTEGER	Оборудование к замене
`created_at`	TIMESTAMP	Дата и время создания
`updated_at`	TIMESTAMP	Дата и время обновления

4.9. Таблица `core_backgroundjob`

Назначение: контроль выполнения фоновых задач и прогресса обработки больших файлов.

4.9.1. Полный перечень полей

Поле	Тип	Описание
`id`	UUID	Уникальный идентификатор задачи
`task_id`	VARCHAR(255)	Идентификатор задачи Celery
`task_name`	VARCHAR(255)	Полное имя задачи
`status`	VARCHAR(20)	Статус выполнения
`progress`	INTEGER	Прогресс в процентах
`progress_message`	VARCHAR(500)	Сообщение о прогрессе
`result`	JSON	Результат выполнения
`error`	TEXT	Текст ошибки
`traceback`	TEXT	Traceback ошибки
`started_at`	TIMESTAMP	Время начала
`completed_at`	TIMESTAMP	Время завершения
`user_id`	INTEGER	Пользователь (опционально)
`meta`	JSON	Дополнительные метаданные
`created_at`	TIMESTAMP	Дата и время создания
`updated_at`	TIMESTAMP	Дата и время обновления

4.10. Таблица `users`

Назначение: учётные записи пользователей системы (аутентификация, авторизация, доступ в админ‑интерфейс и API).

4.10.1. Полный перечень полей

Поле	Тип	Описание
`id`	BIGINT	Уникальный идентификатор пользователя
`password`	VARCHAR(128)	Хэш пароля
`last_login`	TIMESTAMP	Дата и время последнего входа
`is_superuser`	BOOLEAN	Признак суперпользователя
`username`	VARCHAR(150)	Имя пользователя (логин)
`is_staff`	BOOLEAN	Доступ в админ‑интерфейс
`is_active`	BOOLEAN	Активность учётной записи
`date_joined`	TIMESTAMP	Дата регистрации
`email`	VARCHAR(254)	Email пользователя (уникальный)
`phone`	VARCHAR(20)	Телефон (международный формат)
`is_verified`	BOOLEAN	Признак подтверждения email
`created_at`	TIMESTAMP	Дата и время создания
`updated_at`	TIMESTAMP	Дата и время обновления

Примечание: связи с группами и разрешениями реализуются через промежуточные таблицы, автоматически создаваемые Django ORM.

4.11. Таблица `profiles`

Назначение: расширенные профильные данные пользователя (ФИО, био, аватар, дата рождения).

4.11.1. Полный перечень полей

Поле	Тип	Описание
`id`	BIGINT	Уникальный идентификатор профиля
`user_id`	BIGINT (FK)	Ссылка на пользователя
`first_name`	VARCHAR(50)	Имя
`last_name`	VARCHAR(50)	Фамилия
`bio`	TEXT	Описание / биография
`avatar`	VARCHAR(100)	Путь к файлу аватара
`date_of_birth`	DATE	Дата рождения
`created_at`	TIMESTAMP	Дата и время создания
`updated_at`	TIMESTAMP	Дата и время обновления

4.12. Диаграмма связей между таблицами

erDiagram
    ORGANIZATION ||--o{ FORM_F1_RECORD : "organization_id"
    ORGANIZATION ||--o{ FORM_F2_RECORD : "organization_id"
    ORGANIZATION ||--o{ FORM_F3_RECORD : "organization_id"
    ORGANIZATION ||--o{ FORM_F4_RECORD : "organization_id"
    ORGANIZATION ||--o{ FORM_F5_RECORD : "organization_id"
    ORGANIZATION ||--o{ FORM_F6_RECORD : "organization_id"
    USERS ||--|| PROFILES : "user_id"
    USERS ||..o{ CORE_BACKGROUNDJOB : "user_id (опц.)"

5. АРХИТЕКТУРА ПРОГРАММНОГО ИНТЕРФЕЙСА (API)

5.1. Общие сведения

API реализован на базе Django REST Framework и соответствует REST‑подходу. Все запросы и ответы используют JSON, кодировка UTF‑8. Версионирование задано в URL‑пути.

Базовый URL: https://{hostname}/api/v1/
Документация: Swagger UI доступна на корневом URL (/).

5.1.1. Принципы взаимодействия

ресурсы представлены как коллекции и отдельные сущности;
используется стандартный набор HTTP‑методов (GET/POST/PUT/PATCH/DELETE);
ответы унифицированы, включая пагинацию и ошибки;
все изменения данных фиксируются на уровне модели через поля created_at/updated_at.

5.1.2. Формат запросов

Обязательные заголовки:

Authorization: Bearer <access_token>
Content-Type: application/json
Accept: application/json

Параметры пагинации (по умолчанию):

Параметр	Тип	По умолчанию	Описание
`page`	integer	1	Номер страницы
`page_size`	integer	20	Количество записей (1–100)

5.1.3. Формат ответов

Успешные ответы возвращаются в едином формате:

{
  "success": true,
  "data": [
    {"id": "...", "field": "value"}
  ],
  "errors": null,
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_count": 100,
      "total_pages": 5,
      "has_next": true,
      "has_previous": false
    }
  }
}

5.2. Аутентификация и авторизация

Система использует JWT (SimpleJWT). Параметры безопасности:

Access Token — 60 минут.
Refresh Token — 7 дней.
Ротация refresh‑токена включена.
Алгоритм подписи HS256.

Фрагмент модели пользователя:

class User(AbstractUser):
    first_name = None
    last_name = None

    email = models.EmailField(unique=True)
    phone = models.CharField(max_length=20, blank=True, null=True)
    is_verified = models.BooleanField(default=False)

    USERNAME_FIELD = "email"
    REQUIRED_FIELDS = ["username"]

Модель профиля:

class Profile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE, related_name="profile")
    first_name = models.CharField(max_length=50, blank=True, null=True)
    last_name = models.CharField(max_length=50, blank=True, null=True)
    bio = models.TextField(blank=True, null=True)
    avatar = models.ImageField(upload_to="avatars/", blank=True, null=True)

5.3. Структура API

Группа	Базовый путь	Назначение
Пользователи	`/api/v1/users/`	регистрация, авторизация, профиль
Организации	`/api/v1/organizations/`	справочник организаций
Формы	`/api/v1/forms/f1/` … `/api/v1/forms/f6/`	отчётные формы
Задачи	`/api/v1/jobs/`	мониторинг фоновых задач
Health	`/health/`	мониторинг доступности

5.4. API пользователей и профилей

Регистрация: POST /api/v1/users/register/
Вход: POST /api/v1/users/login/
Обновление токена: POST /api/v1/users/token/refresh/
Профиль: GET /api/v1/users/profile/

5.5. API организаций

Список: GET /api/v1/organizations/
Детали: GET /api/v1/organizations/{id}/

Фильтры: name, inn, ogrn.

5.6. API формы Ф‑1

Загрузка: POST /api/v1/forms/f1/upload/
Список записей: GET /api/v1/forms/f1/records/
Детали: GET /api/v1/forms/f1/records/{id}/

Для крупных файлов выполняется фоновая обработка с возвратом task_id.

5.7. API формы Ф‑2

Загрузка: POST /api/v1/forms/f2/upload/
Список записей: GET /api/v1/forms/f2/records/
Детали: GET /api/v1/forms/f2/records/{id}/

Поддерживается фильтр batch_id для выборки по пакету загрузки.

5.8. API формы Ф‑3

Загрузка: POST /api/v1/forms/f3/upload/
Список записей: GET /api/v1/forms/f3/records/
Детали: GET /api/v1/forms/f3/records/{id}/

5.9. API формы Ф‑4

Загрузка: POST /api/v1/forms/f4/upload/
Список записей: GET /api/v1/forms/f4/records/
Детали: GET /api/v1/forms/f4/records/{id}/

5.10. API формы Ф‑5 и Ф‑6

Форма Ф‑5:

POST /api/v1/forms/f5/upload/
GET /api/v1/forms/f5/records/

Форма Ф‑6:

POST /api/v1/forms/f6/upload/
GET /api/v1/forms/f6/records/

5.11. Коды ответов HTTP и формат ошибок

Единый формат ошибок реализован через custom_exception_handler:

{
  "success": false,
  "data": null,
  "errors": [
    {
      "code": "validation_error",
      "message": "Validation failed",
      "details": {
        "fields": {
          "inn": ["ИНН обязателен"]
        }
      }
    }
  ],
  "meta": {
    "request_id": "3f6d4a3a-2c5f-4a0a-a0d6-4d3b78f7c60a"
  }
}

Типовые коды HTTP:

Код	Описание
200	Успешный запрос
201	Ресурс создан
202	Задача принята в очередь
400	Ошибка валидации
401	Неавторизован
403	Недостаточно прав
404	Ресурс не найден
500	Внутренняя ошибка

6. МЕХАНИЗМЫ ОБЕСПЕЧЕНИЯ НАДЁЖНОСТИ И ОТКАЗОУСТОЙЧИВОСТИ

6.1. Система фоновых задач (BackgroundJobs)

Асинхронная обработка крупных файлов исключает блокировку API и повышает масштабируемость. Каждая задача регистрируется в таблице core_backgroundjob, что позволяет:

получать статус в реальном времени;
отображать прогресс и сообщения;
фиксировать ошибки и трассировки;
обеспечивать контроль исполнения на уровне пользователя.

6.2. Инкрементальная загрузка и идентификация пакетов

Механизм load_batch обеспечивает последовательную нумерацию пакетов загрузки. В результате:

каждое обновление формы идентифицируется как самостоятельный пакет;
возможна аналитика по временным срезам;
упрощается повторная загрузка без потери предшествующих данных.

6.3. Валидация, дедупликация и целостность

уникальность справочника организаций обеспечивается ограничением по ИНН;
валидация ИНН/ОГРН/КПП/ОКПО выполняется на уровне парсера;
все операции записи выполняются в транзакции;
ошибочные строки не прерывают общий процесс, фиксируются в ParseResult.

6.4. Логирование, мониторинг и health-check

Система использует middleware RequestIDMiddleware для трассировки запросов, а также реализует endpoints мониторинга:

GET /health/ — комплексная проверка;
GET /health/live/ — liveness probe;
GET /health/ready/ — readiness probe.

6.5. Требования к информационной безопасности

В целях обеспечения защиты данных и устойчивости работы системы должны соблюдаться организационные и технические меры безопасности, определяемые внутренними регламентами заказчика и действующим законодательством. На уровне программной реализации предусмотрены следующие базовые механизмы, обязательные к использованию при эксплуатации:

доступ к защищённым ресурсам осуществляется по JWT‑токену (заголовок Authorization: Bearer <token>), время жизни access‑токена — 60 минут, refresh‑токена — 7 дней;
разграничение доступа реализовано на уровне прав пользователя; доступ к административным функциям имеет только пользователь с is_staff=true, доступ к статусам задач — только владелец задачи или администратор;
пароли пользователей хранятся исключительно в виде криптографических хэшей, что исключает хранение исходных паролей в базе данных;
секреты и параметры подключения (SECRET_KEY, параметры БД/Redis) задаются через переменные окружения и должны храниться в защищённом конфигурационном контуре;
список доверенных источников (CORS) задаётся параметром CORS_ALLOWED_ORIGINS и должен быть ограничен утверждёнными доменами;
механизм ограничения частоты запросов включён на уровне DRF (анонимные запросы — 100/час, авторизованные — 1000/час) и при необходимости подлежит корректировке в соответствии с политиками эксплуатации;
трассировка запросов осуществляется через X-Request-ID, что обеспечивает аудит и расследование инцидентов.

Дополнительно при эксплуатации рекомендуется обеспечить шифрование каналов передачи данных (TLS), сегментацию сети и ограничение административного доступа по IP‑спискам.

6.6. Эксплуатационные регламенты

Для обеспечения стабильной работы системы в промышленной эксплуатации рекомендуется утвердить следующие регламенты:

резервное копирование базы данных — ежедневно, с хранением не менее 30 календарных дней;
резервное копирование файловых каталогов (media/, input/) — ежедневно, синхронно с резервным копированием БД;
проверка восстановления резервных копий — не реже 1 раза в месяц;
плановая очистка устаревших записей фоновых задач — через периодический запуск BackgroundJobService.cleanup_old_jobs(days=30) (настройка через Celery Beat);
контроль свободного дискового пространства и роста логов — по порогам эксплуатации (рекомендуется 20% свободного места как минимальный запас);
обновление программных компонентов — по утверждённому окну сопровождения с обязательным выполнением миграций и smoke‑проверок;
контроль работоспособности — регулярные проверки /health/, /health/ready/ и мониторинг логов ошибок.

6.7. Сценарии отказов и реакции

Сценарий	Признак	Источник контроля	Рекомендованная реакция
Недоступна БД	`health` возвращает `unhealthy`, readiness = 503	`/health/`, `/health/ready/`, логи Django	Проверить доступность PostgreSQL, сетевые правила, восстановить из резервной копии при необходимости
Недоступен Redis	Статус `degraded`, ошибки кеша/очередей	`/health/`, логи Redis	Перезапуск Redis, проверка параметров подключения, повторная проверка задач
Нет активных Celery workers	`include_celery=true` возвращает `down`	`/health/?include_celery=true`, логи Celery	Запустить/перезапустить воркеры, проверить очередь и брокер
Ошибка обработки файла	BackgroundJob = `failure`, заполнены `error/traceback`	`/api/v1/jobs/{task_id}/`	Исправить файл, повторить загрузку, при необходимости задать новый `load_batch`
Ошибки валидации строк	`ParseResult.errors` содержит список ошибок	Ответ API загрузки	Исправить исходные строки и повторить загрузку
Ошибка аутентификации	HTTP 401	Ответ API	Обновить токен через refresh либо выполнить повторный вход
Превышение лимита запросов	HTTP 429	Ответ API, логи DRF	Снизить частоту запросов или скорректировать лимиты

7. ПОРЯДОК РАЗВЁРТЫВАНИЯ И ИСПЫТАНИЙ

7.1. Подготовка операционной среды

Минимальные системные зависимости:

Python 3.11.
PostgreSQL 15.
Redis 7.
Apache / Gunicorn.

Переменные окружения задаются в .env (PostgreSQL, Redis, SECRET_KEY, CORS и др.).

7.2. Развёртывание и запуск

Рекомендуемый вариант для разработки — Docker Compose:

docker-compose up -d

Для установки в продуктивном контуре предусмотрен скрипт deploy/scripts/deploy.sh, выполняющий:

установку зависимостей;
настройку базы данных;
миграции и сбор статических файлов;
запуск Gunicorn и Celery сервисов.

7.3. Проверка качества и тестирование

В проекте предусмотрены автоматические тесты на уровне моделей, сервисов и API:

make test
# или
python run_tests.py

8. ЗАКЛЮЧЕНИЕ

Программный комплекс State Corp Backend реализует надёжную и масштабируемую архитектуру обработки отчётных данных. Он обеспечивает:

стандартизированный приём и валидацию форм Ф‑1…Ф‑6;
централизованное хранение и нормализацию данных организаций;
прозрачный механизм фоновой обработки с контролем прогресса;
удобный REST API с единой спецификацией и расширенной документацией;
готовность к промышленной эксплуатации и мониторингу.

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

ПРИЛОЖЕНИЕ А (ОБЯЗАТЕЛЬНОЕ). ФОРМАТЫ ВХОДНЫХ EXCEL-ШАБЛОНОВ

Настоящее приложение устанавливает требования к структуре входных Excel‑файлов по формам Ф‑1…Ф‑6. Указанные требования являются обязательными для корректной загрузки.

А.1. Общие требования к Excel‑файлам

Формат файла: .xlsx.
Используется первый лист рабочей книги (active sheet).
Строка заголовков — 1.
Данные начинаются со строки 2.
Заголовки должны строго соответствовать перечню ниже.
Порядок колонок является фиксированным.
Пустые строки допускаются и игнорируются.
Типы данных:

Тип	Требование
`str`	Текстовое значение
`int`	Целое число (без дробной части)
`decimal`	Дробные числа, допускаются запятая и пробел как разделитель
`bool`	Значения: «да», «yes», «1», «true», «+» (регистр не важен)
`date`	Ячейка должна иметь тип даты Excel

А.2. Шаблон формы Ф‑1 (Выпуск продукции)

Стандартные колонки организации:

№	Заголовок	Поле модели	Тип
0	Наименование организации	`organization_name`	str
1	ОКПО	`okpo`	str
2	ОГРН	`ogrn`	str
3	ИНН	`inn`	str

Поля формы:

№	Заголовок	Поле модели	Тип
4	Выпуск военной продукции (факт.)	`military_output_actual`	decimal
5	Военная на внутренний рынок (факт.)	`military_domestic_actual`	decimal
6	Военная на экспорт (факт.)	`military_export_actual`	decimal
7	Выпуск гражданской продукции (факт.)	`civilian_output_actual`	decimal
8	Гражданская на внутренний рынок (факт.)	`civilian_domestic_actual`	decimal
9	Гражданская на экспорт (факт.)	`civilian_export_actual`	decimal
10	Высокотехнологичная продукция (факт.)	`hightech_output_actual`	decimal
11	Высокотехнологичная на внутренний рынок (факт.)	`hightech_domestic_actual`	decimal
12	Высокотехнологичная на экспорт (факт.)	`hightech_export_actual`	decimal
13	Объём НИОКР (факт.)	`rd_volume_actual`	decimal
14	НИОКР в интересах обороны (факт.)	`rd_defense_actual`	decimal
15	Выпуск военной продукции (фикс.)	`military_output_fixed`	decimal
16	Военная на внутренний рынок (фикс.)	`military_domestic_fixed`	decimal
17	Военная на экспорт (фикс.)	`military_export_fixed`	decimal
18	Выпуск гражданской продукции (фикс.)	`civilian_output_fixed`	decimal
19	Гражданская на внутренний рынок (фикс.)	`civilian_domestic_fixed`	decimal
20	Гражданская на экспорт (фикс.)	`civilian_export_fixed`	decimal
21	Высокотехнологичная продукция (фикс.)	`hightech_output_fixed`	decimal
22	Высокотехнологичная на внутренний рынок (фикс.)	`hightech_domestic_fixed`	decimal
23	Высокотехнологичная на экспорт (фикс.)	`hightech_export_fixed`	decimal
24	Объём НИОКР (фикс.)	`rd_volume_fixed`	decimal
25	НИОКР в интересах обороны (фикс.)	`rd_defense_fixed`	decimal
26	Средняя численность работников	`avg_employees`	decimal
27	Среднесписочная численность	`avg_payroll_employees`	decimal
28	Фонд начисленной зарплаты	`payroll_fund`	decimal
29	Просроченная задолженность по ЗП	`salary_arrears`	decimal

А.3. Шаблон формы Ф‑2 (Бухгалтерский баланс)

Стандартные колонки организации:

№	Заголовок	Поле модели	Тип
0	Наименование организации	`organization_name`	str
1	ОКПО	`okpo`	str
2	ОГРН	`ogrn`	str
3	ИНН	`inn`	str

Поля формы:

№	Заголовок	Поле модели	Тип
4	Нематериальные активы	`intangible_assets`	decimal
5	Результаты исследований и разработок	`rd_results`	decimal
6	Нематериальные поисковые активы	`intangible_search_assets`	decimal
7	Материальные поисковые активы	`tangible_search_assets`	decimal
8	Основные средства	`fixed_assets`	decimal
9	Доходные вложения в материальные ценности	`profitable_investments`	decimal
10	Финансовые вложения (внеоборотные)	`financial_investments_non_current`	decimal
11	Отложенные налоговые активы	`deferred_tax_assets`	decimal
12	Прочие внеоборотные активы	`other_non_current_assets`	decimal
13	Итого внеоборотные активы	`total_non_current_assets`	decimal
14	Запасы	`inventories`	decimal
15	НДС по приобретённым ценностям	`vat_on_acquired_assets`	decimal
16	Дебиторская задолженность	`receivables`	decimal
17	Финансовые вложения (оборотные)	`financial_investments_current`	decimal
18	Денежные средства и эквиваленты	`cash_and_equivalents`	decimal
19	Прочие оборотные активы	`other_current_assets`	decimal
20	Итого оборотные активы	`total_current_assets`	decimal
21	Баланс (актив)	`total_assets`	decimal
22	Уставный капитал	`authorized_capital`	decimal
23	Собственные акции, выкупленные у акционеров	`own_shares_bought_back`	decimal
24	Переоценка внеоборотных активов	`revaluation_of_non_current_assets`	decimal
25	Добавочный капитал	`additional_capital`	decimal
26	Резервный капитал	`reserve_capital`	decimal
27	Нераспределённая прибыль	`retained_earnings`	decimal
28	Итого капитал и резервы	`total_equity`	decimal
29	Заёмные средства (долгосрочные)	`borrowings_non_current`	decimal
30	Отложенные налоговые обязательства	`deferred_tax_liabilities`	decimal
31	Оценочные обязательства (долгосрочные)	`estimated_liabilities_non_current`	decimal
32	Прочие обязательства (долгосрочные)	`other_liabilities_non_current`	decimal
33	Итого долгосрочные обязательства	`total_non_current_liabilities`	decimal
34	Заёмные средства (краткосрочные)	`borrowings_current`	decimal
35	Кредиторская задолженность	`payables`	decimal
36	Доходы будущих периодов	`deferred_income`	decimal
37	Оценочные обязательства (краткосрочные)	`estimated_liabilities_current`	decimal
38	Прочие обязательства (краткосрочные)	`other_liabilities_current`	decimal
39	Итого краткосрочные обязательства	`total_current_liabilities`	decimal
40	Баланс (пассив)	`total_liabilities`	decimal
41	Выручка	`revenue`	decimal
42	Себестоимость продаж	`cost_of_sales`	decimal
43	Валовая прибыль	`gross_profit`	decimal
44	Коммерческие расходы	`selling_expenses`	decimal
45	Управленческие расходы	`administrative_expenses`	decimal
46	Прибыль от продаж	`profit_from_sales`	decimal
47	Проценты к получению	`interest_receivable`	decimal
48	Проценты к уплате	`interest_payable`	decimal
49	Прочие доходы	`other_income`	decimal
50	Прочие расходы	`other_expenses`	decimal
51	Прибыль до налогообложения	`profit_before_tax`	decimal
52	Текущий налог на прибыль	`income_tax`	decimal
53	Чистая прибыль	`net_profit`	decimal
54	EBITDA	`ebitda`	decimal
55	Амортизация	`depreciation`	decimal
56	Оборотный капитал	`working_capital`	decimal
57	Чистый долг	`net_debt`	decimal
58	Баланс (актив) - прошлый период	`total_assets_prev`	decimal
59	Баланс (пассив) - прошлый период	`total_liabilities_prev`	decimal
60	Выручка - прошлый период	`revenue_prev`	decimal
61	Чистая прибыль - прошлый период	`net_profit_prev`	decimal

А.4. Шаблон формы Ф‑3 (Кадры и оборудование)

Стандартные колонки организации:

№	Заголовок	Поле модели	Тип
0	Наименование организации	`organization_name`	str
1	ОКПО	`okpo`	str
2	ОГРН	`ogrn`	str
3	ИНН	`inn`	str

Поля формы:

№	Заголовок	Поле модели	Тип
4	Средняя численность работников	`avg_employees`	decimal
5	Производственный персонал	`production_workers`	decimal
6	Инженерно‑технические работники	`engineering_workers`	decimal
7	Административный персонал	`administrative_workers`	decimal
8	Всего оборудования	`total_equipment`	int
9	Отечественное оборудование	`domestic_equipment`	int
10	Импортное оборудование	`imported_equipment`	int
11	Оборудование до 5 лет	`equipment_age_under_5`	int
12	Оборудование 5‑10 лет	`equipment_age_5_10`	int
13	Оборудование 10‑15 лет	`equipment_age_10_15`	int
14	Оборудование 15‑20 лет	`equipment_age_15_20`	int
15	Оборудование свыше 20 лет	`equipment_age_over_20`	int
16	Физический износ, %	`physical_wear_percent`	decimal
17	Коэффициент загрузки	`utilization_rate`	decimal
18	Средняя сменность работы	`avg_shift_work`	decimal
19	Потребность в оборудовании	`equipment_needed`	int
20	Потребность в кадрах	`workers_needed`	int

А.5. Шаблон формы Ф‑4 (Сводные финансовые данные)

Стандартные колонки организации:

№	Заголовок	Поле модели	Тип
0	Наименование организации	`organization_name`	str
1	ОКПО	`okpo`	str
2	ОГРН	`ogrn`	str
3	ИНН	`inn`	str

Поля формы:

№	Заголовок	Поле модели	Тип
4	Выручка (РСБУ)	`revenue_rsbu`	decimal
5	Выручка (МСФО)	`revenue_ifrs`	decimal
6	Выручка прошлого года (РСБУ)	`revenue_prev_rsbu`	decimal
7	Выручка прошлого года (МСФО)	`revenue_prev_ifrs`	decimal
8	Чистая прибыль (РСБУ)	`net_profit_rsbu`	decimal
9	Чистая прибыль (МСФО)	`net_profit_ifrs`	decimal
10	Валовая прибыль (РСБУ)	`gross_profit_rsbu`	decimal
11	Операционная прибыль (РСБУ)	`operating_profit_rsbu`	decimal
12	EBITDA (РСБУ)	`ebitda_rsbu`	decimal
13	EBITDA (МСФО)	`ebitda_ifrs`	decimal
14	Кредиты и займы (РСБУ)	`loans_rsbu`	decimal
15	Кредиты и займы (МСФО)	`loans_ifrs`	decimal
16	Чистый долг (РСБУ)	`net_debt_rsbu`	decimal
17	Чистый долг (МСФО)	`net_debt_ifrs`	decimal
18	Долг/EBITDA	`debt_to_ebitda`	decimal
19	Активы (РСБУ)	`total_assets_rsbu`	decimal
20	Активы (МСФО)	`total_assets_ifrs`	decimal
21	Собственный капитал (РСБУ)	`equity_rsbu`	decimal
22	Собственный капитал (МСФО)	`equity_ifrs`	decimal
23	ROE	`roe`	decimal
24	ROA	`roa`	decimal
25	ROS	`ros`	decimal
26	CAPEX	`capex`	decimal
27	Затраты на НИОКР	`rd_expenses`	decimal
28	Выплаченные дивиденды	`dividends_paid`	decimal
29	Дивидендная доходность	`dividend_yield`	decimal

А.6. Шаблон формы Ф‑5 (Инвентаризация оборудования)

Стандартные колонки организации:

№	Заголовок	Поле модели	Тип
0	Наименование организации	`organization_name`	str
1	ОКПО	`okpo`	str
2	ОГРН	`ogrn`	str
3	ИНН	`inn`	str

Поля формы:

№	Заголовок	Поле модели	Тип
4	Идентификационный код	`equipment_id`	str
5	Инвентарный номер	`inventory_number`	str
6	Наименование оборудования	`name`	str
7	Модель	`model`	str
8	Производитель	`manufacturer`	str
9	Страна происхождения	`country_origin`	str
10	Отечественное производство	`is_domestic`	bool
11	Год выпуска	`year_manufacture`	int
12	Наличие ЧПУ	`has_cnc`	bool
13	Тип оборудования	`equipment_type`	str
14	Категория оборудования	`equipment_category`	str
15	Дата ввода в эксплуатацию	`commissioning_date`	date
16	Местонахождение	`location`	str
17	Производственный участок	`production_site`	str
18	Коэффициент использования	`utilization_rate`	decimal
19	Фактический износ, %	`physical_wear_percent`	decimal
20	В рабочем состоянии	`is_operational`	bool
21	Требует ремонта	`requires_repair`	bool
22	Требует замены	`requires_replacement`	bool
23	Первоначальная стоимость	`initial_cost`	decimal
24	Остаточная стоимость	`residual_value`	decimal
25	Примечания	`notes`	str

А.7. Шаблон формы Ф‑6 (Возрастная структура оборудования)

Стандартные колонки организации:

№	Заголовок	Поле модели	Тип
0	Наименование организации	`organization_name`	str
1	ОКПО	`okpo`	str
2	ОГРН	`ogrn`	str
3	ИНН	`inn`	str

Поля формы:

№	Заголовок	Поле модели	Тип
4	Код строки	`row_code`	str
5	Категория оборудования	`category`	str
6	Всего оборудования	`total_equipment`	int
7	Отечественное оборудование	`domestic_equipment`	int
8	Импортное оборудование	`imported_equipment`	int
9	До 5 лет	`age_under_5`	int
10	5‑10 лет	`age_5_10`	int
11	10‑15 лет	`age_10_15`	int
12	15‑20 лет	`age_15_20`	int
13	Свыше 20 лет	`age_over_20`	int
14	С ЧПУ всего	`cnc_total`	int
15	С ЧПУ до 5 лет	`cnc_under_5`	int
16	С ЧПУ 5‑10 лет	`cnc_5_10`	int
17	С ЧПУ 10‑15 лет	`cnc_10_15`	int
18	С ЧПУ 15‑20 лет	`cnc_15_20`	int
19	С ЧПУ свыше 20 лет	`cnc_over_20`	int
20	Средняя сменность работы	`avg_shift_work`	decimal
21	Коэффициент загрузки	`utilization_rate`	decimal
22	Физический износ, %	`physical_wear_percent`	decimal
23	Рабочие места без оборудования	`workplaces_without_equipment`	int
24	Оборудование к замене	`equipment_to_replace`	int

ПРИЛОЖЕНИЕ Б (РЕКОМЕНДУЕМОЕ). ПРИМЕРЫ ВХОДНЫХ ФАЙЛОВ

Б.1. Общие указания к примерам

Примеры приведены для ориентира. Значения условные и должны соответствовать фактическим данным отчётности. Порядок колонок обязателен и соответствует приложению А.

Б.2. Пример заполнения формы Ф-1 (Выпуск продукции)

№	Заголовок	Тип	Пример значения
0	Наименование организации	str	АО "Пример"
1	ОКПО	str	12345678
2	ОГРН	str	1027700132195
3	ИНН	str	7701234567
4	Выпуск военной продукции (факт.)	decimal	1000.00
5	Военная на внутренний рынок (факт.)	decimal	1000.00
6	Военная на экспорт (факт.)	decimal	1000.00
7	Выпуск гражданской продукции (факт.)	decimal	1000.00
8	Гражданская на внутренний рынок (факт.)	decimal	1000.00
9	Гражданская на экспорт (факт.)	decimal	1000.00
10	Высокотехнологичная продукция (факт.)	decimal	1000.00
11	Высокотехнологичная на внутренний рынок (факт.)	decimal	1000.00
12	Высокотехнологичная на экспорт (факт.)	decimal	1000.00
13	Объём НИОКР (факт.)	decimal	1000.00
14	НИОКР в интересах обороны (факт.)	decimal	1000.00
15	Выпуск военной продукции (фикс.)	decimal	1000.00
16	Военная на внутренний рынок (фикс.)	decimal	1000.00
17	Военная на экспорт (фикс.)	decimal	1000.00
18	Выпуск гражданской продукции (фикс.)	decimal	1000.00
19	Гражданская на внутренний рынок (фикс.)	decimal	1000.00
20	Гражданская на экспорт (фикс.)	decimal	1000.00
21	Высокотехнологичная продукция (фикс.)	decimal	1000.00
22	Высокотехнологичная на внутренний рынок (фикс.)	decimal	1000.00
23	Высокотехнологичная на экспорт (фикс.)	decimal	1000.00
24	Объём НИОКР (фикс.)	decimal	1000.00
25	НИОКР в интересах обороны (фикс.)	decimal	1000.00
26	Средняя численность работников	decimal	1000.00
27	Среднесписочная численность	decimal	1000.00
28	Фонд начисленной зарплаты	decimal	1000.00
29	Просроченная задолженность по ЗП	decimal	1000.00

Б.3. Пример заполнения формы Ф-2 (Бухгалтерский баланс)

№	Заголовок	Тип	Пример значения
0	Наименование организации	str	АО "Пример"
1	ОКПО	str	12345678
2	ОГРН	str	1027700132195
3	ИНН	str	7701234567
4	Нематериальные активы	decimal	1000.00
5	Результаты исследований и разработок	decimal	1000.00
6	Нематериальные поисковые активы	decimal	1000.00
7	Материальные поисковые активы	decimal	1000.00
8	Основные средства	decimal	1000.00
9	Доходные вложения в материальные ценности	decimal	1000.00
10	Финансовые вложения (внеоборотные)	decimal	1000.00
11	Отложенные налоговые активы	decimal	1000.00
12	Прочие внеоборотные активы	decimal	1000.00
13	Итого внеоборотные активы	decimal	1000.00
14	Запасы	decimal	1000.00
15	НДС по приобретённым ценностям	decimal	1000.00
16	Дебиторская задолженность	decimal	1000.00
17	Финансовые вложения (оборотные)	decimal	1000.00
18	Денежные средства и эквиваленты	decimal	1000.00
19	Прочие оборотные активы	decimal	1000.00
20	Итого оборотные активы	decimal	1000.00
21	Баланс (актив)	decimal	1000.00
22	Уставный капитал	decimal	1000.00
23	Собственные акции, выкупленные у акционеров	decimal	1000.00
24	Переоценка внеоборотных активов	decimal	1000.00
25	Добавочный капитал	decimal	1000.00
26	Резервный капитал	decimal	1000.00
27	Нераспределённая прибыль	decimal	1000.00
28	Итого капитал и резервы	decimal	1000.00
29	Заёмные средства (долгосрочные)	decimal	1000.00
30	Отложенные налоговые обязательства	decimal	1000.00
31	Оценочные обязательства (долгосрочные)	decimal	1000.00
32	Прочие обязательства (долгосрочные)	decimal	1000.00
33	Итого долгосрочные обязательства	decimal	1000.00
34	Заёмные средства (краткосрочные)	decimal	1000.00
35	Кредиторская задолженность	decimal	1000.00
36	Доходы будущих периодов	decimal	1000.00
37	Оценочные обязательства (краткосрочные)	decimal	1000.00
38	Прочие обязательства (краткосрочные)	decimal	1000.00
39	Итого краткосрочные обязательства	decimal	1000.00
40	Баланс (пассив)	decimal	1000.00
41	Выручка	decimal	1000.00
42	Себестоимость продаж	decimal	1000.00
43	Валовая прибыль	decimal	1000.00
44	Коммерческие расходы	decimal	1000.00
45	Управленческие расходы	decimal	1000.00
46	Прибыль от продаж	decimal	1000.00
47	Проценты к получению	decimal	1000.00
48	Проценты к уплате	decimal	1000.00
49	Прочие доходы	decimal	1000.00
50	Прочие расходы	decimal	1000.00
51	Прибыль до налогообложения	decimal	1000.00
52	Текущий налог на прибыль	decimal	1000.00
53	Чистая прибыль	decimal	1000.00
54	EBITDA	decimal	1000.00
55	Амортизация	decimal	1000.00
56	Оборотный капитал	decimal	1000.00
57	Чистый долг	decimal	1000.00
58	Баланс (актив) - прошлый период	decimal	1000.00
59	Баланс (пассив) - прошлый период	decimal	1000.00
60	Выручка - прошлый период	decimal	1000.00
61	Чистая прибыль - прошлый период	decimal	1000.00

Б.4. Пример заполнения формы Ф-3 (Кадры и оборудование)

№	Заголовок	Тип	Пример значения
0	Наименование организации	str	АО "Пример"
1	ОКПО	str	12345678
2	ОГРН	str	1027700132195
3	ИНН	str	7701234567
4	Средняя численность работников	decimal	1000.00
5	Производственный персонал	decimal	1000.00
6	Инженерно-технические работники	decimal	1000.00
7	Административный персонал	decimal	1000.00
8	Всего оборудования	int	120
9	Отечественное оборудование	int	90
10	Импортное оборудование	int	30
11	Оборудование до 5 лет	int	25
12	Оборудование 5-10 лет	int	40
13	Оборудование 10-15 лет	int	30
14	Оборудование 15-20 лет	int	15
15	Оборудование свыше 20 лет	int	10
16	Физический износ, %	decimal	0.85
17	Коэффициент загрузки	decimal	0.85
18	Средняя сменность работы	decimal	0.85
19	Потребность в оборудовании	int	10
20	Потребность в кадрах	int	10

Б.5. Пример заполнения формы Ф-4 (Сводные финансовые данные)

№	Заголовок	Тип	Пример значения
0	Наименование организации	str	АО "Пример"
1	ОКПО	str	12345678
2	ОГРН	str	1027700132195
3	ИНН	str	7701234567
4	Выручка (РСБУ)	decimal	1000.00
5	Выручка (МСФО)	decimal	1000.00
6	Выручка прошлого года (РСБУ)	decimal	1000.00
7	Выручка прошлого года (МСФО)	decimal	1000.00
8	Чистая прибыль (РСБУ)	decimal	1000.00
9	Чистая прибыль (МСФО)	decimal	1000.00
10	Валовая прибыль (РСБУ)	decimal	1000.00
11	Операционная прибыль (РСБУ)	decimal	1000.00
12	EBITDA (РСБУ)	decimal	1000.00
13	EBITDA (МСФО)	decimal	1000.00
14	Кредиты и займы (РСБУ)	decimal	1000.00
15	Кредиты и займы (МСФО)	decimal	1000.00
16	Чистый долг (РСБУ)	decimal	1000.00
17	Чистый долг (МСФО)	decimal	1000.00
18	Долг/EBITDA	decimal	1000.00
19	Активы (РСБУ)	decimal	1000.00
20	Активы (МСФО)	decimal	1000.00
21	Собственный капитал (РСБУ)	decimal	1000.00
22	Собственный капитал (МСФО)	decimal	1000.00
23	ROE	decimal	1000.00
24	ROA	decimal	1000.00
25	ROS	decimal	1000.00
26	CAPEX	decimal	1000.00
27	Затраты на НИОКР	decimal	1000.00
28	Выплаченные дивиденды	decimal	1000.00
29	Дивидендная доходность	decimal	1000.00

Б.6. Пример заполнения формы Ф-5 (Инвентаризация оборудования)

№	Заголовок	Тип	Пример значения
0	Наименование организации	str	АО "Пример"
1	ОКПО	str	12345678
2	ОГРН	str	1027700132195
3	ИНН	str	7701234567
4	Идентификационный код	str	Пример
5	Инвентарный номер	str	Пример
6	Наименование оборудования	str	Станок токарный
7	Модель	str	СТ-16К20
8	Производитель	str	АО "Машзавод"
9	Страна происхождения	str	Россия
10	Отечественное производство	bool	да
11	Год выпуска	int	2018
12	Наличие ЧПУ	bool	да
13	Тип оборудования	str	Токарное
14	Категория оборудования	str	Металлообработка
15	Дата ввода в эксплуатацию	date	2020-06-01
16	Местонахождение	str	Цех №1
17	Производственный участок	str	Участок обработки
18	Коэффициент использования	decimal	0.85
19	Фактический износ, %	decimal	1000.00
20	В рабочем состоянии	bool	да
21	Требует ремонта	bool	да
22	Требует замены	bool	да
23	Первоначальная стоимость	decimal	1000.00
24	Остаточная стоимость	decimal	1000.00
25	Примечания	str	Без замечаний

Б.7. Пример заполнения формы Ф-6 (Возрастная структура оборудования)

№	Заголовок	Тип	Пример значения
0	Наименование организации	str	АО "Пример"
1	ОКПО	str	12345678
2	ОГРН	str	1027700132195
3	ИНН	str	7701234567
4	Код строки	str	010
5	Категория оборудования	str	Металлообработка
6	Всего оборудования	int	120
7	Отечественное оборудование	int	90
8	Импортное оборудование	int	30
9	До 5 лет	int	25
10	5-10 лет	int	40
11	10-15 лет	int	30
12	15-20 лет	int	15
13	Свыше 20 лет	int	10
14	С ЧПУ всего	int	60
15	С ЧПУ до 5 лет	int	15
16	С ЧПУ 5-10 лет	int	20
17	С ЧПУ 10-15 лет	int	15
18	С ЧПУ 15-20 лет	int	7
19	С ЧПУ свыше 20 лет	int	3
20	Средняя сменность работы	decimal	0.85
21	Коэффициент загрузки	decimal	0.85
22	Физический износ, %	decimal	0.85
23	Рабочие места без оборудования	int	10
24	Оборудование к замене	int	10

ПРИЛОЖЕНИЕ В (СПРАВОЧНОЕ). СПРАВОЧНИК ПОКАЗАТЕЛЕЙ

В.1. Общие положения

Справочник показателей предназначен для унифицированной интерпретации полей базы данных и отчётных колонок. Для каждого показателя приведено наименование и краткое пояснение.

В.2. Показатели формы Ф-1 (Выпуск продукции)

В.3. Показатели формы Ф-2 (Бухгалтерский баланс)

Поле модели	Показатель	Пояснение
`organization_name`	Наименование организации	Полное наименование организации в соответствии с отчётной формой.
`okpo`	ОКПО	Код организации по ОКПО, используется для идентификации в отчётности.
`ogrn`	ОГРН	Основной государственный регистрационный номер организации.
`inn`	ИНН	Идентификационный номер налогоплательщика организации.
`intangible_assets`	Нематериальные активы	Значение показателя «Нематериальные активы», передаваемое в форме Ф-2.
`rd_results`	Результаты исследований и разработок	Значение показателя «Результаты исследований и разработок», передаваемое в форме Ф-2.
`intangible_search_assets`	Нематериальные поисковые активы	Значение показателя «Нематериальные поисковые активы», передаваемое в форме Ф-2.
`tangible_search_assets`	Материальные поисковые активы	Значение показателя «Материальные поисковые активы», передаваемое в форме Ф-2.
`fixed_assets`	Основные средства	Значение показателя «Основные средства», передаваемое в форме Ф-2.
`profitable_investments`	Доходные вложения в материальные ценности	Значение показателя «Доходные вложения в материальные ценности», передаваемое в форме Ф-2.
`financial_investments_non_current`	Финансовые вложения (внеоборотные)	Значение показателя «Финансовые вложения (внеоборотные)», передаваемое в форме Ф-2.
`deferred_tax_assets`	Отложенные налоговые активы	Значение показателя «Отложенные налоговые активы», передаваемое в форме Ф-2.
`other_non_current_assets`	Прочие внеоборотные активы	Значение показателя «Прочие внеоборотные активы», передаваемое в форме Ф-2.
`total_non_current_assets`	Итого внеоборотные активы	Значение показателя «Итого внеоборотные активы», передаваемое в форме Ф-2.
`inventories`	Запасы	Значение показателя «Запасы», передаваемое в форме Ф-2.
`vat_on_acquired_assets`	НДС по приобретённым ценностям	Значение показателя «НДС по приобретённым ценностям», передаваемое в форме Ф-2.
`receivables`	Дебиторская задолженность	Значение показателя «Дебиторская задолженность», передаваемое в форме Ф-2.
`financial_investments_current`	Финансовые вложения (оборотные)	Значение показателя «Финансовые вложения (оборотные)», передаваемое в форме Ф-2.
`cash_and_equivalents`	Денежные средства и эквиваленты	Значение показателя «Денежные средства и эквиваленты», передаваемое в форме Ф-2.
`other_current_assets`	Прочие оборотные активы	Значение показателя «Прочие оборотные активы», передаваемое в форме Ф-2.
`total_current_assets`	Итого оборотные активы	Значение показателя «Итого оборотные активы», передаваемое в форме Ф-2.
`total_assets`	Баланс (актив)	Значение показателя «Баланс (актив)», передаваемое в форме Ф-2.
`authorized_capital`	Уставный капитал	Значение показателя «Уставный капитал», передаваемое в форме Ф-2.
`own_shares_bought_back`	Собственные акции, выкупленные у акционеров	Значение показателя «Собственные акции, выкупленные у акционеров», передаваемое в форме Ф-2.
`revaluation_of_non_current_assets`	Переоценка внеоборотных активов	Значение показателя «Переоценка внеоборотных активов», передаваемое в форме Ф-2.
`additional_capital`	Добавочный капитал	Значение показателя «Добавочный капитал», передаваемое в форме Ф-2.
`reserve_capital`	Резервный капитал	Значение показателя «Резервный капитал», передаваемое в форме Ф-2.
`retained_earnings`	Нераспределённая прибыль	Значение показателя «Нераспределённая прибыль», передаваемое в форме Ф-2.
`total_equity`	Итого капитал и резервы	Значение показателя «Итого капитал и резервы», передаваемое в форме Ф-2.
`borrowings_non_current`	Заёмные средства (долгосрочные)	Значение показателя «Заёмные средства (долгосрочные)», передаваемое в форме Ф-2.
`deferred_tax_liabilities`	Отложенные налоговые обязательства	Значение показателя «Отложенные налоговые обязательства», передаваемое в форме Ф-2.
`estimated_liabilities_non_current`	Оценочные обязательства (долгосрочные)	Значение показателя «Оценочные обязательства (долгосрочные)», передаваемое в форме Ф-2.
`other_liabilities_non_current`	Прочие обязательства (долгосрочные)	Значение показателя «Прочие обязательства (долгосрочные)», передаваемое в форме Ф-2.
`total_non_current_liabilities`	Итого долгосрочные обязательства	Значение показателя «Итого долгосрочные обязательства», передаваемое в форме Ф-2.
`borrowings_current`	Заёмные средства (краткосрочные)	Значение показателя «Заёмные средства (краткосрочные)», передаваемое в форме Ф-2.
`payables`	Кредиторская задолженность	Значение показателя «Кредиторская задолженность», передаваемое в форме Ф-2.
`deferred_income`	Доходы будущих периодов	Значение показателя «Доходы будущих периодов», передаваемое в форме Ф-2.
`estimated_liabilities_current`	Оценочные обязательства (краткосрочные)	Значение показателя «Оценочные обязательства (краткосрочные)», передаваемое в форме Ф-2.
`other_liabilities_current`	Прочие обязательства (краткосрочные)	Значение показателя «Прочие обязательства (краткосрочные)», передаваемое в форме Ф-2.
`total_current_liabilities`	Итого краткосрочные обязательства	Значение показателя «Итого краткосрочные обязательства», передаваемое в форме Ф-2.
`total_liabilities`	Баланс (пассив)	Значение показателя «Баланс (пассив)», передаваемое в форме Ф-2.
`revenue`	Выручка	Значение показателя «Выручка», передаваемое в форме Ф-2.
`cost_of_sales`	Себестоимость продаж	Значение показателя «Себестоимость продаж», передаваемое в форме Ф-2.
`gross_profit`	Валовая прибыль	Значение показателя «Валовая прибыль», передаваемое в форме Ф-2.
`selling_expenses`	Коммерческие расходы	Значение показателя «Коммерческие расходы», передаваемое в форме Ф-2.
`administrative_expenses`	Управленческие расходы	Значение показателя «Управленческие расходы», передаваемое в форме Ф-2.
`profit_from_sales`	Прибыль от продаж	Значение показателя «Прибыль от продаж», передаваемое в форме Ф-2.
`interest_receivable`	Проценты к получению	Значение показателя «Проценты к получению», передаваемое в форме Ф-2.
`interest_payable`	Проценты к уплате	Значение показателя «Проценты к уплате», передаваемое в форме Ф-2.
`other_income`	Прочие доходы	Значение показателя «Прочие доходы», передаваемое в форме Ф-2.
`other_expenses`	Прочие расходы	Значение показателя «Прочие расходы», передаваемое в форме Ф-2.
`profit_before_tax`	Прибыль до налогообложения	Значение показателя «Прибыль до налогообложения», передаваемое в форме Ф-2.
`income_tax`	Текущий налог на прибыль	Значение показателя «Текущий налог на прибыль», передаваемое в форме Ф-2.
`net_profit`	Чистая прибыль	Значение показателя «Чистая прибыль», передаваемое в форме Ф-2.
`ebitda`	EBITDA	Значение показателя «EBITDA», передаваемое в форме Ф-2.
`depreciation`	Амортизация	Значение показателя «Амортизация», передаваемое в форме Ф-2.
`working_capital`	Оборотный капитал	Значение показателя «Оборотный капитал», передаваемое в форме Ф-2.
`net_debt`	Чистый долг	Значение показателя «Чистый долг», передаваемое в форме Ф-2.
`total_assets_prev`	Баланс (актив) - прошлый период	Значение показателя «Баланс (актив) - прошлый период», передаваемое в форме Ф-2.
`total_liabilities_prev`	Баланс (пассив) - прошлый период	Значение показателя «Баланс (пассив) - прошлый период», передаваемое в форме Ф-2.
`revenue_prev`	Выручка - прошлый период	Значение показателя «Выручка - прошлый период», передаваемое в форме Ф-2.
`net_profit_prev`	Чистая прибыль - прошлый период	Значение показателя «Чистая прибыль - прошлый период», передаваемое в форме Ф-2.

В.4. Показатели формы Ф-3 (Кадры и оборудование)

Поле модели	Показатель	Пояснение
`organization_name`	Наименование организации	Полное наименование организации в соответствии с отчётной формой.
`okpo`	ОКПО	Код организации по ОКПО, используется для идентификации в отчётности.
`ogrn`	ОГРН	Основной государственный регистрационный номер организации.
`inn`	ИНН	Идентификационный номер налогоплательщика организации.
`avg_employees`	Средняя численность работников	Значение показателя «Средняя численность работников», передаваемое в форме Ф-3.
`production_workers`	Производственный персонал	Значение показателя «Производственный персонал», передаваемое в форме Ф-3.
`engineering_workers`	Инженерно-технические работники	Значение показателя «Инженерно-технические работники», передаваемое в форме Ф-3.
`administrative_workers`	Административный персонал	Значение показателя «Административный персонал», передаваемое в форме Ф-3.
`total_equipment`	Всего оборудования	Значение показателя «Всего оборудования», передаваемое в форме Ф-3.
`domestic_equipment`	Отечественное оборудование	Значение показателя «Отечественное оборудование», передаваемое в форме Ф-3.
`imported_equipment`	Импортное оборудование	Значение показателя «Импортное оборудование», передаваемое в форме Ф-3.
`equipment_age_under_5`	Оборудование до 5 лет	Значение показателя «Оборудование до 5 лет», передаваемое в форме Ф-3.
`equipment_age_5_10`	Оборудование 5-10 лет	Значение показателя «Оборудование 5-10 лет», передаваемое в форме Ф-3.
`equipment_age_10_15`	Оборудование 10-15 лет	Значение показателя «Оборудование 10-15 лет», передаваемое в форме Ф-3.
`equipment_age_15_20`	Оборудование 15-20 лет	Значение показателя «Оборудование 15-20 лет», передаваемое в форме Ф-3.
`equipment_age_over_20`	Оборудование свыше 20 лет	Значение показателя «Оборудование свыше 20 лет», передаваемое в форме Ф-3.
`physical_wear_percent`	Физический износ, %	Значение показателя «Физический износ, %», передаваемое в форме Ф-3.
`utilization_rate`	Коэффициент загрузки	Значение показателя «Коэффициент загрузки», передаваемое в форме Ф-3.
`avg_shift_work`	Средняя сменность работы	Значение показателя «Средняя сменность работы», передаваемое в форме Ф-3.
`equipment_needed`	Потребность в оборудовании	Значение показателя «Потребность в оборудовании», передаваемое в форме Ф-3.
`workers_needed`	Потребность в кадрах	Значение показателя «Потребность в кадрах», передаваемое в форме Ф-3.

В.5. Показатели формы Ф-4 (Сводные финансовые данные)

Поле модели	Показатель	Пояснение
`organization_name`	Наименование организации	Полное наименование организации в соответствии с отчётной формой.
`okpo`	ОКПО	Код организации по ОКПО, используется для идентификации в отчётности.
`ogrn`	ОГРН	Основной государственный регистрационный номер организации.
`inn`	ИНН	Идентификационный номер налогоплательщика организации.
`revenue_rsbu`	Выручка (РСБУ)	Значение показателя «Выручка (РСБУ)», передаваемое в форме Ф-4.
`revenue_ifrs`	Выручка (МСФО)	Значение показателя «Выручка (МСФО)», передаваемое в форме Ф-4.
`revenue_prev_rsbu`	Выручка прошлого года (РСБУ)	Значение показателя «Выручка прошлого года (РСБУ)», передаваемое в форме Ф-4.
`revenue_prev_ifrs`	Выручка прошлого года (МСФО)	Значение показателя «Выручка прошлого года (МСФО)», передаваемое в форме Ф-4.
`net_profit_rsbu`	Чистая прибыль (РСБУ)	Значение показателя «Чистая прибыль (РСБУ)», передаваемое в форме Ф-4.
`net_profit_ifrs`	Чистая прибыль (МСФО)	Значение показателя «Чистая прибыль (МСФО)», передаваемое в форме Ф-4.
`gross_profit_rsbu`	Валовая прибыль (РСБУ)	Значение показателя «Валовая прибыль (РСБУ)», передаваемое в форме Ф-4.
`operating_profit_rsbu`	Операционная прибыль (РСБУ)	Значение показателя «Операционная прибыль (РСБУ)», передаваемое в форме Ф-4.
`ebitda_rsbu`	EBITDA (РСБУ)	Значение показателя «EBITDA (РСБУ)», передаваемое в форме Ф-4.
`ebitda_ifrs`	EBITDA (МСФО)	Значение показателя «EBITDA (МСФО)», передаваемое в форме Ф-4.
`loans_rsbu`	Кредиты и займы (РСБУ)	Значение показателя «Кредиты и займы (РСБУ)», передаваемое в форме Ф-4.
`loans_ifrs`	Кредиты и займы (МСФО)	Значение показателя «Кредиты и займы (МСФО)», передаваемое в форме Ф-4.
`net_debt_rsbu`	Чистый долг (РСБУ)	Значение показателя «Чистый долг (РСБУ)», передаваемое в форме Ф-4.
`net_debt_ifrs`	Чистый долг (МСФО)	Значение показателя «Чистый долг (МСФО)», передаваемое в форме Ф-4.
`debt_to_ebitda`	Долг/EBITDA	Значение показателя «Долг/EBITDA», передаваемое в форме Ф-4.
`total_assets_rsbu`	Активы (РСБУ)	Значение показателя «Активы (РСБУ)», передаваемое в форме Ф-4.
`total_assets_ifrs`	Активы (МСФО)	Значение показателя «Активы (МСФО)», передаваемое в форме Ф-4.
`equity_rsbu`	Собственный капитал (РСБУ)	Значение показателя «Собственный капитал (РСБУ)», передаваемое в форме Ф-4.
`equity_ifrs`	Собственный капитал (МСФО)	Значение показателя «Собственный капитал (МСФО)», передаваемое в форме Ф-4.
`roe`	ROE	Значение показателя «ROE», передаваемое в форме Ф-4.
`roa`	ROA	Значение показателя «ROA», передаваемое в форме Ф-4.
`ros`	ROS	Значение показателя «ROS», передаваемое в форме Ф-4.
`capex`	CAPEX	Значение показателя «CAPEX», передаваемое в форме Ф-4.
`rd_expenses`	Затраты на НИОКР	Значение показателя «Затраты на НИОКР», передаваемое в форме Ф-4.
`dividends_paid`	Выплаченные дивиденды	Значение показателя «Выплаченные дивиденды», передаваемое в форме Ф-4.
`dividend_yield`	Дивидендная доходность	Значение показателя «Дивидендная доходность», передаваемое в форме Ф-4.

В.6. Показатели формы Ф-5 (Инвентаризация оборудования)

Поле модели	Показатель	Пояснение
`organization_name`	Наименование организации	Полное наименование организации в соответствии с отчётной формой.
`okpo`	ОКПО	Код организации по ОКПО, используется для идентификации в отчётности.
`ogrn`	ОГРН	Основной государственный регистрационный номер организации.
`inn`	ИНН	Идентификационный номер налогоплательщика организации.
`equipment_id`	Идентификационный код	Значение показателя «Идентификационный код», передаваемое в форме Ф-5.
`inventory_number`	Инвентарный номер	Значение показателя «Инвентарный номер», передаваемое в форме Ф-5.
`name`	Наименование оборудования	Значение показателя «Наименование оборудования», передаваемое в форме Ф-5.
`model`	Модель	Значение показателя «Модель», передаваемое в форме Ф-5.
`manufacturer`	Производитель	Значение показателя «Производитель», передаваемое в форме Ф-5.
`country_origin`	Страна происхождения	Значение показателя «Страна происхождения», передаваемое в форме Ф-5.
`is_domestic`	Отечественное производство	Значение показателя «Отечественное производство», передаваемое в форме Ф-5.
`year_manufacture`	Год выпуска	Значение показателя «Год выпуска», передаваемое в форме Ф-5.
`has_cnc`	Наличие ЧПУ	Значение показателя «Наличие ЧПУ», передаваемое в форме Ф-5.
`equipment_type`	Тип оборудования	Значение показателя «Тип оборудования», передаваемое в форме Ф-5.
`equipment_category`	Категория оборудования	Значение показателя «Категория оборудования», передаваемое в форме Ф-5.
`commissioning_date`	Дата ввода в эксплуатацию	Значение показателя «Дата ввода в эксплуатацию», передаваемое в форме Ф-5.
`location`	Местонахождение	Значение показателя «Местонахождение», передаваемое в форме Ф-5.
`production_site`	Производственный участок	Значение показателя «Производственный участок», передаваемое в форме Ф-5.
`utilization_rate`	Коэффициент использования	Значение показателя «Коэффициент использования», передаваемое в форме Ф-5.
`physical_wear_percent`	Фактический износ, %	Значение показателя «Фактический износ, %», передаваемое в форме Ф-5.
`is_operational`	В рабочем состоянии	Значение показателя «В рабочем состоянии», передаваемое в форме Ф-5.
`requires_repair`	Требует ремонта	Значение показателя «Требует ремонта», передаваемое в форме Ф-5.
`requires_replacement`	Требует замены	Значение показателя «Требует замены», передаваемое в форме Ф-5.
`initial_cost`	Первоначальная стоимость	Значение показателя «Первоначальная стоимость», передаваемое в форме Ф-5.
`residual_value`	Остаточная стоимость	Значение показателя «Остаточная стоимость», передаваемое в форме Ф-5.
`notes`	Примечания	Значение показателя «Примечания», передаваемое в форме Ф-5.

В.7. Показатели формы Ф-6 (Возрастная структура оборудования)

Поле модели	Показатель	Пояснение
`organization_name`	Наименование организации	Полное наименование организации в соответствии с отчётной формой.
`okpo`	ОКПО	Код организации по ОКПО, используется для идентификации в отчётности.
`ogrn`	ОГРН	Основной государственный регистрационный номер организации.
`inn`	ИНН	Идентификационный номер налогоплательщика организации.
`row_code`	Код строки	Значение показателя «Код строки», передаваемое в форме Ф-6.
`category`	Категория оборудования	Значение показателя «Категория оборудования», передаваемое в форме Ф-6.
`total_equipment`	Всего оборудования	Значение показателя «Всего оборудования», передаваемое в форме Ф-6.
`domestic_equipment`	Отечественное оборудование	Значение показателя «Отечественное оборудование», передаваемое в форме Ф-6.
`imported_equipment`	Импортное оборудование	Значение показателя «Импортное оборудование», передаваемое в форме Ф-6.
`age_under_5`	До 5 лет	Значение показателя «До 5 лет», передаваемое в форме Ф-6.
`age_5_10`	5-10 лет	Значение показателя «5-10 лет», передаваемое в форме Ф-6.
`age_10_15`	10-15 лет	Значение показателя «10-15 лет», передаваемое в форме Ф-6.
`age_15_20`	15-20 лет	Значение показателя «15-20 лет», передаваемое в форме Ф-6.
`age_over_20`	Свыше 20 лет	Значение показателя «Свыше 20 лет», передаваемое в форме Ф-6.
`cnc_total`	С ЧПУ всего	Значение показателя «С ЧПУ всего», передаваемое в форме Ф-6.
`cnc_under_5`	С ЧПУ до 5 лет	Значение показателя «С ЧПУ до 5 лет», передаваемое в форме Ф-6.
`cnc_5_10`	С ЧПУ 5-10 лет	Значение показателя «С ЧПУ 5-10 лет», передаваемое в форме Ф-6.
`cnc_10_15`	С ЧПУ 10-15 лет	Значение показателя «С ЧПУ 10-15 лет», передаваемое в форме Ф-6.
`cnc_15_20`	С ЧПУ 15-20 лет	Значение показателя «С ЧПУ 15-20 лет», передаваемое в форме Ф-6.
`cnc_over_20`	С ЧПУ свыше 20 лет	Значение показателя «С ЧПУ свыше 20 лет», передаваемое в форме Ф-6.
`avg_shift_work`	Средняя сменность работы	Значение показателя «Средняя сменность работы», передаваемое в форме Ф-6.
`utilization_rate`	Коэффициент загрузки	Значение показателя «Коэффициент загрузки», передаваемое в форме Ф-6.
`physical_wear_percent`	Физический износ, %	Значение показателя «Физический износ, %», передаваемое в форме Ф-6.
`workplaces_without_equipment`	Рабочие места без оборудования	Значение показателя «Рабочие места без оборудования», передаваемое в форме Ф-6.
`equipment_to_replace`	Оборудование к замене	Значение показателя «Оборудование к замене», передаваемое в форме Ф-6.

137 KiB Raw Permalink Blame History Unescape Escape

ТЕХНИЧЕСКОЕ ОПИСАНИЕ ПРОГРАММНОГО КОМПЛЕКСА УЧЁТА И ОБРАБОТКИ ОТЧЁТНЫХ ФОРМ ГОСКОРПОРАЦИЙ (STATE CORP BACKEND)

СОДЕРЖАНИЕ

1. ОБЩИЕ СВЕДЕНИЯ О ПРОГРАММНОМ ОБЕСПЕЧЕНИИ

1.1. Назначение системы

1.2. Используемый технологический стек

1.3. Библиотеки для обработки и валидации данных

1.4. Термины и сокращения

2. ОПИСАНИЕ ПРОГРАММНОЙ РЕАЛИЗАЦИИ МОДЕЛЕЙ ИНФОРМАЦИОННОГО ОБМЕНА И СБОРА ДАННЫХ

2.1. Архитектура подсистемы загрузки и парсинга

2.2. Алгоритмы загрузки данных по ключевым формам

2.2.1. Форма Ф‑1 (выпуск продукции)

2.2.2. Форма Ф‑2 (бухгалтерский баланс)

2.2.3. Формы Ф‑5 и Ф‑6 (оборудование)

2.3. Механизмы контроля качества и безопасной загрузки

2.3.1. Валидация ключевых идентификаторов

2.3.2. Идентификация пакетов и прослеживаемость

2.3.3. Фоновая обработка и контроль прогресса

3. ПРОГРАММНО-ТЕХНОЛОГИЧЕСКИЕ РЕШЕНИЯ ПО СИСТЕМАТИЗАЦИИ И ОБРАБОТКЕ ДАННЫХ

3.1. Слой хранения данных (База данных)

3.1.1. СУБД PostgreSQL

3.1.2. Проектирование моделей данных и миксины

3.2. Сервисный слой и бизнес-логика

4. СТРУКТУРА БАЗЫ ДАННЫХ

4.1. Общие сведения о схеме данных

4.1.1. Перечень таблиц базы данных

4.1.2. Общие правила именования

4.1.3. Типовые поля

4.2. Таблица organization_organization

4.2.1. Полный перечень полей

4.2.2. Модель (фрагмент кода)

4.3. Таблица form_1_formf1record

4.3.1. Полный перечень полей

4.4. Таблица form_2_formf2record

4.4.1. Полный перечень полей

4.5. Таблица form_3_formf3record

4.5.1. Полный перечень полей

4.6. Таблица form_4_formf4record

4.6.1. Полный перечень полей

4.7. Таблица form_5_formf5record

4.7.1. Полный перечень полей

4.8. Таблица form_6_formf6record

4.8.1. Полный перечень полей

4.9. Таблица core_backgroundjob

4.9.1. Полный перечень полей

4.10. Таблица users

4.10.1. Полный перечень полей

4.11. Таблица profiles

4.11.1. Полный перечень полей

4.12. Диаграмма связей между таблицами

5. АРХИТЕКТУРА ПРОГРАММНОГО ИНТЕРФЕЙСА (API)

5.1. Общие сведения

5.1.1. Принципы взаимодействия

5.1.2. Формат запросов

5.1.3. Формат ответов

5.2. Аутентификация и авторизация

5.3. Структура API

5.4. API пользователей и профилей

5.5. API организаций

5.6. API формы Ф‑1

5.7. API формы Ф‑2

5.8. API формы Ф‑3

5.9. API формы Ф‑4

5.10. API формы Ф‑5 и Ф‑6

5.11. Коды ответов HTTP и формат ошибок

6. МЕХАНИЗМЫ ОБЕСПЕЧЕНИЯ НАДЁЖНОСТИ И ОТКАЗОУСТОЙЧИВОСТИ

6.1. Система фоновых задач (BackgroundJobs)

6.2. Инкрементальная загрузка и идентификация пакетов

6.3. Валидация, дедупликация и целостность

6.4. Логирование, мониторинг и health-check

6.5. Требования к информационной безопасности

6.6. Эксплуатационные регламенты

6.7. Сценарии отказов и реакции

7. ПОРЯДОК РАЗВЁРТЫВАНИЯ И ИСПЫТАНИЙ

7.1. Подготовка операционной среды

7.2. Развёртывание и запуск

7.3. Проверка качества и тестирование

8. ЗАКЛЮЧЕНИЕ

ПРИЛОЖЕНИЕ А (ОБЯЗАТЕЛЬНОЕ). ФОРМАТЫ ВХОДНЫХ EXCEL-ШАБЛОНОВ

А.1. Общие требования к Excel‑файлам

137 KiB

Raw Permalink Blame History

4.2. Таблица `organization_organization`

4.3. Таблица `form_1_formf1record`

4.4. Таблица `form_2_formf2record`

4.5. Таблица `form_3_formf3record`

4.6. Таблица `form_4_formf4record`

4.7. Таблица `form_5_formf5record`

4.8. Таблица `form_6_formf6record`

4.9. Таблица `core_backgroundjob`

4.10. Таблица `users`

4.11. Таблица `profiles`