hoangsonww/EstateWise-Chapel-Hill-Chatbot

Composite Lifestyle Scoring Engine

Offen

#60 geöffnet am 14.08.2025

Auf GitHub ansehenContributor Guide
 (0 Kommentare) (0 Reaktionen) (1 zugewiesene Person)TypeScript (21 Forks)auto 404
backendchoreci/cddocumentationenhancementfrontendgood first issuehelp wantedquestiontesting

Repository-Metriken

Stars
 (38 Sterne)
PR-Merge-Metriken
 (PR-Metriken ausstehend)

Beschreibung

Summary Compute a 0–100 score per listing combining commute, amenities, and school signals with explainable breakdown.

Acceptance Criteria

  • Default weights: commute 60%, amenities 25%, schools 15%.
  • Each result includes score and breakdown { commute, amenities, schools }.
  • Caps/floors and tie-breaks documented; weights configurable via env or admin.

Tasks

  • Commute scaler (minutes vs. threshold)
  • Amenity distance scorer (nearest grocery/park/gym)
  • School zone/rating signal
  • Aggregation + rounding; deterministic ties
  • Unit tests for scoring math

Contributor Guide

Research-Richtung
Überprüfen Sie die Datenmodelle für Pendelzeit, Annehmlichkeiten und Schulen in der Codebasis; implementieren Sie dann den Bewertungsalgorithmus mit Standardgewichten und stellen Sie sicher, dass jede Komponente eine eigene Skalierungsfunktion hat. Schreiben Sie Komponententests für Grenzfälle wie Extremwerte und Gleichstandsauflösung.
Tech Stack
typescript
Domain
backend
Issue Type
Funktion
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
2
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
Halber Tag
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Aktiv
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
TypeScriptTesting
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
70