schild.rb 10.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374
  1. require 'schild/version'
  2. require 'sequel'
  3. # erst Ruby 2.1.0 macht include zu einer public-Methode
  4. if Module.private_method_defined? :include
  5. class Module
  6. public :include
  7. end
  8. end
  9. # String und Symbol werden um snake_case ergänzt, das die Schild-Tabellen umbenennt
  10. module CoreExtensions
  11. module String
  12. def snake_case
  13. return downcase if match(/\A[A-Z]+\z/)
  14. gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2').
  15. gsub(/([a-z])([A-Z])/, '\1_\2').
  16. downcase
  17. end
  18. end
  19. module Symbol
  20. def snake_case
  21. to_s.snake_case
  22. end
  23. end
  24. end
  25. # Schild hat teilweise nil in DB-Feldern. SchildTypeSaver gibt entweder einen
  26. # "Fehlt"-String zurück oder bei strftime das 1899 Datum zurück.
  27. module SchildTypeSaver
  28. Symbol.include CoreExtensions::Symbol
  29. String.include CoreExtensions::String
  30. # bei include wird für jede Spalte in der Schild-Tabelle eine Ersatzmethode
  31. # erstellt, die bei nil ein Null-Objekt erstellt.
  32. def self.included(klass)
  33. klass.columns.each do |column|
  34. name = column.snake_case
  35. define_method(name) { public_send(column) || create_null_object(klass, column)}
  36. end
  37. end
  38. def create_null_object(klass, column)
  39. k = DB.schema_type_class(klass.db_schema[column][:type])
  40. if k.class == Array
  41. # Sequel stellt :datetime als [Time, DateTime] dar
  42. DateTime.new(1899)
  43. elsif k == Integer
  44. 0
  45. else
  46. # alle anderen types werden als Klasse zurückgegeben
  47. k.new
  48. end
  49. end
  50. end
  51. # Das Schild Modul, das alle Klassen für die Datenbankanbindung bereitstellt
  52. module Schild
  53. # ist die Datenbank-Verbindung. Alle Daten können über diese Konstante abgerufen werden
  54. DB = Sequel.connect(:adapter=>ENV['S_ADAPTER'], :host=>ENV['S_HOST'], :user=>ENV['S_USER'], :password=>ENV['S_PASSWORD'], :database=>ENV['S_DB'])
  55. # Stellt eine Verbindung zu einem Schild-Server her. Sollte nur aufgerufen werden, wenn wechselnde Verbindungen nötig sind.
  56. def self.connect
  57. Sequel.connect(:adapter=>ENV['S_ADAPTER'], :host=>ENV['S_HOST'], :user=>ENV['S_USER'], :password=>ENV['S_PASSWORD'], :database=>ENV['S_DB'])
  58. end
  59. # Stellt die Schüler-Tabelle samt Assoziationen bereit.
  60. class Schueler < Sequel::Model(:schueler)
  61. many_to_one :fachklasse, :class => :Fachklasse, :key => :Fachklasse_ID
  62. one_to_many :abschnitte, :class => :Abschnitt
  63. one_to_one :bk_abschluss, :class => :BKAbschluss
  64. one_to_many :bk_abschluss_leistungen, :class => :BKAbschlussFaecher
  65. end
  66. # Dient als Assoziation für Schüler und deren Klassenbezeichnung etc.
  67. class Fachklasse < Sequel::Model(:eigeneschule_fachklassen)
  68. one_to_many :schueler
  69. end
  70. # Assoziation für Lehrer, hauptsächlich für Klassenlehrer
  71. class Klassenlehrer < Sequel::Model(:k_lehrer)
  72. one_to_one :abschnitt, :primary_key=>:Kuerzel, :key=>:KlassenLehrer
  73. end
  74. # Ist die Assoziation, die Halbjahre, sog. Abschnitte zurückgibt.
  75. class Abschnitt < Sequel::Model(:schuelerlernabschnittsdaten)
  76. many_to_one :schueler, :class => :Schueler, :key => :Schueler_ID
  77. one_to_many :noten, :class => :Noten
  78. many_to_one :klassenlehrer, :class => :Klassenlehrer, :primary_key=>:Kuerzel, :key=>:KlassenLehrer
  79. end
  80. # Assoziation für Noten
  81. class Noten < Sequel::Model(:schuelerleistungsdaten)
  82. many_to_one :abschnitt, :class => :Abschnitt, :key => :Abschnitt_ID
  83. many_to_one :fach, :class => :Faecher, :key => :Fach_ID
  84. end
  85. # Assoziation für Fächer
  86. class Faecher < Sequel::Model(:eigeneschule_faecher)
  87. one_to_one :noten
  88. end
  89. # Assoziation für BK-Abschluss des Schülers
  90. class BKAbschluss < Sequel::Model(:schuelerbkabschluss)
  91. one_to_one :schueler
  92. end
  93. # Assoziation für die Prüfungsfächer des Schülers
  94. class BKAbschlussFaecher < Sequel::Model(:schuelerbkfaecher)
  95. many_to_one :schueler
  96. end
  97. # Schul-Tabelle
  98. class Schule < Sequel::Model(:eigeneschule)
  99. end
  100. end
  101. module SchildErweitert
  102. include Schild
  103. # Stellt die Schüler-Tabelle samt Assoziationen bereit.
  104. class Schueler < Schild::Schueler
  105. include SchildTypeSaver
  106. # gibt das z.Zt. aktuelle Halbjahr zurück.
  107. def akt_halbjahr
  108. abschnitte.last
  109. end
  110. # gibt das erste Halbjahr von +jahr+ zurück.
  111. def erstes_halbjahr(jahr)
  112. halbjahr(jahr, 1)
  113. end
  114. # gibt das zweite Halbjahr von +jahr+ zurück.
  115. def zweites_halbjahr(jahr)
  116. halbjahr(jahr, 2)
  117. end
  118. # gibt aus +jahr+ das Halbjahr +1+ oder +2+ zurück.
  119. def halbjahr(jahr, abschnitt)
  120. abschnitte_dataset.where(:jahr => jahr, :abschnitt => abschnitt).first
  121. end
  122. # gibt +Herr+ oder +Frau+ als Anrede für Schüler zurück.
  123. def anrede
  124. self.geschlecht == 3 ? "Herr" : "Frau"
  125. end
  126. # gibt die passende Bezeichnung zurück Schüler
  127. def schueler_in
  128. self.geschlecht == 3 ? "Schüler" : "Schülerin"
  129. end
  130. # gibt die passende Bezeichnung zurück Studierende
  131. def studierende_r
  132. self.geschlecht == 3 ? "Studierender" : "Studierende"
  133. end
  134. # gibt die jeweilige Berufsbezeichnung nach Geschlecht zurück.
  135. def berufsbezeichnung_mw
  136. self.geschlecht == 3 ? self.fachklasse.bezeichnung : self.fachklasse.beschreibung_w
  137. end
  138. # gibt +true+ zurück, wenn Schüler volljährig.
  139. def volljaehrig?
  140. self.volljaehrig == "+"
  141. end
  142. # gibt das aktuelle Schuljahr als String im Format "2014/15" zurück.
  143. def schuljahr
  144. jahr = self.akt_schuljahr
  145. "#{jahr}/#{jahr-1999}"
  146. end
  147. end
  148. # Dient als Assoziation für Schüler und deren Klassenbezeichnung etc.
  149. class Fachklasse < Schild::Fachklasse
  150. include SchildTypeSaver
  151. end
  152. # Assoziation für Lehrer, hauptsächlich für Klassenlehrer
  153. class Klassenlehrer < Schild::Klassenlehrer
  154. include SchildTypeSaver
  155. end
  156. # Ist die Assoziation, die Halbjahre, sog. Abschnitte zurückgibt.
  157. class Abschnitt < Schild::Abschnitt
  158. include SchildTypeSaver
  159. dataset_module do
  160. # filtert den Datensatz nach Jahr
  161. def jahr(i)
  162. where(:Jahr => i)
  163. end
  164. # filtert den Datensatz nach Halbjahr
  165. def halbjahr(i,j)
  166. jahr(i).where(:Abschnitt => j)
  167. end
  168. # filtert und gibt den Datensatz als Abschnitt des aktuellen Halbjahrs zurück
  169. def akt_halbjahr
  170. halbjahr(Time.new.year-1, 1).first
  171. end
  172. end
  173. # Hilfsmethode für die folgenden Methoden
  174. def faecher_nach_id(id)
  175. noten.sort_by{ |n| n.fach.SortierungS2 }.select{ |n| n.fach.Fachgruppe_ID == id && n.AufZeugnis == '+' }
  176. end
  177. # wählt alle berufsübergreifenden Fächer des gewählten Schülers in angegeben Halbjahr.
  178. def berufsuebergreifend
  179. faecher_nach_id 10
  180. end
  181. # wählt alle berufsbezogenen Fächer des gewählten Schülers in angegeben Halbjahr.
  182. def berufsbezogen
  183. faecher_nach_id 20
  184. end
  185. # wählt alle Fächer des Differenzierungsbreichs des gewählten Schülers in angegeben Halbjahr.
  186. def differenzierungsbereich
  187. faecher_nach_id 30
  188. end
  189. # wählt alle Fächergruppen aus.
  190. def faechergruppen
  191. [berufsuebergreifend, berufsbezogen, differenzierungsbereich]
  192. end
  193. # gibt den Namen des Klassenlehrers mit gekürztem Vornamen.
  194. def v_name_klassenlehrer
  195. v = klassenlehrer.vorname
  196. n = klassenlehrer.nachname
  197. "#{v[0]}. #{n}"
  198. end
  199. # gibt "Klassenlehrer" entsprechend Geschlecht zurück
  200. def klassenlehrer_in
  201. klassenlehrer.geschlecht == "3" ? "Klassenlehrer" : "Klassenlehrerin"
  202. end
  203. # gibt das aktuelle Schuljahr als String im Format "2014/15" zurück.
  204. def schuljahr
  205. jahr = self.jahr
  206. "#{jahr}/#{jahr-1999}"
  207. end
  208. end
  209. # Assoziation für Noten
  210. class Noten < Schild::Noten
  211. include SchildTypeSaver
  212. # Notenbezeichnung als String
  213. def note
  214. case self.noten_krz
  215. when "1", "1+", "1-"
  216. "sehr gut"
  217. when "2", "2+", "2-"
  218. "gut"
  219. when "3", "3+", "3-"
  220. "befriedigend"
  221. when "4", "4+", "4-"
  222. "ausreichend"
  223. when "5", "5+", "5-"
  224. "mangelhaft"
  225. when "6"
  226. "ungenügend"
  227. when 'NB'
  228. "----------"
  229. when "E1"
  230. "mit besonderem Erfolg teilgenommen"
  231. when "E2"
  232. "mit Erfolg teilgenommen"
  233. when 'E3'
  234. "teilgenommen"
  235. end
  236. end
  237. # Bezeichnung des Fachs
  238. def bezeichnung
  239. fach.bezeichnung
  240. end
  241. # Die Fachgruppen ID des Fachs
  242. def fachgruppe_ID
  243. fach.fachgruppe_id
  244. end
  245. end
  246. # Assoziation für Fächer
  247. class Faecher < Schild::Faecher
  248. include SchildTypeSaver
  249. end
  250. # Assoziation für BK-Abschlussdaten
  251. class BKAbschluss < Schild::BKAbschluss
  252. include SchildTypeSaver
  253. # Ist der Schüler zugelassen?
  254. def zulassung?
  255. self.Zulassung == "+"
  256. end
  257. # Ist der Schüler für den Berufsabschluss zugelassen?
  258. def zulassung_ba?
  259. self.ZulassungBA == "+"
  260. end
  261. # Hat der Schüler den Berufsabschluss bestanden?
  262. def bestanden_ba?
  263. self.BestandenBA == "+"
  264. end
  265. end
  266. # Assoziation für die jeweiligen BK-Prüfungsfächer
  267. class BKAbschlussFaecher < Schild::BKAbschlussFaecher
  268. include SchildTypeSaver
  269. # Vornote des Prüfungsfachs
  270. def vornote
  271. self.Vornote.to_i
  272. end
  273. # Wurde das Fach schriftlich geprüft?
  274. def fach_schriftlich?
  275. self.FachSchriftlich == "+"
  276. end
  277. # Wurde das Fach mündlich geprüft?
  278. def fach_muendlich?
  279. self.MdlPruefung == "+"
  280. end
  281. # die schriftliche Note des Fachs
  282. def note_schriftlich
  283. self.NoteSchriftlich.to_i
  284. end
  285. # Die mündliche Note des Fachs
  286. def note_muendlich
  287. self.NoteMuendlich.to_i
  288. end
  289. # Die berechnete/festgelegte Abschlussnote für das Fach
  290. def note_abschluss
  291. self.NoteAbschluss.to_i
  292. end
  293. end
  294. # Schul-Tabelle mit vereinfachtem Zugriff auf Datenfelder.
  295. class Schule < Schild::Schule
  296. include SchildTypeSaver
  297. # gibt die Schulnummer zurück
  298. def self.schulnummer
  299. self.first.schul_nr
  300. end
  301. def self.v_name_schulleiter
  302. "#{self.first.schulleiter_vorname[0]}. #{self.first.schulleiter_name}"
  303. end
  304. def self.schulleiter_in
  305. self.first.schulleiter_geschlecht == 3 ? "Schulleiter" : "Schulleiterin"
  306. end
  307. def self.ort
  308. self.first.ort
  309. end
  310. end
  311. end