ATLAS

ATLAS (Astrogation, Transit & Logistics Access System) is a webapp which functions as both a SRD for a TTRPG by the same name and as an in-game tool. In the TTRPG, all players have access to a handheld interface with their ship. This interface is called ATLAS. In-game, ATLAS functions as the players number-crunching machine for communications, logistics, ship interfacing, and personal stats. Out of game, it acts as a character sheet, orchestration tool, map, and log.

Table of Contents

Development

• Personas
• Requirements
• Deployment and recovery

SRD

• ATLAS SRD

Authentication

ATLAS uses local email/password accounts. New users can register through the standard signup page, and existing locally authenticated users can be promoted to Webadmin by an operator.

Manual

The database-backed Manual uses the landing-page slug configured by Rails.configuration.x.manual.landing_page_slug. It defaults to index and can be overridden with the MANUAL_LANDING_PAGE_SLUG environment variable.

To promote an existing locally authenticated user to Webadmin, run:

bin/rails console
User.find_by!(email: "admin@example.com").update!(role: :webadmin)

Users are assigned the User role by default. Webadmins are the only users authorized to manage Manual content.

To import or export a Manual page without direct database access, use the provided scripts with a page slug and a text or Markdown file:

bin/manual-import index docs/srd/atlas-srd.md
bin/manual-export index .codex-tmp/atlas-srd-backup.md

The equivalent Rails tasks are manual:import[slug,source_path] and manual:export[slug,destination_path]. Running bin/rails db:seed creates the index landing page when needed and imports the existing SRD through the same import service.