FileRight guide

FileRight keeps a CA office's work in one place: the government due dates for every client, the jobs that come from them, who is doing what, and the hours spent. The demo is a made-up office, Rao & Iyer Associates in Hyderabad, with ten people and thirty clients.

1. Getting started

  1. Open fileright.ajaykongala.online/app. You are signed in as a guest partner straight away, with no sign-up, so you can see every page.
  2. The menu has five items: Home, My work, Due dates, Clients and Team. Inside some of them, tabs under the menu lead to more.
  3. Change anything you like: the demo resets to the made-up office when it restarts.

FileRight works in three steps, which Home also shows: due dates make the jobs, everyone does their jobs, and partners keep the team balanced.

2. Home

Three numbers: Late (jobs past their due date), Due this week and Waiting (jobs that can't start until another job is done). Click a number to see those jobs.

Do these first lists the five most urgent jobs in the office, with the reason (for example "Overdue by 11 days"). Due dates this month shows how many returns are done for each date. A line at the bottom says if anyone has more work than hours this week.

3. My work

TabWhat it shows
My jobsYour jobs in four groups: late, due today, doing, and waiting. On the right, the three jobs to do next.
All jobsEvery job in the office. Filter by status, due date, person, client or type; or sort by urgency.
BoardA column for each status (To do, Doing, Checking, Done). Buttons on each card move it on.
CalendarThe month, with jobs on their due dates. Returns have an orange edge, late jobs are red, done jobs are struck through.
My hoursThis week's timesheet: hours per job per day.

Working on a job

  • Start moves it to Doing. Send for checking when you are done and a senior should check it. Mark done finishes it. Finished jobs can be reopened.
  • Start timer counts your time; press again to stop and log it. Only one timer runs per person: starting another stops the first. You can also type hours (45, 1:30, 2h).
  • Steps: break a big job into steps (an audit has twelve). The job shows how many steps are done, and can't be marked done while a step is open. Suggest fills in the office's checklist.
  • Waits for: type another job's number (T-0123) and this job waits until that one is done. It can't be started early, and FileRight refuses a loop.

4. Due dates

This month lists every government due date in the month, grouped by date, with each client, who is doing it, the date to aim for and the status. Create jobs for (month) adds any missing jobs; pressing it again adds nothing.

ReturnDueWhich clients
GSTR-111th of the next monthClients with a GST number
GSTR-3B20th of the next monthClients with a GST number
TDS return31 Jul, 31 Oct, 31 Jan, 31 MayClients with a TAN
Advance tax15 Jun, 15 Sep, 15 Dec, 15 MarEveryone except trusts
Income-tax return31 Jul, or 31 Oct if audited (and for companies and LLPs)Everyone
Tax audit report30 SepClients whose accounts are audited
Company filings (AOC-4, MGT-7, Form 8)30 OctCompanies and LLPs

The date to aim for is a few working days earlier (3 for GST and advance tax, 5 for TDS, 7 for company filings, 10 for returns and audits), skipping Sundays and the office's holidays. If the government extends a date, change it on the job.

5. Clients

The client list shows each client's PAN and GST number, which returns it needs, and its open and late jobs. A client page shows its services (GST work, TDS work, income tax, audits, company filings, bookkeeping, advice), each with a budget in hours, a fee and a colour: red if a job is late or the hours are over 110% of the budget, amber when close, green when on track.

When you add a client, FileRight checks the numbers: the PAN's fourth letter must match the type of client (C company, F firm or LLP, P person, T trust, H HUF), and the GST number must contain the PAN and a correct last character, which catches most typing mistakes. The client page also lets you add or drop a return by hand.

6. Team

TabWhat it shows
Who is busyA bar per person: the work left on their jobs due by Sunday (late ones included) against the hours they work in a week. Red means more work than hours. Who can help suggests moving jobs not started yet to the person with most free hours; one click moves them.
HoursHours by client, the share that is billable, and hours used against each service's budget. Download as a spreadsheet.
Weekly summaryA short note for the partners with the week's numbers.
ActivityEverything that changed, newest first.
PeoplePartners only: invite people, set roles and hours per week.

7. The assistant

The Assistant button is on every page.

  • What next: your three most urgent jobs that aren't waiting for anything, with the reason. Urgency comes from fixed rules: late jobs first, then jobs due soon, government due dates, jobs other jobs are waiting for, and the priority someone set.
  • Meeting notes: paste lines like “Priya to reconcile 2B for Sri Balaji by Friday”. Each becomes a proposed job with the person, client and date filled in. Untick any you don't want; nothing is created until you confirm.
  • Weekly summary: the same note as the Team tab.
  • Break this job down (on a job page): suggested steps.

It works without any AI service. If an AI key is set up it may write the steps and the summary, and the badge in the assistant says which one answered.

8. Words we use

WordMeaning
JobA piece of work: a return to file, an audit, a notice to answer, a call to make.
StepPart of a bigger job.
WaitingA job that can't start until another job is done.
Due dateThe date the government expects a return. Aim by is the earlier date the office plans for.
ServiceWhat the office does for a client in a year, such as GST work or an audit, with a budget and a fee.
CheckingDone by the person who did the work, waiting for a senior to check it.

9. Who can do what

RoleCan do
PartnerEverything, plus People: invites, roles and hours per week.
ManagerAdd clients and services, create and move anyone's jobs, create due-date jobs, log time.
StaffCreate jobs and steps, move their own jobs, log time.

New people join with an invite link from a partner. The first account on a new installation is a partner.

10. Setting it up

FileRight is one Python program and one data file. It runs on the office computer or server, and people open it in a browser.

uv venv .venv && uv pip install -r requirements.txt
FILERIGHT_SEED=1 .venv/bin/uvicorn app.main:app --port 8391
SettingMeaning
FILERIGHT_DBWhere the data file lives (default fileright.db).
FILERIGHT_SEED=1Fill an empty data file with the made-up demo office.
FILERIGHT_HOMEWhere Home lives: / in the office, /desk on the hosted demo.
FILERIGHT_BASE_URLThe address used in invite links.
SESSION_SECRET, FEED_TOKENKeep sign-ins safe; protect the data feed below.
ANTHROPIC_API_KEY / OPENROUTER_API_KEYOptional: let an AI draft steps and the weekly summary.

11. For developers

A read-only data feed for other tools. Add ?token=… (the FEED_TOKEN); without it the answer is 401.

AddressReturns
GET /healthzPublic: is it running, how many clients and jobs.
GET /api/v1/tasksJobs, with late and waiting worked out. Filters: status, assignee, client, filing.
GET /api/v1/clientsClients with their numbers, returns, open and late jobs.
GET /api/v1/timeHours logged between start and end (default: the last 30 days).

12. Not built yet

  • Bills from hours, a page for clients to upload documents, and a check against the GST portal.
  • Reminders by WhatsApp or email, a calendar feed, and a timeline view of big jobs.
  • Attaching files to a job, and importing clients from a spreadsheet.
  • Government date extensions: change the job's date by hand.
  • The hosted demo forgets your changes when it restarts; the office version keeps everything in its data file.