BuildCycle+ BuildCycle+ is a comprehensive construction management platform designed to streamline site operations, enhance productivity, and ensure cost efficiency. It integrates a robust backend built with Node.js, Express, and MongoDB, with a React Native frontend for real-time site monitoring, workforce management, material tracking, and vendor coordination. Leveraging free-tier services like MongoDB Atlas M0, Google Cloud Storage (GCS) 5 GB, Google Maps API, and Render/Vercel hosting, BuildCycle+ achieves a $0 cost model for small to medium construction projects. The platform supports critical construction workflows, including attendance tracking, photo-based inspections with AI-generated punch lists, material forecasting, vendor billing, and safety incident reporting. It is deployed with a backend on Render and a frontend on Vercel, ensuring scalability and accessibility. Overview BuildCycle+ provides a unified solution for construction project management, targeting site managers, contractors, and vendors. The backend (backend/index.js) handles authentication, data storage, and AI-driven analytics, while the frontend (frontend/ submodule) offers an intuitive interface with features like interactive site maps, dashboards, and real-time notifications. Key integrations include:
The project is structured with a root repository (https://github.com/ImGJUser1/BuildCyclePlus.git) and a frontend submodule (https://github.com/ImGJUser1/BuildCyclePlus-Frontend.git). Features Authentication and User Management
Signup and Login: Secure user registration and authentication using JWT tokens (12-hour expiry) and bcrypt password hashing (/api/auth/signup, /api/auth/login). Role-Based Access: Supports user and admin roles, with admin-only access to sensitive routes (e.g., attendance reports).
LiveWork Grid™: Workforce Management
Attendance Tracking: Log worker check-ins and check-outs with geolocation (latitude, longitude), assets, and notes (/api/attendance/checkin, /api/attendance/checkout). Daily Attendance Reports: Admin-only view of today’s attendance with user and site details (/api/attendance/today). Wage Calculation: Computes wages based on hours worked, with lateness penalties for check-ins after 9 AM (/api/wages/calculate). Machinery Usage: Tracks machinery usage with start/end times and rental costs (/api/machinery/usage).
WorkIntel™: Site Progress and Inspection
Photo Upload and Analysis: Upload site photos to GCS, with Gemini AI generating punch lists (e.g., "fix cracks") (/api/photos/upload). Photo Retrieval: Admin-only view of all photos with punch lists (/api/photos). Punch List Management: Mark punch list items as resolved (/api/punch-list/:id). Checklists: Create phase-specific checklists (e.g., foundation: "Pour concrete") (/api/checklists).
DocFusion™: Reporting and Documentation
Weekly Reports: Generate PDF reports of attendance and photos with punch lists for the past week (/api/reports/weekly). Client View: Fetch site-specific photos and attendance logs for client visibility (/api/client-view/:site_id). Bill of Quantities (BOQ): Create PDF BOQs from material data (/api/templates/boq). Audit Documents: Upload and store audit documents in GCS (/api/audit/upload, /api/audit/export).
PulseMesh™: Site and KPI Management
Site Canvas: Retrieve all sites with names, statuses, and coordinates for map rendering (/api/site-canvas). KPI Pulseboard: Aggregate vendor performance metrics (total/paid bills, scores) (/api/kpi-pulseboard).
MatriLedger™: Material Management
Material Logging: Track materials with quantity, unit, vendor, and phase (/api/materials). Material Forecasting: Estimate days left for materials, flagging shortages (<7 days) (/api/materials/forecast).
BudgetCraft™: Delay and Cost Management
Delay Tracking: Log delays with reasons, days, and cost impact (/api/delays). Delay Impact Analysis: Calculate cost and manpower impacts (/api/delays/impact). Dashboard: Display active workers, open punch list items, and material costs (/api/dashboard).
DrawSync™: BOQ Extraction
BOQ Extraction: Upload PDFs to GCS and extract quantities using Gemini AI (/api/boq/extract).
Venderra™: Vendor and Billing Management
Vendor Management: Create and manage vendors with contact info and documents (/api/vendors). Vendor Bills: Log and update bills with status (pending/paid) (/api/vendor-bills, /api/vendor-bills/:id). Vendor Nudge: Send reminders for pending bills due within 24 hours (/api/vendors/nudge). Vendor Portal: Public endpoint for vendors to submit bills (/api/vendor-portal/bills). Notifications: Retrieve billing, inspection, and safety notifications (/api/notifications).
SafeCore™: Safety Management
Safety Incidents: Log incidents with descriptions and PPE issuance (/api/safety/incidents). Safety Scorecard: Calculate user compliance scores based on incidents (/api/safety/scorecard). Emergency Contacts: Manage site-specific emergency contacts (/api/emergency-contacts).
SentinelIQ™: Anomaly Detection and Suggestions
Anomaly Detection: Identify long work hours (>12 hours), overstaffing (>20 workers/site), and duplicate bills (/api/anomalies). Suggestions: Recommend recent vendors and cost-saving material swaps using Gemini AI (/api/suggestions).
Bonus Features
Cross-Site Analysis: Aggregate vendor bill totals by site and vendor (/api/cross-site). Health Check: Verify API status (/api/health).
Advanced Features
AI-Driven Insights: Gemini AI Integration: Generates punch lists from site photos, extracts quantities from BOQ PDFs, and suggests material swaps, enhancing automation and decision-making. Anomaly Detection: Proactively identifies operational issues (e.g., overstaffing, duplicate bills) to optimize resource allocation.
Geolocation Support: Stores site and attendance coordinates, enabling integration with Google Maps API for real-time site mapping and geofencing in the frontend (e.g., vendors.tsx).
Scalable PDF Generation: Uses pdfkit to create dynamic reports (weekly, BOQ) with detailed attendance, photo, and punch list data, suitable for stakeholders and audits.
Vendor Portal: Public endpoint (/api/vendor-portal/bills) allows vendors to submit bills without authentication, streamlining external collaboration.
Cost Efficiency: Leverages free-tier services to maintain a $0 cost model, with budget alerts for Google Maps API to prevent unexpected charges.
Enhancements for Future Development
Weather API Integration: Integrate OpenWeatherMap to append weather data to delay reasons (/api/delays), improving delay tracking accuracy. Example: Add weather conditions (e.g., "rainy") to DelayEvent.reason based on site coordinates.
Real-Time Notifications: Implement push notifications using Firebase or WebSockets for real-time alerts on billing, safety incidents, or anomalies.
Advanced Analytics Dashboard: Enhance /api/dashboard with visualizations (e.g., worker productivity trends, material usage charts) using Chart.js in the frontend.
Mobile App Optimization: Optimize frontend (React Native) for offline support using AsyncStorage or local caching for remote site operations.
Multi-Language Support: Add internationalization (i18n) to the frontend (app/(tabs)/*.tsx) for regional languages (e.g., Hindi, Marathi) to support diverse workers.
Automated Compliance Checks: Expand SentinelIQ to include PPE compliance detection in site photos using Gemini AI’s image analysis.
Blockchain for Vendor Payments: Integrate a blockchain-based payment system for secure, transparent vendor bill settlements.
IoT Integration: Connect IoT devices (e.g., GPS trackers) to /api/attendance/checkin for automated worker tracking and machinery usage logging.
Enhanced Security: Implement rate limiting and input sanitization to prevent abuse of public endpoints (e.g., /api/vendor-portal/bills). Add two-factor authentication (2FA) for admin accounts.
Cross-Platform Desktop Support: Develop a desktop app using Electron to complement the React Native mobile app, improving accessibility for office-based managers.