# mariateodorapopescu/proiect_posd architecture

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

- Interactive diagram: https://gitdiagram.com/mariateodorapopescu/proiect_posd
- Repository: https://github.com/mariateodorapopescu/proiect_posd

## Overview

SecureSync is a demonstration platform for PDF document access controlled by OAuth 2.0/OIDC. The main workflow is browser SSO through Keycloak, followed by authenticated API requests; the API enforces scope, role, and ownership/department rules before serving document operations. A separate Portal capability manages member roles and departments, and a Python experiment measures revocation delay. Some subsystem links reflect README documentation because their implementation was not sampled; these limits are noted by using documented evidence rather than implying source inspection.

Main entry points: [`web/shared/api.ts`](https://github.com/mariateodorapopescu/proiect_posd/blob/main/web/shared/api.ts) (API client), [`api/src/main/java/ro/securesync/api/documents/DocumentService.java`](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/documents/DocumentService.java) (Document operations), [`web/shared/main.tsx`](https://github.com/mariateodorapopescu/proiect_posd/blob/main/web/shared/main.tsx) (Documente and Portal), [`experiment/measure.py`](https://github.com/mariateodorapopescu/proiect_posd/blob/main/experiment/measure.py) (Revocation measurement)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web applications"]
  node_webui["Documente and Portal<br/>[main.tsx]"]
  node_auth["OIDC session<br/>[auth.ts]"]
  node_webapi["API client<br/>[api.ts]"]
  node_webpolicy["Client policies<br/>[policy.mjs]"]
  node_memberui["Members screen<br/>[Members.tsx]"]
end

subgraph group_api["API and authorization"]
  node_security["Token validation"]
  node_claims["Token claims<br/>[TokenClaims.java]"]
  node_actor["Request identity<br/>[Actor.java]"]
  node_docapi["Document endpoints"]
  node_docservice["Document operations"]
  node_policy["Access policy"]
  node_metadata[("Document metadata")]
  node_pdf["Private PDF storage<br/>[PdfStorage.java]"]
  node_response["Document response"]
end

subgraph group_members["Member administration"]
  node_membersapi["Member endpoints"]
  node_memberservice["Member management"]
  node_gateway["Keycloak gateway"]
  node_kcclient["Keycloak client"]
end

subgraph group_experiment["Revocation experiment"]
  node_experiment["Revocation measurement<br/>[measure.py]"]
  node_analysis["Measurement analysis<br/>[analyze.py]"]
end

node_user(("User"))
node_keycloak["Keycloak"]
node_experimenter(("Experiment operator"))
node_database[("PostgreSQL documents<br/>[V1__documents.sql]")]

node_user -->|"uses"| node_webui
node_webui -->|"starts and observes"| node_auth
node_auth -->|"authenticates via OIDC"| node_keycloak
node_webui -->|"requests API"| node_webapi
node_webapi -->|"gets access token"| node_auth
node_webapi -->|"checks session and errors"| node_webpolicy
node_webapi -->|"calls document endpoints"| node_docapi
node_security -->|"validates issued tokens"| node_keycloak
node_security -->|"derives authorities"| node_claims
node_actor -->|"reads claims"| node_claims
node_docapi -->|"delegates operations"| node_docservice
node_docservice -->|"checks access"| node_policy
node_docservice -->|"reads and writes"| node_metadata
node_docservice -->|"stores and retrieves PDFs"| node_pdf
node_docservice -->|"creates response"| node_response
node_metadata -->|"persists metadata"| node_database
node_webui -->|"renders member tab"| node_memberui
node_memberui -->|"lists and updates members"| node_webapi
node_webapi -->|"calls member endpoints"| node_membersapi
node_membersapi -->|"delegates management"| node_memberservice
node_memberservice -->|"requests member operations"| node_gateway
node_kcclient -->|"implements gateway operations"| node_gateway
node_gateway -->|"manages users and roles"| node_keycloak
node_experimenter -->|"runs"| node_experiment
node_experiment -->|"revokes session"| node_keycloak
node_experiment -->|"measures denial"| node_docapi
node_experiment -.->|"analyzes measurements"| node_analysis

click node_webui "https://github.com/mariateodorapopescu/proiect_posd/blob/main/web/shared/main.tsx"
click node_auth "https://github.com/mariateodorapopescu/proiect_posd/blob/main/web/shared/auth.ts"
click node_webapi "https://github.com/mariateodorapopescu/proiect_posd/blob/main/web/shared/api.ts"
click node_webpolicy "https://github.com/mariateodorapopescu/proiect_posd/blob/main/web/shared/policy.mjs"
click node_memberui "https://github.com/mariateodorapopescu/proiect_posd/blob/main/web/shared/Members.tsx"
click node_security "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/security/SecurityConfiguration.java"
click node_claims "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/security/TokenClaims.java"
click node_actor "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/security/Actor.java"
click node_docapi "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/documents/DocumentController.java"
click node_docservice "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/documents/DocumentService.java"
click node_policy "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/documents/DocumentPolicy.java"
click node_metadata "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/documents/DocumentRepository.java"
click node_pdf "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/documents/PdfStorage.java"
click node_response "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/documents/DocumentResponse.java"
click node_membersapi "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/members/MembersController.java"
click node_memberservice "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/members/MemberManagementService.java"
click node_gateway "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/members/KeycloakMembersGateway.java"
click node_kcclient "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/members/KeycloakMembersClient.java"
click node_experiment "https://github.com/mariateodorapopescu/proiect_posd/blob/main/experiment/measure.py"
click node_analysis "https://github.com/mariateodorapopescu/proiect_posd/blob/main/experiment/analyze.py"
click node_database "https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/resources/db/migration/V1__documents.sql"

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_webui,node_auth,node_webapi,node_webpolicy,node_memberui,node_user toneBlue
class node_security,node_claims,node_actor,node_docapi,node_docservice,node_policy,node_metadata,node_pdf,node_response,node_database toneAmber
class node_membersapi,node_memberservice,node_gateway,node_kcclient toneMint
class node_experiment,node_analysis toneRose
class node_keycloak,node_experimenter toneIndigo
```

## Components

### Web applications

- [Documente and Portal](https://github.com/mariateodorapopescu/proiect_posd/blob/main/web/shared/main.tsx): `web/shared/main.tsx`
- [OIDC session](https://github.com/mariateodorapopescu/proiect_posd/blob/main/web/shared/auth.ts): `web/shared/auth.ts`
- [API client](https://github.com/mariateodorapopescu/proiect_posd/blob/main/web/shared/api.ts): `web/shared/api.ts`
- [Client policies](https://github.com/mariateodorapopescu/proiect_posd/blob/main/web/shared/policy.mjs): `web/shared/policy.mjs`
- [Members screen](https://github.com/mariateodorapopescu/proiect_posd/blob/main/web/shared/Members.tsx): `web/shared/Members.tsx`

### API and authorization

- [Token validation](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/security/SecurityConfiguration.java): `api/src/main/java/ro/securesync/api/security/SecurityConfiguration.java`
- [Token claims](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/security/TokenClaims.java): `api/src/main/java/ro/securesync/api/security/TokenClaims.java`
- [Request identity](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/security/Actor.java): `api/src/main/java/ro/securesync/api/security/Actor.java`
- [Document endpoints](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/documents/DocumentController.java): `api/src/main/java/ro/securesync/api/documents/DocumentController.java`
- [Document operations](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/documents/DocumentService.java): `api/src/main/java/ro/securesync/api/documents/DocumentService.java`
- [Access policy](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/documents/DocumentPolicy.java): `api/src/main/java/ro/securesync/api/documents/DocumentPolicy.java`
- [Document metadata](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/documents/DocumentRepository.java): `api/src/main/java/ro/securesync/api/documents/DocumentRepository.java`
- [Private PDF storage](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/documents/PdfStorage.java): `api/src/main/java/ro/securesync/api/documents/PdfStorage.java`
- [Document response](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/documents/DocumentResponse.java): `api/src/main/java/ro/securesync/api/documents/DocumentResponse.java`

### Member administration

- [Member endpoints](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/members/MembersController.java): `api/src/main/java/ro/securesync/api/members/MembersController.java`
- [Member management](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/members/MemberManagementService.java): `api/src/main/java/ro/securesync/api/members/MemberManagementService.java`
- [Keycloak gateway](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/members/KeycloakMembersGateway.java): `api/src/main/java/ro/securesync/api/members/KeycloakMembersGateway.java`
- [Keycloak client](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/java/ro/securesync/api/members/KeycloakMembersClient.java): `api/src/main/java/ro/securesync/api/members/KeycloakMembersClient.java`

### Revocation experiment

- [Revocation measurement](https://github.com/mariateodorapopescu/proiect_posd/blob/main/experiment/measure.py): `experiment/measure.py`
- [Measurement analysis](https://github.com/mariateodorapopescu/proiect_posd/blob/main/experiment/analyze.py): `experiment/analyze.py`

### Other components

- **User**
- **Keycloak**
- **Experiment operator**
- [PostgreSQL documents](https://github.com/mariateodorapopescu/proiect_posd/blob/main/api/src/main/resources/db/migration/V1__documents.sql): `api/src/main/resources/db/migration/V1__documents.sql`

## Connections

- User → Documente and Portal: uses (evidence: `README.md`)
- Documente and Portal → OIDC session: starts and observes (evidence: `web/shared/main.tsx`)
- OIDC session → Keycloak: authenticates via OIDC (evidence: `README.md`)
- Documente and Portal → API client: requests API (evidence: `web/shared/main.tsx`)
- API client → OIDC session: gets access token (evidence: `web/shared/api.ts`)
- API client → Client policies: checks session and errors (evidence: `web/shared/api.ts`)
- API client → Document endpoints: calls document endpoints (evidence: `README.md`)
- Token validation → Keycloak: validates issued tokens (evidence: `README.md`)
- Token validation → Token claims: derives authorities (evidence: `api/src/main/java/ro/securesync/api/security/SecurityConfiguration.java`)
- Request identity → Token claims: reads claims (evidence: `api/src/main/java/ro/securesync/api/security/Actor.java`)
- Document endpoints → Document operations: delegates operations (evidence: `api/src/main/java/ro/securesync/api/documents/DocumentController.java`)
- Document operations → Access policy: checks access (evidence: `api/src/main/java/ro/securesync/api/documents/DocumentService.java`)
- Document operations → Document metadata: reads and writes (evidence: `api/src/main/java/ro/securesync/api/documents/DocumentService.java`)
- Document operations → Private PDF storage: stores and retrieves PDFs (evidence: `api/src/main/java/ro/securesync/api/documents/DocumentService.java`)
- Document operations → Document response: creates response (evidence: `api/src/main/java/ro/securesync/api/documents/DocumentService.java`)
- Document metadata → PostgreSQL documents: persists metadata (evidence: `README.md`)
- Documente and Portal → Members screen: renders member tab (evidence: `web/shared/main.tsx`)
- Members screen → API client: lists and updates members (evidence: `web/shared/Members.tsx`)
- API client → Member endpoints: calls member endpoints (evidence: `README.md`)
- Member endpoints → Member management: delegates management (evidence: `api/src/main/java/ro/securesync/api/members/MembersController.java`)
- Member management → Keycloak gateway: requests member operations (evidence: `api/src/main/java/ro/securesync/api/members/MemberManagementService.java`)
- Keycloak client → Keycloak gateway: implements gateway operations (evidence: `api/src/main/java/ro/securesync/api/members/KeycloakMembersClient.java`)
- Keycloak gateway → Keycloak: manages users and roles (evidence: `README.md`)
- Experiment operator → Revocation measurement: runs (evidence: `README.md`)
- Revocation measurement → Keycloak: revokes session (evidence: `README.md`)
- Revocation measurement → Document endpoints: measures denial (evidence: `README.md`)
- Revocation measurement → Measurement analysis: analyzes measurements
