Initial commit

This commit is contained in:
root
2026-01-19 17:44:46 +01:00
commit 823af8b11d
8721 changed files with 1130846 additions and 0 deletions

View File

@@ -0,0 +1,218 @@
<?php
/************************************************************************
* This file is part of EspoCRM.
*
* EspoCRM Open Source CRM application.
* Copyright (C) 2014-2025 EspoCRM, Inc.
* Website: https://www.espocrm.com
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*
* The interactive user interfaces in modified source and object code versions
* of this program must display Appropriate Legal Notices, as required under
* Section 5 of the GNU Affero General Public License version 3.
*
* In accordance with Section 7(b) of the GNU Affero General Public License version 3,
* these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
************************************************************************/
namespace Espo\Core\Repositories;
use Espo\ORM\Entity;
use Espo\ORM\Mapper\BaseMapper;
use Espo\ORM\Name\Attribute;
use Espo\ORM\Query\Part\Order;
/**
* @template TEntity of Entity
* @extends Database<Entity>
*/
class CategoryTree extends Database
{
private const ATTR_ORDER = 'order';
private const ATTR_PARENT_ID = 'parentId';
protected function beforeSave(Entity $entity, array $options = [])
{
if ($entity->get(self::ATTR_ORDER) === null && $entity->hasAttribute(self::ATTR_ORDER)) {
$this->setOrderToEnd($entity);
}
parent::beforeSave($entity, $options);
}
/**
* @param array<string, mixed> $options
* @return void
*/
protected function afterSave(Entity $entity, array $options = [])
{
parent::afterSave($entity, $options);
$parentId = $entity->get(self::ATTR_PARENT_ID);
$em = $this->entityManager;
$pathEntityType = $entity->getEntityType() . 'Path';
if ($entity->isNew()) {
if ($parentId) {
$subSelect1 = $em->getQueryBuilder()
->select()
->from($pathEntityType)
->select(['ascendorId', "'" . $entity->getId() . "'"])
->where([
'descendorId' => $parentId,
])
->build();
$subSelect2 = $em->getQueryBuilder()
->select()
->select(["'" . $entity->getId() . "'", "'" . $entity->getId() . "'"])
->build();
$select = $em->getQueryBuilder()
->union()
->all()
->query($subSelect1)
->query($subSelect2)
->build();
$insert = $em->getQueryBuilder()
->insert()
->into($pathEntityType)
->columns(['ascendorId', 'descendorId'])
->valuesQuery($select)
->build();
$em->getQueryExecutor()->execute($insert);
return;
}
$insert = $em->getQueryBuilder()
->insert()
->into($pathEntityType)
->columns(['ascendorId', 'descendorId'])
->values([
'ascendorId' => $entity->getId(),
'descendorId' => $entity->getId(),
])
->build();
$em->getQueryExecutor()->execute($insert);
return;
}
if (!$entity->isAttributeChanged(self::ATTR_PARENT_ID)) {
return;
}
$delete = $em->getQueryBuilder()
->delete()
->from($pathEntityType, 'a')
->join(
$pathEntityType,
'd',
[
'd.descendorId:' => 'a.descendorId',
]
)
->leftJoin(
$pathEntityType,
'x',
[
'x.ascendorId:' => 'd.descendorId',
'x.descendorId:' => 'a.ascendorId',
]
)
->where([
'd.descendorId' => $entity->getId(),
'x.ascendorId' => null,
])
->build();
$em->getQueryExecutor()->execute($delete);
if (!empty($parentId)) {
$select = $em->getQueryBuilder()
->select()
->from($pathEntityType)
->select(['ascendorId', 's.descendorId'])
->join($pathEntityType, 's')
->where([
's.ascendorId' => $entity->getId(),
'descendorId' => $parentId,
])
->build();
$insert = $em->getQueryBuilder()
->insert()
->into($pathEntityType)
->columns(['ascendorId', 'descendorId'])
->valuesQuery($select)
->build();
$em->getQueryExecutor()->execute($insert);
}
}
protected function afterRemove(Entity $entity, array $options = [])
{
parent::afterRemove($entity, $options);
$pathEntityType = $entity->getEntityType() . 'Path';
$em = $this->entityManager;
$delete = $em->getQueryBuilder()
->delete()
->from($pathEntityType)
->where([
'descendorId' => $entity->getId(),
])
->build();
$em->getQueryExecutor()->execute($delete);
$mapper = $em->getMapper();
if (!$mapper instanceof BaseMapper) {
return;
}
$mapper->deleteFromDb($entity->getEntityType(), $entity->getId());
}
private function setOrderToEnd(Entity $entity): void
{
$parentId = $entity->get(self::ATTR_PARENT_ID);
$where = [self::ATTR_PARENT_ID => $parentId];
if (!$entity->isNew()) {
$where[Attribute::ID . '!='] = $entity->getId();
}
$last = $this
->where($where)
->order(self::ATTR_ORDER, Order::DESC)
->findOne();
$order = $last ? ($last->get(self::ATTR_ORDER) + 1) : 1;
$entity->set(self::ATTR_ORDER, $order);
}
}

View File

@@ -0,0 +1,486 @@
<?php
/************************************************************************
* This file is part of EspoCRM.
*
* EspoCRM Open Source CRM application.
* Copyright (C) 2014-2025 EspoCRM, Inc.
* Website: https://www.espocrm.com
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*
* The interactive user interfaces in modified source and object code versions
* of this program must display Appropriate Legal Notices, as required under
* Section 5 of the GNU Affero General Public License version 3.
*
* In accordance with Section 7(b) of the GNU Affero General Public License version 3,
* these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
************************************************************************/
namespace Espo\Core\Repositories;
use Espo\Core\Name\Field;
use Espo\Core\ORM\Repository\Option\SaveOption;
use Espo\Core\Utils\SystemUser;
use Espo\ORM\BaseEntity;
use Espo\ORM\Defs\Params\AttributeParam;
use Espo\ORM\Defs\Params\RelationParam;
use Espo\ORM\Entity;
use Espo\ORM\Relation\RelationsMap;
use Espo\ORM\Repository\RDBRepository;
use Espo\Core\ORM\EntityFactory;
use Espo\Core\ORM\EntityManager;
use Espo\Core\ORM\Repository\HookMediator;
use Espo\Core\ApplicationState;
use Espo\Core\HookManager;
use Espo\Core\Utils\DateTime as DateTimeUtil;
use Espo\Core\Utils\Id\RecordIdGenerator;
use Espo\Core\Utils\Metadata;
use stdClass;
/**
* A database repository. Extending is not recommended. Use hooks, field saver framework instead.
*
* @template TEntity of Entity
* @extends RDBRepository<TEntity>
*/
class Database extends RDBRepository
{
private const ATTR_ID = 'id';
private const ATTR_CREATED_BY_ID = Field::CREATED_BY . 'Id';
private const ATTR_MODIFIED_BY_ID = Field::MODIFIED_BY . 'Id';
private const ATTR_MODIFIED_BY_NAME = Field::MODIFIED_BY . 'Name';
private const ATTR_CREATED_AT = Field::CREATED_AT;
private const ATTR_MODIFIED_AT = Field::MODIFIED_AT;
/**
* Disables hook processing.
* @var bool
*/
protected $hooksDisabled = false;
/** @var ?array<string, mixed> */
private $restoreData = null;
/** @var Metadata */
protected $metadata;
/** @var HookManager */
protected $hookManager;
/** @var ApplicationState */
protected $applicationState;
/** @var RecordIdGenerator */
protected $recordIdGenerator;
public function __construct(
string $entityType,
EntityManager $entityManager,
EntityFactory $entityFactory,
Metadata $metadata,
HookManager $hookManager,
ApplicationState $applicationState,
RecordIdGenerator $recordIdGenerator,
private SystemUser $systemUser,
?RelationsMap $relationsMap,
) {
$this->metadata = $metadata;
$this->hookManager = $hookManager;
$this->applicationState = $applicationState;
$this->recordIdGenerator = $recordIdGenerator;
$this->hooksDisabled = $this->hooksDisabled || $metadata->get("entityDefs.$entityType.hooksDisabled");
$hookMediator = null;
if (!$this->hooksDisabled) {
$hookMediator = new HookMediator($hookManager);
}
parent::__construct($entityType, $entityManager, $entityFactory, $hookMediator, $relationsMap);
}
/**
* @deprecated Use `$this->metadata`.
*/
protected function getMetadata() /** @phpstan-ignore-line */
{
return $this->metadata;
}
/**
* @deprecated Will be removed.
*/
public function handleSelectParams(&$params) /** @phpstan-ignore-line */
{}
/**
* @param TEntity $entity
* @param array<string, mixed> $options
*/
public function save(Entity $entity, array $options = []): void
{
if (
$entity->isNew() &&
!$entity->has(self::ATTR_ID) &&
!$this->getAttributeParam($entity, self::ATTR_ID, AttributeParam::AUTOINCREMENT)
) {
$entity->set(self::ATTR_ID, $this->recordIdGenerator->generate());
}
if (empty($options[SaveOption::SKIP_ALL])) {
$this->processCreatedAndModifiedFieldsSave($entity, $options);
}
$this->restoreData = [];
parent::save($entity, $options);
}
/**
* @deprecated Do not extend. Use hooks.
*
* @param TEntity $entity
* @param array<string, mixed> $options
* @return void
*/
protected function beforeRemove(Entity $entity, array $options = [])
{
parent::beforeRemove($entity, $options);
if (!$this->hooksDisabled && empty($options[SaveOption::SKIP_HOOKS])) {
$this->hookManager->process($this->entityType, 'beforeRemove', $entity, $options);
}
$nowString = DateTimeUtil::getSystemNowString();
if ($entity->hasAttribute(self::ATTR_MODIFIED_AT)) {
$entity->set(self::ATTR_MODIFIED_AT, $nowString);
}
if ($entity->hasAttribute(self::ATTR_MODIFIED_BY_ID)) {
$modifiedById = $options[SaveOption::MODIFIED_BY_ID] ?? null;
if ($modifiedById === SystemUser::NAME) {
// For bc.
$modifiedById = $this->systemUser->getId();
}
if (!$modifiedById && $this->applicationState->hasUser()) {
$modifiedById = $this->applicationState->getUser()->getId();
}
if ($modifiedById) {
$entity->set(self::ATTR_MODIFIED_BY_ID, $modifiedById);
}
}
}
/**
* @deprecated Do not extend. Use hooks.
*
* @param TEntity $entity
* @param array<string, mixed> $options
* @return void
*/
protected function afterRemove(Entity $entity, array $options = [])
{
parent::afterRemove($entity, $options);
if (!$this->hooksDisabled && empty($options[SaveOption::SKIP_HOOKS])) {
$this->hookManager->process($this->entityType, 'afterRemove', $entity, $options);
}
}
/**
* @deprecated Do not extend.
*
* @param TEntity $entity
* @param string $relationName
* @param array<string, mixed> $params
* @param array<string, mixed> $options
* @return void
*/
protected function afterMassRelate(Entity $entity, $relationName, array $params = [], array $options = [])
{
if ($this->hooksDisabled || !empty($options[SaveOption::SKIP_HOOKS])) {
return;
}
$hookData = [
'relationName' => $relationName,
'relationParams' => $params,
];
$this->hookManager->process(
$this->entityType,
'afterMassRelate',
$entity,
$options,
$hookData
);
}
/**
* @deprecated Do not extend. Use hooks.
*
* @param TEntity $entity
* @param string $relationName
* @param Entity|string $foreign
* @param stdClass|array<string, mixed>|null $data
* @param array<string, mixed> $options
* @return void
*/
protected function afterRelate(Entity $entity, $relationName, $foreign, $data = null, array $options = [])
{
if ($this->hooksDisabled || !empty($options[SaveOption::SKIP_HOOKS])) {
return;
}
if (is_string($foreign)) {
$foreignId = $foreign;
$foreignEntityType = $this->getRelationParam($entity, $relationName, RelationParam::ENTITY);
if ($foreignEntityType) {
$foreign = $this->entityManager->getNewEntity($foreignEntityType);
$foreign->set(self::ATTR_ID, $foreignId);
$foreign->setAsFetched();
if ($foreign instanceof BaseEntity) {
$foreign->setAsPartiallyLoaded();
}
}
}
if ($foreign instanceof Entity) {
if (is_object($data)) {
$data = (array) $data;
}
$this->hookMediator->afterRelate($entity, $relationName, $foreign, $data, $options);
}
}
/**
* @deprecated Do not extend. Use hooks.
*
* @param TEntity $entity
* @param string $relationName
* @param Entity|string $foreign
* @param array<string, mixed> $options
* @return void
*/
protected function afterUnrelate(Entity $entity, $relationName, $foreign, array $options = [])
{
if ($this->hooksDisabled || !empty($options[SaveOption::SKIP_HOOKS])) {
return;
}
if (is_string($foreign)) {
$foreignId = $foreign;
$foreignEntityType = $this->getRelationParam($entity, $relationName, RelationParam::ENTITY);
if ($foreignEntityType) {
$foreign = $this->entityManager->getNewEntity($foreignEntityType);
$foreign->set(self::ATTR_ID, $foreignId);
$foreign->setAsFetched();
if ($foreign instanceof BaseEntity) {
$foreign->setAsPartiallyLoaded();
}
}
}
if ($foreign instanceof Entity) {
$this->hookMediator->afterUnrelate($entity, $relationName, $foreign, $options);
}
}
/**
* @deprecated Do not extend. Use hooks.
*
* @param TEntity $entity
* @param array<string, mixed> $options
* @return void
*/
protected function beforeSave(Entity $entity, array $options = [])
{
parent::beforeSave($entity, $options);
if (!$this->hooksDisabled && empty($options[SaveOption::SKIP_HOOKS])) {
$this->hookManager->process($this->entityType, 'beforeSave', $entity, $options);
}
}
/**
* @deprecated Do not extend. Use hooks.
*
* @param TEntity $entity
* @param array<string, mixed> $options
* @return void
*/
protected function afterSave(Entity $entity, array $options = [])
{
if (!empty($this->restoreData)) {
$entity->set($this->restoreData);
$this->restoreData = null;
}
parent::afterSave($entity, $options);
if (!$this->hooksDisabled && empty($options[SaveOption::SKIP_HOOKS])) {
$this->hookManager->process($this->entityType, 'afterSave', $entity, $options);
}
}
/**
* @param TEntity $entity
* @param array<string, mixed> $options
*/
private function processCreatedAndModifiedFieldsSave(Entity $entity, array $options): void
{
if ($entity->isNew()) {
$this->processCreatedAndModifiedFieldsSaveNew($entity, $options);
return;
}
$nowString = DateTimeUtil::getSystemNowString();
if (
!empty($options[SaveOption::SILENT]) ||
!empty($options[SaveOption::SKIP_MODIFIED_BY])
) {
return;
}
$isChanged = false;
foreach ($entity->getAttributeList() as $attribute) {
if ($entity->isAttributeChanged($attribute)) {
$isChanged = true;
break;
}
}
if (!$isChanged && empty($options[SaveOption::MODIFIED_BY_ID])) {
return;
}
if ($entity->hasAttribute(self::ATTR_MODIFIED_AT)) {
$entity->set(self::ATTR_MODIFIED_AT, $nowString);
}
if ($entity->hasAttribute(self::ATTR_MODIFIED_BY_ID)) {
$modifiedById = $options[SaveOption::MODIFIED_BY_ID] ?? null;
if ($modifiedById === SystemUser::NAME) {
// For bc.
$modifiedById = $this->systemUser->getId();
}
if ($modifiedById) {
$entity->set(self::ATTR_MODIFIED_BY_ID, $modifiedById);
} else if ($this->applicationState->hasUser()) {
$user = $this->applicationState->getUser();
$entity->set(self::ATTR_MODIFIED_BY_ID, $user->getId());
$entity->set(self::ATTR_MODIFIED_BY_NAME, $user->getName());
}
}
}
/**
* @param TEntity $entity
* @param array<string, mixed> $options
*/
private function processCreatedAndModifiedFieldsSaveNew(Entity $entity, array $options): void
{
$nowString = DateTimeUtil::getSystemNowString();
if (
$entity->hasAttribute(self::ATTR_CREATED_AT) &&
(empty($options[SaveOption::IMPORT]) || !$entity->has(self::ATTR_CREATED_AT))
) {
$entity->set(self::ATTR_CREATED_AT, $nowString);
}
if ($entity->hasAttribute(self::ATTR_MODIFIED_AT)) {
$entity->set(self::ATTR_MODIFIED_AT, $nowString);
}
if ($entity->hasAttribute(self::ATTR_CREATED_BY_ID)) {
$createdById = $options[SaveOption::CREATED_BY_ID] ?? null;
if ($createdById) {
if ($createdById === SystemUser::NAME) {
// For bc.
$createdById = $this->systemUser->getId();
}
$entity->set(self::ATTR_CREATED_BY_ID, $createdById);
} else if (
empty($options[SaveOption::SKIP_CREATED_BY]) &&
(empty($options[SaveOption::IMPORT]) || !$entity->has(self::ATTR_CREATED_BY_ID)) &&
$this->applicationState->hasUser()
) {
$entity->set(self::ATTR_CREATED_BY_ID, $this->applicationState->getUser()->getId());
}
}
}
/**
* @pparam TEntity $entity
* @return mixed
*/
private function getAttributeParam(Entity $entity, string $attribute, string $param)
{
if ($entity instanceof BaseEntity) {
return $entity->getAttributeParam($attribute, $param);
}
$entityDefs = $this->entityManager
->getDefs()
->getEntity($entity->getEntityType());
if (!$entityDefs->hasAttribute($attribute)) {
return null;
}
return $entityDefs->getAttribute($attribute)->getParam($param);
}
/**
* @param TEntity $entity
* @return mixed
*/
private function getRelationParam(Entity $entity, string $relation, string $param)
{
if ($entity instanceof BaseEntity) {
return $entity->getRelationParam($relation, $param);
}
$entityDefs = $this->entityManager
->getDefs()
->getEntity($entity->getEntityType());
if (!$entityDefs->hasRelation($relation)) {
return null;
}
return $entityDefs->getRelation($relation)->getParam($param);
}
}

View File

@@ -0,0 +1,164 @@
<?php
/************************************************************************
* This file is part of EspoCRM.
*
* EspoCRM Open Source CRM application.
* Copyright (C) 2014-2025 EspoCRM, Inc.
* Website: https://www.espocrm.com
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*
* The interactive user interfaces in modified source and object code versions
* of this program must display Appropriate Legal Notices, as required under
* Section 5 of the GNU Affero General Public License version 3.
*
* In accordance with Section 7(b) of the GNU Affero General Public License version 3,
* these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
************************************************************************/
namespace Espo\Core\Repositories;
use Espo\Core\ORM\Entity as CoreEntity;
use Espo\Modules\Crm\Entities\Reminder;
use Espo\ORM\Entity;
use Espo\Core\Di;
use Espo\Core\Utils\DateTime as DateTimeUtil;
use DateTime;
use DateTimeZone;
use RuntimeException;
use Exception;
/**
* @extends Database<CoreEntity>
*/
class Event extends Database implements
Di\DateTimeAware,
Di\ConfigAware
{
use Di\DateTimeSetter;
use Di\ConfigSetter;
/**
* @param array<string, mixed> $options
* @return void
*/
protected function beforeSave(Entity $entity, array $options = [])
{
if (
$entity->isAttributeChanged('status') &&
in_array($entity->get('status'), $this->getNotActualStatuses())
) {
$entity->set('reminders', []);
}
if ($entity->has('dateStartDate')) {
$dateStartDate = $entity->get('dateStartDate');
if (!empty($dateStartDate)) {
$dateStart = $dateStartDate . ' 00:00:00';
$dateStart = $this->convertDateTimeToDefaultTimezone($dateStart);
$entity->set('dateStart', $dateStart);
} else {
/** @noinspection PhpRedundantOptionalArgumentInspection */
$entity->set('dateStartDate', null);
}
}
if ($entity->has('dateEndDate')) {
$dateEndDate = $entity->get('dateEndDate');
if (!empty($dateEndDate)) {
try {
$dt = new DateTime(
$this->convertDateTimeToDefaultTimezone($dateEndDate . ' 00:00:00')
);
} catch (Exception) {
throw new RuntimeException("Bad date-time.");
}
$dt->modify('+1 day');
$dateEnd = $dt->format(DateTimeUtil::SYSTEM_DATE_TIME_FORMAT);
$entity->set('dateEnd', $dateEnd);
} else {
/** @noinspection PhpRedundantOptionalArgumentInspection */
$entity->set('dateEndDate', null);
}
}
parent::beforeSave($entity, $options);
}
/**
* @param array<string, mixed> $options
* @return void
*/
protected function afterRemove(Entity $entity, array $options = [])
{
parent::afterRemove($entity, $options);
$delete = $this->entityManager->getQueryBuilder()
->delete()
->from(Reminder::ENTITY_TYPE)
->where([
'entityId' => $entity->getId(),
'entityType' => $entity->getEntityType(),
])
->build();
$this->entityManager->getQueryExecutor()->execute($delete);
}
/**
* @param string $string
* @return string
*/
protected function convertDateTimeToDefaultTimezone($string)
{
$timeZone = $this->config->get('timeZone') ?? 'UTC';
try {
$tz = new DateTimeZone($timeZone);
} catch (Exception $e) {
throw new RuntimeException($e->getMessage());
}
$dt = DateTime::createFromFormat(DateTimeUtil::SYSTEM_DATE_TIME_FORMAT, $string, $tz);
if ($dt === false) {
throw new RuntimeException("Could not parse date-time `$string`.");
}
$utcTz = new DateTimeZone('UTC');
return $dt
->setTimezone($utcTz)
->format(DateTimeUtil::SYSTEM_DATE_TIME_FORMAT);
}
/**
* @return string[]
*/
private function getNotActualStatuses(): array
{
return array_merge(
$this->metadata->get("scopes.$this->entityType.completedStatusList") ?? [],
$this->metadata->get("scopes.$this->entityType.canceledStatusList") ?? [],
);
}
}