From 3d5f8e68f9816f35acebd61db6f6cb4822764bc4 Mon Sep 17 00:00:00 2001 From: nfel Date: Fri, 28 Aug 2026 14:59:42 +0330 Subject: [PATCH] docs: add workspace clone commands --- README.md | 41 +++++++++++++++++++++++++++++++++++++++++ REFACTORING-TODO.md | 1 + 2 files changed, 42 insertions(+) diff --git a/README.md b/README.md index 2132058..4d9a6f1 100644 --- a/README.md +++ b/README.md @@ -28,6 +28,47 @@ Multi-service monorepo for the Darano financial/crypto platform. - [overmind](https://github.com/DarthSim/overmind) or [foreman](https://github.com/ddollar/foreman) — Procfile runner - PostgreSQL 16, Redis, RabbitMQ running locally (or via Docker) +## Clone the Workspace + +The Darano workspace is an aggregate of independent Git repositories. These +commands reproduce the current directory layout and select the branches used by +this refactor. They expect the local branches to have been pushed first and +require SSH access to `git.darano.ir` (except `dev-procfile`, which uses HTTPS). + +```bash +mkdir darano +cd darano + +git clone --branch feat/refactor-v1 git@git.darano.ir:Kahroba/AdminPanel.git AdminPanel +git clone --branch m2 git@git.darano.ir:Kahroba/DevOps.git DevOps +git clone --branch dev git@git.darano.ir:Kahroba/GL.git GL +git clone --branch main git@git.darano.ir:KuknosNode/Scripts.git Kuknos-Node-scripts +git clone --branch dev git@git.darano.ir:Kahroba/alert.git alert +git clone --branch main git@git.darano.ir:Kahroba/api.git api +git clone --branch feat/refactor-v1 git@git.darano.ir:Kahroba/auth.git auth +git clone --branch main https://git.darano.ir/Kahroba/dev-procfile.git dev-procfile +git clone --branch dev git@git.darano.ir:Kahroba/docs.git docs +git clone --branch feat/refactor-v1 git@git.darano.ir:Kahroba/proto.git proto +git clone --branch fix/contact-us git@git.darano.ir:Kahroba/ui.git ui +git clone --branch feat/refactor-v1 git@git.darano.ir:Kahroba/wallet.git wallet +``` + +`private-chain/` is not included because the current local repository has no +`origin` remote configured. + +Recreate the root documentation links after cloning: + +```bash +ln -s dev-procfile/AGENTS.md AGENTS.md +ln -s dev-procfile/CLAUDE.md CLAUDE.md +ln -s dev-procfile/README-REFACTORING.md README-REFACTORING.md +ln -s dev-procfile/README.md README.md +ln -s dev-procfile/REFACTORING-AUDIT.md REFACTORING-AUDIT.md +ln -s dev-procfile/REFACTORING-PLAN.md REFACTORING-PLAN.md +ln -s dev-procfile/REFACTORING-TODO.md REFACTORING-TODO.md +ln -s dev-procfile/گزارش-زیرساخت-توکنسازی-دارانو.md گزارش-زیرساخت-توکنسازی-دارانو.md +``` + ## Infrastructure Start the shared infrastructure (Postgres, Redis, RabbitMQ, MinIO): diff --git a/REFACTORING-TODO.md b/REFACTORING-TODO.md index fe08e25..4725426 100644 --- a/REFACTORING-TODO.md +++ b/REFACTORING-TODO.md @@ -97,6 +97,7 @@ This is the authoritative execution tracker for the refactor. Work is performed | T008 | `DONE` | Execute full Docker image builds for every in-scope Go service. | GL passes and produced image `sha256:717c75dfa91f843acdb8d56b4dd111224e5ee45d060dcd4731e5d472ff2c8f69`; API, Auth, and Wallet are blocked in `go mod download` by repeated 300-second `504 Gateway Timeout` responses from `go.reg.darano.ir` for `google.golang.org/api` metadata. | | T009 | `DONE` | Add Gitea CI/CD configuration to GL. | Seven action/workflow YAML files parse successfully; the exact buildx action produced both GL OCI tags using the mandated proxy; committed as `675def5`. | | T010 | `DONE` | Commit outstanding workspace work and centralize root Markdown files in `dev-procfile` with root symlinks. | Pending work committed in DevOps (`665fd6b`), docs (`2c49a92`), Kuknos Node scripts (`c114c13`), and proto (`c778fda`); all eight root Markdown paths resolve through relative symlinks to tracked files in `dev-procfile`. | +| T011 | `DONE` | Document commands for cloning the complete Darano workspace on another machine. | `README.md` now has copy-paste commands for all 12 repositories with configured origins, pins the current branches, recreates all eight root Markdown symlinks, and identifies `private-chain` as lacking a clone URL. | ## Phase 2 — `auth` architecture