Filesystem Layout

This page documents the filesystem structure inside the Docker containers.

Container Filesystem

Path	Mode	Purpose
/data	Read-only	Project source files (mounted from host)
/artefacts	Read-write	All writable state and outputs
/config/system_prompt.md	Read-only	Domain-specific system prompt
/app	Read-only	Application code (baked into image)
/tmp	tmpfs	Temporary files (noexec, nosuid, nodev)
/run	tmpfs	Runtime ephemeral storage
/opt/venv	Read-only	Python virtual environment (workers only)

/data — Project Files

The project data directory is mounted read-only from the host. For the Karavanke project, the structure is:

/data/
└── PID_Karavanke/
    ├── A-01_Zbirni načrt/           # Master index
    │   └── 1. Obrazci/              # Title pages, index PDFs
    ├── B-01_Predor - finalna dela/  # Tunnel final works
    │   ├── 00_Tekst/                # Specifications, kampada registry (Excel)
    │   ├── 01_Situacije/            # Site plans (PDF, DWG)
    │   ├── 02_Vzdolžni prerezi/     # Longitudinal sections
    │   ├── 03_Prečni prerezi/       # Cross sections
    │   ├── 04_Detajli/              # Detail drawings
    │   ├── 05_Armaturni načrti/     # Reinforcement plans
    │   ├── 06_Opažni načrt/         # Formwork plans
    │   └── IFC/                     # BIM models
    ├── B-02_Predor - izkop in podpiranje/  # Excavation & support
    ├── B-03_Portalna zgradba - arhitektura/
    ├── B-04_Portalna zgradba - gradbene konstrukcije/
    ├── C-01_Načrt krajinske arhitekture/
    ├── C-02_Lokacije vtočkov izkopanega materiala/
    └── C-0x_...                     # Additional disciplines

Key Files

File	Location	Description
Kampada Registry	B-01_Predor - finalna dela/00_Tekst/251114_ListaKampad_Elea_zaklenjeno.xlsx	640 kampadas, 69 columns, 7 sheets
Attribute Codebook	B-01_Predor - finalna dela/00_Tekst/KAR_Kodna_knjiga_atributov_v2.9.xlsx	592 element types + 67 enumerations
Model Inventory	B-01_Predor - finalna dela/IFC/Seznam_modelov_BIM_PID.xlsx	177 IFC models

/artefacts — Writable State

All writable state is under the artefacts directory:

/artefacts/
├── state/
│   ├── auth.db                    # User authentication database
│   ├── session_registry.db        # Session slot manager database
│   └── home/
│       └── .claude/
│           ├── .credentials.json  # Anthropic credentials
│           └── projects/          # Conversation state per project
├── sessions/
│   ├── <session-key-1>/          # Session 1 outputs
│   │   ├── betonske_plosce_volumni.csv
│   │   └── ...
│   ├── <session-key-2>/          # Session 2 outputs
│   └── pending/                  # Provisioned but not yet bound
├── conversations/
│   └── export/                   # Exported conversation data
└── logs/
    └── *.jsonl                   # Transcript logs

Session Artefacts

Each session gets an isolated output directory. Files generated by the agent (CSV exports, summaries, analysis results) are saved here and accessible through the web UI's file browser.

/config — Configuration

/config/
└── system_prompt.md              # Domain knowledge and agent behavior rules

The system prompt is mounted read-only and reloaded on each query. Edit the file on the host to update agent behavior without restarting.

Volume Mounts Summary

# docker-compose.yml volume mapping
volumes:
  # Project data — read-only
  - "${DATA_PATH:-../data}:/data:ro"

  # Writable state and outputs
  - "${ARTEFACTS_PATH:-./artefacts}:/artefacts"

  # System prompt — read-only
  - "${SYSTEM_PROMPT_PATH:-./config/system_prompt.md}:/config/system_prompt.md:ro"