# bdvvt/test architecture

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

- Interactive diagram: https://gitdiagram.com/bdvvt/test
- Repository: https://github.com/bdvvt/test

## Overview

This appears to be a Spring-based REST backend for user authentication, organization and department administration, role/permission management, and posts, with audit logging and profile uploads. The likely request workflow is an external client calling a controller, which delegates to a domain service and persists data; authentication and authorization apply across requests. The tree also shows mail, cleanup scheduling, and Cloudinary integration. No README or runtime source was provided, so relationships below are dashed and unverified rather than asserted from naming alone.

Main entry points: [`src/main/java/com/example/test/models/services/impl`](https://github.com/bdvvt/test/tree/main/src/main/java/com/example/test/models/services/impl) (Domain services), [`src/main/java/com/example/test/controllers/ProfileController.java`](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/ProfileController.java) (Profile API), [`src/main/java/com/example/test/models/repositories`](https://github.com/bdvvt/test/tree/main/src/main/java/com/example/test/models/repositories) (Data repositories), [`src/main/java/com/example/test/controllers/AuthController.java`](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/AuthController.java) (Authentication API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and security"]
  node_auth_api["Authentication API"]
  node_security["JWT security"]
  node_users_api["User API"]
end

subgraph group_administration["Organization administration"]
  node_org_api["Organization API"]
  node_dept_api["Department API"]
  node_role_api["Role API"]
  node_permission_api["Permission API"]
  node_membership_api["Membership APIs"]
end

subgraph group_content["Profiles and content"]
  node_posts_api["Posts API"]
  node_profile_api["Profile API"]
  node_uploads["Upload service<br/>[UploadService.java]"]
end

subgraph group_platform["Persistence and integrations"]
  node_audit_api["Audit log API<br/>[LogController.java]"]
  node_audit_aspect["Audit aspect"]
  node_services["Domain services"]
  node_repositories["Data repositories"]
  node_entities["Domain entities"]
  node_database[("Relational database")]
  node_mail["Mail service"]
  node_cleanup["User cleanup schedule"]
end

node_client(("API client"))
node_cloudinary["Cloudinary"]
node_mail_provider["Mail provider"]

node_client -.->|"submits credentials"| node_auth_api
node_client -.->|"manages users"| node_users_api
node_client -.->|"manages organizations"| node_org_api
node_client -.->|"manages departments"| node_dept_api
node_client -.->|"manages roles"| node_role_api
node_client -.->|"manages permissions"| node_permission_api
node_client -.->|"manages memberships"| node_membership_api
node_client -.->|"manages posts"| node_posts_api
node_client -.->|"updates profile"| node_profile_api
node_client -.->|"reads audit logs"| node_audit_api
node_security -.->|"protects routes"| node_auth_api
node_auth_api -.->|"delegates authentication"| node_services
node_users_api -.->|"delegates user operations"| node_services
node_org_api -.->|"delegates organization operations"| node_services
node_dept_api -.->|"delegates department operations"| node_services
node_role_api -.->|"delegates role operations"| node_services
node_permission_api -.->|"delegates permission operations"| node_services
node_membership_api -.->|"delegates membership operations"| node_services
node_posts_api -.->|"delegates post operations"| node_services
node_profile_api -.->|"delegates profile operations"| node_services
node_audit_api -.->|"delegates log queries"| node_services
node_services -.->|"uses repositories"| node_repositories
node_repositories -.->|"maps domain data"| node_entities
node_repositories -.->|"persists data"| node_database
node_audit_aspect -.->|"records actions"| node_services
node_profile_api -.->|"handles file uploads"| node_uploads
node_uploads -.->|"stores media"| node_cloudinary
node_services -.->|"requests mail"| node_mail
node_mail -.->|"sends messages"| node_mail_provider
node_cleanup -.->|"cleans user data"| node_services

click node_auth_api "https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/AuthController.java"
click node_security "https://github.com/bdvvt/test/tree/main/src/main/java/com/example/test/security"
click node_users_api "https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/UserController.java"
click node_org_api "https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/OrganizationController.java"
click node_dept_api "https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/DepartmentController.java"
click node_role_api "https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/RoleController.java"
click node_permission_api "https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/PermissionController.java"
click node_membership_api "https://github.com/bdvvt/test/tree/main/src/main/java/com/example/test/controllers"
click node_posts_api "https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/PostController.java"
click node_profile_api "https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/ProfileController.java"
click node_audit_api "https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/LogController.java"
click node_audit_aspect "https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/audit/AuditActionAspect.java"
click node_services "https://github.com/bdvvt/test/tree/main/src/main/java/com/example/test/models/services/impl"
click node_repositories "https://github.com/bdvvt/test/tree/main/src/main/java/com/example/test/models/repositories"
click node_entities "https://github.com/bdvvt/test/tree/main/src/main/java/com/example/test/models/entities"
click node_uploads "https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/models/services/uploads/UploadService.java"
click node_mail "https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/models/services/impl/MailServiceImpl.java"
click node_cleanup "https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/models/services/schedules/UserCleanupSchedule.java"

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_auth_api,node_security,node_users_api,node_client toneBlue
class node_org_api,node_dept_api,node_role_api,node_permission_api,node_membership_api toneAmber
class node_posts_api,node_profile_api,node_uploads toneMint
class node_audit_api,node_audit_aspect,node_services,node_repositories,node_entities,node_database,node_mail,node_cleanup toneRose
class node_cloudinary,node_mail_provider toneIndigo
```

## Components

### Access and security

- [Authentication API](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/AuthController.java): `src/main/java/com/example/test/controllers/AuthController.java`
- [JWT security](https://github.com/bdvvt/test/tree/main/src/main/java/com/example/test/security): `src/main/java/com/example/test/security`
- [User API](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/UserController.java): `src/main/java/com/example/test/controllers/UserController.java`

### Organization administration

- [Organization API](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/OrganizationController.java): `src/main/java/com/example/test/controllers/OrganizationController.java`
- [Department API](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/DepartmentController.java): `src/main/java/com/example/test/controllers/DepartmentController.java`
- [Role API](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/RoleController.java): `src/main/java/com/example/test/controllers/RoleController.java`
- [Permission API](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/PermissionController.java): `src/main/java/com/example/test/controllers/PermissionController.java`
- [Membership APIs](https://github.com/bdvvt/test/tree/main/src/main/java/com/example/test/controllers): `src/main/java/com/example/test/controllers`

### Profiles and content

- [Posts API](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/PostController.java): `src/main/java/com/example/test/controllers/PostController.java`
- [Profile API](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/ProfileController.java): `src/main/java/com/example/test/controllers/ProfileController.java`
- [Upload service](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/models/services/uploads/UploadService.java): `src/main/java/com/example/test/models/services/uploads/UploadService.java`

### Persistence and integrations

- [Audit log API](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/controllers/LogController.java): `src/main/java/com/example/test/controllers/LogController.java`
- [Audit aspect](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/audit/AuditActionAspect.java): `src/main/java/com/example/test/audit/AuditActionAspect.java`
- [Domain services](https://github.com/bdvvt/test/tree/main/src/main/java/com/example/test/models/services/impl): `src/main/java/com/example/test/models/services/impl`
- [Data repositories](https://github.com/bdvvt/test/tree/main/src/main/java/com/example/test/models/repositories): `src/main/java/com/example/test/models/repositories`
- [Domain entities](https://github.com/bdvvt/test/tree/main/src/main/java/com/example/test/models/entities): `src/main/java/com/example/test/models/entities`
- **Relational database**
- [Mail service](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/models/services/impl/MailServiceImpl.java): `src/main/java/com/example/test/models/services/impl/MailServiceImpl.java`
- [User cleanup schedule](https://github.com/bdvvt/test/blob/main/src/main/java/com/example/test/models/services/schedules/UserCleanupSchedule.java): `src/main/java/com/example/test/models/services/schedules/UserCleanupSchedule.java`

### Other components

- **API client**
- **Cloudinary**
- **Mail provider**

## Connections

- API client → Authentication API: submits credentials
- API client → User API: manages users
- API client → Organization API: manages organizations
- API client → Department API: manages departments
- API client → Role API: manages roles
- API client → Permission API: manages permissions
- API client → Membership APIs: manages memberships
- API client → Posts API: manages posts
- API client → Profile API: updates profile
- API client → Audit log API: reads audit logs
- JWT security → Authentication API: protects routes
- Authentication API → Domain services: delegates authentication
- User API → Domain services: delegates user operations
- Organization API → Domain services: delegates organization operations
- Department API → Domain services: delegates department operations
- Role API → Domain services: delegates role operations
- Permission API → Domain services: delegates permission operations
- Membership APIs → Domain services: delegates membership operations
- Posts API → Domain services: delegates post operations
- Profile API → Domain services: delegates profile operations
- Audit log API → Domain services: delegates log queries
- Domain services → Data repositories: uses repositories
- Data repositories → Domain entities: maps domain data
- Data repositories → Relational database: persists data
- Audit aspect → Domain services: records actions
- Profile API → Upload service: handles file uploads
- Upload service → Cloudinary: stores media
- Domain services → Mail service: requests mail
- Mail service → Mail provider: sends messages
- User cleanup schedule → Domain services: cleans user data
