Appearance
Megadex
Megadex is a user management service: the source of truth for who your users are. It holds their profiles, identities and consents, plus the role assignments of each user (the roles themselves are defined in Gatelin). It is the only place that translates an email address into a user ID.
Megadex is an internal user store. Put a Backend for Frontend in front of it as the public API layer. Gatelin is one such BFF, not a requirement.
Full documentation
megadex.fr has the integration guide, the frontend guide and the API reference.
What it is used for
Use Megadex when you need a ready-made user store that the rest of your services can rely on:
- Manage identities, contact information and consents, with an active and archive lifecycle
- Store the roles assigned to each user so a BFF can build sessions from them
- Save each user's grid configuration, merged with locked system templates
- Serve country, civility and gender lists, localized
What it does
| Capability | Details |
|---|---|
| User profiles | Identities, contact information, consents, and an active and archive lifecycle |
| Social links | Social network handles and assigned role IDs aggregated onto the user record |
| Social networks catalog | Supported platforms, with history tracking and soft archiving |
| Table view preferences | Per-user saved grid configurations merged with locked system templates |
| Reference lookups | Localized read-only catalogs for countries, civilities and genders |
| History and audit logs | Database-level change tracking on users, roles, socials and the social catalog, plus a unified audit view |
| Admin UI | Angular front end to manage users, social network catalogs and audit logs |
Where it fits
Megadex never stores credentials and never issues sessions. It is the only place that translates an email address into a numeric user ID. Gatelin searches it at sign-in to find the user and their roles. When Megadex creates a user it asks Foxnox to create the matching password, and if Foxnox fails it soft-archives the new user. See the reference architecture.
Run it
| Image | Registry |
|---|---|
API, including the Admin UI under /megadex | ghcr.io/alten-group/megadex |
| Migration | ghcr.io/alten-group/megadex-migration |