schild.rb 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422
  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. one_to_one :BKAbschlussFaecher
  119. end
  120. # Assoziation für BK-Abschluss des Schülers
  121. class BKAbschluss < Sequel::Model(:schuelerbkabschluss)
  122. one_to_one :schueler
  123. end
  124. # Assoziation für die Prüfungsfächer des Schülers
  125. class BKAbschlussFaecher < Sequel::Model(:schuelerbkfaecher)
  126. many_to_one :schueler
  127. one_to_one :fach, :class => :Faecher, :primary_key => :Fach_ID, :key => :ID
  128. end
  129. # Assoziation für die bisher erreichten Sprachniveaus
  130. class Sprachenfolge < Sequel::Model(:schuelersprachenfolge)
  131. one_to_one :Faecher
  132. end
  133. # Vermerke von Schülern
  134. class Vermerke < Sequel::Model(:schuelervermerke)
  135. many_to_one :Schueler
  136. end
  137. # Schul-Tabelle
  138. class Schule < Sequel::Model(:eigeneschule)
  139. end
  140. # Tabelle für Schild-Nutzer
  141. class Nutzer < Sequel::Model(:users)
  142. end
  143. end
  144. module SchildErweitert
  145. include Schild
  146. # Stellt die Schüler-Tabelle samt Assoziationen bereit.
  147. class Schueler < Schild::Schueler
  148. include SchildTypeSaver
  149. # gibt das z.Zt. aktuelle Halbjahr zurück.
  150. def akt_halbjahr
  151. abschnitte.last
  152. end
  153. # gibt das erste Halbjahr von +jahr+ zurück.
  154. def erstes_halbjahr(jahr)
  155. halbjahr(jahr, 1)
  156. end
  157. # gibt das zweite Halbjahr von +jahr+ zurück.
  158. def zweites_halbjahr(jahr)
  159. halbjahr(jahr, 2)
  160. end
  161. # gibt aus +jahr+ das Halbjahr +1+ oder +2+ zurück.
  162. def halbjahr(jahr, abschnitt)
  163. abschnitte_dataset.where(:jahr => jahr, :abschnitt => abschnitt).first
  164. end
  165. # gibt +Herr+ oder +Frau+ als Anrede für Schüler zurück.
  166. def anrede
  167. self.geschlecht == 3 ? "Herr" : "Frau"
  168. end
  169. # gibt die passende Bezeichnung zurück Schüler
  170. def schueler_in
  171. self.geschlecht == 3 ? "Schüler" : "Schülerin"
  172. end
  173. # gibt die passende Bezeichnung zurück Studierende
  174. def studierende_r
  175. self.geschlecht == 3 ? "Studierender" : "Studierende"
  176. end
  177. # gibt die jeweilige Berufsbezeichnung nach Geschlecht zurück.
  178. def berufsbezeichnung_mw
  179. self.geschlecht == 3 ? self.fachklasse.bezeichnung : self.fachklasse.beschreibung_w
  180. end
  181. # gibt +true+ zurück, wenn Schüler volljährig.
  182. def volljaehrig?
  183. self.volljaehrig == "+"
  184. end
  185. # gibt das aktuelle Schuljahr als String im Format "2014/15" zurück.
  186. def schuljahr
  187. jahr = self.akt_schuljahr
  188. "#{jahr}/#{jahr-1999}"
  189. end
  190. end
  191. # Dient als Assoziation für Schüler und deren Klassenbezeichnung etc.
  192. class Fachklasse < Schild::Fachklasse
  193. include SchildTypeSaver
  194. end
  195. # Assoziation für Lehrer, hauptsächlich für Klassenlehrer
  196. class Klassenlehrer < Schild::Klassenlehrer
  197. include SchildTypeSaver
  198. end
  199. # Ist die Assoziation, die Halbjahre, sog. Abschnitte zurückgibt.
  200. class Abschnitt < Schild::Abschnitt
  201. include SchildTypeSaver
  202. dataset_module do
  203. # filtert den Datensatz nach Jahr
  204. def jahr(i)
  205. where(:Jahr => i)
  206. end
  207. # filtert den Datensatz nach Halbjahr
  208. def halbjahr(i,j)
  209. jahr(i).where(:Abschnitt => j)
  210. end
  211. # filtert und gibt den Datensatz als Abschnitt des aktuellen Halbjahrs zurück
  212. def akt_halbjahr
  213. halbjahr(Time.new.year-1, 1).first
  214. end
  215. end
  216. # Hilfsmethode für die folgenden Methoden
  217. def faecher_nach_id(id)
  218. noten.sort_by{ |n| n.fach.SortierungS2 }.select{ |n| n.fach.Fachgruppe_ID == id && n.AufZeugnis == '+' }
  219. end
  220. # wählt alle berufsübergreifenden Fächer des gewählten Schülers in angegeben Halbjahr.
  221. def berufsuebergreifend
  222. faecher_nach_id 10
  223. end
  224. # wählt alle berufsbezogenen Fächer des gewählten Schülers in angegeben Halbjahr.
  225. def berufsbezogen
  226. faecher_nach_id 20
  227. end
  228. # wählt alle Fächer des Differenzierungsbreichs des gewählten Schülers in angegeben Halbjahr.
  229. def differenzierungsbereich
  230. faecher_nach_id 30
  231. end
  232. # wählt alle Fächergruppen aus.
  233. def faechergruppen
  234. [berufsuebergreifend, berufsbezogen, differenzierungsbereich]
  235. end
  236. # gibt den Namen des Klassenlehrers mit gekürztem Vornamen.
  237. def v_name_klassenlehrer
  238. v = klassenlehrer.vorname
  239. n = klassenlehrer.nachname
  240. "#{v[0]}. #{n}"
  241. end
  242. # gibt "Klassenlehrer" entsprechend Geschlecht zurück
  243. def klassenlehrer_in
  244. klassenlehrer.geschlecht == "3" ? "Klassenlehrer" : "Klassenlehrerin"
  245. end
  246. # gibt das aktuelle Schuljahr als String im Format "2014/15" zurück.
  247. def schuljahr
  248. jahr = self.jahr
  249. "#{jahr}/#{jahr-1999}"
  250. end
  251. end
  252. # Assoziation für Noten
  253. class Noten < Schild::Noten
  254. include SchildTypeSaver
  255. include NotenHelfer
  256. # note in String umwandeln
  257. def note
  258. note_s self.noten_krz
  259. end
  260. # Bezeichnung des Fachs
  261. def bezeichnung
  262. fach.bezeichnung
  263. end
  264. # Die Fachgruppen ID des Fachs
  265. def fachgruppe_ID
  266. fach.fachgruppe_id
  267. end
  268. end
  269. # Assoziation für Fächer
  270. class Faecher < Schild::Faecher
  271. include SchildTypeSaver
  272. end
  273. # Assoziation für BK-Abschlussdaten
  274. class BKAbschluss < Schild::BKAbschluss
  275. include SchildTypeSaver
  276. # Ist der Schüler zugelassen?
  277. def zulassung?
  278. self.Zulassung == "+"
  279. end
  280. # Ist der Schüler für den Berufsabschluss zugelassen?
  281. def zulassung_ba?
  282. self.ZulassungBA == "+"
  283. end
  284. # Hat der Schüler den Berufsabschluss bestanden?
  285. def bestanden_ba?
  286. self.BestandenBA == "+"
  287. end
  288. end
  289. # Assoziation für die jeweiligen BK-Prüfungsfächer
  290. class BKAbschlussFaecher < Schild::BKAbschlussFaecher
  291. include SchildTypeSaver
  292. include NotenHelfer
  293. # Wurde das Fach schriftlich geprüft?
  294. def fach_schriftlich?
  295. self.FachSchriftlich == "+"
  296. end
  297. # Wurde das Fach mündlich geprüft?
  298. def fach_muendlich?
  299. self.MdlPruefung == "+"
  300. end
  301. def note(notenart)
  302. note_s send(notenart)
  303. end
  304. end
  305. class Sprachenfolge < Schild::Sprachenfolge
  306. include SchildTypeSaver
  307. end
  308. class Vermerke < Schild::Vermerke
  309. include SchildTypeSaver
  310. end
  311. # Schul-Tabelle mit vereinfachtem Zugriff auf Datenfelder.
  312. class Schule < Schild::Schule
  313. include SchildTypeSaver
  314. # gibt die Schulnummer zurück
  315. def self.schulnummer
  316. self.first.schul_nr
  317. end
  318. def self.v_name_schulleiter
  319. "#{self.first.schulleiter_vorname[0]}. #{self.first.schulleiter_name}"
  320. end
  321. def self.schulleiter_in
  322. self.first.schulleiter_geschlecht == 3 ? "Schulleiter" : "Schulleiterin"
  323. end
  324. def self.ort
  325. self.first.ort
  326. end
  327. end
  328. # Tabelle der Schuld-Benutzer zum Abgleichen der Daten
  329. class Nutzer < Schild::Nutzer
  330. include SchildTypeSaver
  331. def name
  332. self.us_name
  333. end
  334. def login
  335. self.us_login_name
  336. end
  337. def passwort
  338. self.us_password
  339. end
  340. alias :password :passwort
  341. def passwort?(passwort='')
  342. crypt(passwort) == self.passwort
  343. end
  344. alias :password? :passwort?
  345. def crypt(passwort)
  346. passwort.codepoints.map{|c| ((c/16)*32+15-c).chr}.join('')
  347. end
  348. end
  349. end