@gelabs/ovr 0.2.2 → 0.4.0

package/dist/types-B8MopM4b.d.ts

@@ -0,0 +1,281 @@
+/**
+ * Base (neutral) copy dictionary for OVR — the single source of user-facing
+ * strings, config-agnostic. The `{municipality}` token is resolved at read time
+ * by `mergeCopy()` against the active LGU's config (so this stays free of any app
+ * import). A per-LGU app supplies overrides; a Tagalog `baseCopyTl` can drop in
+ * later behind the same token/merge structure.
+ */
+declare const baseCopy: {
+    readonly app: {
+        readonly name: "e-OVR";
+        readonly tagline: "Online Ordinance Violation Receipt";
+        readonly description: "Issue, look up, and settle traffic and ordinance violation tickets online.";
+    };
+    readonly common: {
+        readonly search: "Search";
+        readonly clear: "Clear";
+        readonly cancel: "Cancel";
+        readonly confirm: "Confirm";
+        readonly back: "Back";
+        readonly print: "Print";
+        readonly payNow: "Pay now";
+        readonly payFine: "Pay fine";
+        readonly loading: "Loading…";
+        readonly notFound: "Not found";
+        readonly amountDue: "Amount due";
+        readonly totalDue: "Total amount due";
+        readonly dueDate: "Due date";
+        readonly status: "Status";
+    };
+    readonly landing: {
+        readonly heroTitle: "Settle violations online — fast, clear, and official.";
+        readonly heroSubtitle: "The {municipality}'s modern portal for traffic and ordinance violation receipts.";
+        readonly citizenCardTitle: "I have a ticket";
+        readonly citizenCardBody: "Look up your Ordinance Violation Receipt, review the details, and pay your fine online.";
+        readonly citizenCardCta: "Find my ticket";
+        readonly adminCardTitle: "I'm an enforcer";
+        readonly adminCardBody: "Issue a violation ticket on the spot and manage issued receipts.";
+        readonly adminCardCta: "Open enforcer portal";
+    };
+    readonly citizen: {
+        readonly searchTitle: "OVR Ticket Search";
+        readonly searchHelp: "Enter your OVR ticket number and last name to retrieve your violation record.";
+        readonly ticketNoLabel: "OVR Ticket No.";
+        readonly lastNameLabel: "Last name";
+        readonly euaLabel: "I accept the End-User Agreement";
+        readonly searchCta: "Search ticket";
+        readonly notFoundTitle: "No matching ticket";
+        readonly notFoundBody: "We couldn't find a ticket with that number and last name. Check your details and try again.";
+        readonly home: {
+            readonly title: "Find and settle your violation receipt";
+            readonly subtitle: "Enter your OVR ticket number and last name to view your Order of Payment and pay online.";
+            readonly searchCta: "Find my ticket";
+            readonly step1Title: "Find your ticket";
+            readonly step1Body: "Search using your OVR ticket number and last name.";
+            readonly step2Title: "Review the details";
+            readonly step2Body: "Check the violation, the basic fines, and any surcharge.";
+            readonly step3Title: "Pay online";
+            readonly step3Body: "Settle via GCash, Maya, or Landbank and keep your receipt.";
+        };
+        readonly ticket: {
+            readonly orderOfPayment: "Order of Payment";
+            readonly violationDetails: "Violation details";
+            readonly reminders: "Reminders & end-user notice";
+            readonly payFine: "Pay fine";
+            readonly printReceipt: "Print receipt";
+            readonly viewReceipt: "View / print receipt";
+            readonly backToSearch: "Back to search";
+            readonly alreadyPaid: "This ticket has already been paid.";
+            readonly history: {
+                readonly title: "Violation history";
+                readonly subtitle: "All OVR tickets on record under this name.";
+                readonly current: "Current";
+                readonly empty: "No other violation records found under this name.";
+                readonly colTicketNo: "OVR Ticket No.";
+                readonly colDate: "Apprehended";
+                readonly colViolations: "Violation(s)";
+                readonly colStatus: "Status";
+                readonly colAmount: "Amount";
+            };
+        };
+        readonly pay: {
+            readonly title: "Pay your fine";
+            readonly subtitle: "Choose a payment method to settle this violation.";
+            readonly choose: "Choose payment method";
+            readonly payNow: "Pay";
+            readonly processing: "Processing payment…";
+            readonly secure: "Simulated checkout — no real payment is processed.";
+            readonly success: "Payment successful — your receipt is ready.";
+            readonly qr: {
+                readonly title: "Scan to pay";
+                readonly instruction: "Open your e-wallet app, scan this QR, then tap below once your payment is complete.";
+                readonly placeholderNote: "Demo placeholder — the official merchant QR will appear here once the payment gateway is live.";
+                readonly amountToPay: "Amount to pay";
+                readonly confirm: "I've completed payment";
+                readonly cancel: "Cancel";
+            };
+        };
+    };
+    readonly admin: {
+        readonly portal: "Enforcer Portal";
+        readonly dashboard: "Dashboard";
+        readonly tickets: "Tickets";
+        readonly issueTicket: "Issue ticket";
+        readonly accounts: "Accounts";
+        readonly roles: "Roles";
+        readonly officers: "Officers";
+        readonly violations: "Violations";
+        readonly logs: "Activity log";
+        readonly more: "More";
+        readonly signOut: "Sign out";
+        readonly signOutConfirmTitle: "Sign out?";
+        readonly signOutConfirmBody: "You'll need to sign in again to issue or manage tickets.";
+        readonly cancel: "Cancel";
+        readonly newTicketTitle: "Issue Violation Ticket";
+        readonly accountsPage: {
+            readonly title: "Accounts";
+            readonly subtitle: "Create and manage who can sign in to the enforcer portal. Each account's role decides what it can see and do.";
+            readonly newAccount: "New account";
+            readonly edit: "Edit";
+            readonly editTitle: "Edit account";
+            readonly saveChanges: "Save changes";
+            readonly username: "Username";
+            readonly password: "Password";
+            readonly role: "Role";
+            readonly officer: "Linked officer";
+            readonly officerNone: "— None —";
+            readonly officerHint: "Link an enforcer to an officer record so issued tickets are attributed.";
+            readonly status: "Status";
+            readonly active: "Active";
+            readonly inactive: "Inactive";
+            readonly created: "Created";
+            readonly actions: "Actions";
+            readonly create: "Create account";
+            readonly creating: "Creating…";
+            readonly deactivate: "Deactivate";
+            readonly activate: "Activate";
+            readonly resetPassword: "Reset password";
+            readonly newPassword: "New password";
+            readonly save: "Save";
+            readonly saving: "Saving…";
+            readonly cancel: "Cancel";
+            readonly empty: "No accounts yet — create the first one.";
+            readonly you: "You";
+        };
+        readonly rolesPage: {
+            readonly title: "Roles & permissions";
+            readonly subtitle: "Define what each role can do. Create custom roles, set their permissions, then assign them to accounts.";
+            readonly newRole: "New role";
+            readonly roleName: "Role name";
+            readonly roleNamePlaceholder: "e.g. Cashier, Supervisor";
+            readonly permissions: "Permissions";
+            readonly editPermissions: "Edit permissions";
+            readonly noPermissions: "No permissions";
+            readonly permissionsCount: "permissions";
+            readonly system: "System";
+            readonly custom: "Custom";
+            readonly create: "Create role";
+            readonly creating: "Creating…";
+            readonly save: "Save";
+            readonly saving: "Saving…";
+            readonly saved: "Saved";
+            readonly cancel: "Cancel";
+            readonly delete: "Delete";
+            readonly deleteConfirmTitle: "Delete this role?";
+            readonly deleteConfirmBody: "Move any accounts off this role first. This can't be undone.";
+            readonly lockedHint: "Super Admin always keeps account & role management.";
+            readonly empty: "No roles yet — create the first one.";
+            readonly inUseSuffix: "in use";
+        };
+        readonly logsPage: {
+            readonly title: "Activity log";
+            readonly subtitle: "Audit trail of what accounts did — sign-ins, ticket issuance, and account & role changes.";
+            readonly allActions: "All actions";
+            readonly search: "Search actor or detail…";
+            readonly actor: "Actor";
+            readonly action: "Action";
+            readonly detail: "Detail";
+            readonly when: "When";
+            readonly empty: "No activity recorded yet.";
+            readonly system: "system";
+        };
+        readonly officersPage: {
+            readonly title: "Apprehending officers";
+            readonly subtitle: "Officers who apprehend violations — shown in the Issue-Ticket form and linked to enforcer accounts.";
+            readonly newOfficer: "New officer";
+            readonly name: "Full name";
+            readonly namePlaceholder: "e.g. DELA CRUZ, JUAN P.";
+            readonly badge: "Badge no.";
+            readonly badgePlaceholder: "e.g. A176";
+            readonly office: "Office";
+            readonly officePlaceholder: "e.g. POSO";
+            readonly edit: "Edit";
+            readonly editTitle: "Edit officer";
+            readonly create: "Add officer";
+            readonly creating: "Adding…";
+            readonly save: "Save";
+            readonly saving: "Saving…";
+            readonly cancel: "Cancel";
+            readonly delete: "Remove";
+            readonly deleteConfirmTitle: "Remove this officer?";
+            readonly deleteConfirmBody: "This can't be undone. Officers with issued tickets or a linked account can't be removed.";
+            readonly empty: "No officers yet — add the first one.";
+            readonly actions: "Actions";
+        };
+        readonly violationsPage: {
+            readonly title: "Violation catalog";
+            readonly subtitle: "The ordinance / violation schedule enforcers issue against. Archived entries are hidden from the Issue-Ticket form but kept for old tickets.";
+            readonly newViolation: "New violation";
+            readonly code: "Code";
+            readonly codePlaceholder: "e.g. ORD 2021-05 S.4";
+            readonly titleLabel: "Title";
+            readonly titlePlaceholder: "e.g. No helmet (driver)";
+            readonly category: "Category";
+            readonly categoryTraffic: "Traffic";
+            readonly categoryOrdinance: "Ordinance";
+            readonly fine: "Basic fine (₱)";
+            readonly finePlaceholder: "e.g. 500";
+            readonly legalText: "Legal basis (optional)";
+            readonly legalTextPlaceholder: "e.g. Sec. 4, Municipal Ordinance No. 2021-05";
+            readonly status: "Status";
+            readonly active: "Active";
+            readonly archived: "Archived";
+            readonly edit: "Edit";
+            readonly editTitle: "Edit violation";
+            readonly create: "Add violation";
+            readonly creating: "Adding…";
+            readonly save: "Save";
+            readonly saving: "Saving…";
+            readonly cancel: "Cancel";
+            readonly archive: "Archive";
+            readonly restore: "Restore";
+            readonly archiveConfirmTitle: "Archive this violation?";
+            readonly archiveConfirmBody: "It will be hidden from the Issue-Ticket form. Already-issued tickets keep their copy, and you can restore it anytime.";
+            readonly empty: "No violations yet — add the first one.";
+            readonly actions: "Actions";
+        };
+        readonly notifications: {
+            readonly title: "Notifications";
+            readonly subtitle: "Tickets that need attention — overdue and outstanding.";
+            readonly empty: "You're all caught up.";
+            readonly overdue: "Overdue";
+            readonly outstanding: "Outstanding";
+            readonly viewAll: "View all";
+        };
+        readonly changePassword: {
+            readonly title: "Change password";
+            readonly subtitle: "Enter your current password, then your new one.";
+            readonly current: "Current password";
+            readonly new: "New password";
+            readonly confirm: "Confirm new password";
+            readonly submit: "Update password";
+            readonly saving: "Updating…";
+            readonly cancel: "Cancel";
+            readonly mismatch: "New passwords don't match.";
+            readonly success: "Password updated.";
+        };
+        readonly sync: {
+            readonly offline: "Offline";
+            readonly syncing: "Syncing…";
+            readonly synced: "Synced";
+            readonly pending: "pending sync";
+            readonly notSynced: "Not synced";
+            readonly willSync: "Saved on this device — will sync when back online.";
+        };
+    };
+};
+
+type DeepMutable<T> = T extends string ? string : {
+    -readonly [K in keyof T]: DeepMutable<T[K]>;
+};
+/** Deep-mutable mirror of the base shape (leaves widen to string). */
+type Dictionary = {
+    [K in keyof typeof baseCopy]: DeepMutable<(typeof baseCopy)[K]>;
+};
+type DeepPartial<T> = T extends string ? T : {
+    [K in keyof T]?: DeepPartial<T[K]>;
+};
+/** Per-LGU partial override (any subtree, any depth). NOT shallow Partial. */
+type CopyOverrides = DeepPartial<Dictionary>;
+
+export { type CopyOverrides as C, type Dictionary as D, baseCopy as b };

package/dist/types.d.ts

@@ -16,6 +16,17 @@ interface ViolationCatalogItem {
     category: ViolationCategory;
     basicFine: number;
     legalText?: string;
+    /** false = archived: hidden from issuance but kept so old tickets stay
+     *  resolvable. Absent = active (back-compat with un-migrated seed data). */
+    active?: boolean;
+}
+/** What an admin submits to create a catalog entry (GE-031). `code` is the id. */
+interface NewViolationInput {
+    code: string;
+    title: string;
+    category: ViolationCategory;
+    basicFine: number;
+    legalText?: string;
 }
 /** A catalog item as attached to a ticket, snapshotted + enforcer details. */
 interface IssuedViolation {
@@ -42,6 +53,12 @@ interface Officer {
     badgeNo?: string;
     office: string;
 }
+/** What an admin submits to add/edit an apprehending officer (GE-025). */
+interface NewOfficerInput {
+    name: string;
+    badgeNo?: string;
+    office: string;
+}
 type PaymentMethod = "GCASH" | "MAYA" | "LANDBANK" | "OVER_THE_COUNTER";
 interface Payment {
     method: PaymentMethod;
@@ -65,6 +82,8 @@ interface TicketRecord {
     violations: IssuedViolation[];
     remarks?: string;
     issuedBy?: string;
+    apprehendingEnforcerId?: string;
+    apprehendingEnforcerName?: string;
     assessedAt: string;
     dueDate: string;
     basicFinesTotal: number;
@@ -78,5 +97,89 @@ interface Ticket extends TicketRecord {
     penaltyAmount: number;
     totalAmountDue: number;
 }
+/** Every capability the app gates on. Add a gate by extending this + the catalog. */
+type Permission = "dashboard:view" | "tickets:view" | "tickets:create" | "accounts:manage" | "roles:manage" | "officers:manage" | "violations:manage" | "logs:view" | "notifications:view";
+interface PermissionDef {
+    key: Permission;
+    label: string;
+    description: string;
+}
+/** The catalog shown in the Roles editor (array order = display order). */
+declare const PERMISSION_CATALOG: PermissionDef[];
+declare const ALL_PERMISSIONS: Permission[];
+/** A role + its permission set. `isSystem` roles can't be renamed or deleted. */
+interface RoleDef {
+    name: string;
+    label: string;
+    isSystem: boolean;
+    permissions: Permission[];
+}
+/** What an admin submits to create a custom role. */
+interface NewRoleInput {
+    label: string;
+    permissions: Permission[];
+}
+/** The built-in roles, seeded into every deployment. */
+declare const SYSTEM_ROLES: RoleDef[];
+/** Default role assigned to a new account / seeded login. */
+declare const DEFAULT_ROLE_NAME = "ENFORCER";
+/** SUPER_ADMIN ALWAYS keeps these (anti-lockout): locked-on in the Roles editor
+ *  and re-asserted server-side, so no one can revoke their own ability to manage
+ *  accounts/roles and lock everyone out. */
+declare const SUPER_ADMIN_LOCKED_PERMISSIONS: Permission[];
+/** Whether a permission set grants a capability. Safe with null/undefined. */
+declare function hasPermission(permissions: readonly string[] | null | undefined, permission: Permission): boolean;
+/** A user account as shown to admins (NEVER carries the password hash). */
+interface UserAccount {
+    id: string;
+    username: string;
+    role: string;
+    roleLabel?: string;
+    active: boolean;
+    officerId: string | null;
+    /** Convenience: the linked officer's display name, if any. */
+    officerName?: string;
+    createdAt: string;
+}
+/** What an admin submits to create an account. The password hash is computed by
+ *  the app (argon2 stays out of the data layer), mirroring the seed path. */
+interface NewUserInput {
+    username: string;
+    passwordHash: string;
+    role: string;
+    officerId?: string | null;
+}
+/** The recorded action kinds (extensible; stored as a string for forward-compat). */
+declare const ACTIVITY_ACTIONS: readonly ["auth.login", "auth.logout", "ticket.issued", "account.create", "account.update", "account.activate", "account.deactivate", "account.password_reset", "account.password_change", "role.create", "role.update", "role.delete", "officer.create", "officer.update", "officer.delete", "violation.create", "violation.update", "violation.delete"];
+type ActivityAction = (typeof ACTIVITY_ACTIONS)[number];
+declare const ACTIVITY_ACTION_LABELS: Record<ActivityAction, string>;
+/** One audit-trail entry: who did what, when. */
+interface ActivityLog {
+    id: string;
+    actorId: string | null;
+    actorUsername: string | null;
+    action: string;
+    summary: string;
+    targetType?: string;
+    targetId?: string;
+    createdAt: string;
+}
+/** What the app records for an event (id + createdAt are assigned by the store). */
+interface NewActivityInput {
+    actorId?: string | null;
+    actorUsername?: string | null;
+    action: ActivityAction;
+    summary: string;
+    targetType?: string;
+    targetId?: string;
+}
+/** Filter for an activity-log query. */
+interface ActivityFilter {
+    action?: string;
+    actorId?: string;
+    fromISO?: string;
+    toISO?: string;
+    limit?: number;
+}
 
-export type { IssuedViolation, Officer, Payment, PaymentMethod, PaymentStatus, Ticket, TicketRecord, TicketStatus, ViolationCatalogItem, ViolationCategory, Violator };
+export { ACTIVITY_ACTIONS, ACTIVITY_ACTION_LABELS, ALL_PERMISSIONS, type ActivityAction, type ActivityFilter, type ActivityLog, DEFAULT_ROLE_NAME, type IssuedViolation, type NewActivityInput, type NewOfficerInput, type NewRoleInput, type NewUserInput, type NewViolationInput, type Officer, PERMISSION_CATALOG, type Payment, type PaymentMethod, type PaymentStatus, type Permission, type PermissionDef, type RoleDef, SUPER_ADMIN_LOCKED_PERMISSIONS, SYSTEM_ROLES, type Ticket, type TicketRecord, type TicketStatus, type UserAccount, type ViolationCatalogItem, type ViolationCategory, type Violator, hasPermission };

package/dist/types.js

@@ -1 +1 @@
-
+export { ACTIVITY_ACTIONS, ACTIVITY_ACTION_LABELS, ALL_PERMISSIONS, DEFAULT_ROLE_NAME, PERMISSION_CATALOG, SUPER_ADMIN_LOCKED_PERMISSIONS, SYSTEM_ROLES, hasPermission } from './chunk-WUNTHINH.js';

package/dist/ui-components-admin/accounts-manager.d.ts

@@ -0,0 +1,52 @@
+import * as React from 'react';
+import { UserAccount, Officer, RoleDef } from '../types.js';
+
+/**
+ * Account management UI (GE-013). Super admins create & manage who can sign in to
+ * the enforcer portal; each account's role decides what it can see/do. The server
+ * actions (create / activate / reset password) are INJECTED by the page so this
+ * component stays free of any app-specific data wiring — mirrors IssuanceForm.
+ *
+ * Online-only: account management needs the server (argon2 + DB). After a mutation
+ * we refresh the route so the server-rendered list reflects the change.
+ */
+
+/** What the create form submits — the page hashes the password server-side. */
+interface CreateAccountInput {
+    username: string;
+    password: string;
+    role: string;
+    officerId: string | null;
+}
+type CreateAccountAction = (input: CreateAccountInput) => Promise<{
+    error?: string;
+} | void>;
+type SetAccountActiveAction = (id: string, active: boolean) => Promise<{
+    error?: string;
+} | void>;
+type ResetAccountPasswordAction = (id: string, password: string) => Promise<{
+    error?: string;
+} | void>;
+interface EditAccountInput {
+    username?: string;
+    role?: string;
+    officerId?: string | null;
+}
+type EditAccountAction = (id: string, patch: EditAccountInput) => Promise<{
+    error?: string;
+} | void>;
+interface AccountsManagerProps {
+    users: UserAccount[];
+    officers: Officer[];
+    /** Roles assignable to accounts (system + custom). */
+    roles: RoleDef[];
+    /** The signed-in user's id — so they can't deactivate their own account. */
+    currentUserId?: string;
+    createAction: CreateAccountAction;
+    editAction: EditAccountAction;
+    setActiveAction: SetAccountActiveAction;
+    resetPasswordAction: ResetAccountPasswordAction;
+}
+declare function AccountsManager({ users, officers, roles, currentUserId, createAction, editAction, setActiveAction, resetPasswordAction, }: AccountsManagerProps): React.JSX.Element;
+
+export { AccountsManager, type AccountsManagerProps, type CreateAccountAction, type CreateAccountInput, type EditAccountAction, type EditAccountInput, type ResetAccountPasswordAction, type SetAccountActiveAction };