How cache-jujan/brick-x-brick_ap5 works
Brick x Brick is a construction-management platform for small contractors, with web and mobile clients and an Express API. The main workflow spans project setup, milestones and tasks, field progress updates, structured work or material tickets, and receipt-based expense submission, review, and reporting; blockchain verification supports financial accountability. The graph includes modules and controller-to-service calls evidenced by sampled source. OCR, fraud checks, offline sync, and some storage wiring are README capabilities, but their implementations were not sampled.
Main entry points: app.js Express API · expenses Expense controls · blockchain Blockchain audit · db.js PostgreSQL database
Components 18
User clients
- Web dashboard
web/src/App.jsx - Mobile client
mobile/services/api.js
API and identity
- Express API
backend/src/app.js - Authentication
backend/src/modules/auth - User management
backend/src/modules/users
Project operations
- Projects
backend/src/modules/projects - Milestones
backend/src/modules/milestones - Tasks
backend/src/modules/tasks - Task updates
backend/src/modules/task-updates - Project tickets
backend/src/modules/tickets - Material requests
backend/src/modules/material-requests
Financial controls
- Expense controls
backend/src/modules/expenses - Financial reports
backend/src/modules/reports - Blockchain audit
backend/src/modules/blockchain - Audit logs
backend/src/modules/audit-log - PostgreSQL database
backend/src/config/db.js
Other components
- Contractor staff
- Private blockchain
Connections 19
- Contractor staff → Web dashboard: uses
- Contractor staff → Mobile client: uses
- Web dashboard → Express API: HTTP API
- Mobile client → Express API: HTTP API
- Express API → Authentication: mounts routes
- Express API → User management: mounts routes
- Express API → Projects: mounts routes
- Express API → Milestones: mounts routes
- Express API → Tasks: mounts routes
- Express API → Task updates: mounts routes
- Express API → Project tickets: mounts routes
- Express API → Expense controls: mounts routes
- Express API → Financial reports: mounts routes
- Express API → Blockchain audit: mounts routes
- Projects → PostgreSQL database: persists project data
- Expense controls → PostgreSQL database: stores expense data
- Financial reports → PostgreSQL database: reads financial data
- Blockchain audit → Private blockchain: verifies hashes
- Expense controls → Blockchain audit: approved expense audit