Customs Duty Payment

Customs Duty Payment is a React + Vite application for managing customs duty billing, assessment billing, client records, audit logs, staff access, and printable operational reports.

Stack

• React 18
• TypeScript
• Vite
• Tailwind CSS
• Supabase
• GitHub Pages for publishing

Main Features

• Duty payment management
• Assessment billing workflow
• Client/AIN database
• Role-based staff management
• Audit logs with latest-first ordering
• Audit log print/export support
• Daily reporting
• GitHub Pages publishing via gh-pages

Branch Strategy

• main keeps source code only
• gh-pages is used for published build output
• backup/pre-secret-purge exists as a post-rewrite safety backup branch

Local Setup

1. Install dependencies:

npm install

2. Create local environment values from .env.example.

Required variables:

VITE_SUPABASE_URL=https://your-project-ref.supabase.co
VITE_SUPABASE_ANON_KEY=your_anon_public_key_here
SUPABASE_URL=https://your-project-ref.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key_here

3. Start development server:

npm run dev

Production Build

npm run build
npm run preview

Publish

This project publishes to GitHub Pages.

npm run deploy

Published URL:

https://bdyusuf2016.github.io/cdpayment

Database

Use the SQL/schema files in this repo to prepare Supabase:

• supabase_schema.sql
• sql/run_admin_sql.sql
• sql/tenant_isolation_rls.sql

Security Notes

• Real .env files are ignored and should never be committed
• Secret leakage history for .env files has already been purged from Git history
• Rotate Supabase keys if you have ever exposed them in commits or screenshots
• Keep SUPABASE_SERVICE_ROLE_KEY server-side only

Useful Commands

npm run dev
npm run build
npm run preview
npm run deploy
npm run sql:init

Recent Hardening

• Removed tracked local env files from Git
• Cleaned .gitignore
• Patched vulnerable build dependencies
• Cleared npm audit findings
• Kept main source-only and gh-pages publish-only