Files
talktime/features
patrickandClaude Sonnet 5 ad6efc4afa fix(PROJ-11): BUG-26 (session persist), BUG-27 (org-scoped chat token), BUG-28 (composer off-screen)
BUG-27: POST /api/chat/token required no organizationId and just took
whichever provisioned membership row the DB returned first — a user in
more than one org (multi-tenant is explicitly in scope per PRD) could
get a Matrix token for the wrong org's identity. organizationId is now
required, threaded through fetchChatCredentials/useTeamChat/
useTeamUnreadCounts, and the frontend credential cache is now keyed
per-org so switching orgs doesn't reuse a stale token. Same ambiguity
fixed in GET /api/teams' BUG-13 membership lookup. Verified: token
request without organizationId now 400s.

BUG-26: the JWT lived only in useState, so every reload or deep link
threw the user back to /login. auth-context.tsx now persists it to
localStorage and restores/validates it on mount (via /api/auth/me);
ProtectedRoute waits on a new `initializing` flag instead of redirecting
before the restore attempt resolves.

BUG-28: TeamChat's fixed vh-fraction height could never guarantee the
composer stayed on screen — page header, the create-team card and the
team-tile grid all sit above it, so total content exceeds 100vh
regardless of the chat box's own height. Switched vh to dvh (mobile
keyboard/chrome resize) and added a scrollIntoView on mount, which
fires reliably since Radix Tabs only mounts the active tab's content.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0143yYvjesjHndBACoweyK67
2026-09-12 00:05:49 +02:00
..

Feature Specifications

Dieser Ordner enthält detaillierte Feature Specs vom Requirements Engineer.

Naming Convention

PROJ-X-feature-name.md

Beispiele:

  • PROJ-1-user-authentication.md
  • PROJ-2-kanban-board.md
  • PROJ-3-file-attachments.md

Was gehört in eine Feature Spec?

1. User Stories

Beschreibe, was der User tun möchte:

Als [User-Typ] möchte ich [Aktion] um [Ziel zu erreichen]

2. Acceptance Criteria

Konkrete, testbare Kriterien:

- [ ] User kann Email + Passwort eingeben
- [ ] Passwort muss mindestens 8 Zeichen lang sein
- [ ] Nach Registration wird User automatisch eingeloggt

3. Edge Cases

Was passiert bei unerwarteten Situationen:

- Was passiert bei doppelter Email?
- Was passiert bei Netzwerkfehler?
- Was passiert bei gleichzeitigen Edits?

4. Tech Design (vom Solution Architect)

## Database Schema
CREATE TABLE tasks (...);

## Component Architecture
ProjectDashboard
├── ProjectList
│   └── ProjectCard

5. QA Test Results (vom QA Engineer)

Am Ende des Feature-Dokuments fügt QA die Test-Ergebnisse hinzu:

---

## QA Test Results

**Tested:** 2026-01-12
**App URL:** http://localhost:3000

### Acceptance Criteria Status
- [x] AC-1: User kann Email + Passwort eingeben
- [x] AC-2: Passwort mindestens 8 Zeichen
- [ ] ❌ BUG: Doppelte Email wird nicht abgelehnt

### Bugs Found
**BUG-1: Doppelte Email-Registrierung**
- **Severity:** High
- **Steps to Reproduce:** 1. Register with email, 2. Try again with same email
- **Expected:** Error message
- **Actual:** Silent failure

6. Deployment Status (vom DevOps Engineer)

---

## Deployment

**Status:** ✅ Deployed
**Deployed:** 2026-01-13
**Production URL:** https://your-domain.example
**Git Tag:** v1.0.0-PROJ-1

Workflow

  1. Requirements Engineer erstellt Feature Spec
  2. User reviewed Spec und gibt Feedback
  3. Solution Architect fügt Tech-Design hinzu
  4. User approved finales Design
  5. Frontend/Backend Devs implementieren (dokumentiert via Git Commits)
  6. QA Engineer testet und fügt Test-Ergebnisse zum Feature-Dokument hinzu
  7. DevOps deployed und fügt Deployment-Status zum Feature-Dokument hinzu

Status-Tracking

Feature-Status wird direkt im Feature-Dokument getrackt:

# PROJ-1: Feature Name

**Status:** 🔵 Planned | 🟡 In Progress | ✅ Deployed
**Created:** 2026-01-12
**Last Updated:** 2026-01-12

Status-Bedeutung:

  • 🔵 Planned – Requirements sind geschrieben, ready for development
  • 🟡 In Progress – Wird gerade gebaut
  • ✅ Deployed – Live in Production

Git als Single Source of Truth:

  • Alle Implementierungs-Details sind in Git Commits
  • git log --grep="PROJ-1" zeigt alle Änderungen für dieses Feature
  • Keine separate FEATURE_CHANGELOG.md nötig!