GovRes

Changelog — GovRes

GovRes lets a government office (or any busy public-service counter) publish its own online reservation form. Citizens pick a service and an open time slot, so the day fills evenly instead of all at once — cutting congestion and queues. Reservations are free; offices can optionally sell paid Fast Track services (skip the line, help filling forms, faster service) with revenue shared automatically with the platform.

[2026-05-29] — First release 🚀

• Reserve a visit online. Citizens open your public reservation form, pick the service they need, choose an open date and time, and get a reference to show at the counter — no app to install.
• Real appointment-slot capacity. Set your weekly opening hours, slot length, and how many people each slot can hold under Availability. Slots that fill up close automatically, so arrivals stay spread across the day.
• Holidays & special days. Close a date entirely or give it different hours — overrides win over your weekly schedule.
• Live reservation queue. Watch reservations move through Pending → Confirmed → Checked In → Completed. Your counter team gets an instant push alert the moment one lands.
• Optional paid Fast Track services. Offer help that lets citizens move faster — "Hold my place in line", "Help me fill the forms", "Serve me faster" — defined under Fast Track. Citizens can add one at reservation time and pay securely online.
• Automatic revenue split. When a citizen pays for Fast Track, your Paystack collects the money and a set percentage is transferred to the platform automatically; you keep the rest. Configure it under Settings → Fast Track payouts. (Automatic transfers are Naira/Paystack only; fees are still collected on other currencies.)
• Citizen portal. Citizens look up and track their reservation by phone — optionally protected with a PIN.
• Multiple offices. Run several locations, each with its own hours, slots, queue, and reservation link.
• Make it yours. Design your own reservation form (paste your own HTML), rename labels, switch modules on or off, and choose light or dark.
• Shareable & embeddable. Share your reservation link or embed the form on your website; connect a custom domain for a branded address.

• In-app help & guides. Five tutorial lessons ship with the app — getting started, day-to-day, sharing with citizens, customizing, and Fast Track & shared revenue — alongside a full marketing kit (proposal, one-pager, and social copy) for offices and partners.

Internal

• Built on the per-user app chassis: staff (officers) + customers (citizens) with phone+PIN, the FormBase form engine, and the standard bookings pipeline.
• New tables: availability_windows, availability_overrides, slot_counters (the concurrency-safe per-slot counter), plus service_fee_accounts / service_fee_payouts for the Paystack-Transfer revenue split. Additive guarded columns on bookings (slot_key) and payments (concierge_item_id, status, currency).
• New endpoints: public slots/list, slots/days, concierge/menu, concierge/paystack-init|verify|webhook; admin availability/* and concierge/get|banks|resolve|save|process-now.
• Slot claims are atomic: a conditional UPDATE … WHERE booked_count < capacity inside the booking-insert transaction prevents overselling under concurrent submissions.