Rstool

Backend CI Domain CI Frontend CI RSTool CI Uptime Robot status

Concept Portal is a web application for editing RSForm schemas. The UI is a Vite React app; the API is a Django service backed by PostgreSQL.

Repository Layout

Path	Purpose
rsconcept/frontend	Portal UI. Installs @rsconcept/domain from npm.
rsconcept/backend	Django API. Python dependencies are managed by uv.
rsconcept/domain	Shared TypeScript domain package.
rsconcept/rstool	Agent-facing library and stdio wrapper.
rsconcept/rstool-mcp	MCP adapter over rstool.
scripts/dev	Local setup, sample data, and development helpers.
scripts/prod	Production update helpers.
nginx	Local and production reverse proxy configuration.

The npm packages in domain, rstool, and rstool-mcp are independently publishable. Local development uses a pnpm workspace at the repo root so @rsconcept/domain and @rsconcept/rstool resolve to in-tree sources.

Local Development

Prerequisites: Docker Desktop, Python 3.12, uv, Node.js 24, pnpm (via Corepack: corepack enable), PowerShell, and VS Code or another IDE that can use .vscode/launch.json.

1. Install dependencies (repo root, pnpm workspace):

   corepack enable
   pnpm install
   pnpm --filter @rsconcept/domain run build
   

   Or run .\scripts\dev\LocalDevSetup.ps1 (also sets up the Python backend).

2. Start the local debug stack:

   docker compose -f docker-compose-dev.yml up --build -d
   

3. Load sample data when needed:

   .\scripts\dev\PopulateDevData.ps1
   

Use .vscode/launch.json to start app configurations, run tests, and attach debuggers. GitHub Actions run linting and CI builds on push.

To update dependencies across all rsconcept projects in one shot:

.\scripts\dev\UpdateDependencies.ps1

Local production-like build

Mirrors production layout on localhost, without production secrets.

1. Place a TLS certificate (self-signed is fine) at:

   • nginx/cert/local-cert.pem
   • nginx/cert/local-key.pem

2. Start:

   docker compose -f docker-compose-prod-local.yml up --build -d
   

Grammar and npm Packages

RSLang grammar source lives in rsconcept/domain. After changing grammar files, regenerate the domain package output:

cd rsconcept/domain && pnpm run generate

After grammar or domain API changes, rebuild domain (pnpm --filter @rsconcept/domain run build) and test consumers. For npm releases, publish a new @rsconcept/domain version per PUBLISHING.md.

The npm packages are published manually from this repo:

Package	Guide
@rsconcept/domain	PUBLISHING.md
@rsconcept/rstool	PUBLISHING.md
@rsconcept/rstool-mcp	PUBLISHING.md

When dependencies change, release in order: domain -> rstool -> rstool-mcp.

External agents can install @rsconcept/rstool and follow skills/INSTALL.md. MCP-capable hosts can install @rsconcept/rstool-mcp globally and point the client at the rstool-mcp binary.

Production deployment

Runs on the live server with real secrets and public hostnames.

Secrets (under secrets/):

• db_password.txt
• django_key.txt
• email_host.txt, email_user.txt, email_password.txt

Configuration to review:

• SSL/TLS and ports: rsconcept/backend/.env.prod
• Portal and API hostnames: rsconcept/frontend/env/.env.production, nginx/production.conf
• Privacy policy PDF: rsconcept/frontend/public/privacy.pdf

TLS (Certbot):

docker compose -f docker-compose-prod.yml run --rm certbot certonly \
  --webroot --webroot-path /var/www/certbot/ \
  -d portal.acconcept.ru -d api.portal.acconcept.ru

Start:

docker compose -f docker-compose-prod.yml up --build -d

Update:

bash scripts/prod/UpdateProd.sh

Contributing

We welcome issues, discussions, and direct feedback to the maintainer.

Before opening a pull request, run the relevant Test configurations from .vscode/launch.json and use a short commit type marker:

• 🚀 F — new feature
• 🔥 B — bug fix
• 🚑 M — small fix
• 🔧 R — refactor or code cleanup
• 📝 D — documentation only
• 💬 I — infrastructure changes