Разработка:storages/contracts

Плагин
Название	contracts
Тип	storages

Таблица в базе данных

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

Подробный формат полей в таблице:

• typeid - тип договора, если у учебного заведения предусмотрено несколько разных типов договоров
• num - номер договора
• numpass - номер пропуска, студенческого билета и т.п.
• date - дата заключения
• sellerid - куратор (id по таблице persons )
• clientid - клиент, оплачивающий обучение (законный представитель, сам совершеннолетний ученик или куратор от организации, может принимать значение 0 или null, если клиент создается, а контракт имеет черновой вариант) (по таблице persons )
• studentid - ученик ( может принимать значение 0, если ученик создается, а контракт имеет черновой вариант) (по таблице persons )
• adddate - дата добавления в БД
• notes - заметки
• departmentid - подразделение в таблице departments , к которому приписан контракт на обучение (например, принявшее ученика)
• status - список статусов указан в одноименном плагине рабочих процессов contracts
• contractform - форма договора (шаблон)
• organizationid - юридическое лицо в таблице organizations , оплачивающее договор, если ученик платит за себя сам - то не указывается.
• curatorid - куратор данного ученика от работодателя (по таблице persons или не указан)
• enddate - дата окончания договора

Дополнительные методы:

get_list_by_seller()

Ищет список действующих контрактов для куратора.

Аргументы:

• $pid() - id персоны-куратора в таблице persons , по умолчанию - нет(null).

Возвращаемые значения:

• (array) список контрактов.
• (bool) false если контракты не найдены.

Структура работы:

1. если id персоны не указано, устанавливаем id текущего пользователя.
2. по SQL-запросу находим список необходимых контрактов.

get_list_by_client()

Ищет список действующих контрактов для клиента.

Аргументы:

• $pid(int) - id персоны-клиента в таблице persons , по умолчанию - нет(null).

Возвращаемые значения:

• (array) список контрактов.
• (bool) false если контракты не найдены.

Структура работы:

1. если id персоны не указано, устанавливаем id текущего пользователя.
2. по SQL-запросу находим список необходимых контрактов.

get_list_by_student()

Ищет список действующих контрактов для студента.

Аргументы:

• $pid(int) - id персоны-студента в таблице persons , по умолчанию - нет(null).

Возвращаемые значения:

• (array) список контрактов.
• (bool) false если контракты не найдены.

Структура работы:

1. если id персоны не указано, устанавливаем id текущего пользователя.
2. по SQL-запросу находим список необходимых контрактов.

get_list_by_status()

Ищет список контрактов по статусу.

Аргументы:

• $status(string) - статус контракта.

Возвращаемые значения:

• (array) список контрактов.
• (bool) false если контракты не найдены.

Структура работы:

По SQL-запросу находим список необходимых контрактов.

is_person_used()

Проверяет есть ли другие активные договора, где используется учетная запись.

Аргументы:

• $pid(int) - id персоны в таблице persons .
• $except(int) - id контракта в таблице contracts , который следует исключить, по умолчанию - нет (null).

Возвращаемые значения:

• (bool) true если контракты были найдены и false, если их нет.

Структура работы:

1. формируем SQL-запрос.
2. если задан контракт, который слудует исключить, исключаем его из поиска.
3. находим конракты и возвращаем результат.

is_seller()

Проверяет является ли персона куратором по контракту.

Аргументы:

• $contractid(int) - id контракта в таблице contracts .
• $personid(int) - id персоны в таблице persons .

Возвращаемые значения:

• (bool) true - да и false - нет.

Планы:

Дополнительные методы:

• Сгенерировать номер контракта
• Найти контракт по номеру
• Найти контракт по номеру пропуска
• Найти список действующих контрактов, относящихся к структурному подразделению