How abarghoud/pps-easy works
PPS Easy lets a guest or signed-in user submit event and personal details, then simulates the PPS journey to obtain a certificate; the README says the data is transferred to PPS and the result is emailed. The client also supports authentication, contact, and informational pages. The API’s PPS orchestration and journey-step implementation are represented from the tree and module wiring; their internal calls were not sampled, so those links are not asserted. Firebase and local-mode choices are visible in the client composition root.
Main entry points: app.tsx Client composition and routes · generate.controller.ts PPS API · pps-api.ts PPS API adapter · event-form-service.ts Event form service
Components 19
Client experience
- Client composition and routes
apps/client/src/app/app.tsx - Certificate form
apps/client/src/app/components/form/EventFormPage.tsx - Event form service
apps/client/src/app/service/event-form-service.ts - Certificate API client
apps/client/src/app/api/pps-certificate-api-service.ts - Login and guest access
apps/client/src/app/components/form/LoginFormPage.tsx
Identity and data
- Authentication state
apps/client/src/app/hooks/useAuth.ts - Authentication service
apps/client/src/app/service/firebase-authentication-service.ts - Firebase services
apps/client/src/app/config/firebase.ts - Personal info repository
libs/user/data-access/src/lib/user-personal-info-firebase-repository.ts
API and validation
- PPS API
apps/api/src/app/generate.controller.ts - Generation reCAPTCHA guard
apps/api/src/app/guards/recaptcha.guard.ts - reCAPTCHA check endpoint
apps/api/src/app/recpatcha/recaptcha.controller.ts - reCAPTCHA providers
libs/recaptcha/google/src/lib/google-recaptcha-checker.ts
PPS journey
- PPS generation use case
apps/api/src/app/pps/usecase/pps-generator-usecase.service.ts - PPS API adapter
apps/api/src/app/pps/third-party/pps-api.ts - PPS journey steps
apps/api/src/app/pps/third-party/journey-steps
Other components
- Visitor
- PPS service
- Email result
Connections 20
- Visitor → Client composition and routes: uses
apps/client/src/app/app.tsx - Client composition and routes → Certificate form: routes to
apps/client/src/app/app.tsx - Client composition and routes → Login and guest access: routes to
apps/client/src/app/app.tsx - Client composition and routes → Authentication state: uses
apps/client/src/app/app.tsx - Client composition and routes → Event form service: configures
apps/client/src/app/app.tsx - Client composition and routes → Certificate API client: configures
apps/client/src/app/app.tsx - Certificate form → Event form service: submits form
- Event form service → Certificate API client: requests certificate
- Client composition and routes → Authentication service: configures
apps/client/src/app/app.tsx - Authentication state → Authentication service: calls
apps/client/src/app/hooks/useAuth.ts - Authentication service → Firebase services: initializes auth
apps/client/src/app/service/firebase-authentication-service.ts - Client composition and routes → Personal info repository: configures
apps/client/src/app/app.tsx - Certificate API client → PPS API: submits profile
README.md - PPS API → Generation reCAPTCHA guard: guards request
apps/api/src/app/generate.controller.ts - reCAPTCHA check endpoint → reCAPTCHA providers: checks token
- PPS API → PPS generation use case: dispatches generation
apps/api/src/app/generate.controller.ts - PPS generation use case → PPS API adapter: runs journey
apps/api/src/app/pps/usecase/pps-generator-usecase.service.ts - PPS API adapter → PPS journey steps: executes steps
- PPS API adapter → PPS service: transfers data
README.md - PPS service → Email result: sends result
README.md