How harshbodani/stockmate works
StockMate is a web-based business and inventory system. Users sign in, then use configured screens, dashboard views, POS, or the assistant; browser requests reach the Java API, which applies role checks and delegates data operations to PostgreSQL. Database functions implement the documented transactional business rules, while document services generate PDFs. The README also describes CRM, purchasing, invoicing, quality, manufacturing, projects, HR, and POS. Some backend and frontend wiring is unsampled; edges below are limited to excerpts or README statements.
Main entry points: Api.java API routes · Main.java HTTP server startup · Assistant.java Assistant service · app.js Screen router
Components 19
Web interface
- Configured screens
frontend/js/config.js - Screen router
frontend/js/app.js - Dashboard
frontend/js/dashboard.js - POS terminal
frontend/js/pos.js - Voice assistant UI
frontend/js/voice.js
Java server
- HTTP server startup
backend/src/main/java/com/stockmate/Main.java - API routes
backend/src/main/java/com/stockmate/Api.java - Sessions and sign-in
backend/src/main/java/com/stockmate/Auth.java - Role permissions
backend/src/main/java/com/stockmate/Permissions.java - Database interface
backend/src/main/java/com/stockmate/Database.java - JDBC connection pool
backend/src/main/java/com/stockmate/JdbcDatabase.java - JSON parsing
backend/src/main/java/com/stockmate/Json.java
Business data
- PostgreSQL tables
db/schema.sql - Business functions
db/functions.sql
Assistant and documents
- Assistant service
backend/src/main/java/com/stockmate/Assistant.java - PDF documents
backend/src/main/java/com/stockmate/Documents.java - PDF renderer
backend/src/main/java/com/stockmate/Pdf.java
Other components
- Business user
- OpenJarvis
Connections 20
- Business user → Screen router: uses
README.md - Configured screens → Screen router: configures
README.md - Screen router → API routes: requests data
- POS terminal → API routes: requests sales data
frontend/js/pos.js - Voice assistant UI → API routes: posts questions
frontend/js/voice.js - HTTP server startup → JDBC connection pool: creates
backend/src/main/java/com/stockmate/Main.java - HTTP server startup → API routes: routes HTTP
backend/src/main/java/com/stockmate/Main.java - API routes → Sessions and sign-in: checks sessions
backend/src/main/java/com/stockmate/Api.java - API routes → Role permissions: checks roles
backend/src/main/java/com/stockmate/Api.java - API routes → Assistant service: answers questions
backend/src/main/java/com/stockmate/Api.java - API routes → Database interface: queries
backend/src/main/java/com/stockmate/Api.java - HTTP server startup → Database interface: initializes
backend/src/main/java/com/stockmate/Main.java - JDBC connection pool → PostgreSQL tables: executes SQL
README.md - Business functions → PostgreSQL tables: enforce business rules
README.md - Assistant service → Database interface: reads business data
backend/src/main/java/com/stockmate/Assistant.java - Assistant service → OpenJarvis: optionally queries
backend/src/main/java/com/stockmate/Assistant.java - API routes → PDF documents: serves PDFs
backend/src/main/java/com/stockmate/Api.java - PDF documents → PDF renderer: renders documents
backend/src/main/java/com/stockmate/Documents.java - API routes → JSON parsing: parses requests
backend/src/main/java/com/stockmate/Api.java - Sessions and sign-in → JSON parsing: parses login data
backend/src/main/java/com/stockmate/Auth.java