schild.rb 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420
  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. # Mixin für Notenbezeichnungen
  52. module NotenHelfer
  53. # Notenbezeichnung als String
  54. def note_s(ziffer)
  55. case ziffer
  56. when "1", "1+", "1-"
  57. "sehr gut"
  58. when "2", "2+", "2-"
  59. "gut"
  60. when "3", "3+", "3-"
  61. "befriedigend"
  62. when "4", "4+", "4-"
  63. "ausreichend"
  64. when "5", "5+", "5-"
  65. "mangelhaft"
  66. when "6"
  67. "ungenügend"
  68. when 'NB'
  69. "----------"
  70. when "E1"
  71. "mit besonderem Erfolg teilgenommen"
  72. when "E2"
  73. "mit Erfolg teilgenommen"
  74. when 'E3'
  75. "teilgenommen"
  76. end
  77. end
  78. end
  79. # Das Schild Modul, das alle Klassen für die Datenbankanbindung bereitstellt
  80. module Schild
  81. # ist die Datenbank-Verbindung. Alle Daten können über diese Konstante abgerufen werden
  82. DB = Sequel.connect(:adapter=>ENV['S_ADAPTER'], :host=>ENV['S_HOST'], :user=>ENV['S_USER'], :password=>ENV['S_PASSWORD'], :database=>ENV['S_DB'])
  83. # Stellt eine Verbindung zu einem Schild-Server her. Sollte nur aufgerufen werden, wenn wechselnde Verbindungen nötig sind.
  84. def self.connect
  85. Sequel.connect(:adapter=>ENV['S_ADAPTER'], :host=>ENV['S_HOST'], :user=>ENV['S_USER'], :password=>ENV['S_PASSWORD'], :database=>ENV['S_DB'])
  86. end
  87. # Stellt die Schüler-Tabelle samt Assoziationen bereit.
  88. class Schueler < Sequel::Model(:schueler)
  89. many_to_one :fachklasse, :class => :Fachklasse, :key => :Fachklasse_ID
  90. one_to_many :abschnitte, :class => :Abschnitt
  91. one_to_one :bk_abschluss, :class => :BKAbschluss
  92. one_to_many :bk_abschluss_leistungen, :class => :BKAbschlussFaecher
  93. one_to_many :vermerke, :class => :Vermerke
  94. end
  95. # Dient als Assoziation für Schüler und deren Klassenbezeichnung etc.
  96. class Fachklasse < Sequel::Model(:eigeneschule_fachklassen)
  97. one_to_many :schueler
  98. end
  99. # Assoziation für Lehrer, hauptsächlich für Klassenlehrer
  100. class Klassenlehrer < Sequel::Model(:k_lehrer)
  101. one_to_one :abschnitt, :primary_key=>:Kuerzel, :key=>:KlassenLehrer
  102. end
  103. # Ist die Assoziation, die Halbjahre, sog. Abschnitte zurückgibt.
  104. class Abschnitt < Sequel::Model(:schuelerlernabschnittsdaten)
  105. many_to_one :schueler, :class => :Schueler, :key => :Schueler_ID
  106. one_to_many :noten, :class => :Noten
  107. many_to_one :klassenlehrer, :class => :Klassenlehrer, :primary_key=>:Kuerzel, :key=>:KlassenLehrer
  108. end
  109. # Assoziation für Noten
  110. class Noten < Sequel::Model(:schuelerleistungsdaten)
  111. many_to_one :abschnitt, :class => :Abschnitt, :key => :Abschnitt_ID
  112. many_to_one :fach, :class => :Faecher, :key => :Fach_ID
  113. end
  114. # Assoziation für Fächer
  115. class Faecher < Sequel::Model(:eigeneschule_faecher)
  116. one_to_one :noten
  117. one_to_one :sprachenfolge, :class => :Sprachenfolge, :key => :Fach_ID
  118. end
  119. # Assoziation für BK-Abschluss des Schülers
  120. class BKAbschluss < Sequel::Model(:schuelerbkabschluss)
  121. one_to_one :schueler
  122. end
  123. # Assoziation für die Prüfungsfächer des Schülers
  124. class BKAbschlussFaecher < Sequel::Model(:schuelerbkfaecher)
  125. many_to_one :schueler
  126. end
  127. # Assoziation für die bisher erreichten Sprachniveaus
  128. class Sprachenfolge < Sequel::Model(:schuelersprachenfolge)
  129. one_to_one :Faecher
  130. end
  131. # Vermerke von Schülern
  132. class Vermerke < Sequel::Model(:schuelervermerke)
  133. many_to_one :Schueler
  134. end
  135. # Schul-Tabelle
  136. class Schule < Sequel::Model(:eigeneschule)
  137. end
  138. # Tabelle für Schild-Nutzer
  139. class Nutzer < Sequel::Model(:users)
  140. end
  141. end
  142. module SchildErweitert
  143. include Schild
  144. # Stellt die Schüler-Tabelle samt Assoziationen bereit.
  145. class Schueler < Schild::Schueler
  146. include SchildTypeSaver
  147. # gibt das z.Zt. aktuelle Halbjahr zurück.
  148. def akt_halbjahr
  149. abschnitte.last
  150. end
  151. # gibt das erste Halbjahr von +jahr+ zurück.
  152. def erstes_halbjahr(jahr)
  153. halbjahr(jahr, 1)
  154. end
  155. # gibt das zweite Halbjahr von +jahr+ zurück.
  156. def zweites_halbjahr(jahr)
  157. halbjahr(jahr, 2)
  158. end
  159. # gibt aus +jahr+ das Halbjahr +1+ oder +2+ zurück.
  160. def halbjahr(jahr, abschnitt)
  161. abschnitte_dataset.where(:jahr => jahr, :abschnitt => abschnitt).first
  162. end
  163. # gibt +Herr+ oder +Frau+ als Anrede für Schüler zurück.
  164. def anrede
  165. self.geschlecht == 3 ? "Herr" : "Frau"
  166. end
  167. # gibt die passende Bezeichnung zurück Schüler
  168. def schueler_in
  169. self.geschlecht == 3 ? "Schüler" : "Schülerin"
  170. end
  171. # gibt die passende Bezeichnung zurück Studierende
  172. def studierende_r
  173. self.geschlecht == 3 ? "Studierender" : "Studierende"
  174. end
  175. # gibt die jeweilige Berufsbezeichnung nach Geschlecht zurück.
  176. def berufsbezeichnung_mw
  177. self.geschlecht == 3 ? self.fachklasse.bezeichnung : self.fachklasse.beschreibung_w
  178. end
  179. # gibt +true+ zurück, wenn Schüler volljährig.
  180. def volljaehrig?
  181. self.volljaehrig == "+"
  182. end
  183. # gibt das aktuelle Schuljahr als String im Format "2014/15" zurück.
  184. def schuljahr
  185. jahr = self.akt_schuljahr
  186. "#{jahr}/#{jahr-1999}"
  187. end
  188. end
  189. # Dient als Assoziation für Schüler und deren Klassenbezeichnung etc.
  190. class Fachklasse < Schild::Fachklasse
  191. include SchildTypeSaver
  192. end
  193. # Assoziation für Lehrer, hauptsächlich für Klassenlehrer
  194. class Klassenlehrer < Schild::Klassenlehrer
  195. include SchildTypeSaver
  196. end
  197. # Ist die Assoziation, die Halbjahre, sog. Abschnitte zurückgibt.
  198. class Abschnitt < Schild::Abschnitt
  199. include SchildTypeSaver
  200. dataset_module do
  201. # filtert den Datensatz nach Jahr
  202. def jahr(i)
  203. where(:Jahr => i)
  204. end
  205. # filtert den Datensatz nach Halbjahr
  206. def halbjahr(i,j)
  207. jahr(i).where(:Abschnitt => j)
  208. end
  209. # filtert und gibt den Datensatz als Abschnitt des aktuellen Halbjahrs zurück
  210. def akt_halbjahr
  211. halbjahr(Time.new.year-1, 1).first
  212. end
  213. end
  214. # Hilfsmethode für die folgenden Methoden
  215. def faecher_nach_id(id)
  216. noten.select{ |n| n.fach.Fachgruppe_ID == id && n.AufZeugnis == '+' }.sort_by{ |n| n.fach.SortierungS2 }
  217. end
  218. # wählt alle berufsübergreifenden Fächer des gewählten Schülers in angegeben Halbjahr.
  219. def berufsuebergreifend
  220. faecher_nach_id 10
  221. end
  222. # wählt alle berufsbezogenen Fächer des gewählten Schülers in angegeben Halbjahr.
  223. def berufsbezogen
  224. faecher_nach_id 20
  225. end
  226. # wählt alle Fächer des Differenzierungsbreichs des gewählten Schülers in angegeben Halbjahr.
  227. def differenzierungsbereich
  228. faecher_nach_id 30
  229. end
  230. # wählt alle Fächergruppen aus.
  231. def faechergruppen
  232. [berufsuebergreifend, berufsbezogen, differenzierungsbereich]
  233. end
  234. # gibt den Namen des Klassenlehrers mit gekürztem Vornamen.
  235. def v_name_klassenlehrer
  236. v = klassenlehrer.vorname
  237. n = klassenlehrer.nachname
  238. "#{v[0]}. #{n}"
  239. end
  240. # gibt "Klassenlehrer" entsprechend Geschlecht zurück
  241. def klassenlehrer_in
  242. klassenlehrer.geschlecht == "3" ? "Klassenlehrer" : "Klassenlehrerin"
  243. end
  244. # gibt das aktuelle Schuljahr als String im Format "2014/15" zurück.
  245. def schuljahr
  246. jahr = self.jahr
  247. "#{jahr}/#{jahr-1999}"
  248. end
  249. end
  250. # Assoziation für Noten
  251. class Noten < Schild::Noten
  252. include SchildTypeSaver
  253. include NotenHelfer
  254. # note in String umwandeln
  255. def note
  256. note_s self.noten_krz
  257. end
  258. # Bezeichnung des Fachs
  259. def bezeichnung
  260. fach.bezeichnung
  261. end
  262. # Die Fachgruppen ID des Fachs
  263. def fachgruppe_ID
  264. fach.fachgruppe_id
  265. end
  266. end
  267. # Assoziation für Fächer
  268. class Faecher < Schild::Faecher
  269. include SchildTypeSaver
  270. end
  271. # Assoziation für BK-Abschlussdaten
  272. class BKAbschluss < Schild::BKAbschluss
  273. include SchildTypeSaver
  274. # Ist der Schüler zugelassen?
  275. def zulassung?
  276. self.Zulassung == "+"
  277. end
  278. # Ist der Schüler für den Berufsabschluss zugelassen?
  279. def zulassung_ba?
  280. self.ZulassungBA == "+"
  281. end
  282. # Hat der Schüler den Berufsabschluss bestanden?
  283. def bestanden_ba?
  284. self.BestandenBA == "+"
  285. end
  286. end
  287. # Assoziation für die jeweiligen BK-Prüfungsfächer
  288. class BKAbschlussFaecher < Schild::BKAbschlussFaecher
  289. include SchildTypeSaver
  290. include NotenHelfer
  291. # Wurde das Fach schriftlich geprüft?
  292. def fach_schriftlich?
  293. self.FachSchriftlich == "+"
  294. end
  295. # Wurde das Fach mündlich geprüft?
  296. def fach_muendlich?
  297. self.MdlPruefung == "+"
  298. end
  299. def note(notenart=:note_abschluss_ba)
  300. note_s send(notenart)
  301. end
  302. end
  303. class Sprachenfolge < Schild::Sprachenfolge
  304. include SchildTypeSaver
  305. end
  306. class Vermerke < Schild::Vermerke
  307. include SchildTypeSaver
  308. end
  309. # Schul-Tabelle mit vereinfachtem Zugriff auf Datenfelder.
  310. class Schule < Schild::Schule
  311. include SchildTypeSaver
  312. # gibt die Schulnummer zurück
  313. def self.schulnummer
  314. self.first.schul_nr
  315. end
  316. def self.v_name_schulleiter
  317. "#{self.first.schulleiter_vorname[0]}. #{self.first.schulleiter_name}"
  318. end
  319. def self.schulleiter_in
  320. self.first.schulleiter_geschlecht == 3 ? "Schulleiter" : "Schulleiterin"
  321. end
  322. def self.ort
  323. self.first.ort
  324. end
  325. end
  326. # Tabelle der Schuld-Benutzer zum Abgleichen der Daten
  327. class Nutzer < Schild::Nutzer
  328. include SchildTypeSaver
  329. def name
  330. self.us_name
  331. end
  332. def login
  333. self.us_login_name
  334. end
  335. def passwort
  336. self.us_password
  337. end
  338. alias :password :passwort
  339. def passwort?(passwort='')
  340. crypt(passwort) == self.passwort
  341. end
  342. alias :password? :passwort?
  343. def crypt(passwort)
  344. passwort.codepoints.map{|c| ((c/16)*32+15-c).chr}.join('')
  345. end
  346. end
  347. end