iscatel_student_list 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/.yardopts +11 -0
- data/README.md +24 -0
- data/diagrams/controller.md +102 -0
- data/diagrams/domain.md +89 -0
- data/diagrams/model.md +83 -0
- data/diagrams/sequence_create.md +57 -0
- data/diagrams/sequence_delete.md +49 -0
- data/diagrams/sequence_init.md +57 -0
- data/diagrams/sequence_read.md +53 -0
- data/diagrams/sequence_update.md +57 -0
- data/diagrams/structure.md +44 -0
- data/diagrams/view.md +123 -0
- data/exe/student_list +5 -0
- data/lib/student_list/controller/student_list_controller.rb +326 -0
- data/lib/student_list/domain/ValidAttrAccessor.rb +21 -0
- data/lib/student_list/domain/basic_student.rb +69 -0
- data/lib/student_list/domain/student.rb +191 -0
- data/lib/student_list/domain/student_short.rb +42 -0
- data/lib/student_list/model/data_list.rb +109 -0
- data/lib/student_list/model/data_list_student_short.rb +58 -0
- data/lib/student_list/model/data_table.rb +32 -0
- data/lib/student_list/model/student_list.rb +138 -0
- data/lib/student_list/view/student_list_view.rb +595 -0
- data/lib/student_list.rb +23 -0
- data/sql/PostgreSQL/init +24 -0
- data/sql/PostgreSQL/insertion +51 -0
- metadata +107 -0
checksums.yaml
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
---
|
|
2
|
+
SHA256:
|
|
3
|
+
metadata.gz: b044da7b0e6fea6356ad3f5a5e8047538800527d1edd128c0599b21aa2ebe255
|
|
4
|
+
data.tar.gz: a5620454162aea99e40a9e127f5ce95d532c458f1c81120e9fea0f6e49fa04f6
|
|
5
|
+
SHA512:
|
|
6
|
+
metadata.gz: 40adbe399573ace42feeab8b97cd95d88b66f5e9f469179e0d38155ec145d25fd33649862294dad1c4842f988f67212e2a6234c79112f2aa1e041eb00129c70d
|
|
7
|
+
data.tar.gz: 0d2d39fcb9db0570b97511da7a27f5e14bf30bafb65e82a630c48560d6e2993a4ebf362eb2da0b2712c107c16d77f680a8dfe1183bfa6eb9e25337cf53a5b130
|
data/.yardopts
ADDED
data/README.md
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# StudentList
|
|
2
|
+
|
|
3
|
+
Настольное GUI-приложение на Ruby для управления списком студентов с хранением данных в PostgreSQL. Приложение построено по архитектурному паттерну **MVC** с применением паттернов **Observer** (обновление таблицы при изменении модели) и **Template Method** (`DataList` / `ModalWindow` / `ModalWindowController`).
|
|
4
|
+
|
|
5
|
+
## Структура проекта
|
|
6
|
+
|
|
7
|
+
* `domain/` — сущности предметной области (`BasicStudent`, `Student`, `StudentShort`) и модуль валидации атрибутов (`ValidAttrAccessor`).
|
|
8
|
+
* `model/` — табличные структуры (`DataTable`, `DataList`, `DataListStudentShort`) и слой доступа к PostgreSQL (`StudentList`).
|
|
9
|
+
* `controller/` — контроллер главного окна (`StudentListInitialController`), контроллеры модальных диалогов (`ModalWindowController`) и двухуровневое логирование (`ControllerLogger`).
|
|
10
|
+
* `view/` — графический интерфейс на библиотеке FXRuby (`StudentListView` и модальные окна `ReadWindow`, `DeleteWindow`, `InsertUpdateWindow`).
|
|
11
|
+
* `sql/PostgreSQL/` — SQL-скрипты инициализации схемы (`init`) и наполнения тестовыми данными (`insertion`).
|
|
12
|
+
* `diagrams/` — UML-диаграммы классов и последовательностей (Sequence) в формате Mermaid.
|
|
13
|
+
|
|
14
|
+
## Требования
|
|
15
|
+
|
|
16
|
+
* Ruby >= 3.1
|
|
17
|
+
* PostgreSQL >= 14
|
|
18
|
+
* Библиотека FOX Toolkit 1.6 и гемы `fox16`, `pg`
|
|
19
|
+
|
|
20
|
+
## Установка и подготовка БД
|
|
21
|
+
|
|
22
|
+
1. Установите зависимости:
|
|
23
|
+
```bash
|
|
24
|
+
gem install fox16 pg yard
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
```mermaid
|
|
2
|
+
classDiagram
|
|
3
|
+
direction LR
|
|
4
|
+
|
|
5
|
+
namespace External_View {
|
|
6
|
+
class StudentListView {
|
|
7
|
+
<<View>>
|
|
8
|
+
}
|
|
9
|
+
class InsertUpdateWindow {
|
|
10
|
+
<<View>>
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
namespace Controller {
|
|
15
|
+
|
|
16
|
+
class ControllerLogger {
|
|
17
|
+
<<module>>
|
|
18
|
+
+ LOG_DIR : String$
|
|
19
|
+
+ ERROR_LOG_PATH : String$
|
|
20
|
+
+ DB_LOG_PATH : String$
|
|
21
|
+
+ error_logger()$ Logger
|
|
22
|
+
+ db_logger()$ Logger
|
|
23
|
+
+ create_logger(path : String, level : Integer)$ Logger
|
|
24
|
+
- log_error(message : String, exception : Exception)
|
|
25
|
+
- log_db(operation : String, details : String)
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
class ModalWindowController {
|
|
29
|
+
- student_list : StudentList
|
|
30
|
+
+ validate_data(field_name : Symbol, field_data : String) Boolean
|
|
31
|
+
+ get_window_data()*
|
|
32
|
+
+ refresh_data(_student_data)*
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
class ModalInsertWindowController {
|
|
36
|
+
+ get_window_data() Hash
|
|
37
|
+
+ refresh_data(student_data : Hash)
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
class ModalUpdateWindowController {
|
|
41
|
+
- student_id : Integer
|
|
42
|
+
+ get_window_data() Hash
|
|
43
|
+
+ refresh_data(student_data : Hash)
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
class StudentListInitialController {
|
|
47
|
+
- view : StudentListView
|
|
48
|
+
- current_page : Integer
|
|
49
|
+
- rows_on_page_count : Integer
|
|
50
|
+
- model : DataListStudentShort
|
|
51
|
+
- student_list : StudentList
|
|
52
|
+
+ current_page() Integer
|
|
53
|
+
+ rows_on_page_count() Integer
|
|
54
|
+
+ initialize_insert_controller() ModalInsertWindowController
|
|
55
|
+
+ initialize_update_controller() ModalUpdateWindowController
|
|
56
|
+
+ get_rows_on_page_count() Integer
|
|
57
|
+
+ set_rows_on_page_count(rows_on_page_count : Integer)
|
|
58
|
+
+ next_page()
|
|
59
|
+
+ previous_page()
|
|
60
|
+
+ get_pages_count() Integer
|
|
61
|
+
+ refresh_selected_rows(selected_rows : Integer[])
|
|
62
|
+
+ delete_students()
|
|
63
|
+
+ refresh_data()
|
|
64
|
+
- valid_page()
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
namespace External_Model {
|
|
69
|
+
class DataListStudentShort {
|
|
70
|
+
<<Model>>
|
|
71
|
+
}
|
|
72
|
+
class StudentList {
|
|
73
|
+
<<Model>>
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
namespace External_Domain {
|
|
78
|
+
class Student {
|
|
79
|
+
<<Domain>>
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
ModalWindowController ..> ControllerLogger : подключает
|
|
84
|
+
StudentListInitialController ..> ControllerLogger : подключает
|
|
85
|
+
|
|
86
|
+
ModalInsertWindowController --|> ModalWindowController
|
|
87
|
+
ModalUpdateWindowController --|> ModalWindowController
|
|
88
|
+
|
|
89
|
+
StudentListView o-- StudentListInitialController : информирует
|
|
90
|
+
StudentListInitialController o-- StudentListView : информирует
|
|
91
|
+
InsertUpdateWindow o-- ModalWindowController : информирует
|
|
92
|
+
|
|
93
|
+
StudentListInitialController ..> ModalInsertWindowController : создаёт
|
|
94
|
+
StudentListInitialController ..> ModalUpdateWindowController : создаёт
|
|
95
|
+
StudentListInitialController *-- DataListStudentShort : управляет
|
|
96
|
+
StudentListInitialController *-- StudentList : управляет
|
|
97
|
+
|
|
98
|
+
ModalWindowController o-- StudentList : использует
|
|
99
|
+
ModalWindowController ..> Student : валидирует
|
|
100
|
+
ModalInsertWindowController ..> Student : создаёт
|
|
101
|
+
ModalUpdateWindowController ..> Student : создаёт
|
|
102
|
+
```
|
data/diagrams/domain.md
ADDED
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
```mermaid
|
|
2
|
+
classDiagram
|
|
3
|
+
direction LR
|
|
4
|
+
|
|
5
|
+
namespace Domain {
|
|
6
|
+
class ValidAttrAccessor {
|
|
7
|
+
<<module>>
|
|
8
|
+
+ attr_accessor(*fields)$
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
class BasicStudent {
|
|
12
|
+
- id : Integer
|
|
13
|
+
- git : String
|
|
14
|
+
+ id() Integer
|
|
15
|
+
+ git() String
|
|
16
|
+
+ contact()* String
|
|
17
|
+
+ last_name_initials()* String
|
|
18
|
+
+ has_git?() Boolean
|
|
19
|
+
+ has_contact?() Boolean
|
|
20
|
+
+ to_s()* String
|
|
21
|
+
+ short_info() String
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
class Student {
|
|
25
|
+
- first_name : String
|
|
26
|
+
- last_name : String
|
|
27
|
+
- patronymic : String
|
|
28
|
+
- phone : String
|
|
29
|
+
- telegram : String
|
|
30
|
+
- email : String
|
|
31
|
+
- valid?(value : String, regex: Regexp, null_value: Boolean = false)$ Boolean
|
|
32
|
+
+ valid_name?(name : String, null_value: Boolean = false)$ Boolean
|
|
33
|
+
- valid_first_name?(first_name : String)$ Boolean
|
|
34
|
+
- valid_last_name?(last_name : String)$ Boolean
|
|
35
|
+
- valid_patronymic?(patronymic : String)$ Boolean
|
|
36
|
+
+ valid_telegram?(telegram : String)$ Boolean
|
|
37
|
+
+ valid_email?(email : String)$ Boolean
|
|
38
|
+
+ valid_phone?(phone : String)$ Boolean
|
|
39
|
+
+ valid_git?(git : String)$ Boolean
|
|
40
|
+
+ from_hash(student : Hash)$ Student
|
|
41
|
+
+ first_name() String
|
|
42
|
+
+ first_name=(first_name : String)
|
|
43
|
+
+ last_name() String
|
|
44
|
+
+ last_name=(last_name : String)
|
|
45
|
+
+ patronymic() String
|
|
46
|
+
+ patronymic=(patronymic : String)
|
|
47
|
+
+ git=(git : String)
|
|
48
|
+
+ contact() String
|
|
49
|
+
+ contact=(contacts : Hash)
|
|
50
|
+
+ <=>(other : Student) Integer
|
|
51
|
+
+ last_name_initials() String
|
|
52
|
+
+ to_s() String
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
class StudentShort {
|
|
56
|
+
- last_name_initials : String
|
|
57
|
+
- contact : String
|
|
58
|
+
+ last_name_initials() String
|
|
59
|
+
+ contact() String
|
|
60
|
+
+ from_student(student : Student)$ StudentShort
|
|
61
|
+
+ to_s() String
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
namespace External_Model {
|
|
66
|
+
class StudentList {
|
|
67
|
+
<<Model>>
|
|
68
|
+
}
|
|
69
|
+
class DataListStudentShort {
|
|
70
|
+
<<Model>>
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
namespace External_Controller {
|
|
75
|
+
class ModalWindowController {
|
|
76
|
+
<<Controller>>
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
Student --|> BasicStudent
|
|
81
|
+
StudentShort --|> BasicStudent
|
|
82
|
+
Student ..> ValidAttrAccessor : подключает
|
|
83
|
+
StudentShort ..> Student : использует
|
|
84
|
+
|
|
85
|
+
StudentList ..> Student : создаёт
|
|
86
|
+
StudentList ..> StudentShort : создаёт
|
|
87
|
+
DataListStudentShort o-- StudentShort : содержит
|
|
88
|
+
ModalWindowController ..> Student : валидирует / создаёт
|
|
89
|
+
```
|
data/diagrams/model.md
ADDED
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
```mermaid
|
|
2
|
+
classDiagram
|
|
3
|
+
direction LR
|
|
4
|
+
|
|
5
|
+
namespace Model {
|
|
6
|
+
class DataTable {
|
|
7
|
+
- table : Array
|
|
8
|
+
+ element(row : Integer, column : Integer)
|
|
9
|
+
+ rows() Integer
|
|
10
|
+
+ columns() Integer
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
class DataList {
|
|
14
|
+
- list : Array
|
|
15
|
+
- selected : Array
|
|
16
|
+
+ list=(list : Array)
|
|
17
|
+
+ select(number : Integer)
|
|
18
|
+
+ get_selected() Integer[]
|
|
19
|
+
+ get_names() String[]
|
|
20
|
+
+ get_data() DataTable
|
|
21
|
+
+ clear_selected()
|
|
22
|
+
- valid_list?(list : Array) Boolean
|
|
23
|
+
- valid_class_names_list?(list : Array)* Boolean
|
|
24
|
+
- get_class_names()* String[]
|
|
25
|
+
- get_object_data(object)* Array
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
class DataListStudentShort {
|
|
29
|
+
- observers : Array
|
|
30
|
+
+ observe(view : StudentListView)
|
|
31
|
+
+ notify()
|
|
32
|
+
- valid_class_names_list?(list : Array) Boolean
|
|
33
|
+
- get_class_names() String[]
|
|
34
|
+
- get_object_data(student : StudentShort) Array
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
class StudentList {
|
|
38
|
+
- conn : Connection
|
|
39
|
+
- next_id : Integer
|
|
40
|
+
+ get_size() Integer
|
|
41
|
+
+ get_next_id() Integer
|
|
42
|
+
+ get_student_by_id(id : Integer) Student
|
|
43
|
+
+ get_k_n_student_short_list(k : Integer, n : Integer) StudentShort[]
|
|
44
|
+
+ create_student(student : Student)
|
|
45
|
+
+ update_student_by_id(student : Student)
|
|
46
|
+
+ delete_student_by_id(id : Integer)
|
|
47
|
+
- execute_query(query : String)
|
|
48
|
+
- execute_params_query(query : String, params : Array)
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
namespace External_Domain {
|
|
53
|
+
class Student
|
|
54
|
+
class StudentShort
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
namespace External_View {
|
|
58
|
+
class StudentListView {
|
|
59
|
+
<<View>>
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
namespace External_Controller {
|
|
64
|
+
class StudentListInitialController {
|
|
65
|
+
<<Controller>>
|
|
66
|
+
}
|
|
67
|
+
class ModalWindowController {
|
|
68
|
+
<<Controller>>
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
DataListStudentShort --|> DataList
|
|
73
|
+
DataList ..> DataTable : создаёт
|
|
74
|
+
|
|
75
|
+
DataListStudentShort o-- StudentShort : содержит
|
|
76
|
+
StudentList ..> Student : создаёт
|
|
77
|
+
StudentList ..> StudentShort : создаёт
|
|
78
|
+
|
|
79
|
+
StudentListInitialController *-- DataListStudentShort : управляет
|
|
80
|
+
StudentListInitialController *-- StudentList : управляет
|
|
81
|
+
ModalWindowController o-- StudentList : использует
|
|
82
|
+
DataListStudentShort ..> StudentListView : уведомляет
|
|
83
|
+
```
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
```mermaid
|
|
2
|
+
sequenceDiagram
|
|
3
|
+
participant view as view : StudentListView
|
|
4
|
+
participant controller as controller : StudentListInitialController
|
|
5
|
+
participant student_list as student_list : StudentList
|
|
6
|
+
participant PG as PG : Module
|
|
7
|
+
|
|
8
|
+
view->>controller: initialize_insert_controller()
|
|
9
|
+
|
|
10
|
+
create participant insert_controller as insert_controller : ModalInsertWindowController
|
|
11
|
+
controller->>+insert_controller: ModalInsertWindowController.new(student_list)
|
|
12
|
+
insert_controller-->>controller: insert_controller
|
|
13
|
+
|
|
14
|
+
create participant insert_window as insert_window : InsertUpdateWindow
|
|
15
|
+
view->>+insert_window: InsertUpdateWindow.new(app, parent, title_text, width, height, insert_controller)
|
|
16
|
+
|
|
17
|
+
insert_window->>insert_controller: get_window_data()
|
|
18
|
+
insert_controller-->>insert_window: window_data
|
|
19
|
+
insert_window->>insert_controller: validate_data(field_name, field_data)
|
|
20
|
+
insert_controller-->>insert_window: field_validation
|
|
21
|
+
|
|
22
|
+
insert_window->>insert_controller: refresh_data(inputs)
|
|
23
|
+
insert_controller->>Student: Student.from_hash(inputs)
|
|
24
|
+
Student-->>insert_controller: student
|
|
25
|
+
insert_controller->>student_list: insert_student(student)
|
|
26
|
+
student_list->>PG: exec_params(query, params)
|
|
27
|
+
PG-->>student_list: nil
|
|
28
|
+
student_list-->>insert_controller: nil
|
|
29
|
+
insert_controller-->>insert_window: nil
|
|
30
|
+
destroy insert_window
|
|
31
|
+
insert_window-->>view: nil
|
|
32
|
+
|
|
33
|
+
view->>controller: refresh_data()
|
|
34
|
+
controller->>model: get_list(current_page, rows_on_page_count)
|
|
35
|
+
model->>student_list: get_k_n_student_short_list(page, rows_on_page_count)
|
|
36
|
+
student_list->>PG: exec_params(query, params)
|
|
37
|
+
PG-->>student_list: result
|
|
38
|
+
participant Student as Student : Class
|
|
39
|
+
participant StudentShort as StudentShort : Class
|
|
40
|
+
student_list->>Student: Student.from_hash(result)
|
|
41
|
+
Student-->>student_list: student
|
|
42
|
+
student_list->>StudentShort: StudentShort.from_student(student)
|
|
43
|
+
StudentShort-->>student_list: student
|
|
44
|
+
student_list-->>model: list
|
|
45
|
+
model-->>controller: nil
|
|
46
|
+
controller->>model: notify()
|
|
47
|
+
model->>student_list: get_size()
|
|
48
|
+
student_list-->>model: whole_entities_count
|
|
49
|
+
model->>view: set_table_params(column_names, whole_entities_count, page_entities_count)
|
|
50
|
+
view-->>model: nil
|
|
51
|
+
model->>view: set_table_data(data_table)
|
|
52
|
+
view-->>model: nil
|
|
53
|
+
model-->>controller: nil
|
|
54
|
+
controller->>view: update_table(current_page, pages_count)
|
|
55
|
+
view-->>controller: nil
|
|
56
|
+
controller-->>view: nil
|
|
57
|
+
```
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
```mermaid
|
|
2
|
+
sequenceDiagram
|
|
3
|
+
participant view as view : StudentListView
|
|
4
|
+
|
|
5
|
+
create participant delete_window as delete_window : DeleteWindow
|
|
6
|
+
view->>+delete_window: DeleteWindow.new(app, parent, title_text, width, height, controller)
|
|
7
|
+
|
|
8
|
+
participant controller as controller : StudentListInitialController
|
|
9
|
+
delete_window->>controller: delete_students()
|
|
10
|
+
|
|
11
|
+
participant model as model : DataListStudentShort
|
|
12
|
+
controller->>model: get_selected()
|
|
13
|
+
model->>controller: selected_ids
|
|
14
|
+
|
|
15
|
+
participant student_list as student_list : StudentList
|
|
16
|
+
participant PG as PG : Module
|
|
17
|
+
|
|
18
|
+
controller->>student_list: delete_student_by_id(id)
|
|
19
|
+
student_list->>PG: exec_params(query, params)
|
|
20
|
+
PG-->>student_list: result
|
|
21
|
+
student_list-->>controller: nil
|
|
22
|
+
controller-->>delete_window: nil
|
|
23
|
+
delete_window->>controller: refresh_data()
|
|
24
|
+
controller->>model: get_list(current_page, rows_on_page_count)
|
|
25
|
+
model->>student_list: get_k_n_student_short_list(page, rows_on_page_count)
|
|
26
|
+
student_list->>PG: exec_params(query, params)
|
|
27
|
+
PG-->>student_list: result
|
|
28
|
+
participant Student as Student : Class
|
|
29
|
+
participant StudentShort as StudentShort : Class
|
|
30
|
+
student_list->>Student: Student.from_hash(result)
|
|
31
|
+
Student-->>student_list: student
|
|
32
|
+
student_list->>StudentShort: StudentShort.from_student(student)
|
|
33
|
+
StudentShort-->>student_list: student
|
|
34
|
+
student_list-->>model: list
|
|
35
|
+
model-->>controller: nil
|
|
36
|
+
controller->>model: notify()
|
|
37
|
+
model->>student_list: get_size()
|
|
38
|
+
student_list-->>model: whole_entities_count
|
|
39
|
+
model->>view: set_table_params(column_names, whole_entities_count, page_entities_count)
|
|
40
|
+
view-->>model: nil
|
|
41
|
+
model->>view: set_table_data(data_table)
|
|
42
|
+
view-->>model: nil
|
|
43
|
+
model-->>controller: nil
|
|
44
|
+
controller->>view: update_table(current_page, pages_count)
|
|
45
|
+
view-->>controller: nil
|
|
46
|
+
controller-->>delete_window: nil
|
|
47
|
+
destroy delete_window
|
|
48
|
+
delete_window-->>view: nil
|
|
49
|
+
```
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
```mermaid
|
|
2
|
+
sequenceDiagram
|
|
3
|
+
participant script as script : Object
|
|
4
|
+
|
|
5
|
+
create participant app as app : FXApp
|
|
6
|
+
script->>+app: FXApp.new()
|
|
7
|
+
|
|
8
|
+
create participant view as view : StudentListView
|
|
9
|
+
app->>+view: StudentListView.new(app)
|
|
10
|
+
|
|
11
|
+
create participant controller as controller : StudentListInitialController
|
|
12
|
+
view->>+controller: StudentListInitialController.new(view)
|
|
13
|
+
|
|
14
|
+
create participant model as model : DataListStudentShort
|
|
15
|
+
controller->>+model: DataListStudentShort.new([])
|
|
16
|
+
controller->>model: observe(view)
|
|
17
|
+
|
|
18
|
+
participant PG as PG : Module
|
|
19
|
+
create participant student_list as student_list : StudentList
|
|
20
|
+
model->>+student_list: StudentList.new()
|
|
21
|
+
student_list->>+PG: connect(dbname, user, password, host, port)
|
|
22
|
+
PG-->>student_list: conn
|
|
23
|
+
student_list-->>model: student_list
|
|
24
|
+
model-->>controller: model
|
|
25
|
+
controller-->>view: controller
|
|
26
|
+
view-->>app: nil
|
|
27
|
+
|
|
28
|
+
participant Student as Student : Class
|
|
29
|
+
participant StudentShort as StudentShort : Class
|
|
30
|
+
app->>view: create()
|
|
31
|
+
view->>controller: refresh_data()
|
|
32
|
+
controller->>model: get_list(current_page, rows_on_page_count)
|
|
33
|
+
model->>student_list: get_k_n_student_short_list(page, rows_on_page_count)
|
|
34
|
+
student_list->>PG: exec_params(query, params)
|
|
35
|
+
PG-->>student_list: result
|
|
36
|
+
student_list->>Student: Student.from_hash(result)
|
|
37
|
+
Student-->>student_list: student
|
|
38
|
+
student_list->>StudentShort: StudentShort.from_student(student)
|
|
39
|
+
StudentShort-->>student_list: student
|
|
40
|
+
student_list-->>model: list
|
|
41
|
+
model-->>controller: nil
|
|
42
|
+
controller->>model: notify()
|
|
43
|
+
model->>student_list: get_size()
|
|
44
|
+
student_list-->>model: whole_entities_count
|
|
45
|
+
model->>view: set_table_params(column_names, whole_entities_count, page_entities_count)
|
|
46
|
+
view-->>model: nil
|
|
47
|
+
model->>view: set_table_data(data_table)
|
|
48
|
+
view-->>model: nil
|
|
49
|
+
model-->>controller: nil
|
|
50
|
+
controller->>view: update_table(current_page, pages_count)
|
|
51
|
+
view-->>controller: nil
|
|
52
|
+
controller-->>view: nil
|
|
53
|
+
view-->>app: nil
|
|
54
|
+
app->>view: run()
|
|
55
|
+
view-->>app: nil
|
|
56
|
+
app-->>script: nil
|
|
57
|
+
```
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
```mermaid
|
|
2
|
+
sequenceDiagram
|
|
3
|
+
participant view as view : StudentListView
|
|
4
|
+
|
|
5
|
+
create participant read_window as read_window : ReadWindow
|
|
6
|
+
view->>+read_window: ReadWindow.new(app, parent, title_text, width, height, controller)
|
|
7
|
+
|
|
8
|
+
participant controller as controller : StudentListInitialController
|
|
9
|
+
read_window->>controller: get_rows_on_page_count()
|
|
10
|
+
controller-->>read_window: rows_on_page_count
|
|
11
|
+
|
|
12
|
+
read_window->>controller: set_rows_on_page_count(rows_on_page_count)
|
|
13
|
+
controller-->>read_window: nil
|
|
14
|
+
|
|
15
|
+
read_window->>controller: refresh_data()
|
|
16
|
+
|
|
17
|
+
participant student_list as student_list : StudentList
|
|
18
|
+
participant PG as PG : Module
|
|
19
|
+
controller->>student_list: get_k_n_student_short_list(current_page, rows_on_page_count)
|
|
20
|
+
student_list->>PG: exec_params(query, params)
|
|
21
|
+
PG-->>student_list: result
|
|
22
|
+
|
|
23
|
+
participant Student as Student : Class
|
|
24
|
+
participant StudentShort as StudentShort : Class
|
|
25
|
+
student_list->>Student: Student.from_hash(row)
|
|
26
|
+
Student-->>student_list: student
|
|
27
|
+
student_list->>StudentShort: StudentShort.from_student(student)
|
|
28
|
+
StudentShort-->>student_list: student_short
|
|
29
|
+
student_list-->>controller: list
|
|
30
|
+
|
|
31
|
+
participant model as model : DataListStudentShort
|
|
32
|
+
controller->>model: list=(list)
|
|
33
|
+
model-->>controller: nil
|
|
34
|
+
|
|
35
|
+
controller->>model: notify()
|
|
36
|
+
model->>view: set_table_params(column_names, page_entities_count)
|
|
37
|
+
view-->>model: nil
|
|
38
|
+
model->>view: set_table_data(data_table)
|
|
39
|
+
view-->>model: nil
|
|
40
|
+
model-->>controller: nil
|
|
41
|
+
|
|
42
|
+
controller->>student_list: get_size()
|
|
43
|
+
student_list->>PG: exec(query)
|
|
44
|
+
PG-->>student_list: result
|
|
45
|
+
student_list-->>controller: size
|
|
46
|
+
|
|
47
|
+
controller->>view: update_table(current_page, pages_count)
|
|
48
|
+
view-->>controller: nil
|
|
49
|
+
controller-->>read_window: nil
|
|
50
|
+
|
|
51
|
+
destroy read_window
|
|
52
|
+
read_window-->>view: nil
|
|
53
|
+
```
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
```mermaid
|
|
2
|
+
sequenceDiagram
|
|
3
|
+
participant view as view : StudentListView
|
|
4
|
+
participant controller as controller : StudentListInitialController
|
|
5
|
+
participant student_list as student_list : StudentList
|
|
6
|
+
participant PG as PG : Module
|
|
7
|
+
|
|
8
|
+
view->>controller: initialize_update_controller()
|
|
9
|
+
|
|
10
|
+
create participant update_controller as update_controller : ModalUpdateWindowController
|
|
11
|
+
controller->>+update_controller: ModalUpdateWindowController.new(student_list, id)
|
|
12
|
+
update_controller-->>controller: update_controller
|
|
13
|
+
|
|
14
|
+
create participant update_window as update_window : InsertUpdateWindow
|
|
15
|
+
view->>+update_window: InsertUpdateWindow.new(app, parent, title_text, width, height, update_controller)
|
|
16
|
+
|
|
17
|
+
update_window->>update_controller: get_window_data()
|
|
18
|
+
update_controller-->>update_window: window_data
|
|
19
|
+
update_window->>update_controller: validate_data(field_name, field_data)
|
|
20
|
+
update_controller-->>update_window: field_validation
|
|
21
|
+
|
|
22
|
+
update_window->>update_controller: refresh_data(inputs)
|
|
23
|
+
update_controller->>Student: Student.from_hash(inputs)
|
|
24
|
+
Student-->>update_controller: student
|
|
25
|
+
update_controller->>student_list: update_student_by_id(student)
|
|
26
|
+
student_list->>PG: exec_params(query, params)
|
|
27
|
+
PG-->>student_list: nil
|
|
28
|
+
student_list-->>update_controller: nil
|
|
29
|
+
update_controller-->>update_window: nil
|
|
30
|
+
destroy update_window
|
|
31
|
+
update_window-->>view: nil
|
|
32
|
+
|
|
33
|
+
view->>controller: refresh_data()
|
|
34
|
+
controller->>model: get_list(current_page, rows_on_page_count)
|
|
35
|
+
model->>student_list: get_k_n_student_short_list(page, rows_on_page_count)
|
|
36
|
+
student_list->>PG: exec_params(query, params)
|
|
37
|
+
PG-->>student_list: result
|
|
38
|
+
participant Student as Student : Class
|
|
39
|
+
participant StudentShort as StudentShort : Class
|
|
40
|
+
student_list->>Student: Student.from_hash(result)
|
|
41
|
+
Student-->>student_list: student
|
|
42
|
+
student_list->>StudentShort: StudentShort.from_student(student)
|
|
43
|
+
StudentShort-->>student_list: student
|
|
44
|
+
student_list-->>model: list
|
|
45
|
+
model-->>controller: nil
|
|
46
|
+
controller->>model: notify()
|
|
47
|
+
model->>student_list: get_size()
|
|
48
|
+
student_list-->>model: whole_entities_count
|
|
49
|
+
model->>view: set_table_params(column_names, whole_entities_count, page_entities_count)
|
|
50
|
+
view-->>model: nil
|
|
51
|
+
model->>view: set_table_data(data_table)
|
|
52
|
+
view-->>model: nil
|
|
53
|
+
model-->>controller: nil
|
|
54
|
+
controller->>view: update_table(current_page, pages_count)
|
|
55
|
+
view-->>controller: nil
|
|
56
|
+
controller-->>view: nil
|
|
57
|
+
```
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
```mermaid
|
|
2
|
+
classDiagram
|
|
3
|
+
direction LR
|
|
4
|
+
|
|
5
|
+
namespace View_Layer {
|
|
6
|
+
class StudentListView
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
namespace Controller_Layer {
|
|
10
|
+
class ControllerLogger {
|
|
11
|
+
<<module>>
|
|
12
|
+
}
|
|
13
|
+
class StudentListInitialController
|
|
14
|
+
class ModalWindowController
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
namespace Model_Layer {
|
|
18
|
+
class DataListStudentShort
|
|
19
|
+
class StudentList
|
|
20
|
+
class DataTable
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
namespace Domain_Layer {
|
|
24
|
+
class Student
|
|
25
|
+
class StudentShort
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
StudentListView <--> StudentListInitialController : информирует
|
|
29
|
+
StudentListView <--> ModalWindowController : информирует
|
|
30
|
+
StudentListInitialController ..> ControllerLogger : подключает
|
|
31
|
+
ModalWindowController ..> ControllerLogger : подключает
|
|
32
|
+
StudentListInitialController ..> ModalWindowController : создаёт
|
|
33
|
+
StudentListInitialController *-- DataListStudentShort : управляет
|
|
34
|
+
StudentListInitialController *-- StudentList : управляет
|
|
35
|
+
ModalWindowController o-- StudentList : использует
|
|
36
|
+
|
|
37
|
+
StudentList ..> Student : создаёт
|
|
38
|
+
StudentList ..> StudentShort : создаёт
|
|
39
|
+
ModalWindowController ..> Student : валидирует / создаёт
|
|
40
|
+
DataListStudentShort o-- StudentShort : содержит
|
|
41
|
+
DataListStudentShort ..> DataTable : использует
|
|
42
|
+
|
|
43
|
+
DataListStudentShort --> StudentListView : уведомляет
|
|
44
|
+
```
|