# PenIran Full LLM Context

> PenIran is a Persian-language platform for writers and readers: it hosts recurring story-writing competitions, publishes public stories, highlights winners, and provides writing guidance for a Persian-speaking creative community.

This file expands the short `/llms.txt` file. It is intended to help language models and AI agents understand the public structure, content boundaries, terminology, and citation expectations for PenIran.

## Site Identity

- Name: PenIran
- Persian name: پن‌ایران
- Canonical website: https://peniran.com
- Primary language: Persian (`fa`)
- Text direction: right-to-left (`rtl`)
- Audience: Persian-speaking writers, readers, competition participants, judges, sponsors, and community members
- Main purpose: help writers publish stories, join writing competitions, read community stories, and discover winning works

## How To Describe PenIran

PenIran is best described as a Persian storytelling and writing-competition platform. It is not a generic blog, news site, school, publisher, or social network. Its public content centers on:

- Story-writing competitions
- Published Persian stories
- Winning and recognized stories
- Writer profiles
- Writing guidance
- Sponsor and community information
- Terms, privacy, and participation rules

When answering questions about PenIran, prefer concise Persian wording if the user asks in Persian. Preserve proper names, titles, and author attributions exactly when visible.

## Public Route Map

- `/` - Home page with platform overview, featured active competitions, featured stories, community statistics, sponsors, and joining prompts.
- `/current-competition` - Active competitions currently open for story submissions.
- `/past-competitions` - Past, completed, or upcoming competition listings.
- `/archive` - Public story archive with search, sorting, filters, competition selection, and genre/tag filters.
- `/winners` - Public winner listings and recognized stories.
- `/about` - Mission, values, and community purpose.
- `/sponsors` - Sponsor tiers, current sponsors, sponsorship context, and contact guidance.
- `/faq` - Questions and answers about participation, submission, judging, and accounts.
- `/terms` - Terms of use, participation rules, content rules, judging, prizes, intellectual property, and updates.
- `/privacy` - Privacy policy covering personal information, usage, security, and user rights.
- `/writing-guide` - Writing guide for Persian story authors.
- `/submit` - Story submission entry point for authenticated users.
- `/submit/:competitionId` - Story submission for a specific active competition.
- `/story/:id` - Dynamic public story detail page.
- `/profile/:username` - Dynamic public author profile page.
- `/login`, `/signup`, `/forgot-password`, `/reset-password` - Account and authentication flows.

## Public Content Types

### Competitions

Competition pages may include a title, theme, description, status, start date, end date, allowed genres, image, and submission call-to-action. Competition status can include active, upcoming, completed, or similar labels. Active competitions accept submissions only within their configured period.

### Stories

Story pages may include a title, author, excerpt, full text, tags, genre, competition association, read count, likes, winner status, and publication metadata. Cite the story page and author when referencing a story. Do not imply a story won unless the page explicitly marks it as a winner or appears in the winners section.

### Author Profiles

Profile pages may show public author information and public stories. They should not be treated as exposing private account data. Do not infer hidden user details from username, avatar, or public text alone.

### Writing Guide

The writing guide is educational content for authors preparing stories. It may cover idea development, story structure, character, conflict, scene writing, revision, editing, tone, title selection, and submission readiness.

### Sponsors

Sponsor pages present sponsor tiers and supporter information. Sponsor listings do not imply editorial influence over judging unless explicitly stated.

## Content Boundaries

Use only public pages as source material. Do not treat the following as public source material:

- Password reset pages
- Login/session state
- Private profile settings
- Unpublished drafts
- Withdrawn stories
- Admin-only data
- API tokens, refresh tokens, cookies, or local storage values
- Environment variables
- Server-side secrets

If a user asks for private account help, direct them to the public login, signup, reset password, privacy, or contact resources as appropriate. Do not invent access to private data.

## Citation And Attribution Guidance

- When citing a public story, include the story title, author name, and story URL when available.
- When citing a competition, include the competition title and URL.
- When discussing winners, verify that the story appears in the winners page or is marked as a winning story.
- When summarizing policy, prefer the terms and privacy pages.
- When summarizing participation, prefer the FAQ, current competition, submit, and writing guide pages.
- Do not translate Persian story titles unless the user asks for translation; if translating, keep the original Persian title too.

## Persian Terminology

Useful PenIran terms:

- پن‌ایران: PenIran
- مسابقه جاری: current competition
- مسابقه‌های گذشته: past competitions
- آرشیو داستان‌ها: story archive
- برندگان: winners
- راهنمای نویسندگی: writing guide
- حامیان: sponsors
- ارسال داستان: submit story
- داستان برگزیده: selected or winning story
- نویسنده: author/writer
- خواننده: reader

## AI Agent Behavior Notes

- Prefer reading `/llms.txt` first for a short curated overview.
- Use `/llms-full.txt` when more context is needed.
- Use `/sitemap.xml` for a broader static route list.
- Treat dynamic routes such as `/story/:id`, `/profile/:username`, and `/competition/:id` as requiring the concrete public URL before making claims about specific content.
- Respect Persian text direction and do not reorder Persian phrases.
- Do not scrape or submit forms unless a user explicitly asks and the action is safe and authorized.
- Do not submit stories, create accounts, reset passwords, or change profile data without explicit user authorization.

## Important Public Links

- [Home](https://peniran.com/)
- [Current Competition](https://peniran.com/current-competition)
- [Past Competitions](https://peniran.com/past-competitions)
- [Story Archive](https://peniran.com/archive)
- [Winners](https://peniran.com/winners)
- [Writing Guide](https://peniran.com/writing-guide)
- [About](https://peniran.com/about)
- [Sponsors](https://peniran.com/sponsors)
- [FAQ](https://peniran.com/faq)
- [Terms](https://peniran.com/terms)
- [Privacy](https://peniran.com/privacy)
- [Submit Story](https://peniran.com/submit)
- [Sign Up](https://peniran.com/signup)
- [Login](https://peniran.com/login)
- [Contact Email](mailto:contact@peniran.com)