| Foundations | Schema: users, invites, clients, engagements, tasks, task dependencies, compliance templates, subscriptions, time entries, holidays, events | Built | db.init() on an empty file creates exactly those tables plus schema_version; running it twice is a no-op (row counts unchanged) |
| Foundations | Synthetic seed: a Hyderabad CA firm, its team and thirty clients | Built | seeded DB holds 10 users across partner/manager/staff, 30 clients of >=4 constitution types (company, LLP, firm, individual, trust), >=40 engagements, >=250 tasks covering every status and priority, >=8 weeks of time entries and generated compliance tasks for the current and previous month; reseeding an empty DB gives the same counts |
| Foundations | App shell: FastAPI boot, /healthz, base layout with design tokens | Built | curl /healthz returns 200 JSON with ok=true, db path, client/task/user counts and ai provider; the signed-in dashboard returns 200 HTML with the nav |
| Foundations | Test harness | Built | pytest -q runs >=1 test against a temp DB via TestClient and passes |
| Clients & engagements | Client register with PAN/GSTIN validation and constitution type | Built | POST a client with a malformed PAN or a GSTIN whose embedded PAN differs returns 422 with a field error; a valid one is created; GET /clients?q=<fragment> lists only matches |
| Clients & engagements | Client detail: engagements, open tasks, filings this month, hours this month | Built | GET /clients/{id} shows its engagements and open tasks; the hours figure equals the SQL sum of that client's time entries in the current month |
| Clients & engagements | Engagements with type, budget hours, fee and up to 10 custom fields | Built | creating an engagement with 11 custom fields returns 422; with 3 it stores and renders all 3 on the engagement page |
| Clients & engagements | Engagement health derived: % done, overdue count, hours vs budget, a red/amber/green flag | Built | unit test: an engagement with an overdue task or hours >110% of budget is red; >=90% hours or a task due in 2 days is amber; else green — health is never stored |
| Tasks | Task register with filters (status, priority, assignee, client, due window, search) | Built | GET /tasks with each filter returns exactly the SQL-matching ids; submitting the form with every select on its blank 'All' option returns 200 (never 422) |
| Tasks | Lifecycle: todo -> in progress -> review -> done, plus cancelled; every change writes an event | Built | an illegal transition (done -> todo without reopen) returns 409; a legal one writes a 'task.status' event with from/to; reopen works from done and cancelled |
| Tasks | Subtasks to any depth; parent progress derived from leaves | Built | a three-level tree renders nested on the task page; the parent's progress equals done leaves / all leaves; a parent cannot be marked done while a subtask is open (409) |
| Tasks | Dependencies (finish-to-start): blocked derived, cycles rejected | Built | adding B depends-on A makes B 'blocked' until A is done; adding A depends-on B then returns 422 (cycle); starting a blocked task returns 409 |
| Tasks | Board view (columns by status, move by button) and month calendar by due date | Built | GET /board shows one column per status with card counts equal to SQL; GET /calendar?month=YYYY-MM puts each task with a due date in that month in its day cell (headless: cell counts match SQL, 0 console errors) |
| Tasks | My day: my overdue, due today, in progress and blocked, in that order | Built | GET /me as a staff user lists only their tasks in the four groups; overdue is derived from due date and status |
| Statutory calendar | Compliance templates: GSTR-1, GSTR-3B, TDS return, advance tax, ITR, tax audit, ROC annual filing | Built | each template has a frequency and a due-date rule; unit test: for FY 2026-27 the rules give GSTR-3B on the 20th of the following month, TDS 24Q/26Q on 31 Jul/31 Oct/31 Jan/31 May, advance tax on 15 Jun/Sep/Dec/Mar |
| Statutory calendar | Client subscriptions derived from profile (GST-registered, TAN holder, audit applicable, company) | Built | a company with GSTIN, TAN and audit gets GSTR-1, GSTR-3B, TDS, advance tax, tax audit, ITR and ROC; an individual without GSTIN gets only advance tax and ITR; overrides can add or drop a filing |
| Statutory calendar | Generator: idempotent, statutory due date plus an internal target N working days earlier | Built | running the generator twice for the same period creates tasks once; the internal target skips Sundays and listed holidays (unit test with a holiday on the natural target) |
| Statutory calendar | Filing calendar: a month of statutory deadlines with status per client | Built | GET /filings?month=YYYY-MM shows every generated filing task in that month grouped by due date with its client and status; the filed count equals SQL |
| Time | Timer on a task: start, stop; one running timer per person | Built | starting a second timer stops the first and records its minutes; stopping writes an entry whose minutes equal the elapsed time (frozen clock test) |
| Time | Manual time entry with validation (date, minutes 5-720, billable flag) | Built | an entry of 0 or 800 minutes or a future date returns 422; a valid one appears on the task and in the timesheet |
| Time | Weekly timesheet per person (days x tasks grid, totals) | Built | GET /time?week=YYYY-Www renders one row per task with entries that week; each day total equals SQL |
| Time | Time report: hours by client and engagement, billable share, budget burn, CSV export | Built | GET /reports/time?from&to totals equal SQL sums; /export/time.csv has one row per entry in the window |
| Workload & dashboard | Capacity per person and load from remaining estimates due in the window | Built | unit test: a person with 40 h capacity and 46 h of remaining estimate due this week is 'over' by 6 h; load excludes done/cancelled tasks and counts logged time against the estimate |
| Workload & dashboard | Workload page: a bar per person, over-capacity flagged, suggested reassignments | Built | GET /workload shows one bar per active user; an over-capacity person has >=1 suggestion to move a task to the least-loaded eligible colleague |
| Workload & dashboard | Dashboard: overdue, due this week, filings due, blocked, running timers, hours this week | Built | each dashboard tile equals its SQL count (headless check against the seeded DB, 0 console errors) |
| Workload & dashboard | Activity log with filters | Built | every create/status/assign/time action appears in GET /activity newest first; ?kind= filters |
| Assistant | Provider selection and honest labelling (Anthropic, OpenRouter, heuristic) | Built | /healthz names the provider; with no key the assistant answers from the heuristic path and every answer is labelled with its provider |
| Assistant | Auto-prioritise: a score per open task with the reasons shown | Built | unit test: an overdue statutory filing outranks a later internal task; each score lists its factors (due, penalty, blocks others, priority); /tasks?sort=score orders by it |
| Assistant | Next three actions for the signed-in person | Built | GET /assistant/next returns 3 of the person's unblocked open tasks, highest score first, each with a one-line reason |
| Assistant | Draft subtasks for a task (checklist per filing type; LLM when configured) | Built | POST /tasks/{id}/draft returns >=3 subtasks for a GSTR-3B task from the heuristic path; accepting creates them as children |
| Assistant | Meeting notes to action items | Built | POSTing notes with lines like 'Priya to reconcile 2B for Sri Balaji by Friday' proposes tasks with assignee, client and due date resolved; nothing is created until confirmed |
| Assistant | Weekly practice report narrative | Built | GET /reports/weekly returns a narrative whose every number (filings filed/due, hours, overdue) equals SQL |
| Accounts | Users, PBKDF2 passwords, stateless signed sessions | Built | wrong password returns 401 on /login; a session cookie from one instance is accepted by another with the same secret |
| Accounts | Roles: partner, manager, staff with a permission map | Built | staff cannot create clients or reassign others' tasks (403); manager can; partner can manage users |
| Accounts | Shared OC Apps guest login and the gate-off guest session | Built | guest-YYMMDD-xxxx with the derived password signs in as partner-view; OC_GATE_OFF=1 on the twin lands /app on the dashboard with a guest session |
| Ship | JSON API with feed token (tasks, clients, time) | Built | GET /api/v1/tasks without token returns 401 JSON; with ?token=<FEED_TOKEN> returns 200 with count equal to the task table |
| Ship | Local lane under pm2 on :8391 | Built | pm2 shows 'fileright' online; curl 127.0.0.1:8391/healthz ok=true after pm2 restart fileright; pm2 save done |
| Ship | Headless walk of every page | Built | tools/walk.py exits 0 against :8391, light and dark, 1280/820/390 px, 0 console errors, 0 failed requests |
| Ship | Hosted twin on Vercel at fileright.ajaykongala.online | Built | fileright.ajaykongala.online/healthz returns ok=true; /app opens the dashboard with a guest session while OC_GATE_OFF=1; walk against the twin exits 0 |
| Ship | Betadoc LONG: story, architecture, honest matrix generated from this tracker, documentation page | Built | GET / and /documentation.html on the twin return 200; the matrix block equals tools/matrix.py output for the current tasks.db; light and dark at 1280/390 px have 0 console errors |
| Ship | OC Apps card: apps.json entry, mark, /fileright/ rewrite, measured memory, deploy | Built | tools/check_apps.py says schema ok; the probe finds every FileRight link answering; oc-apps.ajaykongala.online/fileright/ returns the betadoc with and without the oc_access cookie |
| Ship | Register: port registry rows, HOME.md line, mirror repo ajay-453/fileright | Roadmap | port_registry.py list shows 8391 and 6805; tools/mirror_repos.sh fileright pushes and prints the commit count |
| Beyond v1 | Integrations: calendar feed, email-in to task, Slack/WhatsApp reminders | Roadmap | an .ics feed per person validates and lists their due tasks; an email to the inbox address creates a task |
| Beyond v1 | Gantt view with critical path across dependencies | Roadmap | GET /gantt?engagement= renders bars by start/due; the critical path equals the longest dependency chain by estimate |
| Beyond v1 | Client portal: document requests and uploads | Roadmap | a client link lists requested documents; an upload marks the request received and notifies the assignee |
| Beyond v1 | GST portal status sync (filed / not filed per return) | Roadmap | a sandbox call for a GSTIN returns filing status per period and updates the matching filing tasks |
| Beyond v1 | Invoicing from timesheets and fixed fees | Roadmap | an invoice for an engagement totals billable hours x rate plus fixed fee, with GST at 18%, and exports to PDF |
| Rename and simplify | Rename to FileRight everywhere: app, twin domain, card, registry, mirror name | Built | grep finds the old name nowhere in the app, the card or the product page outside its generated matrix; fileright.ajaykongala.online/healthz says app=FileRight; the old domain redirects to it |
| Rename and simplify | Five-item menu (Home, My work, Due dates, Clients, Team) with tabs for the rest | Built | headless: the top menu has exactly 5 links on every page; every former page is reachable from the menu plus one tab; 0 console errors |
| Rename and simplify | Plain words: job, step, service, waiting, due dates | Built | headless: no page's visible text contains 'engagement', 'blocked', 'subtask' or 'filings'; tests updated and green |
| Rename and simplify | Simpler Home: three numbers, five jobs to do first, a three-step 'how it works' | Built | Home shows exactly 3 number tiles, each equal to its SQL count, a 'Do these first' list of 5 and the 3-step intro; walk 0 console errors |
| Rename and simplify | Product page and documentation rewritten for FileRight and the new menu | Built | / and /documentation.html on the twin say FileRight, use the new menu names, matrix equals tools/matrix.py; light and dark at 1280/390 px clean |