[Feature] Opt into search placed candidates backend

[vd1992]

🤖 Resolves #12212

👋 Introduction

Handles some of the backend work needed as well as introduces an Artisan command.

🕵️ Details

The command will update placed term and indeterminate candidates to have suspended dates.
Placement mutations will touch the suspended date field, and search accounts for the two statuses as well.

Issue to delete command #12331

🧪 Testing

1. Test Artisan command
2. Place/revert candidates, assert field updated in database client
3. Test placed candidate searchable or not based off suspended value, such as from /en/search

🚚 Deployment

Run
php artisan app:suspend-placed-candidates

[vd1992]

Supplemented by testScopeAvailable()

[petertgiles]

Really nice work. 👏 Mostly, I'm just asking for more comments. 😆 A few things to check out but this is great work.

[petertgiles]

Very nice!

[vd1992]

@petertgiles

Appears to populate the activity log. All good to go then?

[petertgiles]

Make it so.

[petertgiles]

Could you please also try running the Eloquent command in Tinker, locally?

[vd1992]

Could you please also try running the Eloquent command in Tinker, locally?

It's a little tricky

First, the spacing/newlines can mess it up so you have to adjust it
Second, it aliases a typing incorrectly

[petertgiles]

It's a little tricky

Ah, too bad. Are you able to provide the commands that we can copy/paste for prod?

[vd1992]

It's a little tricky

Ah, too bad. Are you able to provide the commands that we can copy/paste for prod?

Going back to the facade seems to do the trick

$applicableStatuses = [PoolCandidateStatus::PLACED_TERM->name, PoolCandidateStatus::PLACED_INDETERMINATE->name];

DB::table('pool_candidates')->whereIn('pool_candidate_status', $applicableStatuses)->whereNull('suspended_at')->update(['suspended_at' => Carbon\Carbon::now()]);

[petertgiles]

I dont' think it's necessary to go back to the DB facade. You can use use commands in your Tinker environment to avoid the aliasing problems and backslashes to add multiline commands. Here's what worked for me.

use App\Enums\PoolCandidateStatus;
use App\Models\PoolCandidate;
use Illuminate\Database\Eloquent\Collection;
use Carbon\Carbon;

$applicableStatuses = [PoolCandidateStatus::PLACED_TERM->name, PoolCandidateStatus::PLACED_INDETERMINATE->name];

PoolCandidate::whereIn('pool_candidate_status', $applicableStatuses) \
    ->whereNull('suspended_at') \
    ->with('user') \
    ->chunkById(100, function (Collection $candidates) { \
        foreach ($candidates as $candidate) { \
            $candidate->suspended_at = Carbon::now(); \
            $candidate->save(); \
        } \
    } \
);

[vd1992]

I guess we've got what we need then

[brindasasi]

php artisan app:suspend-placed-candidates
Doesn't work in Dev.

copy pasting those tinker scripts worked well .. except those deprecated warnings .. I guess it is still no harm.