Enterprise Platform
Company Management System
Full-stack enterprise platform with project tracking, invoicing, GST billing, salary slips, finance reports, and Keycloak RBAC with Google login.
Status
Completed
Auth
Keycloak + Google
Invoicing
GST · LUT · PDF
Modules
7 core modules
Users
Multi-role RBAC
The Problem
An enterprise company managing multiple projects, clients, freelancers, and internal employees across invoicing, payments, and reporting relied on disconnected spreadsheets — with no unified system for project tracking, billing, or financial reporting.
The Solution
A FastAPI backend with domain-separated modules and a type-safe Next.js frontend. Keycloak handles SSO with Google login and role-based groups for employees, freelancers, and admins. FullCalendar manages task scheduling. PDF generation produces professional invoices and salary slips. Finance reports provide filtered views of GST, TDS, client and developer payments.
Features
Project & Task Management
- Project creation with developer assignment and profit ratio tracking
- Task management with custom status colors (completed, in-progress, cancelled)
- Calendar-based task scheduling with FullCalendar integration
- Today / This week / Next week task views
- Task assignment to Keycloak members — shown via dropdown
- Comments section with edit, delete, and timestamped history
- Completed tasks tab with 50-task limit and tick-icon completion flow
Invoicing & Billing
- Client invoices with GST (CGST/SGST) for Indian clients
- LUT-based invoices for foreign clients — company name, GSTIN auto-populated
- Developer invoices with validation against quotation limits
- Invoice preview page before PDF download
- PDF generation using canvas library with logo, signature, and rupee symbol
- Salary slips with PF, ESIC auto-calculation based on working days
- Non-GST and TDS transaction tracking
Finance & Reports
- Client payment report with filters
- Developer payment report with filters
- GST sales report with total sales summary
- TDS transaction table
- Non-GST transaction table
- Company profit displayed in rupees per project
- Developer profit ratio auto-adjusted to sum to 100%
HR & People Management
- Employee management — add, edit, remove with Keycloak integration
- Freelancer management with separate billing and detail pages
- Client management with Indian/foreign classification
- Salary slip generation with ESIC no, PF number, allowances
- Inhouse developer tracking without profit ratio
- Role-based access — admin, manager, employee, freelancer
- Fully responsive mobile layout with hamburger sidebar across all pages
Architecture
“FastAPI backend with domain-separated routers: projects, tasks, finance, invoices, employees, freelancers, clients, reports. Keycloak provides SSO with Google login and JWT-based group permissions. Next.js frontend uses typed REST contracts for all API interactions. PDF generation happens server-side with HTML templates. PostgreSQL stores all relational business data with auto-calculated fields and cascading relations.”