sync SVN r18163
This commit is contained in:
@@ -5,133 +5,90 @@ description: Fluxul de commit si sincronizare pentru biblioteca partajata COMUN
|
|||||||
|
|
||||||
# Commit si sincronizare in COMUN (SVN + git)
|
# Commit si sincronizare in COMUN (SVN + git)
|
||||||
|
|
||||||
SVN = sursa de adevar. git = oglinda. Pe `main` din COMUN scrie **doar** `roa_sync`. Comenzile le
|
SVN = sursa de adevar. git = oglinda. Pe `main` din COMUN scrie **doar** `roa_sync`. Nimic nu se
|
||||||
rulezi tu; utilizatorul doar aproba - dar nimic nu se comite fara un "da" explicit de la el.
|
comite fara un "da" explicit de la utilizator.
|
||||||
|
|
||||||
## SVN sau git: decizia NU se face manual
|
## Fluxul complet (comenzi, in ordinea asta)
|
||||||
|
|
||||||
Regula de baza: **in proiectul ROA si in COMUN, fisierele sursa (`.prg`, `.md`, `.ps1`, `.sql`,
|
|
||||||
`.bat`, `AGENTS.md`, `.vcx/.scx`, `.vc2/.sc2`) sunt SVN-tracked.** `git commit` se foloseste doar
|
|
||||||
pentru fisiere care NU sunt in SVN (`.gitignore`, `.gitattributes`, fisiere generate). Nu ghici -
|
|
||||||
verifici inainte de orice commit, cu o singura comanda:
|
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
svn info "<cale_fisier>" >$null 2>&1
|
# 0. radacina proiectului - o cauti, nu o hardcodezi (urci pana gasesti roa_sync.bat)
|
||||||
if ($?) { 'SVN -> svn commit' } else { 'git -> git commit' }
|
$Root = (Get-Location).Path
|
||||||
|
while ($Root -and -not (Test-Path (Join-Path $Root 'roa_sync.bat'))) { $Root = Split-Path $Root }
|
||||||
|
|
||||||
|
# 1. ce e de comis
|
||||||
|
svn status "$Root" # M/A/D = de comis in SVN; ? = neversionat
|
||||||
|
git -C "$Root" status --short # oglinda (doar informativ)
|
||||||
|
|
||||||
|
# 2. arata lista de fisiere + mesajul utilizatorului; astepti "da". Fara "da", nu comiti.
|
||||||
```
|
```
|
||||||
|
|
||||||
Decizia pe `svn status <cale>`:
|
Decizia **SVN vs git** per fisier - o da comanda, nu o alegi tu:
|
||||||
- `M` / `A` / `D` -> SVN -> `svn commit` (niciodata `git commit`).
|
|
||||||
- `?` (neversionat) -> daca e sursa care trebuie sa circule la clienti -> `svn add` apoi
|
|
||||||
`svn commit`; daca e local/transient (handoff, plan, `.patch`, `.gitignore`) -> NU se comite.
|
|
||||||
|
|
||||||
Ce e de comis, descoperit cu comenzi (nu din memorie):
|
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
svn status <proiect_sau_COMUN> # M/A/D = de comis in SVN; ? = neversionat
|
svn info "<cale_fisier>" *> $null
|
||||||
git -C <repo> status --short # doar oglinda; nu comiti aici fisierele SVN-tracked
|
if ($?) { 'SVN -> svn commit' } else { 'git -> doar fisiere care NU sunt in SVN (.gitignore etc.)' }
|
||||||
```
|
```
|
||||||
|
|
||||||
Cazul care a muscat: `AGENTS.md` e SVN-tracked (`svn/ROA/ROAFACTURARE/Trunk/AGENTS.md`). Comis cu
|
Commit (dupa "da"), tintit:
|
||||||
`git commit`, creeaza un commit "non-sync" (nu l-a produs `roa_sync`) si lasa SVN-ul in urma ->
|
|
||||||
alt calculator nu primeste schimbarea prin `svn update`. Se repara: `git reset <ultim_sync>` +
|
|
||||||
`svn commit AGENTS.md` + `roa_sync.bat` + `git push --force` (doar daca commit-ul non-sync era deja
|
|
||||||
impins).
|
|
||||||
|
|
||||||
## Cand se foloseste
|
|
||||||
|
|
||||||
- "am terminat, dau commit", "vreau sa comit in COMUN", "comit ce am lucrat";
|
|
||||||
- "sincronizeaza cu SVN", "adu ce au facut altii", "ruleaza roa_sync", "de ce am conflicte";
|
|
||||||
- intrarea intr-o sesiune de lucru in proiect (sync de inceput).
|
|
||||||
|
|
||||||
Nu se aplica altui repo decat COMUN + proiectul care il contine. Pentru editarea codului VFP
|
|
||||||
(`.vcx`/`.scx` prin `.vc2`/`.sc2`) vezi skill-ul `roa-vfp-text-edit`.
|
|
||||||
|
|
||||||
## Pasi
|
|
||||||
|
|
||||||
Arbore de decizie - opreste-te la primul caz care se potriveste.
|
|
||||||
|
|
||||||
1. **Intri in proiect** -> rulezi `roa_sync.bat`, fara sa intrebi, DOAR daca `svn status` si
|
|
||||||
`git status` sunt curate. Daca nu sunt, intrebi intai (pot fi modificari nefinalizate ale
|
|
||||||
altcuiva).
|
|
||||||
2. **Ai editat `.prg` / `.md` / `.ps1` / `.sql`** (proiect sau COMUN) -> antetul la zi, testul
|
|
||||||
rulat, diff-ul scris ca fisier in `docs\`.
|
|
||||||
3. **Ai editat `.vc2` / `.sc2`** -> `txt2vcx.ps1` IMEDIAT, apoi verifici pe binar (reconversie
|
|
||||||
intr-un cache temporar + comparatie; mtime nu dovedeste nimic). Text fara write-back =
|
|
||||||
modificarea nu exista. Abia apoi antet / test / diff.
|
|
||||||
4. **Ceri aprobarea, explicit si complet**: lista fisierelor de comis + mesajul propus. Nu
|
|
||||||
presupune "da" din tacere si nu amana pentru "mai tarziu" - el nu tine minte pasul, tu il tii.
|
|
||||||
5. **A zis "da"** -> rulezi tu `svn commit` **tintit**, doar fisierele aprobate, cu comenzile
|
|
||||||
exacte (nu le alegi tu - le rulezi asa):
|
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
# fisiere noi -> intai svn add
|
svn add <fisier-nou> # doar fisierele '?' din svn status
|
||||||
svn add <fisier1> <fisier2>
|
svn commit <fisier1> <fisier2> -m "<mesaj>" # .prg/.md/.ps1/.sql/.scx+.sct; NU .sc2, NU tot COMUN
|
||||||
# commit tintit: .prg / .md / .ps1 / .sql / .scx + .sct - niciodata .sc2, niciodata tot COMUN
|
|
||||||
svn commit <fisier1> <fisier2> -m "<mesaj>"
|
|
||||||
```
|
```
|
||||||
6. **Imediat dupa** -> `roa_sync.bat`. Raportezi revizia SVN si ce a intrat pe `main`.
|
|
||||||
7. **A zis "nu" / cere modificari** -> nu comiti, nu insisti, nu rulezi `roa_sync`. Lucrarea
|
|
||||||
ramane necomisa pe disc si o raportezi asa la predarea contextului.
|
|
||||||
|
|
||||||
### Cazuri
|
Sync, imediat dupa orice `svn commit`:
|
||||||
|
|
||||||
- **Vrei sa-ti tii munca in git** -> branch. In repo-ul proiectului: liber. In COMUN:
|
```powershell
|
||||||
`claude/<subiect>`, commit doar acolo, niciodata pe `main`.
|
& (Join-Path $Root 'roa_sync.bat')
|
||||||
- **Ai terminat branch-ul** -> proiect: merge in `main`, normal. COMUN: **fara merge**; dupa
|
```
|
||||||
`svn commit` continutul ajunge pe `main` ca `sync SVN rN`, iar branch-ul se sterge (doar daca
|
|
||||||
`git diff main..branch` e gol).
|
|
||||||
- **Esti pe branch in COMUN si te bate gandul la `roa_sync`** -> nu. `roa_sync` se ruleaza in
|
|
||||||
exact doua momente: la intrarea in proiect si imediat dupa `svn commit`. Pe branch cu tree
|
|
||||||
curat face `checkout main` fara sa intrebe (binarele raman de pe branch); pe branch murdar
|
|
||||||
sare peste, dar `svn update` de la pasul 1 ruleaza oricum si poate aduce binare peste ce ai
|
|
||||||
pe disc.
|
|
||||||
- **Vrei `svn update`** -> doar din stare curata, niciodata in mijlocul lucrului. Daca ai text
|
|
||||||
`.??2` editat fara write-back, fa intai write-back-ul.
|
|
||||||
- **`svn update` a dat conflict** -> opreste-te si raporteaza; binarele nu se rezolva manual.
|
|
||||||
- **Dupa `svn update` git arata fisiere modificate** -> e oglinda ramasa in urma, nu munca ta;
|
|
||||||
nu le comite de mana, le ia `roa_sync` intr-un `sync SVN rN`.
|
|
||||||
- **Vrei sa aduci ce au facut altii** -> `roa_sync.bat`. **Niciodata `git pull`**: git poarta
|
|
||||||
doar textele, nu binarele; un pull da `.sc2` nou peste `.scx/.sct` vechi, VFP compileaza
|
|
||||||
binarul, iar urmatorul `git_sync` sterge modificarea.
|
|
||||||
- **Copie de COMUN ramasa in urma** -> se aliniaza singura la primul `roa_sync.bat` rulat acolo.
|
|
||||||
- **Predai contextul** -> raporteaza explicit daca ai lasat text `.??2` editat fara write-back
|
|
||||||
(stare periculoasa).
|
|
||||||
|
|
||||||
## Interzis
|
## Reguli nenegociabile
|
||||||
|
|
||||||
- `git commit` / `git push` / `git merge` pe `main` in COMUN.
|
- **SVN = sursa de adevar.** Fisierele sursa (`.prg .md .ps1 .sql .bat AGENTS.md .vcx/.scx
|
||||||
- `git pull` in COMUN - aduce textele fara binare; se foloseste `roa_sync.bat`.
|
.vc2/.sc2`) sunt SVN-tracked -> `svn commit`, niciodata `git commit`.
|
||||||
- `git commit` pe tot COMUN sau pe `.sc2` - doar tintit, pe fisierele aprobate.
|
- **`git pull` in COMUN = interzis** (aduce textele fara binare). In loc: `roa_sync.bat`.
|
||||||
- Copierea unui fisier dintr-o copie de COMUN in alta - `svn update` il duce; copierea =
|
- **Pe `main` din COMUN scrie doar `roa_sync`.** Si in repo-ul proiectului, munca merge prin SVN,
|
||||||
intrare dubla.
|
nu direct in git.
|
||||||
- Write-back pe `.fr2` / `.mn2` / `.lb2` / `.pj2` - nesuportat; acolo se modifica in IDE.
|
- **`roa_sync.bat` doar in doua momente**: la intrarea in proiect si imediat dupa `svn commit`.
|
||||||
- Commit fara un "da" explicit de la utilizator.
|
Nu pe tree murdar, nu in mijlocul lucrului.
|
||||||
|
- **`.vc2/.sc2` editat -> `txt2vcx.ps1` INAINTE de commit** (write-back pe binar; skill
|
||||||
|
`roa-vfp-text-edit`). Text fara write-back = modificarea nu exista.
|
||||||
|
|
||||||
## Criterii de acceptare si dovada
|
## Cazuri
|
||||||
|
|
||||||
Fara dovada da/nu de mai jos, commit-ul/sincronizarea NU se raporteaza ca terminata. "Arata
|
- **Branch in repo-ul proiectului**: liber. In COMUN: `claude/<subiect>`, niciodata pe `main`.
|
||||||
bine" nu e dovada.
|
- **Branch COMUN terminat**: fara merge; dupa `svn commit` continutul intra pe `main` ca
|
||||||
|
`sync SVN rN`, branch-ul se sterge (doar daca `git diff main..branch` e gol).
|
||||||
|
- **`svn update` a dat conflict**: opreste-te si raporteaza (binarele nu se rezolva manual).
|
||||||
|
- **Dupa `svn update`, git arata fisiere modificate**: e oglinda ramasa in urma; le ia `roa_sync`,
|
||||||
|
nu le comiti de mana.
|
||||||
|
|
||||||
1. Inainte de commit: `git status --porcelain` contine EXACT fisierele aprobate; nimic
|
## Repararea unui commit non-sync (ex. `AGENTS.md` comis cu `git commit`)
|
||||||
neasteptat stagiat.
|
|
||||||
2. Dupa `svn commit`: `svn status` curat pe fisierele tintite, iar revizia SVN este raportata.
|
`AGENTS.md` e SVN-tracked; comis cu `git commit` devine commit "non-sync" (nu l-a produs
|
||||||
3. Dupa commit: `roa_sync.bat` a rulat si raporteaza succes (exit 0, commit `sync SVN rN` pe
|
`roa_sync`) si SVN ramane in urma -> alt calculator nu-l primeste prin `svn update`.
|
||||||
`main` in COMUN, fara avertismente de conflict).
|
|
||||||
4. `git status` curat pe fisierele tintite in COMUN; branch-urile `claude/*` terminate sunt
|
```powershell
|
||||||
inchise, cele active raportate.
|
git -C "$Root" reset <ultim_sync> # sterge commit-ul non-sync (local)
|
||||||
5. Verificarea se face inainte de `svn commit`: fara "da" explicit, commit-ul nu are loc
|
git -C "$Root" push --force origin main # doar daca era deja impins
|
||||||
(skill-ul nu comite din proprie initiativa).
|
svn commit "$Root\AGENTS.md" -m "<mesaj>" # il duci in SVN, unde trebuia
|
||||||
6. Daca utilizatorul a zis "nu": dovada e absenta oricarei urme de commit sau sync in log.
|
& (Join-Path $Root 'roa_sync.bat')
|
||||||
|
```
|
||||||
|
|
||||||
|
## Dovada (fara ea nu raportezi "gata")
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
svn status "$Root" # curat pe fisierele tintite
|
||||||
|
git -C "$Root" log --oneline -3 # ultimul commit = 'sync SVN rN'
|
||||||
|
```
|
||||||
|
|
||||||
## Scripturi
|
## Scripturi
|
||||||
|
|
||||||
- `D:\ROA\ROAFACTURARE\roa_sync.bat` (sau `roa_sync.bat` din radacina proiectului).
|
- `roa_sync.bat` (radacina proiectului) + `COMUN\scripts\roa_sync.ps1` (`-ProjectRoot <root>`,
|
||||||
- `D:\ROA\ROAFACTURARE\COMUN\scripts\roa_sync.ps1` - `-ProjectRoot <root>`, iar `-GitOnly`
|
`-GitOnly` sare peste SVN si regenerarea textelor).
|
||||||
sare peste SVN si regenerarea textelor.
|
- `COMUN\utile\leaga_skills.ps1` / `scrie_backstop_skills.ps1` - expunere skill-uri (skill
|
||||||
- `D:\ROA\UTIL\foxbin2prg\txt2vcx.ps1` si `git_sync.ps1` - doar daca ai atins binare.
|
`roa-onboarding`).
|
||||||
|
|
||||||
## Referinta (doar la nevoie)
|
## Referinta (doar la nevoie)
|
||||||
|
|
||||||
- Doar daca ai nevoie de contextul complet, citeste `COMUN\docs\fluxul_svn_git.md`
|
- `COMUN\docs\fluxul_svn_git.md` (cazuri, interdictii).
|
||||||
(cazuri, interdictii) pentru fluxul SVN + git.
|
|
||||||
|
|||||||
Reference in New Issue
Block a user