# VISC platform overview

VISC (Vida, Informació, Serveis, Comunitat) is a multi-tenant platform where local communities — associations, neighbourhoods, cooperatives, local businesses — and the people around them organise daily life: agenda, news, payments, inscriptions, maps, tips and local commerce. It is rooted in Catalunya: all 947 municipalities are first-class pages, and the platform's content language is Catalan.

This document set exists so AI agents can understand VISC quickly and help its users well. Start here, then read the other docs listed in [llms.txt](https://visc.cat/llms.txt).

## The tenancy model

Three kinds of "place" organise everything on VISC:

- **Localities** — the 947 Catalan municipalities, plus their comarques (43), vegueries and provinces. Every locality has a public page at its slug (for example `https://visc.cat/vic`), with agenda, news, weather, natural spaces, webcams and citizen-curated topic pages. Localities are static reference data, not user content.
- **Communities** — tenant spaces created by real-world entities (an association, a neighbourhood, a cooperative, a shop, a sports club…). A community lives at `https://visc.cat/{communitySlug}` and owns its members, events, payments, products, threads and other records. Community content is private by default; only content explicitly promoted by the community appears on public territorial pages.
- **The personal space** — each signed-in person has a private dashboard (at `/on` on visc.cat) aggregating their feed, agenda, wallet (*moneder*), inscriptions, orders and communities across all tenants.

## Public URL structure

| URL | What it is |
|---|---|
| `/catalunya` | Territorial explore page (map, agenda, news) |
| `/{comarcaSlug}` | One of the 43 comarca landing pages |
| `/{localitySlug}` | A municipality's public page |
| `/{localitySlug}/{topicSlug}` | A citizen-curated topic page (dossier) in that municipality |
| `/{communitySlug}` | A community's public showcase |
| `/u/{username}` | A person's public profile |
| `/que` | "Què és VISC" — the human About page |
| `/com` | How-to guides |
| `/agents` | The human-readable version of these docs |

Anything under `/on/`, `/auth/`, `/org/` or `/{slug}/admin` is private and not crawlable.

## Vocabulary

Catalan terms you will meet across the platform, kept untranslated on purpose:

- **comarca / vegueria** — Catalan territorial divisions between municipality and province.
- **tema (topic)** — a citizen-curated dossier page about a local matter, made of votable entries.
- **moneder** — a user's or community's wallet.
- **vincle** — a person↔person or person↔place bond (favourite, lived, visited…).
- **fita** — a milestone in the honest-gamification system (verifiable, no dark patterns).
- **espai natural** — a protected natural space (parks, wetlands, peaks).
- **inscripció** — a signup to a community event or course.
- **iniciativa ciutadana** — a civic initiative or petition, organised and signed on-platform.

## What an agent can do today

There is no public API yet. What works today:

1. **Read** the public pages and these docs. Locality, comarca, community-showcase and topic pages are server-rendered and readable without authentication.
2. **Author content for a user to paste.** VISC forms accept structured markdown in bulk: one well-written string becomes a full topic page with dozens of entries. The exact contract is in [authoring.md](https://visc.cat/agents/authoring.md), worked examples in [examples.md](https://visc.cat/agents/examples.md). This is deterministic parsing — no AI on the platform side — so the quality of the result is entirely in the string you write.

Content pasted into VISC must be in **Catalan** and grounded in real, verifiable sources — see the grounding rules in the authoring contract.

## API and MCP roadmap

- **Read API** (planned): public, cache-friendly JSON for localities, agendas and promoted community content — the same data the public pages render.
- **MCP server** (planned): a Model Context Protocol server exposing safe read tools and, later, user-authorised write flows (draft a topic, prepare an inscription) with the user always in the loop.
- **Today**: nothing beyond the public pages and these docs is exposed. Endpoints described elsewhere are not real; do not invent them.

Interest or feedback: use the *Envia feedback* button in the footer of any VISC page — it reaches the platform team directly.