# Scouting Ireland Document Library

> Search and browse the official Scouting Ireland document library — policies, forms, reports, guidelines, minutes, and more. All documents are sourced from Scouting Ireland's official Issuu publications and processed with OCR and AI-generated summaries.

## Overview

This site indexes 979 Scouting Ireland documents covering areas such as health and safety, programme, governance, adult resources, water activities, and training. Each document has a title, type, tags, correspondent, publication date, and a plain-English summary generated by AI.

Documents include: policies (health & safety, safeguarding, activity approvals), terms of reference, annual reports, forms, certificates, meeting minutes, and programme resources.

## Pages

- [https://docs.uisce.app/](https://docs.uisce.app/) — Main search interface with AI-assisted question answering, full-text search, and browse-all with filters
- [https://docs.uisce.app/browse](https://docs.uisce.app/browse) — Browse and filter all documents by type, year, tag, or correspondent
- [https://docs.uisce.app/popular](https://docs.uisce.app/popular) — Most-viewed documents over the last 30 days

## API

All API responses are JSON. No authentication required for read endpoints.

- [https://docs.uisce.app/api/documents](https://docs.uisce.app/api/documents) — List/search documents with filters. Params: `q` (text search), `sort` (relevance|newest|oldest), `doc_type`, `tag`, `correspondent`, `published_year`, `page`, `page_size` (max 100). Returns `total`, `results[]`, `facets`.
- [https://docs.uisce.app/api/search](https://docs.uisce.app/api/search) — Hybrid BM25 + semantic search. Param: `q` (required), `limit` (max 30). Returns ranked `results[]` with title, summary, doc_type, tags, source_url.
- [https://docs.uisce.app/api/evidence-search](https://docs.uisce.app/api/evidence-search) — Search document evidence blocks (paragraphs/sections). Param: `q`. Returns ranked passages with page-level context.
- [https://docs.uisce.app/api/popular-documents](https://docs.uisce.app/api/popular-documents) — Most-viewed documents. Params: `limit`, `days`.

## Document fields

Each result object includes: `paperless_id`, `title`, `summary`, `doc_type`, `tags[]`, `correspondent`, `published_date`, `published_year`, `source_url` (PDF viewer), `thumb_url`.

## Document types

Policy, ToR (Terms of Reference), Report, Form, Certificate, Minutes, Letter, Notice, Memo, Invoice, Contract, Receipt, Statement, Other.

## Notes

- Full PDF available at `/pdfs/{id}` for every document
- Canonical document pages at `/documents/{id}/{slug}` include the full summary and an embedded PDF viewer
- The library is updated automatically when new documents are published to Scouting Ireland's Issuu account
- Sitemap: https://docs.uisce.app/sitemap.xml