How pennywis404/hackathon works
This repository is a French-language assistant for reviewing company-meeting minutes (PV d’AG): it indexes internal reference documents, retrieves relevant passages, and produces cited recommendations. Its richer draft-review flow qualifies and scores a draft, finds comparable past acts, proposes edits, and returns a review result to the UI. The graph covers documented and indexed relationships; some modules are listed as core but were not excerpted, so their internal calls are not asserted.
Main entry points: review.py Review orchestrator · ingest.py Corpus ingestion · retrieval.py Passage retrieval · llm.py Mistral client
Components 22
Review interface
- Review page
ui/app/page.tsx - Review API
ui/app/api/review/route.ts - Review results
ui/components/result-view.tsx - Architecture view
ui/app/architecture/architecture-view.tsx
Draft review
- Review orchestrator
scripts/review.py - Draft qualification
qualify.py - Context preparation
pipeline.py - Similar acts
similar.py - Quality scoring
scoring.py - Draft correction
redraft.py - Review response
respond.py
RAG analysis
- Minutes analysis
analyze.py - Passage retrieval
retrieval.py
Corpus and services
- Corpus ingestion
ingest.py - Source normalization
sources.py - Document chunking
chunking.py - Scanned PDF OCR
ocr.py - Vector index
- Parent passages
parents.py - Mistral client
llm.py - Runtime configuration
config.py
Other components
- Reviewer
Connections 25
- Reviewer → Review page: submits draft
- Review page → Review API: requests review
- Review API → Review orchestrator: runs review
- Review orchestrator → Draft qualification: qualifies
scripts/review.py - Review orchestrator → Context preparation: prepares context
scripts/review.py - Review orchestrator → Similar acts: finds precedents
scripts/review.py - Review orchestrator → Draft correction: corrects draft
scripts/review.py - Review orchestrator → Review response: generates response
scripts/review.py - Review orchestrator → Quality scoring: scores draft
scripts/review.py - Review API → Review results: returns review
- Context preparation → Minutes analysis: retrieves passages
pipeline.py - Context preparation → Mistral client: decomposes sections
pipeline.py - Minutes analysis → Passage retrieval: searches passages
analyze.py - Minutes analysis → Mistral client: analyzes sections
analyze.py - Corpus ingestion → Source normalization: normalizes sources
ingest.py - Corpus ingestion → Document chunking: chunks PDFs
ingest.py - Document chunking → Scanned PDF OCR: extracts scanned text
chunking.py - Corpus ingestion → Mistral client: embeds chunks
ingest.py - Corpus ingestion → Vector index: writes chunks
ingest.py - Corpus ingestion → Parent passages: stores full passages
ingest.py - Passage retrieval → Vector index: queries embeddings
retrieval.py - Passage retrieval → Parent passages: loads parent text
retrieval.py - Mistral client → Runtime configuration: reads settings
llm.py - Corpus ingestion → Runtime configuration: reads settings
ingest.py - Passage retrieval → Runtime configuration: reads settings
retrieval.py