docs/structure.md

Project Structure — Prism

prism/
├── CLAUDE.md
├── README.md
├── requirements.txt
├── .env.example
├── config.yaml                      # All tunable params (chunk sizes, weights, eval flags)
├── Dockerfile
├── render.yaml
├── .gitignore
│
├── .claude/
│   ├── settings.json
│   ├── hooks/
│   │   └── session-reflect.sh
│   └── rules/
│       ├── memory-profile.md        # Facts about Ben
│       ├── memory-preferences.md    # How Ben likes things done
│       ├── memory-decisions.md      # Technical decisions log
│       ├── memory-sessions.md       # Session log
│       └── coding-standards.md     # Code style rules
│
├── docs/
│   ├── architecture.md
│   ├── decisions.md
│   ├── api-spec.md
│   └── structure.md                 # This file
│
├── server/
│   ├── __init__.py
│   ├── main.py                      # FastAPI app, lifespan startup
│   ├── ingest.py                    # Load → ParentDocumentRetriever → embed → store
│   ├── retriever.py                 # Hybrid: dense + BM25 + RRF + reranker
│   ├── bm25_index.py               # BM25 index singleton
│   ├── reranker.py                  # Cross-encoder reranker singleton
│   ├── memory.py                    # ConversationBufferWindowMemory
│   ├── chain.py                     # ConversationalRetrievalChain
│   ├── utils.py                     # Config loader, logger, token counter
│   ├── routes/
│   │   ├── __init__.py
│   │   ├── chat.py                  # POST /api/chat, DELETE /api/chat/memory
│   │   ├── upload.py               # POST /api/upload
│   │   └── eval.py                  # GET /api/eval/session, POST /api/eval/precision|ragas
│   └── eval/
│       ├── __init__.py
│       ├── precision.py             # Precision@K
│       ├── faithfulness.py          # LLM-as-Judge (1–5 score)
│       └── ragas_eval.py           # RAGAS (4 metrics)
│
├── frontend/
│   ├── package.json
│   ├── vite.config.js
│   ├── tailwind.config.js
│   ├── index.html
│   └── src/
│       ├── main.jsx
│       ├── App.jsx                  # Tab nav: Chat | Eval | Upload
│       ├── api.js                   # Axios client
│       └── components/
│           ├── ChatTab.jsx
│           ├── EvalDashboard.jsx    # RAGAS scorecard + Precision@K + LangSmith link
│           ├── UploadTab.jsx        # Drag-and-drop upload
│           ├── MessageBubble.jsx
│           └── SourceExpander.jsx
│
├── scripts/
│   ├── run_ingest.py               # CLI ingestion
│   ├── run_eval.py                  # CLI Precision@K eval
│   ├── run_ragas_eval.py           # CLI RAGAS eval
│   └── benchmark_chunks.py         # Sweep chunk sizes, plot Precision@K
│
├── tests/
│   ├── test_ingest.py
│   ├── test_retriever.py
│   ├── test_reranker.py
│   ├── test_chain.py
│   ├── test_eval.py
│   └── test_ragas.py
│
├── data/
│   ├── raw/                         # Drop PDFs here (gitignored)
│   └── ground_truth/
│       └── eval_pairs.json          # 20 query/chunk pairs + ground_truth field
│
├── sample_data/                     # Seeded sample PDFs for demo
└── chroma_db/                       # Auto-created, gitignored