# 1024pix/pix architecture

> Architecture diagram of the GitHub repository 1024pix/pix, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1024pix/pix
- Repository: https://github.com/1024pix/pix

## Overview

Pix is an online platform for assessing and certifying digital skills. A learner-facing portal is the natural starting point for assessment; the API is the central backend, with certification and evaluation as distinct domain stages. Separate portals support organizations, certification centers, and administrators. The tree also shows training, campaigns, and skill-profile management. The README establishes the product purpose, while the server excerpt shows backend route registration; frontend-to-API and several domain interactions are not demonstrated in the sampled source, so those links are marked unverified.

Main entry points: [`api/server.js`](https://github.com/1024pix/pix/blob/dev/api/server.js) (HTTP API), [`orga/app`](https://github.com/1024pix/pix/tree/dev/orga/app) (Organization portal), [`admin/app`](https://github.com/1024pix/pix/tree/dev/admin/app) (Administration portal), [`mon-pix/app`](https://github.com/1024pix/pix/tree/dev/mon-pix/app) (Learner portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portals["User portals"]
  node_learner["Learner portal"]
  node_organization["Organization portal"]
  node_certif["Center portal"]
  node_admin["Administration portal"]
  node_junior["Junior portal"]
end

subgraph group_backend["API platform"]
  node_api["HTTP API<br/>[server.js]"]
  node_identity["Identity access<br/>[routes.js]"]
end

subgraph group_assessment["Learning and assessment"]
  node_evaluation["Skill evaluation"]
  node_development["Learning development"]
  node_learner_mgmt["Learner management"]
end

subgraph group_operations["Certification operations"]
  node_certification["Certification"]
  node_organization_mgmt["Organization management"]
  node_training["Training programs"]
  node_campaigns["Campaign participation"]
end

subgraph group_shared["Shared infrastructure"]
  node_data[("Database connections")]
end

node_learner_user(("Learner"))
node_org_user(("Organization staff"))
node_center_user(("Certification staff"))
node_admin_user(("Platform administrator"))
node_certification_result["Certification result"]

node_learner_user -.->|"uses"| node_learner
node_learner -.->|"requests services"| node_api
node_org_user -.->|"uses"| node_organization
node_organization -.->|"requests services"| node_api
node_center_user -.->|"uses"| node_certif
node_certif -.->|"requests services"| node_api
node_admin_user -.->|"uses"| node_admin
node_admin -.->|"requests services"| node_api
node_api -->|"registers routes"| node_identity
node_api -->|"registers routes"| node_evaluation
node_api -->|"registers routes"| node_certification
node_learner -.->|"assesses skills"| node_evaluation
node_evaluation -.->|"supports certification"| node_certification
node_organization -.->|"manages organizations"| node_organization_mgmt
node_organization -.->|"manages learners"| node_learner_mgmt
node_admin -.->|"manages training"| node_training
node_admin -.->|"manages campaigns"| node_campaigns
node_certification -.->|"produces results"| node_certification_result
node_api -.->|"uses connections"| node_data

click node_learner "https://github.com/1024pix/pix/tree/dev/mon-pix/app"
click node_organization "https://github.com/1024pix/pix/tree/dev/orga/app"
click node_certif "https://github.com/1024pix/pix/tree/dev/certif/app"
click node_admin "https://github.com/1024pix/pix/tree/dev/admin/app"
click node_junior "https://github.com/1024pix/pix/tree/dev/junior/app"
click node_api "https://github.com/1024pix/pix/blob/dev/api/server.js"
click node_identity "https://github.com/1024pix/pix/blob/dev/api/src/identity-access-management/application/routes.js"
click node_evaluation "https://github.com/1024pix/pix/tree/dev/api/src/evaluation"
click node_development "https://github.com/1024pix/pix/tree/dev/api/src/devcomp"
click node_learner_mgmt "https://github.com/1024pix/pix/tree/dev/api/src/prescription/learner-management"
click node_certification "https://github.com/1024pix/pix/tree/dev/api/src/certification"
click node_organization_mgmt "https://github.com/1024pix/pix/tree/dev/api/src/organizational-entities"
click node_campaigns "https://github.com/1024pix/pix/tree/dev/api/src/prescription/campaign-participation"
click node_data "https://github.com/1024pix/pix/blob/dev/api/db/database-connection.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_learner,node_organization,node_certif,node_admin,node_junior toneBlue
class node_api,node_identity toneAmber
class node_evaluation,node_development,node_learner_mgmt toneMint
class node_certification,node_organization_mgmt,node_training,node_campaigns toneRose
class node_data,node_learner_user,node_org_user,node_center_user,node_admin_user,node_certification_result toneIndigo
```

## Components

### User portals

- [Learner portal](https://github.com/1024pix/pix/tree/dev/mon-pix/app): `mon-pix/app`
- [Organization portal](https://github.com/1024pix/pix/tree/dev/orga/app): `orga/app`
- [Center portal](https://github.com/1024pix/pix/tree/dev/certif/app): `certif/app`
- [Administration portal](https://github.com/1024pix/pix/tree/dev/admin/app): `admin/app`
- [Junior portal](https://github.com/1024pix/pix/tree/dev/junior/app): `junior/app`

### API platform

- [HTTP API](https://github.com/1024pix/pix/blob/dev/api/server.js): `api/server.js`
- [Identity access](https://github.com/1024pix/pix/blob/dev/api/src/identity-access-management/application/routes.js): `api/src/identity-access-management/application/routes.js`

### Learning and assessment

- [Skill evaluation](https://github.com/1024pix/pix/tree/dev/api/src/evaluation): `api/src/evaluation`
- [Learning development](https://github.com/1024pix/pix/tree/dev/api/src/devcomp): `api/src/devcomp`
- [Learner management](https://github.com/1024pix/pix/tree/dev/api/src/prescription/learner-management): `api/src/prescription/learner-management`

### Certification operations

- [Certification](https://github.com/1024pix/pix/tree/dev/api/src/certification): `api/src/certification`
- [Organization management](https://github.com/1024pix/pix/tree/dev/api/src/organizational-entities): `api/src/organizational-entities`
- **Training programs**
- [Campaign participation](https://github.com/1024pix/pix/tree/dev/api/src/prescription/campaign-participation): `api/src/prescription/campaign-participation`

### Shared infrastructure

- [Database connections](https://github.com/1024pix/pix/blob/dev/api/db/database-connection.js): `api/db/database-connection.js`

### Other components

- **Learner**
- **Organization staff**
- **Certification staff**
- **Platform administrator**
- **Certification result**

## Connections

- Learner → Learner portal: uses
- Learner portal → HTTP API: requests services
- Organization staff → Organization portal: uses
- Organization portal → HTTP API: requests services
- Certification staff → Center portal: uses
- Center portal → HTTP API: requests services
- Platform administrator → Administration portal: uses
- Administration portal → HTTP API: requests services
- HTTP API → Identity access: registers routes (evidence: `api/server.js`)
- HTTP API → Skill evaluation: registers routes (evidence: `api/server.js`)
- HTTP API → Certification: registers routes (evidence: `api/server.js`)
- Learner portal → Skill evaluation: assesses skills
- Skill evaluation → Certification: supports certification
- Organization portal → Organization management: manages organizations
- Organization portal → Learner management: manages learners
- Administration portal → Training programs: manages training
- Administration portal → Campaign participation: manages campaigns
- Certification → Certification result: produces results
- HTTP API → Database connections: uses connections
