PEOPLE: Wizard für Beitritt Zusatzsektion

[daniel-illi]

depends on #602, #612, #653

Vor der Umsetzung bitte mit @daniel-illi besprechen.

Mockup

Tech-Spec

Ein POC existiert auf dem branch poc/wizard-registration und ein dazugehöriger Draft PR https://github.com/hitobito/hitobito/pull/2653/files?w=1 / https://github.com/hitobito/hitobito_sac_cas/pull/603/files?w=1
Dieser soll als Vorlage für die Implementation verwendet werden.

• Wizard Step Wizards::Steps::MembershipTerminatedInfo, Titel: "Mitgliedschaft gekündigt"

  • Step nur anzeigen, falls die Person eine gekündigte Mitgliedschaft besitzt (wizard.membership_terminated?)
  • implementiert in #653

• Wizard Step Wizards::Steps::JoinZusatzsektion::ChooseMembership Titel "Familienmitgliedschaft"

  • Step nur anzeigen, sofern die Person eine Familienmitgliedschaft besitzt
  • Falls person.sac_family_main_person kann typ gewählt werden
  • Text

    Für wen soll die Zusatzmitgliedschaft gelden?

  • type: select mit options
    • self: "für mich selber"
    • family: "für die ganze Familie"
  • Sonst Infotext

    Du kannst als Einzelperson eine Zusatzmitgliedschaft abschliessen.
    Falls die Zusatzmitgliedschaft für die ganze Familie gelten soll, muss die Familienhauptperson diese abschliessen. Wende dich dafür an {name}.

• Wizard Step Wizards::Steps::ChooseSektion, Titel: "Sektion wählen"

  • Preisinformationen anzeigen wenn Sektion ausgewählt ist, analog Selfreg
  • Falls die gewählte Sektion kein "self-service" erlaubt (sie enthält ein child vom typ Group::SektionsNeuanmeldungenSektion):
  • wenn current_user SAC Mitarbeiter ist, Warnung anzeigen:

    Achtung: der Wechsel findet zu einer Sektion statt, die die Mitgliederaufnahme selbständig vornehmen. Allenfalls musst du diesen Wechsel vorgängig mit der Sektion abklären

  • wenn current_user KEIN SAC Mitarbeiter ist, Validierungsfehler:

    Wir bitten dich den gewünschten Sektionswechsel telefonisch oder per E-Mail* zu beantragen. Nimm dazu bitte Kontakt mit uns auf

• Wizard Step Wizards::Steps::JoinZusatzsektion::Summary, Titel: "Bestätigung"

  • Infotext

    Die Mitgliedschaft bei der Zusatzsektion wird als {Einzelmitglied|Jugendmitglied|Familienmitglied} abgeschlossen und ist per sofort gültig.

  • Preisinfo anzeigen auf der rechten Seite analog dem Selfregistration Wizard
  • next button mit Text "Kostenpflichtig bestellen"

• Wizard Wizards::JoinZusatzsektion include Wizards::Registering
  Der Wizard verwendet für die Rollenmutationen das Memberships::JoinZusatzsektion.

  • #step_after implementieren

    flowchart LR
    _start -->|terminated?| TerminatedMembershipInfo
    _start -->|family_membership?| ChooseMembership --> ChooseSektion
    _start --> ChooseSektion
    ChooseSektion --> Summary --> save[(save!)]

  • 
    def join_operation
    @join_operation ||= 
    Memberships::JoinZusatzsektion.new(
      person:, 
      sektion: choose_sektion.group, 
      family_membership: choose_membership.type == 'family'
    )
    end

  • in #valid? auf dem last_step zusätzlich die #join_operation validieren. Falls diese invalid ist, deren errors ins errors des wizards übernehmen.

    def valid?
    super
    
    if last_step? && !join_operation.valid? 
    join_operation.errors.full_messages.each do |msg|
      errors.add(:base, msg)
    end
    end
    
    errors.empty?
    end

  • in #save! das join_operation.save! aufrufen

    def save!
    super
    join_operation.save!
    end

• Ability on(Wizards::JoinZusatzsektion).may(:create)

  • wenn person eine aktive Mitgliedrolle besitzt (People::SacMembership#active?)
  • UND person == current_user || current_user.sac_mitarbeiter? (SacCas::SAC_MITARBEITER_ROLES)

• Controller People::ZusatzsektionJoinsController auf Basis des Wizards::BaseController des POC

  • route

    resources :groups do
    resources :people do
    get :zusatzsektion_joins, to: 'people/zusatzsektion_joins#new'
    resources :zusatzsektion_joins, only: [:new, :create], module: 'people'

  • before action: authorize!(:create, entry)
  • def model_class: Wizards::JoinZusatzsektion
  • def redirect_target: group_person_path

• class Sheet::ZusatzsektionJoin < Base
  self.parent_sheet = Sheet::Person

• Views app/views/people/zusatzsektion_joins/new.html.haml, new.js.haml, _form.html.haml, _fields.html.haml analog app/views/people/membership_changes/*.haml des POC

• In partial app/views/people/_roles.html.haml Button einfügen mit link auf group_person_zusatzsektion_join_path.
  Link/Dropdown menu nur anzeigen, falls current_user für die Person einen Zusatzsektions Beitritt initiieren darf: zuvor definierte Ability verwenden siehe Mockup

ToDo

• [ ] Domainklassen erstellen
• [ ] View/Controller erstellen
• [ ] Specs schreiben
• [ ] Mit angemessener Rolle "durchklicken"

[daniel-illi]

Beim Testen ist mir aufgefallen, dass ich beim Spezifizieren noch einen Fehler gemacht habe. Der Check bezüglich "self-service" sollte eigentlich nur im Stammsektionswechsel Wizard zum Zug kommen. Beim Zusatzsektion Beitritt ist dieser nicht relevant, da ja eine Neuanmeldung in der korrekten Neuanmeldungsgruppe erstellt wird. ~Das müssen wir noch anpassen bevor wir mergen.~ wird in follow-up ticket korrigiert: https://github.com/hitobito/hitobito_sac_cas/issues/708