# Fernscout dev

> JSON documents and photographs in a folder you own. Write a day yourself, or hand it to an agent. A self-hostable travel journal with an HTTP API an agent can write through, with the owner's review.

## Docs

- [Documentation for agents](https://dev.fernscout.ch/documentation.txt): what this instance is, how to get a token, and every door
- [OpenAPI v2](https://dev.fernscout.ch/api/v2/openapi.json): the API contract, generated from the schemas the server checks against

## Task guides

- [Getting a token, from nothing or from an existing journal](https://dev.fernscout.ch/skill/new-account.md): Prove an address, get a journal made, and get a token for it.
- [A journal's own settings, and deleting one](https://dev.fernscout.ch/skill/add-journal.md): Change what a journal says about itself, and delete one.
- [A trip: making one, and changing it afterwards](https://dev.fernscout.ch/skill/add-a-trip.md): Create a trip, describe who was on it, and change its own fields afterwards.
- [Writing a day: fields, correcting one, and publishing](https://dev.fernscout.ch/skill/add-a-day.md): Write one day as a draft, correct it, and put it on the site.
- [Photographs and video: attaching them, and the inbox](https://dev.fernscout.ch/skill/ingest-photos.md): Attach photographs and video to a day, or stage them before the days exist.
- [A trip's budget and what it actually cost](https://dev.fernscout.ch/skill/costs.md): A trip's budget, what it actually cost, and the rates that convert it.
- [Real postcards, in the post](https://dev.fernscout.ch/skill/send-postcards.md): Propose a printed postcard from a day — a person still has to send it.
- [Printing a photobook](https://dev.fernscout.ch/skill/make-a-photobook.md): Arrange a trip's photobook draft — size, cover, photographs. Ordering and paying stay the owner's own page.

## For schools and tour operators

- [Schools](https://dev.fernscout.ch/schools)
- [Tour operators](https://dev.fernscout.ch/tour-operators)

## Example

- [Fernscout Demo](https://dev.fernscout.ch/example): a public journal on this instance

## Optional

- [Hosting](https://dev.fernscout.ch/docs/hosting): One server with Node and Caddy. Every optional capability stays off until you configure it.
- [API](https://dev.fernscout.ch/docs/api): The v2 API, for your own agent or scripts — every endpoint, generated from the schemas the server checks against.
- [Contributing](https://dev.fernscout.ch/docs/contributing): Running the code, and what a change has to pass before it is merged.
- [Your own agent](https://dev.fernscout.ch/docs/helper): Fernscout Helper, a separate toolbox for sorting photographs and extracting costs with an agent you run yourself.
- [Where your GPS goes](https://dev.fernscout.ch/docs/guide/gps): Where your location goes: what is recorded, what is published, what never leaves your own folder, and how to export or delete it.