Feature/document of document option

[scrubele]

Пов'язаність документів

Даний функціонал є частиною функціоналу підписання контракту постачальником.

Підсумок:

Для розширення системи функціоналом Е-Контрактингу у даному PR внесли наступні зміни:

• Ввели тип підпорядкування documentOf – document
• Додали валідації validate_relatedItem_for_contract_document_uploading, validate_relatedItem_for_contract_document_uploading

Модель Document (Tender):

Для поєднання нових типів документів між собою було введено тип підпорядкування поля documentOf – document, Він надасть можливість пов’язати між собою відповідні документи об'єкту Tender для генерації документу Contract.

ProzorroUKR-openprocurement.api/src/openprocurement/tender/core/models.py

Lines 151 to 152 in dffb0b9

	documentOf = StringType(required=True, choices=[
	"tender", "item", "lot", "document"], default="tender")

Для валідації прив'язаного документу змінили функціонал validate_related_item наступним чином:

ProzorroUKR-openprocurement.api/src/openprocurement/tender/core/models.py

Lines 178 to 181 in b84a5ab

	if data.get("documentOf") == "document":
	documents = get_all_nested_from_the_object("documents",tender) + get_all_nested_from_the_object("documents",parent)
	if relatedItem not in [i.id for i in documents]:
	raise ValidationError(u"relatedItem should be one of documents")

Даний функціонал перевіряє, чи документи є вкладені в межах одного об'єкту Tender, обмежує перехресну та зовнішню прив'язку документів .

У процедурі closeFrameworkAgreementSelectionUA було додано нову модель ContractDocument.

Валідації запитів:

Для реалізації прив'язаності документів під часу процecу Contract document signing, додана валідація для перевірки, чи відповідні документи належать об'єкту Contract:

Валідація викликається з TenderAwardContractDocumentResource, тому, в межах запиту parent завжди буде об'єкт Contract.

ProzorroUKR-openprocurement.api/src/openprocurement/tender/core/validation.py

Lines 1619 to 1630 in b84a5ab

	def validate_relatedItem_for_contract_document_uploading(request):
	if "data" in request.validated:
	data = request.validated["data"]
	parent = data["__parent__"]
	documents = []
	if hasattr(parent, "documents"):
	documents = parent.documents
	elif hasattr(parent["__parent__"], "documents"):
	documents = parent["__parent__"].documents
	if data.get("documentOf") == "document" and data.get('relatedItem') not in [i.id for i in documents]:
	raise_operation_error(
	request, "relatedItem should be one of contract documents")

У процесі підисання контракту (Contract document signing) постачальнику (contarct_supplier):

• заборонено прикріплювати нові документи до об'єкту Tender та Contract;
• серед документів лише дозволено завантажувати ЄЦП у форматі application/pkcs7-signature.

Функціонал перевірки у наступній валідації:

ProzorroUKR-openprocurement.api/src/openprocurement/tender/core/validation.py

Lines 1592 to 1616 in b84a5ab

	def validate_contract_supplier_role_for_contract_document_uploading(request):
	if request.authenticated_role in ("contract_supplier"):
	if 'file' in request.validated:
	raise_operation_error(
	request, "Supplier can't {} contract documents".format(
	OPERATIONS.get(request.method))
	)
	elif "data" in request.validated:
	data = request.validated["data"]
	if data["documentOf"] == "document":
	if data["format"] != "application/pkcs7-signature":
	raise_operation_error(
	request, "Supplier can {} only 'application/pkcs7-signature' document format files".format(
	OPERATIONS.get(request.method))
	)
	else:
	raise_operation_error(
	request, "Supplier can't {} {} documents".format(
	OPERATIONS.get(request.method), data["documentOf"])
	)
	elif request.content_type != "application/pkcs7-signature":
	raise_operation_error(
	request, "Supplier can {} only 'application/pkcs7-signature' document format files".format(
	OPERATIONS.get(request.method))
	)