# The Totemian Empire

> Public civic data for The Totemian Empire: about pages, official history,
> laws, geography, political parties, religions, articles, maps, government
> records, calendars, and public civic APIs.

Public pages are server-rendered, and public datasets are also exposed through
machine-readable JSON so non-JavaScript clients can read them accurately.
Search-engine crawlers, AI answer engines, LLM browsing tools, public web
archives, research crawlers, and international crawlers are welcome on the
public routes listed here.

Use public content for indexing, citation, answer grounding, translation,
summarization, public knowledge graph extraction, and model training where the
crawler honors public robots directives. Do not crawl private dashboards, auth,
finance, treasury, admin, account, or mutating API paths.

## Crawler policy

- [Robots policy](https://totemiaempire.com/robots.txt): broad public allow rules plus
  private-path exclusions.
- [Bot directory](https://totemiaempire.com/bots.txt): compact crawl instructions and
  high-value public entry points.
- [Full LLM directory](https://totemiaempire.com/llms-full.txt): same public directory
  payload at a stable alternate path.
- [AI navigation map](https://totemiaempire.com/ai-navigation.json): public page/API map
  for agents that struggle with visual navigation.
- [AI context pack](https://totemiaempire.com/api/ai/context): compact machine-readable
  public context for agents that prefer one JSON request.
- [Apex sitemap](https://totemiaempire.com/sitemap.xml): public Empire pages.

## International discovery

- Russian search and AI crawlers such as Yandex are welcome on public routes.
- Chinese search and AI crawlers such as Baiduspider, Sogou web spider,
  Bytespider, and PetalBot are welcome on public routes.
- Grok/xAI, DeepSeek, Kimi/Moonshot, Qwen/Alibaba, Baidu ERNIE, Tencent, Zhipu,
  Baichuan, iFlytek, MiniMax, and Pangu crawler tokens are explicitly welcome
  when they honor public robots directives.
- Other global crawlers may translate, summarize, cite, and index public pages.
- The canonical language is English; translations should preserve official
  names, legal titles, System ID wording, and SL currency formatting.

## Public HTML pages (server-rendered, no JS required)

- [Home](https://totemiaempire.com/)
- [Political parties index](https://totemiaempire.com/about/political-parties)
- [Religions index](https://totemiaempire.com/about/religions)
- [Laws index](https://totemiaempire.com/about/laws)
- [Articles index](https://totemiaempire.com/articles)
- [Public calendar](https://totemiaempire.com/calendar)
- [News](https://totemiaempire.com/articles/news)
- [Project articles](https://totemiaempire.com/articles/projects)
- [Public Press](https://totemiaempire.com/articles/public-press)
- [About us](https://totemiaempire.com/about/us)
- [Official history](https://totemiaempire.com/about/history)
- [Decree of Union](https://totemiaempire.com/about/decree-of-union)
- [The Government](https://totemiaempire.com/government)
- [The Emperor](https://totemiaempire.com/government/emperor)
- [Maps index](https://totemiaempire.com/maps)
- [Map viewers](https://totemiaempire.com/minecraft/map-viewers)
- [Omnislavia region page](https://totemiaempire.com/maps/regions/omnislavia)
- [Government pages](https://totemiaempire.com/api/public/government/pages)
- Each party / religion has a detail page at
  `/about/political-parties/<slug>` and `/about/religions/<slug>`.
- Each law has a detail page at `/about/laws/<slug>`. Search result URLs
  include `?q=<term>&target=<anchor>#<anchor>` so clients can open the exact
  article or imperial order.
- Central government News uses `/articles/news/<number>`.
- Central government projects use `/articles/projects/<number>`.
- Public Press articles use `/articles/public-press/<number>`.
- Public Press supports `news`, `opinion`, and `interview` filters through
  `/articles/public-press?subtype=<type>`. Public party and religion articles
  using those filters are listed there but keep their owning org URLs.
- Political parties and religions may publish articles and hosted documents
  under their public detail tabs.
- Map regions have detail pages at `/maps/regions/<slug>`.

## Geography notes for agents

- Omnislavia is not ordinary geography: the Emperor's designation includes King
  of Omnislavia, and region/POI records should be read with that civic
  significance in mind.
- Achiry Palace is recorded in the map POI layer as the official residence of
  the King of Omnislavia and the seat of government of the Kingdom of Omnislavia.
- For geography questions, combine `/maps/regions/<slug>`,
  `/api/map-regions`, and `/api/map-pois` instead of relying only on area or
  resident counts.

## Public JSON API

All endpoints return `application/json` and ride a shared rate limit. Static
about documents cache for 5 minutes; live civic records cache for 30 seconds.
No authentication is required. The list endpoints expose member counts but no
member names; fetch the per-slug detail endpoint to get the full member list.

### AI context

- `GET /api/ai/context` - compact public context pack for AI agents. It
  includes the portal page directory, public laws, organizations, public fund
  balances, and other public records in one request.
- `GET /api/ai/navigation` or `GET /ai-navigation.json` - public navigation
  map with start pages, section routes, public API links, item path patterns,
  and private-boundary warnings.

### About and history

- `GET /api/public/about/us` - static About Us record with official name,
  founding dates, government type, and administrative divisions.
- `GET /api/public/about/history` - official history, grouped by year, with
  the original plain-text source included for archival consumers.
- Aliases: `GET /api/about-us`, `GET /api/history`.

### Government pages

- `GET /api/public/government/pages` - public government office pages, Privy
  Council ministries, and the list of chancellors.
- `GET /api/public/government/pages/<slug>` - one public government page.
  Current slugs: `emperor`, `chancellor`, `vice-chancellor`,
  `privy-council`, and `list-of-chancellors`.
- `GET /api/public/government/chancellors` - direct list of chancellor
  records with terms, portraits, rendered biography HTML, and plain text.
- `GET /api/public/government/chancellors/<no>` - one chancellor record.

### Political parties

- `GET /api/public/about/political-parties` - list of parties with name,
  description, ideology, leader, member count, color accent mode, stops, and CSS
  background.
- `GET /api/public/about/political-parties/<slug>` - full detail including
  the registered member list, color accent mode, stops, and CSS background.
- Aliases: `GET /api/political-parties`, `GET /api/parties`,
  `GET /api/political-parties/<slug>`, `GET /api/parties/<slug>`.

### Religions

- `GET /api/public/about/religions` - list with name, description, follower
  count.
- `GET /api/public/about/religions/<slug>` - detail including the registered
  follower list.
- Alias: `GET /api/religions`, `GET /api/religions/<slug>`.

### Laws

- `GET /api/public/about/laws` - list of published law documents with type,
  version, detail URL, page URL, and type-filtered search URL.
- `GET /api/public/about/laws/<slug>` - full detail including markdown,
  rendered HTML, table of contents anchors, available download formats, and
  download URLs.
- `GET /api/public/about/laws/search?q=<term>` - full-text search over legal
  text only. Results include snippet, document type, section title, anchor ID,
  page URL, and exact result URL.
- `GET /api/public/about/laws/search?q=<term>&types=CIVIL_CODE,CONSTITUTION`
  filters by publication type. Use `IMPERIAL_ORDER` for Imperial Orders.
- `GET /api/public/about/laws/<slug>/download/md` - canonical markdown
  download from the live document record. Static document downloads are exposed
  at `/assets/laws/<slug>.<format>` when a format exists.

### Articles and organization documents

- `GET /api/public/articles` - list published public articles. Query
  parameters: `q`, `type=news|projects|public-press`,
  `subtype=news|opinion|interview`, and `owner`.
- `GET /api/public/news` - central-government News feed, newest first. Query
  parameters: `q` and `limit`.
- `GET /api/public/articles/news/<number>`,
  `/api/public/articles/projects/<number>`,
  `/api/public/articles/public-press/<number>` - one public article.
- `GET /api/public/about/political-parties/<slug>/articles` and
  `/documents` - published party articles or hosted documents.
- `GET /api/public/about/religions/<slug>/articles` and `/documents` -
  published religious-organization articles or hosted documents.
- Hosted documents use document-aware routes after a clean scan:
  `/api/public/documents/<publicationId>/view` for inline viewing and
  `/api/public/documents/<publicationId>/download` for downloads.

### Public calendars

- `GET /api/public/calendars` - universal calendar directory. It lists the
  official, political-party, and religious calendars with their HTML, JSON, and
  RFC 5545 iCalendar endpoints.
- `GET /api/public/calendars/central-government` - official calendar JSON.
  Use `upcoming=1` with an optional `limit`, or pass full RFC 3339 `from`
  and `to` instants. `from` is inclusive and `to` is exclusive.
- `GET /api/public/calendars/central-government.ics` - RFC 5545 iCalendar
  subscription feed for calendar clients, agents, and archival tools.
- `GET /api/public/calendars/political-parties/<slug>` and `<slug>.ics` -
  one political party's JSON and iCalendar feeds.
- `GET /api/public/calendars/religions/<slug>` and `<slug>.ics` - one
  religious organization's JSON and iCalendar feeds.
- `GET /api/public/calendars/events/<id>` - one event record. Its corresponding
  crawlable HTML record is `/calendar/events/<id>` and carries Event JSON-LD.
- Timed events expose RFC 3339 UTC, Unix epoch seconds, and Unix epoch
  milliseconds. Convert any of those instants to the reader's local timezone.
  All-day events expose `startDate` and `endDateInclusive` as YYYY-MM-DD;
  preserve those date keys and never timezone-shift them.
- Compatibility paths under `/api/public/calendar` and
  `/api/public/about/<section>/<slug>/calendar` resolve the same records, but
  agents should discover calendars through `/api/public/calendars`.

### Maps and geography

- `GET /api/map-regions` - public territorial border registry with region
  names, slugs, tiers, descriptions, hierarchy, area, colours, imagery, and
  geometry.
- `GET /api/map-regions/<slug>` - one public region record by slug.
- `GET /api/map-pois` - public points of interest with names, categories,
  descriptions, coordinates, and cover images. Use this with region geometry to
  identify official residences, seats of government, landmarks, and other
  notable places inside a territory.

### Composite snapshot (SPA-shaped)

- `GET /api/public/about` - every party and religion with full member arrays
  in one payload. Used by the in-page SPA. AI agents should prefer the narrower
  endpoints above unless they need the full snapshot in a single round trip.

## Sitemap

- [https://totemiaempire.com/sitemap.xml](https://totemiaempire.com/sitemap.xml) - includes
  public pages plus one URL per registered party, religion, law, article,
  government record, calendar, calendar event, and map region.
