How cloudmonks-1000/invoice-automation-ts works
This is an invoice and voucher automation web application: users authenticate, inspect dashboard and processing history, retrieve voucher files, and submit bulk uploads; administrators manage users, processing, and system views. The runtime is a Next.js application backed by Oracle, with repository-backed auth and voucher services. The tree and source index document the major capabilities, but there is no README and most UI/API implementation excerpts were not supplied, so some UI-to-API relationships are intentionally omitted.
Main entry points: auth.ts Authentication guard · oracle.ts Oracle connection pool · route.ts Login endpoint · App.tsx Application shell
Components 34
User interfaces
- Application shell
src/App.tsx - Dashboard view
src/ui-pages/Dashboard.tsx - Summary view
src/ui-pages/Summary.tsx - History view
src/ui-pages/History.tsx - User navigation
src/components/Sidebar.tsx
Identity and access
- Login endpoint
app/api/auth/login/route.ts - Session endpoints
app/api/auth - Authentication guard
src/auth/auth.ts - JWT handling
src/utils/jwt.ts - Login rate limit
src/security/login-rate-limit.ts
Invoice operations
- Dashboard endpoint
app/api/dashboard/route.ts - History endpoint
app/api/history/route.ts - History export
app/api/history/export/route.ts - Invoice retrieval
app/api/invoices/[voucherNumber]/route.ts - Bulk upload
app/api/invoices/bulk/upload/route.ts - Voucher download
app/api/vouchers/download/route.ts - Input file parsing
src/utils/input-file.ts - Voucher validation
src/validation/voucher.validation.ts - Download service
src/services/voucher-download.service.ts - ZIP generation
src/utils/zip.ts
Administration
- Admin layout
src/admin/layout/AdminLayout.tsx - Admin navigation
src/admin/components/AdminSidebar.tsx - Admin header
src/admin/components/AdminHeader.tsx - Admin dashboard
app/admin/page.tsx - Processing controls
app/admin/processing/page.tsx - System view
app/admin/system/page.tsx - User management
app/admin/users/page.tsx - Admin endpoints
app/api/admin
Persistence and files
- Oracle connection pool
src/db/oracle.ts - User and session data
src/db/repositories/auth.repository.ts - Processing records
src/db/repositories/records.repository.ts - Voucher files
src/db/repositories/voucher.repository.ts
Other components
- User
- Administrator
Connections 44
- User → Application shell: uses
- Administrator → Admin layout: uses
- Application shell → Dashboard view: renders
src/App.tsx - Application shell → Summary view: renders
src/App.tsx - Application shell → History view: renders
src/App.tsx - Application shell → User navigation: uses
src/App.tsx - Admin layout → Admin navigation: uses
src/admin/layout/AdminLayout.tsx - Admin layout → Admin header: uses
src/admin/layout/AdminLayout.tsx - Administrator → Admin dashboard: opens
- Administrator → Processing controls: opens
- Administrator → System view: opens
- Administrator → User management: opens
- User → Login endpoint: signs in
- Login endpoint → Login rate limit: checks limits
app/api/auth/login/route.ts - Login endpoint → User and session data: looks up user
app/api/auth/login/route.ts - Login endpoint → JWT handling: creates token
app/api/auth/login/route.ts - Login endpoint → Oracle connection pool: opens connection
app/api/auth/login/route.ts - Login endpoint → User and session data: creates session
app/api/auth/login/route.ts - Authentication guard → JWT handling: verifies token
src/auth/auth.ts - Authentication guard → Oracle connection pool: checks session
src/auth/auth.ts - User and session data → Oracle connection pool: queries
src/db/repositories/auth.repository.ts - Dashboard endpoint → Authentication guard: authenticates
app/api/dashboard/route.ts - Dashboard endpoint → Oracle connection pool: queries metrics
app/api/dashboard/route.ts - History endpoint → Authentication guard: authenticates
app/api/history/route.ts - History endpoint → Oracle connection pool: queries history
app/api/history/route.ts - History export → Authentication guard: authenticates
app/api/history/export/route.ts - History export → Oracle connection pool: reads records
app/api/history/export/route.ts - Invoice retrieval → Authentication guard: authenticates
app/api/invoices/[voucherNumber]/route.ts - Invoice retrieval → Processing records: reads records
app/api/invoices/[voucherNumber]/route.ts - Invoice retrieval → Voucher files: reads voucher files
app/api/invoices/[voucherNumber]/route.ts - Invoice retrieval → ZIP generation: packages files
app/api/invoices/[voucherNumber]/route.ts - Bulk upload → Authentication guard: authenticates
app/api/invoices/bulk/upload/route.ts - Bulk upload → Input file parsing: parses input
app/api/invoices/bulk/upload/route.ts - Bulk upload → Voucher validation: validates input
app/api/invoices/bulk/upload/route.ts - Bulk upload → Processing records: records processing
app/api/invoices/bulk/upload/route.ts - Voucher download → Authentication guard: authenticates
app/api/vouchers/download/route.ts - Voucher download → Voucher validation: validates request
app/api/vouchers/download/route.ts - Voucher download → Download service: gets files
app/api/vouchers/download/route.ts - Download service → Voucher files: finds files
src/services/voucher-download.service.ts - Download service → ZIP generation: builds archive
src/services/voucher-download.service.ts - Processing records → Oracle connection pool: reads and writes
src/db/repositories/records.repository.ts - Voucher files → Oracle connection pool: reads files
src/db/repositories/voucher.repository.ts - Admin endpoints → Authentication guard: authenticates
app/api/admin/dashboard/route.ts - Admin endpoints → Oracle connection pool: queries admin data
app/api/admin/dashboard/route.ts