How shaheem-codes/lost-and-found-dbms- works
This is a lost-and-found management frontend backed by an Express API and PostgreSQL. The main workflow is a user browsing or editing records in the UI: app.js uses the API wrapper for CRUD, the server dispatches API requests to entity handlers, and handlers query the database. The dashboard refreshes records into statistics, charts, announcements, and notifications. README documents all 16 entity areas. The tree places handlers at its root, while server.js requires them under ./routes; that mismatch limits confidence in the dispatch links. Frontend config and several named modules were not sampled.
Main entry points: server.js Express server · db.js Postgres pool · app.js UI and dashboard · api.js Fetch wrapper
Components 23
Frontend
- UI and dashboard
app.js - Fetch wrapper
api.js - Dashboard charts
charts.js
API service
- Express server
server.js - Postgres pool
db.js
Record domains
- Items
items.js - Lost reports
lost_reports.js - Found reports
found_reports.js - Claims
claims.js - Users
users.js - Roles
roles.js - Departments
departments.js - Categories
categories.js - Locations
locations.js - Item status
status.js - Item conditions
item_condition.js - Admins
admins.js - Audit logs
audit_logs.js
Engagement
- Notifications
notifications.js - Announcements
announcements.js - Feedback
feedback.js
Other components
- User
- PostgreSQL
Connections 28
- User → UI and dashboard: uses
- UI and dashboard → Fetch wrapper: requests CRUD
- Fetch wrapper → Express server: HTTP requests
- Express server → Items: mounts items*
- Express server → Lost reports: mounts reports*
- Express server → Found reports: mounts reports*
- Express server → Claims: mounts claims*
- Express server → Users: mounts users*
- Express server → Roles: mounts roles*
- Express server → Departments: mounts departments*
- Express server → Categories: mounts categories*
- Express server → Locations: mounts locations*
- Express server → Item status: mounts status*
- Express server → Item conditions: mounts conditions*
- Express server → Admins: mounts admins*
- Express server → Audit logs: mounts audit*
- Express server → Notifications: mounts notifications*
- Express server → Announcements: mounts announcements*
- Express server → Feedback: mounts feedback*
- Items → Postgres pool: queries
- Found reports → Postgres pool: queries
- Users → Postgres pool: queries
- Admins → Postgres pool: queries
- Audit logs → Postgres pool: queries
- Announcements → Postgres pool: queries
- Feedback → Postgres pool: queries
- Postgres pool → PostgreSQL: reads/writes
- UI and dashboard → Dashboard charts: renders dashboard