RELab v0.2.0

.cspell.yml

@@ -0,0 +1,120 @@
+version: "0.2"
+dictionaries:
+  - coding-terms
+  - cpp-compound-words
+  - data-science
+  - docker
+  - en-gb
+  - en-us
+  - filetypes
+  - fullstack
+  - npm
+  - python
+  - python-common
+  - software-tools
+enabled: true
+enabledFileTypes:
+  "*": true
+dot: true
+useGitignore: true
+cache:
+  useCache: true
+  cacheStrategy: content
+ignorePaths:
+  - .cspell.yml
+  - .cspellcache
+  - .devcontainer
+  - .dockerignore
+  - .git
+  - .gitignore
+  - .trivyignore
+  - .vscode
+  - package-lock.json
+  - pnpm-lock.yaml
+  - uv.lock
+  - backend/app/api/auth/resources/disposable_email_domains.txt
+  - frontend-app/src/assets/data/**
+  - frontend-app/src/types/api.generated.ts
+
+language: en_us
+words:
+  # Proper nouns
+  - Donati
+  - Lierde
+  - RELab
+
+  # Font names
+  - grotesk
+
+  # Technical terms
+  - linkinator
+  - LogQL
+  - mpegurl
+  - nosniff
+  - OTLP
+  - shellcheck
+  - subrepo
+  - subrepos
+  - trivyignores
+  - trixie
+  - tsvector
+
+  # Miscellaneous
+  - orcid
+  - refurbishers
+  - remanufacturability
+  - remanufacturable
+  - repairability
+  - zenodo
+
+ignoreWords:
+  - USEPOLLING
+
+overrides:
+  - filename: "{backend,docs}/**"
+    words:
+      # Model terms
+      - categorymateriallink
+      - categoryproducttypelink
+      - circularityproperties
+      - fileparenttype
+      - imageparenttype
+      - materialproductlink
+      - newslettersubscriber
+      - organizationrole
+      - oauthaccount
+      - physicalproperties
+      - producttype
+      - subcomponent
+      - subcomponents
+      - supercategory
+      - taxonomydomain
+
+  - filename: "backend/**"
+    words:
+      # Technical terms
+      - instrumentor
+      - instrumentors
+      - piexif
+      - PYTHONDONTWRITEBYTECODE
+      - PYTHONUNBUFFERED
+      - primaryjoin
+      - selectinload
+      - tsquery
+      - uninstrument
+      - xdist
+      - zxcvbn
+
+  - filename: "docs/**"
+    words:
+      - RTMP
+      - HIBP
+
+  - filename: "frontend-app/**"
+    words:
+      # Technical terms
+      - ellipsize
+      - pressable
+      - pressables
+      - refetches
+      - worklets

.devcontainer/backend/devcontainer.json

@@ -1,37 +1,26 @@
 {
   "name": "relab-backend",
-  "dockerComposeFile": ["../../compose.yml", "../../compose.override.yml"],
-  "service": "backend",
-  "runServices": ["backend"],
+  "dockerComposeFile": ["../../compose.yml", "../../compose.dev.yml"],
+  "service": "api",
+  "runServices": ["api", "redis", "postgres"],
   "workspaceFolder": "/opt/relab/backend",
-  // The local workspace is mounted in /opt/relab for git integration
   "mounts": ["source=${localWorkspaceFolder},target=/opt/relab,type=bind,consistency=cached"],
   "overrideCommand": true,
-  "postCreateCommand": "",
-  "postAttachCommand": "echo '🚀 Backend dev container ready!\\n💡 To start the FastAPI dev server, run: fastapi dev\\n🔄 If that fails, try: uv run fastapi dev\\n🌐 The server will be available at http://localhost:8011 (forwarded port)'",
+  "postAttachCommand": "echo 'RELab backend devcontainer ready.\\nUse this for focused backend work; the root full-stack container is the default onboarding path.\\nRun just install if needed, then just dev or just check.\\nAPI: http://localhost:8011'",
   "features": {
     "ghcr.io/devcontainers/features/git:1": {}
   },
   "customizations": {
     "vscode": {
-      "extensions": ["charliermarsh.ruff", "ms-python.python", "wholroyd.jinja"],
       "settings": {
-        "[python][notebook]": {
-          "editor.codeActionsOnSave": {
-            "source.fixAll": "explicit",
-            "source.organizeImports": "explicit"
-          },
-          "editor.defaultFormatter": "charliermarsh.ruff"
+        "python.defaultInterpreterPath": "${containerWorkspaceFolder}/.venv/bin/python",
+        "ty.configuration": {
+          "environment": {
+            "root": ["${containerWorkspaceFolder}"],
+            "python": "${containerWorkspaceFolder}/.venv/"
+          }
         },
-        "editor.formatOnSave": true,
-        "python-envs.terminal.showActivateButton": true,
-        "python.analysis.autoFormatStrings": true,
-        "python.analysis.typeCheckingMode": "standard",
-        "python.linting.enabled": true,
-        "python.linting.ruffEnabled": true,
-        "python.terminal.activateEnvInCurrentTerminal": true,
-        "python.terminal.activateEnvironment": true,
-        "python.testing.pytestEnabled": true
+        "ty.interpreter": ["${containerWorkspaceFolder}/.venv/bin/python"]
       }
     }
   }

.devcontainer/devcontainer.json

@@ -1,74 +1,14 @@
 {
   "name": "relab-fullstack",
-  "dockerComposeFile": ["../compose.yml", "../compose.override.yml"],
-  "service": "frontend-web",
+  "dockerComposeFile": ["../compose.yml", "../compose.dev.yml"],
+  "service": "app-site",
+  "runServices": ["api", "redis", "postgres", "docs-site", "web-site", "app-site"],
   "workspaceFolder": "/opt/relab",
   "mounts": ["source=${localWorkspaceFolder},target=/opt/relab,type=bind,consistency=cached"],
   "features": {
     "ghcr.io/devcontainers/features/git:1": {},
     "ghcr.io/devcontainers-extra/features/expo-cli:1": {},
     "ghcr.io/jsburckhardt/devcontainer-features/uv:1": {}
   },
-  "postAttachCommand": "echo '🚀 Fullstack dev container ready!\\n💡 Frontend: http://localhost:8010\\n💡 Backend: http://localhost:8011\\n💡 Docs: http://localhost:8012 (all forwarded ports)'",
-  "customizations": {
-    "vscode": {
-      "extensions": [
-        // Frontend
-        "msjsdiag.vscode-react-native",
-        "christian-kohler.npm-intellisense",
-        "esbenp.prettier-vscode",
-        "dbaeumer.vscode-eslint",
-        "expo.vscode-expo-tools",
-        // Backend
-        "charliermarsh.ruff",
-        "ms-python.python",
-        "wholroyd.jinja",
-        // Docs
-        "bierner.markdown-mermaid",
-        "bierner.markdown-preview-github-styles",
-        "DavidAnson.vscode-markdownlint",
-        "shd101wyy.markdown-preview-enhanced",
-        "yzhang.markdown-all-in-one"
-      ],
-      "settings": {
-        // Frontend
-        "[javascript][typescript][javascriptreact][typescriptreact]": {
-          "editor.codeActionsOnSave": {
-            "source.fixAll.eslint": "always",
-            "source.organizeImports": "explicit"
-          },
-          "editor.defaultFormatter": "esbenp.prettier-vscode"
-        },
-        "eslint.format.enable": true,
-        "eslint.lintTask.enable": true,
-        "eslint.run": "onSave",
-        // Backend
-        "[python][notebook]": {
-          "editor.codeActionsOnSave": {
-            "source.fixAll": "explicit",
-            "source.organizeImports": "explicit"
-          },
-          "editor.defaultFormatter": "charliermarsh.ruff"
-        },
-        "python.analysis.typeCheckingMode": "standard",
-        "python.linting.enabled": true,
-        "python.linting.ruffEnabled": true,
-        "python.terminal.activateEnvInCurrentTerminal": true,
-        "python.terminal.activateEnvironment": true,
-        "python.testing.pytestEnabled": true,
-        // Docs
-        "[markdown]": {
-          "editor.defaultFormatter": "DavidAnson.vscode-markdownlint"
-        },
-        "editor.formatOnSave": true,
-        "github.copilot.enable": {
-          "markdown": true
-        },
-        "markdown.extension.completion.enabled": true,
-        "markdown.extension.orderedList.marker": "one",
-        "markdown.extension.tableFormatter.normalizeIndentation": true,
-        "markdown.extension.theming.decoration.renderTrailingSpace": true
-      }
-    }
-  }
+  "postAttachCommand": "echo 'RELab full-stack devcontainer ready.\\nPrimary workflow: run just install once, then use just dev / just ci from the repo root.\\nPlatform: http://localhost:8010\\nAPI: http://localhost:8011\\nDocs: http://localhost:8012\\nApp: http://localhost:8013'"
 }

.devcontainer/docs/devcontainer.json

@@ -1,44 +1,13 @@
 {
   "name": "relab-docs",
-  "dockerComposeFile": ["../../compose.yml", "../../compose.override.yml"],
-  "service": "docs",
-  "runServices": ["docs"],
+  "dockerComposeFile": ["../../compose.yml", "../../compose.dev.yml"],
+  "service": "docs-site",
+  "runServices": ["docs-site"],
   "workspaceFolder": "/opt/relab/docs",
-  /*
-    NOTE: The non-trivial mount setup to allow live reload and git:
-
-      [Devcontainer: /opt/relab/docs]  ⇄  [Local ./docs]  ⇄  [Devcontainer: /docs]
-
-    - Edit in git-integrated /opt/relab/docs (devcontainer) → updates local ./docs
-    - MkDocs in the devcontainer live reloads /docs (synced from local ./docs)
-  */
   "mounts": ["source=${localWorkspaceFolder},target=/opt/relab,type=bind,consistency=cached"],
+  "postAttachCommand": "echo 'RELab docs devcontainer ready.\\nUse this for focused docs work; the root full-stack container is the default onboarding path.\\nRun just install if needed, then just dev or just check.\\nDocs: http://localhost:8012'",
   "features": {
     "ghcr.io/cirolosapio/devcontainers-features/alpine-bash:0": {},
     "ghcr.io/devcontainers/features/git:1": {}
-  },
-  "customizations": {
-    "vscode": {
-      "extensions": [
-        "bierner.markdown-mermaid",
-        "bierner.markdown-preview-github-styles",
-        "DavidAnson.vscode-markdownlint",
-        "shd101wyy.markdown-preview-enhanced",
-        "yzhang.markdown-all-in-one"
-      ]
-    },
-    "settings": {
-      "[markdown]": {
-        "editor.defaultFormatter": "DavidAnson.vscode-markdownlint"
-      },
-      "editor.formatOnSave": true,
-      "github.copilot.enable": {
-        "markdown": true
-      },
-      "markdown.extension.completion.enabled": true,
-      "markdown.extension.orderedList.marker": "one",
-      "markdown.extension.tableFormatter.normalizeIndentation": true,
-      "markdown.extension.theming.decoration.renderTrailingSpace": true
-    }
   }
 }

.devcontainer/frontend-app/devcontainer.json

@@ -0,0 +1,14 @@
+{
+  "name": "relab-frontend-app",
+  "dockerComposeFile": ["../../compose.yml", "../../compose.dev.yml"],
+  "service": "app-site",
+  "runServices": ["app-site"],
+  "workspaceFolder": "/opt/relab/frontend-app",
+  "mounts": ["source=${localWorkspaceFolder},target=/opt/relab,type=bind,consistency=cached"],
+  "overrideCommand": true,
+  "postAttachCommand": "echo 'RELab app devcontainer ready.\\nUse this for focused app work; the root full-stack container is the default onboarding path.\\nRun just install if needed, then just dev or just check.\\nApp: http://localhost:8013'",
+  "features": {
+    "ghcr.io/devcontainers/features/git:1": {},
+    "ghcr.io/devcontainers-extra/features/expo-cli:1": {}
+  }
+}

.devcontainer/frontend-web/devcontainer.json

@@ -0,0 +1,13 @@
+{
+  "name": "relab-frontend-web",
+  "dockerComposeFile": ["../../compose.yml", "../../compose.dev.yml"],
+  "service": "web-site",
+  "runServices": ["web-site"],
+  "workspaceFolder": "/opt/relab/frontend-web",
+  "mounts": ["source=${localWorkspaceFolder},target=/opt/relab,type=bind,consistency=cached"],
+  "overrideCommand": true,
+  "postAttachCommand": "echo 'RELab web devcontainer ready.\\nUse this for focused web work; the root full-stack container is the default onboarding path.\\nRun just install if needed, then just dev or just check.\\nWeb: http://localhost:8010'",
+  "features": {
+    "ghcr.io/devcontainers/features/git:1": {}
+  }
+}