capture-model-server

Work on Madoc TS capture model server APIs, repositories, and migration helpers. Use when modifying capture model routes, repository queries, or model migration flows in services/madoc-ts.

Jump to install

Repository: digirati-co-uk/madoc-platform
Last source activity: February 5, 2026 at 21:05
Detected SKILL.md language: English
Stars: 57
Forks: 15

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/digirati-co-uk/madoc-platform --skill capture-model-server

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

crowdsourcing-task-review-workflow

Understand and modify the full Madoc TS crowdsourcing contribution and review pipeline. Use when changing claim creation rules, crowdsourcing-task and crowdsourcing-review lifecycle behavior, reviewer assignment policy, or project settings that control submission/review flow in services/madoc-ts.

2026-05-07

frontend-site

Work on Madoc TS site UI structure, React routes, and site-specific SSR behaviors. Use when adding or updating site pages, loaders, or site theme usage in services/madoc-ts.

2026-04-14

madoc-docker-ops

Build, run, and debug the Madoc Docker/compose stack with the Docker daemon already running, including rebuilding images, starting/stopping services, inspecting containers/images, and using pm2 inside the madoc-ts container (server/queue/scheduler/auth) plus frontend rebuilds for volume-mounted assets.

2026-04-08

View all from this repository

Capture Model Server (Madoc TS)

Goal

Explain capture model server routes and repository logic so model CRUD and migration updates stay consistent.

Scope

Capture model server routes and router table

Capture model repository queries and helpers

Server-side model filters and migrations

Non-scope

Frontend capture model editor UI

Extension registration outside capture model server

Unrelated route handlers

Key Entry Points

services/madoc-ts/src/capture-model-server/router.ts

services/madoc-ts/src/capture-model-server/capture-model-repository.ts

services/madoc-ts/src/capture-model-server/routes/

services/madoc-ts/src/capture-model-server/migration/

services/madoc-ts/src/capture-model-server/server-filters/

Architecture Summary (Based on Source)

router.ts maps capture model API endpoints under /api/madoc/crowdsourcing/*.

CaptureModelRepository contains the core Slonik queries for models, documents, structures, and revisions.

Server filters shape model payloads and migration helpers support legacy API transitions.

Quick Start Workflow

Review services/madoc-ts/src/capture-model-server/router.ts to locate the endpoint you are changing.

Inspect the relevant route handler in services/madoc-ts/src/capture-model-server/routes/.

Update repository queries in capture-model-repository.ts if data shape changes.

Common Tasks

Add a new capture model route

Adjust model/revision query shapes

Update model migration behavior

Pitfalls

Returning inconsistent model shapes between routes

Skipping repository helpers when a shared query exists

Changing migration paths without updating router mappings

Suggested Checks

Fetch a capture model and revision list

Run a model migration endpoint in dev

name	capture-model-server
description	Work on Madoc TS capture model server APIs, repositories, and migration helpers. Use when modifying capture model routes, repository queries, or model migration flows in services/madoc-ts.