Add Care Pro billing, renewal, and scheduler.

Organizations can subscribe from wallet, expire correctly on free tier, and renew nightly via care:pro-renew.

Co-authored-by: Cursor <cursoragent@cursor.com>

app/Console/Commands/RenewProSubscriptionsCommand.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Services\Care\ProRenewalService;
+use Illuminate\Console\Command;
+
+class RenewProSubscriptionsCommand extends Command
+{
+    protected $signature = 'care:pro-renew';
+
+    protected $description = 'Charge the Ladill wallet for due Care Pro subscriptions (and downgrade after the grace window).';
+
+    public function handle(ProRenewalService $renewals): int
+    {
+        $due = $renewals->dueOrganizations();
+        $this->info("Renewing {$due->count()} due organization(s).");
+        $due->each(fn ($organization) => $renewals->renewIfDue($organization));
+
+        return self::SUCCESS;
+    }
+}

app/Http/Controllers/Care/ProController.php

@@ -0,0 +1,92 @@
+<?php
+
+namespace App\Http\Controllers\Care;
+
+use App\Http\Controllers\Controller;
+use App\Http\Controllers\Care\Concerns\ScopesToAccount;
+use App\Services\Billing\BillingClient;
+use App\Services\Care\CarePermissions;
+use App\Services\Care\PlanService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Carbon;
+use Illuminate\View\View;
+
+class ProController extends Controller
+{
+    use ScopesToAccount;
+
+    public function index(Request $request, PlanService $plans): View
+    {
+        $organization = $this->organization($request);
+        $canManage = app(CarePermissions::class)->can($this->member($request), 'settings.manage');
+        $settings = $organization->settings ?? [];
+        $expiresAt = ! empty($settings['plan_expires_at'])
+            ? Carbon::parse($settings['plan_expires_at'])
+            : null;
+
+        return view('care.pro.index', [
+            'organization' => $organization,
+            'isPro' => $plans->isPro($organization),
+            'canManage' => $canManage,
+            'priceMinor' => $plans->proPriceMinor(),
+            'currency' => (string) config('billing.currency', 'GHS'),
+            'planExpiresAt' => $expiresAt,
+            'proFeatures' => [
+                'Unlimited branches',
+                'Full clinical workflows',
+                'Laboratory & pharmacy modules',
+                'Finance reports & audit exports',
+                'Queue integration',
+            ],
+        ]);
+    }
+
+    public function subscribe(Request $request, PlanService $plans, BillingClient $billing): RedirectResponse
+    {
+        $this->authorizeAbility($request, 'settings.manage');
+        $organization = $this->organization($request);
+
+        if ($plans->isPro($organization)) {
+            return redirect()->route('care.pro.index')
+                ->with('success', 'Your organization is already on Care Pro.');
+        }
+
+        $priceMinor = $plans->proPriceMinor();
+
+        try {
+            if (! $billing->canAfford($organization->owner_ref, $priceMinor)) {
+                return redirect()->route('care.pro.index')
+                    ->with('error', 'Insufficient wallet balance. Top up your Ladill wallet to upgrade to Pro.');
+            }
+
+            $charged = $billing->debit(
+                $organization->owner_ref,
+                $priceMinor,
+                'care_pro',
+                'care-pro-'.$organization->id.'-'.now()->format('Y-m-d-His'),
+                'Ladill Care Pro — monthly subscription',
+            );
+        } catch (\Throwable) {
+            return redirect()->route('care.pro.index')
+                ->with('error', 'Could not process upgrade. Please try again.');
+        }
+
+        if (! $charged) {
+            return redirect()->route('care.pro.index')
+                ->with('error', 'Insufficient wallet balance. Top up your Ladill wallet to upgrade to Pro.');
+        }
+
+        $settings = $organization->settings ?? [];
+        $settings['plan'] = 'pro';
+        $settings['auto_renew'] = true;
+        $settings['plan_expires_at'] = now()
+            ->addDays((int) config('care.pro.period_days', 30))
+            ->toIso8601String();
+        unset($settings['plan_renewal_error']);
+        $organization->update(['settings' => $settings]);
+
+        return redirect()->route('care.pro.index')
+            ->with('success', 'Welcome to Care Pro — active for one month.');
+    }
+}

app/Services/Care/PlanService.php

@@ -3,22 +3,37 @@
 namespace App\Services\Care;
 
 use App\Models\Organization;
+use Carbon\Carbon;
 
 class PlanService
 {
+    public function planKey(Organization $organization): string
+    {
+        $settings = $organization->settings ?? [];
+        $plan = (string) ($settings['plan'] ?? 'free');
+
+        if ($plan === 'pro' && ! empty($settings['plan_expires_at'])) {
+            if (Carbon::parse($settings['plan_expires_at'])->isPast()) {
+                return 'free';
+            }
+        }
+
+        return array_key_exists($plan, config('care.plans', [])) ? $plan : 'free';
+    }
+
     public function plan(Organization $organization): string
     {
-        return (string) data_get($organization->settings, 'plan', 'free');
+        return $this->planKey($organization);
     }
 
     public function isPro(Organization $organization): bool
     {
-        return $this->plan($organization) === 'pro';
+        return $this->planKey($organization) === 'pro';
     }
 
     public function maxBranches(Organization $organization): ?int
     {
-        $plan = config('care.plans.'.$this->plan($organization));
+        $plan = config('care.plans.'.$this->planKey($organization));
 
         return $plan['max_branches'] ?? null;
     }

app/Services/Care/ProRenewalService.php

@@ -0,0 +1,89 @@
+<?php
+
+namespace App\Services\Care;
+
+use App\Models\Organization;
+use App\Services\Billing\BillingClient;
+use Illuminate\Support\Carbon;
+use Illuminate\Support\Collection;
+
+class ProRenewalService
+{
+    public function __construct(
+        private readonly BillingClient $billing,
+        private readonly PlanService $plans,
+    ) {}
+
+    /** @return Collection<int, Organization> */
+    public function dueOrganizations(): Collection
+    {
+        return Organization::query()
+            ->where('settings->plan', 'pro')
+            ->whereNotNull('settings->plan_expires_at')
+            ->get()
+            ->filter(fn (Organization $organization) => $this->isDue($organization));
+    }
+
+    public function isDue(Organization $organization): bool
+    {
+        $settings = $organization->settings ?? [];
+        if (($settings['plan'] ?? '') !== 'pro') {
+            return false;
+        }
+        if (array_key_exists('auto_renew', $settings) && $settings['auto_renew'] === false) {
+            return false;
+        }
+        if (empty($settings['plan_expires_at'])) {
+            return false;
+        }
+
+        return Carbon::parse($settings['plan_expires_at'])->lte(now());
+    }
+
+    public function renewIfDue(Organization $organization): void
+    {
+        if (! $this->isDue($organization)) {
+            return;
+        }
+
+        $settings = $organization->settings ?? [];
+        $price = $this->plans->proPriceMinor();
+        $reference = 'care-pro-'.$organization->id.'-'.now()->format('YmdHis');
+
+        try {
+            $charged = $this->billing->debit(
+                $organization->owner_ref,
+                $price,
+                'care_pro_renewal',
+                $reference,
+                'Ladill Care Pro — monthly renewal',
+            );
+        } catch (\Throwable) {
+            $charged = false;
+        }
+
+        if ($charged) {
+            $settings['plan'] = 'pro';
+            $settings['auto_renew'] = true;
+            $settings['plan_expires_at'] = now()
+                ->addDays((int) config('care.pro.period_days', 30))
+                ->toIso8601String();
+            unset($settings['plan_renewal_error']);
+            $organization->update(['settings' => $settings]);
+
+            return;
+        }
+
+        $expires = Carbon::parse($settings['plan_expires_at']);
+        $graceEnd = $expires->copy()->addDays((int) config('care.pro.grace_days', 3));
+        if ($graceEnd->isPast()) {
+            $settings['plan'] = 'free';
+            unset($settings['plan_expires_at']);
+            $settings['plan_renewal_error'] = 'Suspended after failed renewal.';
+        } else {
+            $settings['plan_renewal_error'] = 'Renewal failed — top up your wallet.';
+        }
+
+        $organization->update(['settings' => $settings]);
+    }
+}

config/care.php

@@ -217,6 +217,11 @@ return [
         ],
     ],
 
+    'pro' => [
+        'grace_days' => (int) env('CARE_PRO_GRACE_DAYS', 3),
+        'period_days' => (int) env('CARE_PRO_PERIOD_DAYS', 30),
+    ],
+
     'queue' => [
         'api_url' => env('QUEUE_API_URL', 'https://queue.ladill.com/api/v1'),
         'api_key' => env('QUEUE_API_KEY_CARE'),

resources/views/care/pro/index.blade.php

@@ -0,0 +1,54 @@
+<x-app-layout title="Pro" heading="Care Pro">
+    @php
+        $price = number_format($priceMinor / 100, 2);
+    @endphp
+
+    <div class="mx-auto max-w-2xl">
+        <div class="overflow-hidden rounded-2xl border border-slate-200 bg-white">
+            <div class="bg-gradient-to-r from-indigo-700 via-teal-600 to-cyan-500 px-6 py-7 text-white">
+                <div class="flex items-center gap-2">
+                    <span class="rounded-md bg-white/20 px-2 py-0.5 text-[11px] font-semibold uppercase tracking-wide">Pro</span>
+                    @if ($isPro)
+                        <span class="rounded-md bg-emerald-400/90 px-2 py-0.5 text-[11px] font-semibold text-emerald-950">Active</span>
+                    @endif
+                </div>
+                <h1 class="mt-3 text-2xl font-bold">Ladill Care Pro</h1>
+                <p class="mt-1 text-sm text-white/80">Unlimited branches and the full hospital management toolkit.</p>
+                <p class="mt-4 text-3xl font-bold">{{ $currency }} {{ $price }}<span class="text-base font-medium text-white/70"> / month</span></p>
+            </div>
+
+            <div class="px-6 py-6">
+                <ul class="grid gap-3 sm:grid-cols-2">
+                    @foreach ($proFeatures as $feature)
+                        <li class="flex items-start gap-2 text-sm text-slate-700">
+                            <svg class="mt-0.5 h-4 w-4 shrink-0 text-emerald-500" fill="none" viewBox="0 0 24 24" stroke-width="2.5" stroke="currentColor"><path stroke-linecap="round" stroke-linejoin="round" d="m4.5 12.75 6 6 9-13.5"/></svg>
+                            <span>{{ $feature }}</span>
+                        </li>
+                    @endforeach
+                </ul>
+
+                <div class="mt-6 border-t border-slate-100 pt-6">
+                    @if ($isPro)
+                        <div class="text-sm text-slate-600">
+                            @if ($planExpiresAt)
+                                Pro is active until <strong>{{ $planExpiresAt->format('d M Y') }}</strong>.
+                            @else
+                                Your organization is on Care Pro.
+                            @endif
+                        </div>
+                    @elseif ($canManage)
+                        <form method="post" action="{{ route('care.pro.subscribe') }}">
+                            @csrf
+                            <button class="btn-primary w-full sm:w-auto">
+                                Upgrade to Pro — {{ $currency }} {{ $price }}/mo from wallet
+                            </button>
+                        </form>
+                        <p class="mt-3 text-xs text-slate-400">Billed monthly from your Ladill wallet.</p>
+                    @else
+                        <p class="rounded-xl bg-slate-50 px-4 py-3 text-sm text-slate-500">Ask an organization administrator to upgrade this workspace to Pro.</p>
+                    @endif
+                </div>
+            </div>
+        </div>
+    </div>
+</x-app-layout>

resources/views/partials/sidebar.blade.php

@@ -78,7 +78,7 @@
              'icon' => '<path stroke-linecap="round" stroke-linejoin="round" d="M19.5 14.25v-2.625a3.375 3.375 0 0 0-3.375-3.375h-1.5A1.125 1.125 0 0 1 13.5 7.125v-1.5a3.375 3.375 0 0 0-3.375-3.375H8.25m0 12.75h7.5m-7.5 3H12M10.5 2.25H5.625c-.621 0-1.125.504-1.125 1.125v17.25c0 .621.504 1.125 1.125 1.125h12.75c.621 0 1.125-.504 1.125-1.125V11.25a9 9 0 0 0-9-9Z" />'];
         }
 
-        $settingsActive = request()->routeIs('care.settings*');
+        $settingsActive = request()->routeIs('care.settings*') && ! request()->routeIs('care.pro.*');
     @endphp
 
     <nav class="flex-1 space-y-0.5 overflow-y-auto px-3 py-4">
@@ -110,5 +110,18 @@
             <span>Settings</span>
         </a>
         @endif
+
+        @php $proActive = request()->routeIs('care.pro.*'); @endphp
+        @if (! empty($isPro))
+            <a href="{{ route('care.pro.index') }}" class="group mt-0.5 flex items-center gap-3 rounded-lg px-3 py-2 text-[13px] transition {{ $proActive ? 'bg-indigo-50 text-indigo-700 font-semibold' : 'text-slate-600 hover:bg-slate-50 hover:text-slate-900' }}">
+                <svg class="h-[18px] w-[18px] shrink-0 text-amber-500" viewBox="0 0 24 24" fill="currentColor"><path d="M12 2.25c.3 0 .58.18.7.46l2.36 5.5 5.96.5a.75.75 0 0 1 .43 1.31l-4.53 3.9 1.36 5.83a.75.75 0 0 1-1.12.81L12 17.77l-5.16 3a.75.75 0 0 1-1.12-.81l1.36-5.83-4.53-3.9a.75.75 0 0 1 .43-1.31l5.96-.5 2.36-5.5c.12-.28.4-.46.7-.46Z"/></svg>
+                <span>Care Pro</span>
+            </a>
+        @else
+            <a href="{{ route('care.pro.index') }}" class="group mt-0.5 flex items-center gap-3 rounded-lg bg-gradient-to-r from-indigo-600 to-emerald-500 px-3 py-2 text-[13px] font-semibold text-white shadow-sm transition hover:opacity-95">
+                <svg class="h-[18px] w-[18px] shrink-0" viewBox="0 0 24 24" fill="currentColor"><path d="M12 2.25c.3 0 .58.18.7.46l2.36 5.5 5.96.5a.75.75 0 0 1 .43 1.31l-4.53 3.9 1.36 5.83a.75.75 0 0 1-1.12.81L12 17.77l-5.16 3a.75.75 0 0 1-1.12-.81l1.36-5.83-4.53-3.9a.75.75 0 0 1 .43-1.31l5.96-.5 2.36-5.5c.12-.28.4-.46.7-.46Z"/></svg>
+                <span>Upgrade to Pro</span>
+            </a>
+        @endif
     </div>
 </div>

routes/console.php

@@ -1,3 +1,5 @@
 <?php
 
 use Illuminate\Support\Facades\Schedule;
+
+Schedule::command('care:pro-renew')->dailyAt('02:20')->withoutOverlapping();

routes/web.php

@@ -18,6 +18,7 @@ use App\Http\Controllers\Care\OnboardingController;
 use App\Http\Controllers\Care\PatientController;
 use App\Http\Controllers\Care\PrescriptionController;
 use App\Http\Controllers\Care\QueueController;
+use App\Http\Controllers\Care\ProController;
 use App\Http\Controllers\Care\ReportController;
 use App\Http\Controllers\Care\ServiceQueueController;
 use App\Http\Controllers\Care\SettingsController;
@@ -130,6 +131,9 @@ Route::middleware(['auth', 'platform.session'])->group(function () {
         Route::get('/settings', [SettingsController::class, 'edit'])->name('care.settings');
         Route::put('/settings', [SettingsController::class, 'update'])->name('care.settings.update');
 
+        Route::get('/pro', [ProController::class, 'index'])->name('care.pro.index');
+        Route::post('/pro/subscribe', [ProController::class, 'subscribe'])->name('care.pro.subscribe');
+
         Route::get('/branches', [BranchController::class, 'index'])->name('care.branches.index');
         Route::get('/branches/create', [BranchController::class, 'create'])->name('care.branches.create');
         Route::post('/branches', [BranchController::class, 'store'])->name('care.branches.store');

tests/Feature/CareProTest.php

@@ -0,0 +1,103 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Http\Middleware\EnsurePlatformSession;
+use App\Models\Branch;
+use App\Models\Member;
+use App\Models\Organization;
+use App\Models\User;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\Http;
+use Tests\TestCase;
+
+class CareProTest extends TestCase
+{
+    use RefreshDatabase;
+
+    protected User $owner;
+
+    protected Organization $organization;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $this->withoutMiddleware(EnsurePlatformSession::class);
+        config(['billing.api_url' => 'https://billing.test']);
+
+        $this->owner = User::create([
+            'public_id' => 'care-owner-001',
+            'name' => 'Owner',
+            'email' => 'owner@example.com',
+        ]);
+
+        $this->organization = Organization::create([
+            'owner_ref' => $this->owner->public_id,
+            'name' => 'Care Org',
+            'slug' => 'care-org',
+            'settings' => ['onboarded' => true, 'facility_type' => 'clinic'],
+        ]);
+
+        Member::create([
+            'owner_ref' => $this->owner->public_id,
+            'organization_id' => $this->organization->id,
+            'user_ref' => $this->owner->public_id,
+            'role' => 'hospital_admin',
+        ]);
+
+        Branch::create([
+            'owner_ref' => $this->owner->public_id,
+            'organization_id' => $this->organization->id,
+            'name' => 'HQ',
+            'is_active' => true,
+        ]);
+    }
+
+    public function test_pro_page_renders_for_free_organization(): void
+    {
+        $this->actingAs($this->owner)
+            ->get(route('care.pro.index'))
+            ->assertOk()
+            ->assertSee('Ladill Care Pro')
+            ->assertSee('GHS 199')
+            ->assertSee('Upgrade to Pro');
+    }
+
+    public function test_subscribe_upgrades_organization(): void
+    {
+        Http::fake([
+            'billing.test/can-afford*' => Http::response(['affordable' => true]),
+            'billing.test/debit' => Http::response(['ok' => true]),
+        ]);
+
+        $this->actingAs($this->owner)
+            ->post(route('care.pro.subscribe'))
+            ->assertRedirect(route('care.pro.index'))
+            ->assertSessionHas('success');
+
+        $this->assertSame('pro', $this->organization->fresh()->settings['plan']);
+    }
+
+    public function test_pro_renew_extends_subscription_when_wallet_charges(): void
+    {
+        $this->organization->update([
+            'settings' => [
+                'onboarded' => true,
+                'facility_type' => 'clinic',
+                'plan' => 'pro',
+                'auto_renew' => true,
+                'plan_expires_at' => now()->subDay()->toIso8601String(),
+            ],
+        ]);
+
+        Http::fake([
+            'billing.test/debit' => Http::response(['ok' => true]),
+        ]);
+
+        $this->artisan('care:pro-renew')->assertSuccessful();
+
+        $settings = $this->organization->fresh()->settings;
+        $this->assertSame('pro', $settings['plan']);
+        $this->assertTrue(now()->parse($settings['plan_expires_at'])->isFuture());
+    }
+}