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.
Links
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 (
step1tostep5) that progressed from selector discovery and login handling intoMIS -> Information Center -> Payment Detailsnavigation. - 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.