feat: Refactor CPuls entity and related resources; enhance localization, update layouts, and improve validation logic

This commit is contained in:
2026-02-13 10:28:21 +01:00
parent e1a963ffab
commit bf7eaa965f
12 changed files with 175 additions and 191 deletions

View File

@@ -1,121 +1,90 @@
<?php
namespace Espo\Custom\Api\CPuls;
use Espo\Core\Api\Action;
use Espo\Core\Api\Request;
use Espo\Core\Api\Response;
use Espo\Core\Api\ResponseComposer;
use Espo\Core\Exceptions\BadRequest;
use Espo\Core\Exceptions\Forbidden;
use Espo\Core\Exceptions\NotFound;
use Espo\ORM\EntityManager;
class AbschliessenFuerTeam implements Action
{
public function __construct(
private \Espo\ORM\EntityManager $entityManager,
private \Espo\Core\Acl\Table $acl,
private \Espo\Entities\User $user,
private \Espo\Core\Utils\Log $log
private EntityManager $entityManager
) {}
public function process(Request $request): Response
{
$pulsId = $request->getRouteParam('id');
$data = $request->getParsedBody();
$teamId = $data->teamId ?? null;
if (!$pulsId || !$teamId) {
throw new BadRequest('pulsId oder teamId fehlt');
$id = $request->getRouteParam('id');
if (!$id) {
throw new BadRequest('ID fehlt.');
}
// 1. Validierung: Ist User in diesem Team?
$userTeams = $this->user->getLinkMultipleIdList('teams');
if (!in_array($teamId, $userTeams)) {
throw new Forbidden('User nicht in angegebenem Team');
}
// 2. Lade Puls
$puls = $this->entityManager->getEntity('CPuls', $pulsId);
$puls = $this->entityManager->getEntityById('CPuls', $id);
if (!$puls) {
throw new NotFound('Puls nicht gefunden');
throw new NotFound('Puls nicht gefunden.');
}
// 3. Validierung: syncStatus = clean?
if ($puls->get('syncStatus') !== 'clean') {
throw new BadRequest('Puls hat neue Dokumente (unclean) - bitte warten Sie auf die KI-Analyse');
// Prüfe, ob bereits finalisiert
if ($puls->get('status') === 'Finalisiert') {
throw new Forbidden('Puls wurde bereits finalisiert.');
}
// 4. Finde Zuordnung
$zuordnung = $this->entityManager
->getRDBRepository('CPulsTeamZuordnung')
// Prüfe syncStatus
if ($puls->get('syncStatus') === 'unclean') {
throw new BadRequest('Neue Dokumente vorhanden. Bitte warten Sie auf die KI-Analyse.');
}
// Hole aktuelle Team-ID des Benutzers
$user = $this->entityManager->getEntityById('User', $request->getServerParam('ESPO_USER_ID'));
if (!$user) {
throw new Forbidden('Benutzer nicht gefunden.');
}
$teamIds = $user->getLinkMultipleIdList('teams');
if (empty($teamIds)) {
throw new Forbidden('Sie sind keinem Team zugeordnet.');
}
// Finde Zuordnung für erstes Team des Benutzers
$zuordnung = $this->entityManager->getRDBRepositoryByClass('CPulsTeamZuordnung')
->where([
'pulsId' => $pulsId,
'teamId' => $teamId,
'pulsId' => $id,
'teamId' => $teamIds,
'aktiv' => true
])
->findOne();
if (!$zuordnung) {
throw new NotFound('Team-Zuordnung nicht gefunden oder nicht aktiv');
throw new Forbidden('Sie sind diesem Puls nicht zugeordnet oder nicht aktiv.');
}
// 5. Bereits abgeschlossen?
if ($zuordnung->get('abgeschlossen')) {
return Response::json([
'success' => true,
'message' => 'Bereits abgeschlossen',
'alreadyCompleted' => true
]);
}
// 6. Abschluss setzen
// Markiere Zuordnung als abgeschlossen
$zuordnung->set([
'abgeschlossen' => true,
'abgeschlossenAm' => date('Y-m-d H:i:s'),
'abgeschlossenVonId' => $this->user->getId()
'abgeschlossenVon' => $user->getId()
]);
$this->entityManager->saveEntity($zuordnung);
// 6.5. FIRST-READ-CLOSES: Finalisiere Block bei erstem Abschluss
if (!$puls->get('finalisiert')) {
$puls->set([
'finalisiert' => true,
'finalisierungsGrund' => 'Erstes Team',
'finalisiertAm' => date('Y-m-d H:i:s'),
'finalisiertVonId' => $this->user->getId()
]);
$this->log->info("Block finalisiert durch erstes Team (Team {$teamId}, User {$this->user->getId()})");
}
// 7. Prüfe: Alle Teams abgeschlossen?
$offeneTeams = $this->entityManager
->getRDBRepository('CPulsTeamZuordnung')
->where([
'pulsId' => $pulsId,
'aktiv' => true,
'abgeschlossen' => false
])
->count();
// 8. Update Puls-Status
if ($offeneTeams === 0) {
$puls->set('status', 'Abgeschlossen');
} else {
$puls->set('status', 'Teilweise abgeschlossen');
}
// FIRST-READ-CLOSES: Finalisiere den Puls sofort
$puls->set([
'status' => 'Finalisiert',
'finalisiertAm' => date('Y-m-d H:i:s'),
'finalisiertVon' => $user->getId()
]);
$this->entityManager->saveEntity($puls);
$this->log->info("Team {$teamId} hat Puls {$pulsId} abgeschlossen");
return Response::json([
$GLOBALS['log']->info("Puls {$id} durch Team {$zuordnung->get('teamId')} finalisiert (First-Read-Closes).");
return ResponseComposer::json([
'success' => true,
'status' => $puls->get('status'),
'finalisiert' => $puls->get('finalisiert'),
'offeneTeams' => $offeneTeams
'finalized' => true,
'message' => 'Puls wurde finalisiert (First-Read-Closes).'
]);
}
}