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
- 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.
- The menu has five items: Home, My work, Due dates, Clients and Team. Inside some of them, tabs under the menu lead to more.
- 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
| Tab | What it shows |
|---|---|
| My jobs | Your jobs in four groups: late, due today, doing, and waiting. On the right, the three jobs to do next. |
| All jobs | Every job in the office. Filter by status, due date, person, client or type; or sort by urgency. |
| Board | A column for each status (To do, Doing, Checking, Done). Buttons on each card move it on. |
| Calendar | The month, with jobs on their due dates. Returns have an orange edge, late jobs are red, done jobs are struck through. |
| My hours | This 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.
| Return | Due | Which clients |
|---|---|---|
| GSTR-1 | 11th of the next month | Clients with a GST number |
| GSTR-3B | 20th of the next month | Clients with a GST number |
| TDS return | 31 Jul, 31 Oct, 31 Jan, 31 May | Clients with a TAN |
| Advance tax | 15 Jun, 15 Sep, 15 Dec, 15 Mar | Everyone except trusts |
| Income-tax return | 31 Jul, or 31 Oct if audited (and for companies and LLPs) | Everyone |
| Tax audit report | 30 Sep | Clients whose accounts are audited |
| Company filings (AOC-4, MGT-7, Form 8) | 30 Oct | Companies 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
| Tab | What it shows |
|---|---|
| Who is busy | A 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. |
| Hours | Hours by client, the share that is billable, and hours used against each service's budget. Download as a spreadsheet. |
| Weekly summary | A short note for the partners with the week's numbers. |
| Activity | Everything that changed, newest first. |
| People | Partners 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
| Word | Meaning |
|---|---|
| Job | A piece of work: a return to file, an audit, a notice to answer, a call to make. |
| Step | Part of a bigger job. |
| Waiting | A job that can't start until another job is done. |
| Due date | The date the government expects a return. Aim by is the earlier date the office plans for. |
| Service | What the office does for a client in a year, such as GST work or an audit, with a budget and a fee. |
| Checking | Done by the person who did the work, waiting for a senior to check it. |
9. Who can do what
| Role | Can do |
|---|---|
| Partner | Everything, plus People: invites, roles and hours per week. |
| Manager | Add clients and services, create and move anyone's jobs, create due-date jobs, log time. |
| Staff | Create 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
| Setting | Meaning |
|---|---|
FILERIGHT_DB | Where the data file lives (default fileright.db). |
FILERIGHT_SEED=1 | Fill an empty data file with the made-up demo office. |
FILERIGHT_HOME | Where Home lives: / in the office, /desk on the hosted demo. |
FILERIGHT_BASE_URL | The address used in invite links. |
SESSION_SECRET, FEED_TOKEN | Keep sign-ins safe; protect the data feed below. |
ANTHROPIC_API_KEY / OPENROUTER_API_KEY | Optional: 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.
| Address | Returns |
|---|---|
GET /healthz | Public: is it running, how many clients and jobs. |
GET /api/v1/tasks | Jobs, with late and waiting worked out. Filters: status, assignee, client, filing. |
GET /api/v1/clients | Clients with their numbers, returns, open and late jobs. |
GET /api/v1/time | Hours 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.