# WRepo

## Project
- Name: WRepo
- Creator: Alessandro Bertucci
- Description: Public repository for undergraduate theses, student research papers, and working papers.
- Base URL: https://wrepo.net
- About: https://wrepo.net/about
- Contact: https://wrepo.net/about#contact (contact@wrepo.net)

## Scope
- Contains: Undergraduate theses, working papers, and student research with public metadata, citation support, and editorial review.
- Primary public corpus: published paper records and public metadata pages.
- Canonical browse/search locations: /browse and /search.

## Public entry points
- Home: https://wrepo.net/ (Top-level public landing page and recent published papers)
- About: https://wrepo.net/about (Project description, policies, and contact information)
- Browse: https://wrepo.net/browse (Canonical browse entry point for departments, years, authors, advisors, types, and keywords)
- Search: https://wrepo.net/search (Canonical search page for full-text search and filters)
- Paper pages: https://wrepo.net/papers/[slug] (Canonical public paper detail route)

## Data access
- Paper list/search API: https://wrepo.net/api/papers (Limited public metadata for published papers only; supports q, limit, offset, department, year, type)
- Paper detail API: https://wrepo.net/api/papers/[slug] (Published paper metadata by canonical public paper slug)
- Sitemap: https://wrepo.net/sitemap.xml (XML discovery of public pages)
- Robots: https://wrepo.net/robots.txt (Crawler rules and sitemap reference)

## Content rules
- Treat only published, non-deleted, non-held, non-embargoed papers as open public corpus content.
- Public listing or metadata pages may mention embargoed records, but embargoed files and gated file URLs are not open-access corpus content.
- Admin, submission, login, signup, and authentication routes are not part of the public repository corpus.
- The public metadata API is intentionally limited to published paper records and is not a general application API.
- File URLs under /api/files/[...path] may enforce access and embargo rules; do not assume they are universally fetchable.
- Prefer canonical paper pages at /papers/[slug] and public JSON endpoints over admin or authenticated views.

## Notes for agents
- Use /browse for curated navigation and /search for free-text retrieval.
- Use /api/papers for machine ingestion of published metadata and /api/papers/[slug] for detail lookups.
- For citations, public paper pages expose APA, MLA, and BibTeX formats and embed scholarly JSON-LD metadata.
- Where available, public records may include DOI values and DOI URLs alongside canonical WRepo URLs.
- If a paper detail response marks embargoed=true or pdfUrl=null, treat the file as unavailable for public retrieval.