Skip to content
kimipsenPublic

About

A simple angular application to group people based on preferences

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Grouper

Grouper is an Angular app for creating sessions and grouping people based on preferences.

Demo

A live demo of the application is available at https://grouper.kim-ipsen.workers.dev/.

Sample Data

Importable sample classes for testing and demos are described in docs/sample-data.md.

Repository Layout

  • grouper-app/: main application (Angular 22, standalone components)
  • docs/: project documentation and release notes

Getting Started

  1. Install dependencies:
    npm install
    npm --prefix grouper-app install
  2. Start the app:
    npm --prefix grouper-app start
  3. Open http://localhost:4204.

Common Commands

Run from the repository root unless stated otherwise.

  • Start app: npm --prefix grouper-app start
  • Build app: npm --prefix grouper-app run build
  • Lint app: npm run lint
  • Run unit tests: npm --prefix grouper-app test -- --watch=false
  • Run accessibility specs: npm --prefix grouper-app run test:a11y

Important Product Rules

  • Session export includes only the latest 5 groupingHistory entries.
  • Preference scoring is configurable per session:
    • preferenceScoring.wantWith (default 2)
    • preferenceScoring.avoid (default -2)
  • Custom weights are configurable per weight:
    • each custom weight has a mode: balance or match-similar
    • mode is set when the weight is created and can be changed later
    • weighted grouping uses the mode of each selected custom weight
    • legacy imported weights without mode default to balance
  • Supported locales are English (en) and Danish (da).

Key Source Folders

  • Models: grouper-app/src/app/models/
  • Services: grouper-app/src/app/core/services/
  • Algorithms: grouper-app/src/app/core/algorithms/
  • Session feature UI: grouper-app/src/app/features/sessions/
  • i18n files: grouper-app/src/assets/i18n/

Release Process

See docs/release-process.md.

Note: Documentation-only changes do not affect application behavior. No-op note: repository workflow validation change.

About

A simple angular application to group people based on preferences

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages