Skip to content

user-stories.md

Latest commit

 

History

History
123 lines (107 loc) · 7.43 KB

user-stories.md

File metadata and controls

123 lines (107 loc) · 7.43 KB
Raw

User Stories

Elenco completo delle user stories implementate nel progetto, organizzate per fase di sviluppo.

Fase 1 — Core Backend (US-001 → US-020)

ID Titolo Descrizione
US-001 Create pyproject.toml and folder structure Scaffolding iniziale del progetto Python
US-002 Create .env.example and Pydantic Settings Configurazione environment e settings
US-003 Create common module with types and exceptions Modulo condiviso con tipi ed eccezioni
US-004 Docker Compose for vector stores Qdrant, ChromaDB e MongoDB via Docker
US-005 OpenAI Embedding service Servizio embedding con OpenAI API
US-006 OpenAI LLM service Servizio LLM con OpenAI API
US-007 Memory service base interface Interfaccia astratta MemoryServiceBase
US-008 Context Window Memory Service Memoria a finestra (ultimi N messaggi)
US-009 Linear RAG Memory Service Vector search + time decay su ChromaDB
US-010 A-MEM MemoryNote dataclass Modello nota strutturata per A-MEM
US-011 A-MEM note construction prompt Prompt per estrazione entita/relazioni
US-012 A-MEM Memory Inductor Pipeline di induzione note dal messaggio
US-013 A-MEM link generation prompt Prompt per collegamento semantico tra note
US-014 A-MEM Memory Linker Collegamento automatico tra note correlate
US-015 A-MEM memory evolution prompt Prompt per evoluzione contesto/tags
US-016 A-MEM Memory Evolver Evoluzione periodica del grafo di memoria
US-017 A-MEM Service with Qdrant Servizio completo A-MEM con storage Qdrant
US-018 Obsidian export service Export note come Markdown con wikilinks
US-019 Obsidian import service Import note modificate in Obsidian
US-020 Obsidian file watcher Sync automatico su modifiche Obsidian

Fase 2 — API e CLI (US-021 → US-033)

ID Titolo Descrizione
US-021 Chat system prompt System prompt per l'agente conversazionale
US-022 PydanticAI Chat Agent Agente chat con tool calling (store_memory)
US-023 Chat and Memory DTOs Request/Response models Pydantic
US-024 REST API Chat endpoints POST /api/chat/{memory_type}
US-025 REST API Memory endpoints GET/DELETE /api/memory/{memory_type}
US-026 REST API Compare endpoint POST /api/compare (parallelo 3 sistemi)
US-027 FastAPI Application factory App factory con lifespan e middleware
US-028 CLI chat and compare commands Comandi chat e compare via Typer
US-029 CLI memory and serve commands Comandi memory e serve via Typer
US-030 Dashboard HTML structure Struttura HTML del dashboard comparativo
US-031 Dashboard CSS styling Stile del dashboard
US-032 Dashboard JavaScript functionality Logica JS del dashboard
US-033 Update CLAUDE.md with project documentation Documentazione progetto in CLAUDE.md

Fase 3 — Multi-User e Sessioni (US-034 → US-043)

ID Titolo Descrizione
US-034 User and Session models Dataclass per User, Session, ConversationTurn
US-035 Update MemoryServiceBase with user scoping Memoria separata per utente
US-036 Update Context Memory with user scoping Context Window con dict[user_id, deque]
US-037 Update Linear Memory with user scoping Linear RAG con filtro user_id in ChromaDB
US-038 Update A-MEM Service with user scoping A-MEM con collection separate per utente
US-039 Session storage service CRUD sessioni in MongoDB
US-040 Conversation history service CRUD conversation turns con debug info
US-041 Session API endpoints POST/GET /api/session/...
US-042 Update Chat API with session support Chat con sessione e metriche per turno
US-043 Conversation history API endpoints GET/DELETE /api/conversation/...

Fase 4 — Frontend React (US-044 → US-057)

ID Titolo Descrizione
US-044 Chat Frontend HTML structure Struttura HTML della chat (pre-React)
US-045 Chat Frontend CSS styling Stile CSS della chat (pre-React)
US-046 React Chat Page Layout and Sidebar Layout pagina chat con sidebar sessioni
US-047 React Chat Session Management Gestione sessioni per memory type
US-048 React Chat Messaging and History Invio messaggi e caricamento storico
US-049 React Dashboard Page Layout Layout pagina dashboard
US-050 React Dashboard Memory Cards Card con memorie per tipo
US-052 React Dashboard Search and Compare Ricerca e confronto memorie
US-053 React Dashboard KG Graph Visualization Visualizzazione grafo Knowledge Graph
US-054 API endpoint for memory users list GET /api/memory/users per lista utenti
US-055 Update memory endpoints with user filtering Filtro per utente sugli endpoint memoria
US-056 FastAPI serves React production build SPA React servita da FastAPI in produzione
US-057 React Navigation with Router React Router con navbar (Chat / Dashboard)

Fase 5 — Documentazione (US-059 → US-066)

ID Titolo Descrizione
US-059 docs/getting-started.md Guida setup e installazione
US-060 docs/architecture.md Panoramica architettura del sistema
US-061 docs/memory-systems.md Dettagli sui 3 sistemi di memoria
US-062 docs/amem-theory.md Paper A-MEM e teoria del Knowledge Graph
US-063 docs/api-reference.md Riferimento endpoint API
US-064 docs/cli-reference.md Riferimento comandi CLI
US-065 docs/obsidian-integration.md Guida integrazione Obsidian
US-066 docs/index.md with documentation overview Indice della documentazione

Fase 6 — Testing e CI (US-067 → US-082)

ID Titolo Descrizione
US-067 Test fixtures and pytest configuration Fixture condivise e configurazione pytest
US-068 Connection health check utilities Utility per health check servizi esterni
US-069 Connection tests for vector stores Test connessione Qdrant e ChromaDB
US-070 Connection tests for OpenAI Test connessione API OpenAI
US-071 E2E tests for Context Memory Service Test end-to-end Context Window
US-072 E2E tests for Linear RAG Memory Service Test end-to-end Linear RAG
US-073 E2E tests for A-MEM Service Test end-to-end A-MEM con mock LLM
US-074 E2E tests for Session and Conversation services Test CRUD sessioni e conversazioni
US-075 E2E tests for Chat API endpoints Test HTTP endpoint chat
US-076 E2E tests for Compare API endpoints Test HTTP endpoint compare
US-077 E2E tests for Memory API endpoints Test HTTP endpoint memoria
US-078 E2E tests for Session API endpoints Test HTTP endpoint sessioni
US-079 CLI command for running tests Comando memory-agent test
US-080 CLI command for health checks Comando memory-agent health
US-081 GitHub Actions CI workflow Pipeline CI con lint, typecheck, test
US-082 Test documentation docs/testing.md

Fase 7 — Dashboard Analytics e Debug (US-102 → US-104)

ID Titolo Descrizione
US-102 Vite + React + TypeScript project scaffolding Scaffolding frontend con Vite
US-103 Chat API debug info response Debug info embedded in ogni turno
US-104 React Debug Panel Toggle and Layout Pannello debug con memorie recuperate, pipeline, entities