Repository README index
Names vs URLs: the customer-facing product is Prego; the public site is www.pregoi.com; the legal entity is iPrego Pte Ltd; GitHub repositories for this program live under the Pregoi organization. See Product naming & identities.
Use this table to jump from this docs site to the entry README (and a few high-signal sub-docs) in each repository. Aligns with the repo responsibility matrix.
GitHub base URL: links below use https://github.com/Pregoi/… for production (same as this site’s edit link). Forks: replace the Pregoi owner segment with your org.
Core application & docs
| Repository | Layer | README | Notes |
|---|---|---|---|
| Prego | UI monorepo + internal Starlight docs | README | AGENTS.md; platform under docs/src/content/docs/platform/. Workspace index packages/README.md. Shared Zod: @platform/web-auth-schemas (packages/prego-web-auth-schemas), @platform/contracts (packages/contracts); Next tsconfig CLI @platform/next-dev-scripts (packages/prego-next-dev-scripts); CI web-auth-schemas.yml, next-dev-scripts.yml (@platform/next-dev-scripts); workflows index README. Root pnpm run build:verify (shared packages + build:docs). Internal Starlight docs/ = MDX — docs/README.md · Dependency inspection §7. pnpm run build:docs or cd docs && pnpm run build. Missing chunks under docs/dist (e.g. renderers.mjs): pnpm run build:docs:clean — AGENTS.md. |
| prego_docs | User-facing docs site | README | AGENTS.md; .cursor/rules/prego-platform-docs-pointer.mdc. Engineering narrative links to this platform hub. |
Gateway & extended runtimes
| Repository | Layer | README | Extra |
|---|---|---|---|
| prego-zuplo | API gateway | README | AGENTS.md; Dev Portal / docs README; OpenAPI folder; OAS layout history (fragment renames); Operator runbook — CORS / origins / x-trace-id |
| prego_ai | Worker runtime (Hono) | README | AGENTS.md; deployment / KV; local docs/ for architecture, OpenAPI, env. Phase 2: optional CP connector read + optional KV CACHE erp_cred: (ERP_CREDENTIAL_KV_PREFIX) + ref — connector slots. |
| prego-control-plane | Orchestration Worker | README | AGENTS.md; routes table, D1 migrations, Stripe/provision. Phase 2: D1 0029, internal GET /internal/tenants-directory / PATCH /internal/tenant-connector-metadata; operators set connector_credential_ref here and key material in prego_ai KV — connector slots · prego_ai KV runbook. |
Domain & runtime images
| Repository | Layer | README | Extra |
|---|---|---|---|
| prego_saas | Frappe / ERP domain | README | AGENTS.md; docs/README (bench, contributing) |
| prego-docker | Container images | README | AGENTS.md; apps.json, CI, multi-arch. |
Infrastructure automation
| Repository | Layer | README | Extra |
|---|---|---|---|
| prego-pulumi | IaC | README | AGENTS.md; stacks, Cloudflare / Hetzner. |
| prego-ansible | Provisioning | README | AGENTS.md; playbooks, inventory examples. |
Cursor / IDE agents
Satellite repos (prego-zuplo, prego_ai, prego-control-plane, prego-ansible, prego-pulumi, prego-docker, prego_saas, prego_docs) each include .cursor/rules/prego-platform-docs-pointer.mdc (alwaysApply: true) and root AGENTS.md with GitHub links to this platform documentation, so multi-root workspaces still load the checklist without opening the Prego monorepo folder. The Prego monorepo uses the fuller .cursor/rules/prego-multi-repo-platform.mdc plus root AGENTS.md.
한국어
Phase 2 (멀티 ERP 커넥터): 위 표 Gateway & extended runtimes 절의 prego_ai / prego-control-plane Extra 열 요약 — 계약·운영 흐름은 connector slots를 본다.
위 표는 각 레포의 README 진입점과 Zuplo OpenAPI·Frappe docs/README 같이 자주 보는 문서로 바로 가기 위한 것입니다. 운영 기본 org는 Pregoi; 포크나 다른 GitHub 조직을 쓰면 URL의 owner 부분을 맞게 바꿉니다. Cursor: 위성 레포(prego-zuplo, prego_ai, control-plane, ansible, pulumi, docker, prego_saas, prego_docs)에는 .cursor/rules/prego-platform-docs-pointer.mdc와 루트 AGENTS.md가 있어 플랫폼 문서 링크가 자동으로 붙습니다. Prego 내부 Starlight docs 는 MDX — docs/README.md. docs/dist chunk 오류로 실패하면(예: renderers.mjs) 루트 pnpm run build:docs:clean — AGENTS.md. prego-zuplo OpenAPI 조각 번호·구 파일명: OAS layout history (oas-manifest.json 이 병합 순서의 단일 소스).