# yurkovskiy/dtapi architecture

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

- Interactive diagram: https://gitdiagram.com/yurkovskiy/dtapi
- Repository: https://github.com/yurkovskiy/dtapi

## Overview

d-tester is a Kohana-based JSON API for academic records, user administration, and student quizzes. The main workflow is a student starting an eligible test, receiving question/answer data, submitting answers for checking, and accessing results; administrators maintain users and academic/test data through CRUD APIs. The graph also shows shared entity access and question-type checking. Several controller/model implementations are unsampled, so documented endpoints establish API capabilities, while uncertain internal links are omitted or dashed.

Main entry points: [`application/classes/Model/Log.php`](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Model/Log.php) (Test eligibility), [`application/classes/Model/Student.php`](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Model/Student.php) (Student records), [`application/config/database.php`](https://github.com/yurkovskiy/dtapi/blob/master/application/config/database.php) (MySQL database), [`application/classes/Controller/Student.php`](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Student.php) (Student API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API controllers"]
  node_admin["Admin CRUD<br/>[BaseAdmin.php]"]
  node_student["Student API<br/>[Student.php]"]
  node_entity["Entity lookup<br/>[EntityManager.php]"]
end

subgraph group_quiz["Quiz runtime"]
  node_logapi["Test start API<br/>[Log.php]"]
  node_logmodel["Test eligibility<br/>[Log.php]"]
  node_player["Test player API<br/>[TestPlayer.php]"]
  node_answercheck["Answer checking<br/>[SAnswer.php]"]
  node_questiontypes["Question types"]
end

subgraph group_domain["Academic data"]
  node_questionapi["Question API<br/>[Question.php]"]
  node_answerapi["Answer API<br/>[Answer.php]"]
  node_resultapi["Results API<br/>[Result.php]"]
  node_academicapi["Academic APIs<br/>[Group.php]"]
  node_timetableapi["Timetable API<br/>[TimeTable.php]"]
end

subgraph group_identity["Identity and access"]
  node_authapi["Login API<br/>[Login.php]"]
  node_adminuser["Admin user API<br/>[AdminUser.php]"]
  node_usermodel["User accounts<br/>[User.php]"]
end

subgraph group_persistence["Persistence"]
  node_commonmodel["Entity operations<br/>[Common.php]"]
  node_studentmodel["Student records<br/>[Student.php]"]
  node_database[("MySQL database<br/>[database.php]")]
end

node_client(("API client"))

node_client -->|"manages records"| node_admin
node_client -->|"manages students"| node_student
node_client -->|"authenticates"| node_authapi
node_client -->|"manages admins"| node_adminuser
node_client -->|"fetches entities"| node_entity
node_client -->|"starts test"| node_logapi
node_client -->|"plays test"| node_player
node_client -->|"fetches questions"| node_questionapi
node_client -->|"fetches answers"| node_answerapi
node_client -->|"checks answers"| node_answercheck
node_client -->|"reads results"| node_resultapi
node_client -->|"reads academic data"| node_academicapi
node_client -->|"reads schedules"| node_timetableapi
node_adminuser -->|"uses accounts"| node_usermodel
node_student -->|"registers students"| node_studentmodel
node_studentmodel -->|"creates account"| node_usermodel
node_entity -->|"loads entity model"| node_commonmodel
node_commonmodel -->|"queries records"| node_database
node_logapi -.->|"starts eligibility check"| node_logmodel
node_logmodel -->|"writes test log"| node_database
node_logmodel -->|"reads student"| node_studentmodel
node_answercheck -.->|"checks type"| node_questiontypes
node_questiontypes -->|"reads answers"| node_database

click node_admin "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/BaseAdmin.php"
click node_student "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Student.php"
click node_entity "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/EntityManager.php"
click node_authapi "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Login.php"
click node_adminuser "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/AdminUser.php"
click node_usermodel "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Model/User.php"
click node_logapi "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Log.php"
click node_logmodel "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Model/Log.php"
click node_player "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/TestPlayer.php"
click node_answercheck "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/SAnswer.php"
click node_questiontypes "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/NumericalQuestion.php"
click node_questionapi "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Question.php"
click node_answerapi "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Answer.php"
click node_resultapi "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Result.php"
click node_academicapi "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Group.php"
click node_timetableapi "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/TimeTable.php"
click node_commonmodel "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Model/Common.php"
click node_studentmodel "https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Model/Student.php"
click node_database "https://github.com/yurkovskiy/dtapi/blob/master/application/config/database.php"

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_admin,node_student,node_entity,node_client toneBlue
class node_logapi,node_logmodel,node_player,node_answercheck,node_questiontypes toneAmber
class node_questionapi,node_answerapi,node_resultapi,node_academicapi,node_timetableapi toneMint
class node_authapi,node_adminuser,node_usermodel toneRose
class node_commonmodel,node_studentmodel,node_database toneIndigo
```

## Components

### API controllers

- [Admin CRUD](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/BaseAdmin.php): `application/classes/Controller/BaseAdmin.php`
- [Student API](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Student.php): `application/classes/Controller/Student.php`
- [Entity lookup](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/EntityManager.php): `application/classes/Controller/EntityManager.php`

### Quiz runtime

- [Test start API](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Log.php): `application/classes/Controller/Log.php`
- [Test eligibility](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Model/Log.php): `application/classes/Model/Log.php`
- [Test player API](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/TestPlayer.php): `application/classes/Controller/TestPlayer.php`
- [Answer checking](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/SAnswer.php): `application/classes/Controller/SAnswer.php`
- [Question types](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/NumericalQuestion.php): `application/classes/NumericalQuestion.php`

### Academic data

- [Question API](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Question.php): `application/classes/Controller/Question.php`
- [Answer API](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Answer.php): `application/classes/Controller/Answer.php`
- [Results API](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Result.php): `application/classes/Controller/Result.php`
- [Academic APIs](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Group.php): `application/classes/Controller/Group.php`
- [Timetable API](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/TimeTable.php): `application/classes/Controller/TimeTable.php`

### Identity and access

- [Login API](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/Login.php): `application/classes/Controller/Login.php`
- [Admin user API](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Controller/AdminUser.php): `application/classes/Controller/AdminUser.php`
- [User accounts](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Model/User.php): `application/classes/Model/User.php`

### Persistence

- [Entity operations](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Model/Common.php): `application/classes/Model/Common.php`
- [Student records](https://github.com/yurkovskiy/dtapi/blob/master/application/classes/Model/Student.php): `application/classes/Model/Student.php`
- [MySQL database](https://github.com/yurkovskiy/dtapi/blob/master/application/config/database.php): `application/config/database.php`

### Other components

- **API client**

## Connections

- API client → Admin CRUD: manages records
- API client → Student API: manages students
- API client → Login API: authenticates
- API client → Admin user API: manages admins
- API client → Entity lookup: fetches entities
- API client → Test start API: starts test
- API client → Test player API: plays test
- API client → Question API: fetches questions
- API client → Answer API: fetches answers
- API client → Answer checking: checks answers
- API client → Results API: reads results
- API client → Academic APIs: reads academic data
- API client → Timetable API: reads schedules
- Admin user API → User accounts: uses accounts (evidence: `application/classes/Controller/AdminUser.php`)
- Student API → Student records: registers students (evidence: `application/classes/Controller/Student.php`)
- Student records → User accounts: creates account (evidence: `application/classes/Model/Student.php`)
- Entity lookup → Entity operations: loads entity model (evidence: `application/classes/Controller/EntityManager.php`)
- Entity operations → MySQL database: queries records (evidence: `application/classes/Model/Common.php`)
- Test start API → Test eligibility: starts eligibility check
- Test eligibility → MySQL database: writes test log (evidence: `application/classes/Model/Log.php`)
- Test eligibility → Student records: reads student (evidence: `application/classes/Model/Log.php`)
- Answer checking → Question types: checks type
- Question types → MySQL database: reads answers (evidence: `application/classes/NumericalQuestion.php`)
