How yecos/archii works
Archii is a multi-tenant construction project-management platform. Its main user journey runs from signing in and choosing a workspace, through project and field-work screens, to persistent records, dashboards, and reports. The README also describes AI-assisted work, collaboration, integrations, compliance, notifications, offline/PWA support, and a public API/SDK, so these appear as distinct branches. Relationships are limited to README statements and source-index references; unsampled implementation details are not assumed.
Main entry points: HomeContent.tsx App shell · AppContext.tsx Application state · AuthScreen.tsx Sign-in · DashboardScreen.tsx Dashboard and reports
Components 27
App experience
- Sign-in
src/components/layout/AuthScreen.tsx - Workspace selection
src/components/layout/TenantSelectionScreen.tsx - App shell
src/app/HomeContent.tsx - Dashboard and reports
src/screens/DashboardScreen.tsx
Project work
- Project screens
src/screens/ProjectDetailScreen.tsx - Tasks and Kanban
src/screens/TasksScreen.tsx - Field operations
src/screens/WeeklyAgendaScreen.tsx - Inventory
src/hooks/useInventory.tsx - Time tracking
src/hooks/useTimeTracking.tsx
Platform services
- Application state
src/contexts/AppContext.tsx - Entity operations
src/lib/firestore-actions.ts - Firebase client
src/lib/firebase-service.ts - Firebase Admin
src/lib/firebase-admin.ts - API authentication
src/lib/api-auth.ts - API routes
src/app/api - AI assistant and RAG
src/app/api/ai - Compliance and GDPR
src/app/api/compliance/route.ts
Integrations
- External integrations
src/app/api/integrations - OneDrive files
src/app/api/onedrive - Notifications and WhatsApp
src/app/api/notifications - PWA and offline
public/sw.js
Public API and SDK
- Archii SDK
sdk/src/client.ts - Webhook SDK
sdk/src/webhooks.ts
Other components
- User
- Firebase Firestore
- Firebase Auth
- Third-party services
Connections 32
- User → Sign-in: signs in
- Sign-in → Workspace selection: selects workspace
- Workspace selection → App shell: opens app
- App shell → Dashboard and reports: shows screens
- App shell → Project screens: shows screens
- App shell → Tasks and Kanban: shows screens
- App shell → Field operations: shows screens
- App shell → Application state: uses state
- Application state → Firebase client: calls
src/contexts/AppContext.tsx - Application state → Entity operations: calls
src/contexts/AppContext.tsx - Firebase client → Firebase Firestore: reads and writes
- Sign-in → Firebase Auth: authenticates with
- Dashboard and reports → Time tracking: summarizes
- Dashboard and reports → Inventory: summarizes
- Tasks and Kanban → Time tracking: uses tracking
src/screens/TasksScreen.tsx - Inventory → Application state: reads context
src/hooks/useInventory.tsx - Time tracking → Application state: reads context
src/hooks/useTimeTracking.tsx - API routes → API authentication: authenticates requests
src/app/api/admin-data/route.ts - API authentication → Firebase Admin: verifies tokens
src/lib/api-auth.ts - Firebase Admin → Firebase Firestore: accesses
- API routes → Compliance and GDPR: includes
- Compliance and GDPR → API authentication: authenticates requests
src/app/api/compliance/route.ts - Compliance and GDPR → Third-party services: handles GDPR data
- App shell → AI assistant and RAG: offers AI assistant
- AI assistant and RAG → Third-party services: uses Gemini
- App shell → External integrations: offers connectors
- App shell → OneDrive files: browses files
- App shell → Notifications and WhatsApp: shows notifications
- Notifications and WhatsApp → Third-party services: sends messages
- App shell → PWA and offline: supports offline
- Archii SDK → API routes: calls API
- Webhook SDK → Third-party services: handles webhooks