How sumaniya-sheikh/gst-invoice-system works
This is a web-based GST invoice compliance and finance-operations system for business users and administrators. Users authenticate, submit invoice data, review parsed invoices and compliance findings, correct records, and inspect risk and reporting views. The README documents GSTIN and tax validation, duplicate/anomaly detection, risk scoring, reports, and role-based access; the source excerpts confirm CSV parsing and invoice analysis. Several finance modules are listed but unsampled, so their internal calls are not asserted.
Main entry points: App.jsx Application shell · MonthlyGstSummary.jsx Finance views · InvoiceService.java Invoice ingestion and analysis · invoiceService.js Invoice API client
Components 22
Web application
- Application shell
frontend/src/App.jsx - Login and account
frontend/src/pages/Login.jsx - Invoice review
frontend/src/pages/RecentInvoices.jsx - Dashboard and issues
frontend/src/pages/Dashboard.jsx - Finance views
frontend/src/pages/MonthlyGstSummary.jsx - Invoice API client
frontend/src/services/invoiceService.js
Identity and access
- Authentication API client
frontend/src/services/authService.js - Authentication endpoints
src/main/java/com/gstcompliance/gstinvoicesystem/controller/AuthController.java - User administration
src/main/java/com/gstcompliance/gstinvoicesystem/controller/UserManagementController.java
Invoice compliance
- Invoice ingestion and analysis
src/main/java/com/gstcompliance/gstinvoicesystem/service/InvoiceService.java - GSTIN validation
src/main/java/com/gstcompliance/gstinvoicesystem/validation/GstinValidator.java - Invoice endpoints
src/main/java/com/gstcompliance/gstinvoicesystem/controller/InvoiceController.java
Finance operations
- Vendor management and risk
src/main/java/com/gstcompliance/gstinvoicesystem/controller/VendorController.java - Payment tracking
src/main/java/com/gstcompliance/gstinvoicesystem/controller/PaymentController.java - GST summaries and registers
src/main/java/com/gstcompliance/gstinvoicesystem/controller/MonthlyGstSummaryController.java - Audit history
src/main/java/com/gstcompliance/gstinvoicesystem/controller/AuditController.java
Domain data
- User records
src/main/java/com/gstcompliance/gstinvoicesystem/repository/UserRepository.java - Invoice records
src/main/java/com/gstcompliance/gstinvoicesystem/repository/InvoiceRepository.java - Compliance issues
src/main/java/com/gstcompliance/gstinvoicesystem/repository/InvoiceIssueRepository.java - Correction history
src/main/java/com/gstcompliance/gstinvoicesystem/repository/InvoiceCorrectionRepository.java - Finance data stores
src/main/java/com/gstcompliance/gstinvoicesystem/repository
Other components
- Business user / admin
Connections 27
- Business user / admin → Application shell: uses
frontend/src/App.jsx - Application shell → Login and account: renders
frontend/src/App.jsx - Application shell → Invoice review: renders
frontend/src/App.jsx - Application shell → Dashboard and issues: renders
frontend/src/App.jsx - Application shell → Finance views: routes to
frontend/src/App.jsx - Application shell → Authentication API client: checks session
frontend/src/App.jsx - Application shell → Invoice API client: loads invoices
frontend/src/App.jsx - Login and account → Authentication API client: authenticates
- Authentication API client → Authentication endpoints: HTTP requests
- Authentication endpoints → User records: reads users
- User administration → User records: manages users
src/main/java/com/gstcompliance/gstinvoicesystem/controller/UserManagementController.java - Invoice review → Invoice API client: requests invoices
- Dashboard and issues → Invoice API client: uploads data
- Invoice API client → Invoice endpoints: HTTP requests
- Invoice endpoints → Invoice ingestion and analysis: delegates to
- Invoice ingestion and analysis → GSTIN validation: validates GSTIN
src/main/java/com/gstcompliance/gstinvoicesystem/service/InvoiceService.java - Invoice ingestion and analysis → Invoice records: saves and checks
src/main/java/com/gstcompliance/gstinvoicesystem/service/InvoiceService.java - Invoice ingestion and analysis → Compliance issues: stores findings
src/main/java/com/gstcompliance/gstinvoicesystem/service/InvoiceService.java - Invoice ingestion and analysis → Correction history: stores corrections
src/main/java/com/gstcompliance/gstinvoicesystem/service/InvoiceService.java - Finance views → Vendor management and risk: views vendor data
- Finance views → Payment tracking: views payments
- Finance views → GST summaries and registers: views summaries
- Finance views → Audit history: views audit data
- Vendor management and risk → Finance data stores: uses records
- Payment tracking → Finance data stores: uses records
- GST summaries and registers → Finance data stores: uses records
- Audit history → Finance data stores: uses records