stone-tax

As a user, I want to see a multi-level dashboard with 7 action cards upon login so that I can quickly navigate to key modules. Implement the Dashboard page based on the existing JSX design (Dashboard v1). Includes IRIS-style file folder action cards with 3D hover/tilt, virtual desk surface, color-shifting navbar accent stripe, and role-specific views (Admin: system stats, Consultant: client overview, Accountant: analytics, User: action cards).

As a user, I want to securely log in using my username and password so that I can access my dashboard. Implement the Login page based on the existing JSX design (Login v1). Includes floating card with embossed texture, hover shadow effect, and role-based stamp animation on success. Links from Landing page to Dashboard.

As a user, I want to see a visually compelling landing/registration page so that I can register a new account with my NTN/CNIC and personal details. Implement the Landing page based on the existing JSX design (Landing v1). Includes animated blueprint grid background, Pakistan Green crescent watermark, and registration form. Links to Login page.

As a user, I want to send, receive, and draft messages so that I can communicate with my tax consultant or clients. Implement the Messages page based on the existing JSX design (Messages v1). Includes Inbox, Outbox, and Drafts tabs. Paper airplane micro-animation on draft save, envelope-open animation on new message notification. Admin can broadcast announcements.

As a user, I want to view and update my profile information and change my password so that I can keep my account details current. Implement the Profile page based on the existing JSX design (Profile v1). Includes NTN/CNIC fields, password change form with inline validation, and Tax Consultant client list management section.

As an Admin, I want to view a complete audit log of all user actions so that I can monitor system activity for security and compliance. Implement the Audit Log page based on the existing JSX design (Audit Log v1). Includes chronological table with typewriter entry animation, filters by user/action/date, and timestamp display in PKT (Asia/Karachi).

As a backend developer, I want to implement FastAPI endpoints for user registration, login (JWT), logout, role management, and RBAC middleware so that the frontend authentication and user management pages have a secure API layer. Includes NTN/CNIC registration, bcrypt password hashing, JWT token issuance with 30-min inactivity expiry, Redis session store, and role-based route guards.

As a user, I want to file, edit, view, and track income tax returns so that I can manage my annual ITR submissions. Implement the Returns page based on the existing JSX design (Returns v1). Includes filing wizard with highlighter-style field focus, green checkmark stamps on completed sections, and 'FILED' stamp animation on submission. Supports draft editing and status tracking. Tax Consultant can file on behalf of clients.

As a user, I want to view my payment history and pending dues so that I can track my tax payment status. Implement the Payments page based on the existing JSX design (Payments v1). Includes payment history table with sorting/filtering, status badges (Pending, Paid, Overdue), and coin cascade micro-animation on payment confirmation. Consultant can track all client payments.

As an Admin, I want to manage user accounts and assign roles so that I can control system access. Implement the Users page based on the existing JSX design (Users v1). Includes user listing table with role badges, edit role modal, account activation/deactivation, and inline search/filter. Only accessible by Admin role.

As a user, I want to upload and manage tax-related documents so that I can organize all my filing materials. Implement the Documents page based on the existing JSX design (Documents v1). Includes document upload interface, file listing with type icons, and access controls for Tax Consultants viewing client documents.

As a Tax Consultant or Accountant, I want to browse and manage my client list so that I can oversee all assigned clients' tax filings. Implement the Clients page based on the existing JSX design (Clients v1). Includes horizontal scrolling carousel of manila folder cards showing client initials, filing status tags, and hover peek animation revealing last filing date and outstanding amount.

As a backend developer, I want to implement FastAPI endpoints for audit log retrieval and automatic logging middleware so that all Create, Update, Delete actions are captured with user ID and PKT timestamp. Admin-only access with filtering by user, action type, and date range.

As a user, I want to view and manage my withholding statements so that I can track taxes deducted at source. Implement the Withholding page based on the existing JSX design (Withholding v1). Includes withholding statement table with PKR currency formatting, DD/MM/YYYY dates, and sales invoice management.

As a backend developer, I want to implement FastAPI endpoints that return role-specific dashboard data so that each user persona sees the correct statistics and action card data. Includes system stats for Admin, client overview for Tax Consultant, analytics summary for Accountant, and action card counts for Individual User.

As a backend developer, I want to implement FastAPI endpoints for payment tracking so that users and consultants can view payment history, pending dues, and status updates. Includes PKR currency fields and transactional payment confirmation.

As a backend developer, I want to implement FastAPI endpoints for document upload/management and withholding statement CRUD so that users can manage their tax documents and consultants can access client documents. Includes sales invoice management and file storage via Docker volume.

As a backend developer, I want to implement FastAPI endpoints for the inbox, outbox, and drafts messaging system so that users can send, receive, and save messages. Includes admin broadcast endpoint, message threading, and draft persistence.

As a backend developer, I want to implement FastAPI CRUD endpoints for income tax returns so that users can file, edit drafts, view, and track return status. Includes transactional submission, status transitions (Draft → Filed → Approved/Rejected), and consultant proxy filing. All operations logged to audit log.

As a backend developer, I want to implement FastAPI endpoints for profile viewing, updating, and password change so that users can keep their account details current. Includes NTN/CNIC fields, secure password update with bcrypt, and consultant client list management.

As a frontend developer, I want to connect all React pages to their respective FastAPI backend endpoints so that the application uses live data instead of mock data. Includes Axios/fetch client setup, JWT token handling, error/toast notifications, loading states, and role-based route protection in React Router.