How socialgouv/domifa works
DomiFa is a monorepo platform for organizations managing domiciliation and for people without stable housing accessing related services. The principal workflow is organization staff authentication, followed by API operations to create and manage a domiciled person’s record; the API persists domain data and can manage associated documents. Separate Angular portals serve domiciled users, administrators, and statistics users. The tree and README establish the broader product shape; sampled excerpts show selected authentication, record-management, and file-storage relationships, not every subsystem’s wiring.
Main entry points: entities PostgreSQL data · app Resident portal · usagers.controller.ts Resident API · auth Authentication API
Components 19
User portals
- Organization interface
packages/frontend/src/app - Resident portal
packages/portail-usagers/src/app - Admin portal
packages/portail-admins/src/app - Statistics portal
packages/portail-stats/src/app
Backend API
- Authentication API
packages/backend/src/auth - Resident API
packages/backend/src/usagers/controllers/usagers.controller.ts - Admin API
packages/backend/src/modules/portail-admin
Domiciliation domain
- Organization records
packages/backend/src/database/services/structure - User accounts
packages/backend/src/database/services/user-structure - Resident records
packages/backend/src/database/services/usager - Resident interactions
packages/backend/src/modules/interactions - Document handling
packages/backend/src/modules/structures/controllers/structure-doc.controller.ts
Data and services
- PostgreSQL data
packages/backend/src/database/entities - Encrypted file service
packages/backend/src/util/file-manager/file-manager.service.ts - SMS messaging
packages/backend/src/database/services/message-sms
Shared contracts
- Shared models
packages/common/src
Other components
- Organization staff
- Domiciled person
- Administrator
Connections 26
- Organization staff → Organization interface: uses
README.md - Domiciled person → Resident portal: uses
README.md - Administrator → Admin portal: uses
README.md - Administrator → Statistics portal: uses
README.md - Organization interface → Authentication API: authenticates via
- Resident portal → Authentication API: authenticates via
packages/portail-usagers/src/app/modules/usager-auth/services/usager-auth.service.ts - Admin portal → Admin API: authenticates via
packages/portail-admins/src/app/modules/admin-auth/services/admin-auth.service.ts - Statistics portal → Admin API: authenticates via
packages/portail-stats/src/app/modules/auth/services/portail-stats-auth.service.ts - Organization interface → Shared models: uses contracts
README.md - Resident portal → Shared models: uses contracts
packages/portail-usagers/src/app/modules/usager-auth/services/usager-auth.service.ts - Admin portal → Shared models: uses contracts
packages/portail-admins/src/app/modules/admin-auth/services/admin-auth.service.ts - Statistics portal → Shared models: uses contracts
packages/portail-stats/src/app/modules/auth/services/portail-stats-auth.service.ts - Organization staff → Resident API: manages records
- Resident portal → Resident interactions: records interactions
- Authentication API → User accounts: checks credentials
packages/backend/src/auth/structures-auth.controller.ts - Authentication API → PostgreSQL data: blacklists tokens
packages/backend/src/auth/structures-auth.controller.ts - Resident API → Resident records: updates records
packages/backend/src/usagers/controllers/usagers.controller.ts - Resident API → Encrypted file service: manages documents
packages/backend/src/usagers/controllers/usagers.controller.ts - Resident API → PostgreSQL data: deletes SMS records
packages/backend/src/usagers/controllers/usagers.controller.ts - Document handling → Encrypted file service: serves documents
- Encrypted file service → PostgreSQL data: stores metadata
- Admin API → Organization records: manages organizations
- Admin API → User accounts: manages accounts
- Resident records → PostgreSQL data: persists records
- Organization records → PostgreSQL data: persists records
- User accounts → PostgreSQL data: persists accounts