​

Formal date and time handling

UTC at rest. Local at the edges.

​

Added

• Core/Clock.php as a stateless static framework utility.
• UTC timestamp helpers such as Clock::nowUtcString() and Clock::utcOffsetString().
• UTC normalisation helpers such as Clock::toUtcString() and Clock::parseUtc().
• Timezone validation and resolution helpers including Clock::resolveTimezone().
• Local input conversion helpers including Clock::localInputToUtcString().
• UTC-to-local display helpers including Clock::formatUtcForTimezone().
• Local date query-boundary helpers including Clock::utcRangeForLocalDate() and Clock::utcRangeForLocalDates().
• Local “now” helpers for display and input defaults only.
• CODEBASE.md documentation for Date and Time Handling and Framework Core Utilities.

​

Timezone resolution order

user.timezone
→ tenant.timezone
→ config['timezone']
→ UTC

​

Build rules introduced

• Use App\Core\Clock for persisted timestamp generation.
• Store exact instants as UTC DATETIME.
• Use DATE for date-only values with no time-of-day meaning.
• Do not use SQL NOW() or CURRENT_TIMESTAMP for application-managed timestamps.
• Do not calculate local date windows directly in SQL.
• Convert local user, tenant, or application input into UTC before storage.
• Convert UTC values into the resolved local timezone before display.
• Resolve timezone explicitly using Clock::resolveTimezone($user, $tenant, $config).
• Do not let Clock read from $_SESSION, request globals, middleware state, controller globals, or the database.
• Do not call Clock from views.
• Services must prepare display-ready date labels for views.
• Views must not perform timezone conversion, timestamp comparison, date fallback logic, or relative date labelling.
• Document intentional application-level deviations in MYAPP.md.

​

Migration notes

date(
time(
strtotime(
new DateTime(
new DateTimeImmutable(
NOW()
CURRENT_TIMESTAMP

SET time_zone = '+00:00';

​

Fixed

​

Mail configuration fix

​

Changed

• Added admin_email to the config.php mail array from MAIL_SITE_ADMIN.
• Added .env support for MAIL_SITE_ADMIN=admin@yourdomain.com.

​

Fixed

• Fixed SignupService::initiateSignup so it uses EmailService and the configured admin email correctly.

​

Dependency injection and signup email wiring

​

Added

• Core/Container.php, a minimal explicit DI container with singleton(), bind(), make(), and has().
• Container singleton registrations for SignupService and PasswordResetService in bootstrap.php.
• Container bindings for AuthController and SignupController.
• EmailService::sendSignupVerification() for signup verification emails.
• EmailService::sendCoachAdvisory() for tenant-owner advisory emails.
• .env.example key: MAIL_ADVISORY_TO.
• CODEBASE documentation for the DI container, framework services, and signup routes.

​

Changed

• Core/Router.php now accepts an optional Container and checks for controller bindings before falling back to direct construction.
• AuthController now receives PasswordResetService by constructor injection.
• SignupController now receives SignupService by constructor injection.
• PasswordResetService and SignupService no longer fall back to broken zero-argument new EmailService() construction.
• Signup email methods now delegate to the injected EmailService instead of carrying SMTP details at the call site.
• CODEBASE sections for request lifecycle, controllers, services, security notes, deliberate omissions, and framework ownership were updated.

​

Fixed

• Removed the EmailService construction failure caused by services falling back to new EmailService() without required SMTP configuration.
• Removed hardcoded SMTP credentials from SignupService; credentials now flow from .env to config['mail'], into EmailService::fromConfig(), and then through the container singleton.

​

MYAPP.md template and framework documentation updates

​

Added

• MYAPP.md created as a template and added to the distribution.

​

Changed

• CODEBASE section 14 now documents AI instructions for creating and maintaining MYAPP.md.
• CODEBASE section 15 now documents framework tables around user and tenant management.

​

Framework configuration management

​

Added

• Framework config management for FrankPHP Core and app code using .env.
• Email credentials incorporated into the single .env file.
• Syncfusion license key incorporated into the main .env file.