How adit244496/asset_management works
IT Asset Engine is a shared, authenticated asset-register application: users sign in, enter or import records, and submitted records pass through verification before becoming visible in inventory, dashboards, history and reports. The React client calls a Flask API, which enforces permissions and owns PostgreSQL reads and writes. Separate product branches support administration, master data, audit activity, live updates and an AI assistant. Some routes and pages are documented but unsampled, so their internal links are shown only where the README or source index establishes them.
Main entry points: AssetsContext.jsx Register state · main.py Flask application · crud.py Register operations · api.js API client
Components 26
Web application
- App routing
frontend/src/App.jsx - Session state
frontend/src/context/AuthContext.jsx - Register state
frontend/src/context/AssetsContext.jsx - API client
frontend/src/api.js - Data entry
frontend/src/pages/DataEntryPage.jsx - Verification queue
frontend/src/pages/VerificationPage.jsx - Inventory and reports
frontend/src/pages/ReportPage.jsx - Dashboard
frontend/src/pages/DashboardPage.jsx - History views
frontend/src/pages/HistoryPage.jsx
API and access
- Flask application
backend/app/main.py - Authentication routes
backend/app/api/auth.py - Asset routes
backend/app/api/assets.py
Register lifecycle
- Register operations
backend/app/crud.py - Approval workflow
backend/app/approvals.py - Register data model
backend/app/models.py - PostgreSQL store
backend/app/database.py
Insights and assistance
- Assistant panel
frontend/src/components/AssistantPanel.jsx - Assistant endpoint
backend/app/api/assistant.py - Assistant engine
backend/app/assistant/engine.py - Assistant tools
backend/app/assistant/tools.py
Administration
- Activity audit
backend/app/activity.py - Activity screen
frontend/src/pages/ActivityLogPage.jsx - Master data
frontend/src/pages/MasterDataPage.jsx - Master routes
backend/app/api/masters.py - Live updates
backend/app/live.py
Other components
- Staff user
Connections 34
- Staff user → App routing: uses
- App routing → Session state: provides session
frontend/src/App.jsx - App routing → Register state: provides register state
frontend/src/App.jsx - Session state → API client: requests session
frontend/src/context/AuthContext.jsx - Register state → API client: fetches and mutates
frontend/src/context/AssetsContext.jsx - Data entry → Register state: submits records
- Register state → Asset routes: calls API
frontend/src/context/AssetsContext.jsx - API client → Flask application: sends API requests
- Flask application → Authentication routes: registers routes
backend/app/main.py - Flask application → Asset routes: registers routes
backend/app/main.py - Authentication routes → Register operations: loads user
backend/app/api/auth.py - Asset routes → Register operations: operates on records
backend/app/api/assets.py - Asset routes → Approval workflow: handles approvals
backend/app/api/assets.py - Register operations → Register data model: queries register models
backend/app/crud.py - Register operations → PostgreSQL store: reads and writes
- Approval workflow → PostgreSQL store: persists decisions
backend/app/approvals.py - Verification queue → API client: decides records
- Approval workflow → Register operations: uses register operations
backend/app/approvals.py - Register state → Inventory and reports: supplies register data
frontend/src/pages/ReportPage.jsx - Register state → Dashboard: supplies register data
- Register state → History views: supplies register data
- Inventory and reports → API client: exports and edits
frontend/src/pages/ReportPage.jsx - Assistant panel → Assistant endpoint: asks questions
- Flask application → Assistant endpoint: registers routes
backend/app/main.py - Assistant endpoint → Assistant engine: runs turns
backend/app/api/assistant.py - Assistant engine → Assistant tools: dispatches tools
backend/app/assistant/engine.py - Assistant tools → Register operations: queries register
backend/app/assistant/tools.py - Activity screen → API client: loads audit feed
- Flask application → Activity audit: records requests
backend/app/main.py - Master data → API client: manages master data
- Flask application → Master routes: registers routes
backend/app/main.py - Master routes → Register operations: updates master data
- Register state → Live updates: subscribes to updates
frontend/src/context/AssetsContext.jsx - Flask application → Live updates: initializes live service
backend/app/main.py