Tax Filing System

In Progress

Apr 2026 - Present

Tax Filing System is an automation-focused project for Pakistan FBR IRIS Form 114 workflows, combining Playwright-driven portal execution with explicit human control at sensitive decision points.

The current phase has moved beyond planning into runnable browser automation scripts that cover login handling, manual CAPTCHA/OTP continuation, Payment Details search, and Excel export capture with session reuse.

Built with: Node.js (ES modules), Playwright, npm scripts with .env loading, browser session storage-state handling, and Markdown-based workflow documentation.

Project Activity

Recent updates for Tax Filing System. In Progress

May 2026

  • Delivered ATL status-check infrastructure by adding typed ATL contracts, today-only validation, protected init/verify gateway actions, snapshot persistence, one-row-per-user enforcement, and a new ATL check card aligned to the auth UI theme.
  • Refactored ATL verification execution so captcha-gated checks move into the admin-controlled flow with Supabase-backed status persistence, and introduced roles/features migration with PostgreSQL RLS to secure capability access.
  • Stabilized the user-facing baseline by finalizing post-login onboarding persistence to Supabase, restoring the previous landing page after framework experiments, and resolving build/type issues with updated ATL usage documentation.
  • Set up Superpowers workflow tooling to improve local execution ergonomics and prepare faster agent-assisted development loops for the ongoing ATL and onboarding streams.
  • Completed the Phase 01 gap-closure track by canonicalizing auth/onboarding routes, restoring deferred auth scope behavior, tightening middleware redirects and protected-flow gating, adding regression-first tests, and syncing UAT plus phase documentation; removed the interim GSD path from the runtime flow.
  • Executed core Phase 01 auth implementation: introduced Supabase SSR client factories and role contracts, implemented deterministic signup/signin and callback server actions, enforced server-side session/role gates with onboarding redirects, and added RED-to-green contract tests across auth, onboarding, and identity-convergence flows.
  • Hardened delivery and operability with local Supabase project configuration, explicit environment/setup guidance, restored public home entry behavior, and complete phase planning/state documents for reproducible verification and handoff.
  • Captured Phase 01 working state and context-session notes to preserve decision history and maintain continuity before continuing auth and onboarding execution.
  • Bootstrapped the new ATL-facing web initiative by initializing project configuration, completing initial research, defining v1 requirements, and publishing a seven-phase roadmap to sequence implementation.
  • Shipped the initial Next.js Phase 1 frontend slice with landing and registration-start flows, including CNIC/OTP-gated UX, polished four-step registration theming, hydration/layout fixes, and stronger submit-path behavior for reliable onboarding interactions.

April 2026

  • Completed Step 8 end-to-end selector discovery for Tax Chargeable/Payments subsections (archive order 01-18) with stable per-subsection archival naming, stronger session/draft/submenu reliability, and README updates reflecting full 18/18 coverage.
  • Established the Playwright IRIS baseline across Steps 1-4 with .env-backed configuration and reusable login/session flow, then updated roadmap/docs to guide the next automation milestones.
  • Built a robust Step 5 payment-details automation path that reuses authenticated state, executes controlled search behavior, and downloads a validated non-empty Excel export with deterministic file naming and overwrite handling.
  • Implemented Step 6 Form 114 return-creation automation and standardized Steps 1-6 to emit a unified JSON contract with DEBUG-gated logs and headed execution defaults for consistent operational observability.
  • Implemented Step 7 as a generic payload-driven IRIS draft editor that opens existing drafts, applies resilient field operations (fill/select/click/check/uncheck), saves safely, and returns structured per-field outcomes with artifacts.
  • Initialized the repository and replaced starter template docs with project-specific architecture direction for FBR IRIS Form 114 automation, defining controlled draft preparation with tax-expert review, client approval, and human-governed submission.

Objective Link to heading

  • Build a practical automation baseline for Pakistan FBR IRIS Form 114 workflows, with browser-driven execution for repeatable operational steps.
  • Keep filing control human-governed by preserving explicit review/approval checkpoints and avoiding silent end-to-end submission behavior.

Implementation path Link to heading

  • Replaced generic project boilerplate with IRIS-specific product and workflow documentation, including controlled automation boundaries.
  • Implemented a Playwright stepwise runner (step1 to step5) that progressed from selector discovery and login handling into MIS -> Information Center -> Payment Details navigation.
  • Added session-state reuse, deterministic download naming, and export diagnostics to support reliable local execution and easier backend integration later.

Compliance and reliability focus Link to heading

  • Keep CAPTCHA/OTP in the human control path for sensitive authentication and portal-verification steps.
  • Emit structured status outcomes and capture screenshots/HTML artifacts on failure paths for traceability and recovery.
  • Keep credentials externalized via environment variables and avoid committing operational secrets.