How ilyesbelahsen/btp-project works
This is a construction-project operations suite: mobile workers record and submit time against assigned jobs, while web staff manage projects, workers, costs, billing, payroll, and reporting. The NestJS API exposes role-protected domain operations backed by Prisma; sampled controllers show the time-entry and administration routes delegating to services. Web/mobile-to-API links are shown as unverified because the excerpts do not establish their HTTP wiring. The README is empty, so capability coverage is based on the repository tree and sampled source.
Main entry points: page.tsx Staff web app · prisma.service.ts Prisma data access · pointage.tsx Worker mobile app · pointage.service.ts Time entry and review
Components 19
Web and mobile clients
- Worker mobile app
apps/mobile/app/(tabs)/pointage.tsx - Staff web app
apps/web/src/app/(dashboard)/dashboard/page.tsx - Mobile sign-in
apps/mobile/src/services/auth.service.ts - Web sign-in
apps/web/src/features/auth/services/auth.service.ts
Identity and access
- Authentication API
apps/api/src/modules/auth/auth.service.ts - Worker accounts
apps/api/src/modules/users/users.service.ts - Token blacklist
apps/api/src/modules/redis/redis.service.ts
Project operations
- Construction sites
apps/api/src/modules/chantier/chantier.service.ts - Site task plans
apps/api/src/modules/tache-chantier/tache-chantier.controller.ts - Time entry and review
apps/api/src/modules/pointage/pointage.service.ts
Finance and insight
- Site expenses
apps/api/src/modules/depense/depense.controller.ts - Situations and invoicing
apps/api/src/modules/facturation/facturation.controller.ts - Payroll and allowances
apps/api/src/modules/paie/paie.controller.ts - Reporting
apps/api/src/modules/rapport/rapport.service.ts - Zone premiums
apps/api/src/modules/zone/zone.service.ts
API and persistence
- Prisma data access
apps/api/src/modules/prisma/prisma.service.ts - Application database
Other components
- Worker
- Company staff
Connections 25
- Worker → Worker mobile app: records time
- Company staff → Staff web app: manages operations
- Worker mobile app → Mobile sign-in: signs in
- Staff web app → Web sign-in: signs in
- Worker mobile app → Time entry and review: submits entries
- Worker mobile app → Construction sites: views assigned sites
- Staff web app → Construction sites: manages sites
- Staff web app → Site task plans: manages tasks
- Staff web app → Site expenses: reviews expenses
- Staff web app → Situations and invoicing: manages billing
- Staff web app → Payroll and allowances: previews payroll
- Staff web app → Reporting: views reports
- Authentication API → Worker accounts: looks up users
apps/api/src/modules/auth/auth.service.ts - Authentication API → Token blacklist: blacklists tokens
apps/api/src/modules/auth/auth.service.ts - Construction sites → Prisma data access: queries data
apps/api/src/modules/chantier/chantier.service.ts - Worker accounts → Prisma data access: queries data
apps/api/src/modules/users/users.service.ts - Time entry and review → Prisma data access: persists entries
- Site expenses → Prisma data access: persists expenses
- Situations and invoicing → Prisma data access: persists billing
- Payroll and allowances → Prisma data access: reads payroll data
- Reporting → Prisma data access: reads aggregates
- Zone premiums → Prisma data access: persists premiums
- Prisma data access → Application database: reads and writes
- Time entry and review → Construction sites: checks site assignment
- Payroll and allowances → Time entry and review: uses approved time