FEAT:🌙 Prefer remote stands overnight for configured airfields

[MrAdder]

✨ Summary

This PR adds an optional overnight bias to stand allocation for selected arrival airfields.
When enabled, and during a configured night window (Europe/London), the allocator will prefer stands explicitly marked as overnight-remote via a new stands.overnight_remote_preferred flag.

✅ Default behaviour remains unchanged because the feature is disabled by default.

---

🔧 What changed

🛬 Allocation ordering update

• Updates nightTimeRemoteStandOrderCondition() to:
  • Use planned_destairport (normalised to uppercase) for airfield matching
  • Respect stands.night_remote_stand_weighting.enabled + airfields
  • Apply only during configured night window (start_hour → end_hour, supports midnight crossing)
  • Prefer stands where stands.overnight_remote_preferred = 1

Ordering fragment added (prepended when active):

CASE WHEN stands.overnight_remote_preferred = 1 THEN 0 ELSE 1 END ASC

---

🧱 Schema change (new column)

• Adds stands.overnight_remote_preferred boolean column:
  • default: false
  • indexed for filtering/sorting/perf
  • migration: 2026_02_25_000001_add_overnight_remote_preferred_to_stands.php

---

🧩 Model / factory updates

• Stand model:
  • adds overnight_remote_preferred to $fillable
  • casts to boolean
• StandFactory default:
  • sets overnight_remote_preferred => false

---

🖥️ Admin UI (Filament) updates

• StandResource form:
  • adds a toggle for overnight_remote_preferred
• StandResource table:
  • adds boolean column for overnight_remote_preferred

---

🌍 Config updates

• Keeps stands.night_remote_stand_weighting feature flag + time window config
• Removes remote_priority_threshold (no longer used)

Config still includes:

• enabled (env: NIGHT_REMOTE_STAND_WEIGHTING_ENABLED, default false)
• airfields
• start_hour
• end_hour

---

🧪 Tests

Adds/updates functional coverage to verify:

• ✅ At night (23:00 Europe/London) and for configured airfields, a stand with overnight_remote_preferred=true is preferred
• ✅ Outside the night window (12:00 Europe/London), allocation behaves normally

Tests use Carbon::setTestNow() and reset afterwards.

---

💡 Why

Some airfields prefer remote stands overnight (ops flow, noise/terminal constraints, overnight parking patterns).
This change makes that preference explicit and configurable per stand, rather than inferring “remote-ness” from assignment_priority.

---

🚀 Rollout / Ops notes

✅ Enable feature (optional)

NIGHT_REMOTE_STAND_WEIGHTING_ENABLED=true

✅ Mark stands to be preferred overnight

• Set overnight_remote_preferred = true for relevant stands (via Filament UI or DB update)

✅ Limit scope per airfield

• Add airfield ICAOs to stands.night_remote_stand_weighting.airfields

---

⚠️ Risk / Impact

🟢 Low risk

• Feature is opt-in via flag
• Scoped by airfield + time window
• Ordering is additive (prepended), existing logic remains intact

🧠 Considerations

• Uses Europe/London timezone (DST-aware)
• Requires stands to be explicitly flagged as overnight_remote_preferred

---

📋 Checklist

• Feature flag defaulted OFF 📴
• Migration added + indexed 🗄️
• Model + factory updated 🧬
• Filament form + table updated 🖥️
• Tests updated/added 🧪
• Backwards compatible by default ✅

---

Fixes #1762

[19wintersp]

Would it not be better to define a new property for stands indicating whether they are remote/preferred for overnight parking? Hijacking the assignment priority for this purpose seems a little perverse when it is also used (as I understand it) for marking stands as temporarily out-of-use, or for larger stands in mixed-size stand arrangements

[MrAdder]

Would it not be better to define a new property for stands indicating whether they are remote/preferred for overnight parking? Hijacking the assignment priority for this purpose seems a little perverse when it is also used (as I understand it) for marking stands as temporarily out-of-use, or for larger stands in mixed-size stand arrangements

I can implement that logic instead I just did it this way originally as it seemed logical with what was asked didn't think of this way round

[MrAdder]

Updated PR Text in regards to changes

[kristiankunc]

Please remove the env config, let!s just enable this out of the box.

[Copilot]

Pull request overview

Adds an “overnight remote preference” signal to stands and introduces a night-time ordering bias intended to prefer those stands during a configured window.

Changes:

• Adds stands.overnight_remote_preferred column, model cast/fillable, factory default, and Filament UI toggle/column.
• Adds a night-window ORDER BY fragment to prefer overnight_remote_preferred stands.
• Adds functional tests covering “night prefers flagged stand” vs “daytime unchanged”.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
app/Allocator/Stand/SelectsStandsUsingStandardConditions.php	Introduces night-window ORDER BY bias preferring overnight_remote_preferred.
config/stands.php	Adds night window configuration keys.
database/migrations/2026_02_25_000001_add_overnight_remote_preferred_to_stands.php	Adds new boolean column + index.
app/Models/Stand/Stand.php	Adds fillable + boolean cast for new column.
database/factories/Stand/StandFactory.php	Sets factory default for new column.
app/Filament/Resources/StandResource.php	Adds toggle to form and boolean column to table.
lang/en/stands/form.php	Adds form label/helper copy for new toggle.
lang/en/stands/table.php	Adds table column label.
tests/app/Allocator/Stand/FallbackArrivalStandAllocatorTest.php	Adds tests for night/day ordering behavior.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Adds an opt-in “overnight remote stand” preference to arrival stand allocation, allowing configured airfields to bias allocations during a Europe/London night window toward stands explicitly flagged as overnight-remote.

Changes:

• Introduces stands.overnight_remote_preferred (DB column + model cast/fillable + factory default) and exposes it in Filament.
• Adds a conditional ORDER BY fragment to prefer overnight_remote_preferred stands during a configured night window for configured destination airfields.
• Adds functional tests for in-window vs out-of-window allocation behavior.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
tests/app/Allocator/Stand/FallbackArrivalStandAllocatorTest.php	Adds tests covering overnight preference and non-preference outside the night window.
app/Allocator/Stand/SelectsStandsUsingStandardConditions.php	Prepends an optional night-window ORDER BY fragment for overnight_remote_preferred.
database/migrations/2026_02_25_000001_add_overnight_remote_preferred_to_stands.php	Adds the new boolean column + index to stands.
app/Models/Stand/Stand.php	Makes the new field mass-assignable and casts it to boolean.
database/factories/Stand/StandFactory.php	Sets default overnight_remote_preferred to false.
app/Filament/Resources/StandResource.php	Adds toggle + table column for the new flag in the admin UI.
config/stands.php	Adds configuration for night-window weighting.
lang/en/stands/form.php	Adds label/helper text for the new toggle.
lang/en/stands/table.php	Adds table column label for the new flag.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud