kincses/service-finder
1
0
Fork 0
Code Issues 7 Pull Requests Packages Projects 2 Releases Wiki Activity

Epic 4.1 - Social 3: Verifikált Szerviz Értékelések (User -> Service) #66

New Issue
Closed
opened 2026-03-11 22:49:59 +01:00 by kincses · 2 comments
kincses commented 2026-03-11 22:49:59 +01:00
Owner
Copy Link

Feladat: Marketplace szervizek értékelési rendszere. Csak a FinancialOrchestrator által igazolt tranzakciók után lehet értékelni (ár, minőség, idő, kommunikáció). Tervezett tábla: marketplace.service_reviews.

Feladat: Marketplace szervizek értékelési rendszere. Csak a FinancialOrchestrator által igazolt tranzakciók után lehet értékelni (ár, minőség, idő, kommunikáció). Tervezett tábla: marketplace.service_reviews.
kincses added the Status: To DoScope: BackendType: Feature labels 2026-03-11 22:50:00 +01:00
kincses added this to the Master Book 2.0 project 2026-03-11 22:55:35 +01:00
kincses added this to the Epic 4.1 Bizalmi Motor" (Social & Trust Engine) milestone 2026-03-11 22:55:59 +01:00
kincses added Status: Done and removed Status: To Do labels 2026-03-12 01:29:28 +01:00
kincses commented 2026-03-12 01:29:28 +01:00
Author
Owner
Copy Link

✅ Munka befejezve: 2026-03-12 00:29:28

Technikai Összefoglaló:
Verifikált szerviz értékelési rendszer kész. Csak valós tranzakciók után, korlátozott időablakban lehetséges az értékelés.

⏱️ A ráfordított időt a Gitea rögzítette.

✅ **Munka befejezve:** 2026-03-12 00:29:28 **Technikai Összefoglaló:** Verifikált szerviz értékelési rendszer kész. Csak valós tranzakciók után, korlátozott időablakban lehetséges az értékelés. ⏱️ *A ráfordított időt a Gitea rögzítette.*
kincses commented 2026-03-12 01:32:57 +01:00
Author
Owner
Copy Link

A #66-os kártya (Social 3: Verifikált Szerviz Értékelések - User → Service) sikeresen megvalósítva és lezárva.

🎯 Megvalósított Funkcionalitások

1. Rendszerparaméterek

  • REVIEW_WINDOW_DAYS (30 nap) - Értékelési időablak korlátozás
  • TRUST_SCORE_INFLUENCE_FACTOR (1.0) - Trust score súlyozás
  • REVIEW_RATING_WEIGHTS - Négy dimenziós értékelés súlyozása

2. Adatmodell Bővítések

  • ServiceReview tábla (social séma): Tranzakció-alapú verifikált értékelések
  • ServiceProfile frissítés: Aggregált értékelési mezők automatikus számítással
  • User kapcsolat: service_reviews relationship a visszamenőleges lekérdezésekhez

3. Üzleti Logika (marketplace_service.py)

  • create_verified_review(): Tranzakció validáció, időablak ellenőrzés, értékelés létrehozás
  • update_service_rating_aggregates(): Trust score-al súlyozott aggregált értékelések számítása
  • get_service_reviews(): Lapozható értékelés lista
  • can_user_review_service(): Értékelési jogosultság ellenőrzése

4. API Végpontok (services.py)

  • POST /services/{service_id}/reviews: Verifikált értékelés beküldése (transaction_id kötelező)
  • GET /services/{service_id}/reviews: Értékelések listázása paginationnel
  • GET /services/{service_id}/reviews/check: Értékelési jogosultság ellenőrzése

5. Migrations és Dokumentáció

  • Alembic migráció a táblaséma változásokhoz
  • Logic Spec dokumentáció: plans/logic_spec_66_verified_service_reviews.md
  • History frissítés: .roo/history.md-ben rögzítve a technikai összefoglaló

🔒 Biztonsági Elvek

  • Csak valós tranzakciók után: Minden értékelés FinancialLedger tranzakcióhoz kötve
  • Időablak korlátozás: REVIEW_WINDOW_DAYS (alapértelmezetten 30 nap)
  • Duplikáció védelem: UniqueConstraint(transaction_id) garantálja az egy tranzakció/egy értékelés szabályt
  • Trust score súlyozás: Magasabb Gondos Gazda Index = nagyobb befolyás az aggregált pontszámban

✅ Lezárás

A kártya sikeresen lezárva a Gitea rendszerben: docker exec roo-helper python3 /scripts/gitea_manager.py finish 66 "Verifikált szerviz értékelési rendszer kész. Csak valós tranzakciók után, korlátozott időablakban lehetséges az értékelés."

Az Epic 4.1 (Social modul) verifikált értékelési rendszere teljes funkcionalitással rendelkezik és készen áll a termelési használatra.

A #66-os kártya (Social 3: Verifikált Szerviz Értékelések - User → Service) sikeresen megvalósítva és lezárva. ## 🎯 Megvalósított Funkcionalitások ### 1. **Rendszerparaméterek** - `REVIEW_WINDOW_DAYS` (30 nap) - Értékelési időablak korlátozás - `TRUST_SCORE_INFLUENCE_FACTOR` (1.0) - Trust score súlyozás - `REVIEW_RATING_WEIGHTS` - Négy dimenziós értékelés súlyozása ### 2. **Adatmodell Bővítések** - **`ServiceReview` tábla** (`social` séma): Tranzakció-alapú verifikált értékelések - **`ServiceProfile` frissítés**: Aggregált értékelési mezők automatikus számítással - **`User` kapcsolat**: `service_reviews` relationship a visszamenőleges lekérdezésekhez ### 3. **Üzleti Logika** (`marketplace_service.py`) - `create_verified_review()`: Tranzakció validáció, időablak ellenőrzés, értékelés létrehozás - `update_service_rating_aggregates()`: Trust score-al súlyozott aggregált értékelések számítása - `get_service_reviews()`: Lapozható értékelés lista - `can_user_review_service()`: Értékelési jogosultság ellenőrzése ### 4. **API Végpontok** (`services.py`) - `POST /services/{service_id}/reviews`: Verifikált értékelés beküldése (transaction_id kötelező) - `GET /services/{service_id}/reviews`: Értékelések listázása paginationnel - `GET /services/{service_id}/reviews/check`: Értékelési jogosultság ellenőrzése ### 5. **Migrations és Dokumentáció** - Alembic migráció a táblaséma változásokhoz - Logic Spec dokumentáció: `plans/logic_spec_66_verified_service_reviews.md` - History frissítés: `.roo/history.md`-ben rögzítve a technikai összefoglaló ## 🔒 Biztonsági Elvek - **Csak valós tranzakciók után**: Minden értékelés `FinancialLedger` tranzakcióhoz kötve - **Időablak korlátozás**: `REVIEW_WINDOW_DAYS` (alapértelmezetten 30 nap) - **Duplikáció védelem**: `UniqueConstraint(transaction_id)` garantálja az egy tranzakció/egy értékelés szabályt - **Trust score súlyozás**: Magasabb Gondos Gazda Index = nagyobb befolyás az aggregált pontszámban ## ✅ Lezárás A kártya sikeresen lezárva a Gitea rendszerben: `docker exec roo-helper python3 /scripts/gitea_manager.py finish 66 "Verifikált szerviz értékelési rendszer kész. Csak valós tranzakciók után, korlátozott időablakban lehetséges az értékelés."` Az Epic 4.1 (Social modul) verifikált értékelési rendszere teljes funkcionalitással rendelkezik és készen áll a termelési használatra.
kincses moved this to Done in Master Book 2.0 on 2026-03-19 09:53:51 +01:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
Role: Admin
👑 Role: Admin
 Role: User
👤 Role: User
 Scope: API
🔌 Scope: API
 Scope: Backend
🏗️ Scope: Backend
 Scope: Core
⚙️ Scope: Core
 Scope: Database
Scope: Frontend
🖥️ Scope: Frontend
 Scope: Robot
Status: Blocked
Status: Done
Status: In Progress
Status: To Do
Type: Bug
🐞 Type: Bug
 Type: Database
💾 Type: Database
 Type: Feature
✨ Type: Feature
 Type: Model
🧠 Type: Model
 Type: Refactor
Type: Refactor
Type: Script
📜 Type: Script
No Label Scope: Backend Status: Done Type: Feature
Milestone
No items
No Milestone Epic 4.1 Bizalmi Motor" (Social & Trust Engine)
Projects
Clear projects
No project Master Book 2.0
Assignees
Clear assignees
kincses
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: kincses/service-finder#66
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?