Marius Mutu
e79dea97fc
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015DQoCUF3QSCgQCwCBK1qbz
102 lines
5.1 KiB
Markdown
102 lines
5.1 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## What this is
|
|
|
|
ROAFACTURARE is a Visual FoxPro 9 desktop invoicing application, one product in the ROA
|
|
business-software suite built by ROA Romfast SRL. Thick client: VFP source (`.prg`, `.scx`,
|
|
`.vcx`, `.mnx`, `.frx`) compiled to `roafacturare.exe`, talking to an Oracle backend. No web
|
|
front-end, no package-manager-based build.
|
|
|
|
This directory (`D:\ROA\ROAFACTURARE`) is one working copy inside the larger `D:\ROA` tree that
|
|
holds the sibling ROA products (ROACONT, ROAGEST, ROAIMOB, ROAACNPRO, ...) plus the suite-wide
|
|
shared library `D:\ROA\COMUNROA`.
|
|
|
|
## Version control
|
|
|
|
Primarily an **SVN** working copy (`^/ROAFACTURARE/Trunk`, repository root
|
|
`http://svnroa:3001/svn/ROA`) — use `svn status`, `svn diff`, `svn commit` for the day-to-day
|
|
legacy workflow. A **git** mirror runs in parallel (`gitea.romfast.ro:romfast/roafacturare.git`),
|
|
synced manually from SVN; SVN stays the source of truth.
|
|
|
|
Git tracks the **FoxBin2Prg text versions** of the VFP binaries (`.vc2/.sc2/.fr2/.mn2/.lb2/.pj2`),
|
|
generated in-tree next to each binary — not the binaries themselves. Refresh them with
|
|
`git_sync.ps1` at the start of every session and before any `git commit`:
|
|
|
|
```
|
|
powershell -ExecutionPolicy Bypass -File D:\ROA\UTIL\foxbin2prg\git_sync.ps1 -ProjectRoot D:\ROA\ROAFACTURARE
|
|
```
|
|
|
|
Then search the `.??2` files in-tree with Grep, citing `file:line`. Write-back text->binary via
|
|
`txt2vcx.ps1` is supported **only for `.vc2`/`.sc2`**; `.frx/.mnx/.lbx/.pjx/.dbc/.dbf` are editable
|
|
only in the VFP IDE. See `D:\ROA\UTIL\foxbin2prg\CLAUDE.md` and
|
|
`COMUN\docs\flux-editare-vfp-text.md`.
|
|
|
|
`COMUN/` is excluded from this repo's git — it is shared by every ROA product and versioned by its
|
|
**own git repo**, `gitea.romfast.ro:romfast/comun.git`. Run git commands for `COMUN/` from inside
|
|
that directory, and treat any change there as cross-project.
|
|
|
|
## Building / running
|
|
|
|
No CLI build tool. Compiled from inside the VFP 9 IDE: open `roafacturare.PJX`, then
|
|
Project > Build / Rebuild. Entry point is `Programe/roafacturare.prg` (`PARAMETERS tparam` — a
|
|
connection string passed by the ROA "Start" launcher); it sets the VFP environment
|
|
(`SET PATH`, `SET CLASSLIB`, `SET PROCEDURE ... ADDITIVE`), so new shared `.prg`/`.vcx` files must
|
|
be registered there to be reachable app-wide. Always edit the source file, never its compiled
|
|
sibling (`.FXP`/`.SCT`/`.VCT`/`.MPR`). No automated tests.
|
|
|
|
## Directory layout
|
|
|
|
`Programe/` top-level business-logic modules · `Clase/` `.vcx` class libraries · `Ferestre/` and
|
|
`Formulare/` `.scx` forms · `Meniuri/` menus · `Rapoarte/` `.frx` reports · `Locale/` DBF-based
|
|
i18n · `COMUN/` this project's copy of the shared assets (clase, ferestre, programe, rapoarte,
|
|
utile) · `Utile/`, `Include/`, `Grafice/`, `Ajutor/`, `Mesaje/` support assets.
|
|
`versiune_db.txt` is a manually bumped `YYYY_MM_DD_NN` marker for the last applied DB migration.
|
|
|
|
## Changelog convention
|
|
|
|
`changelog_roafacturare.txt` is a flat file of HTML-comment blocks, newest first:
|
|
|
|
```
|
|
<!--
|
|
DD/MM/YYYY
|
|
ROAFACTURARE - X.Y.Z
|
|
|
|
:modificare:
|
|
<what changed>
|
|
-->
|
|
```
|
|
|
|
Tags: `:nou:` (new feature), `:modificare:` (change), `:eroare:` (bug fix), `:adaugare:`
|
|
(addition). Bump `MAJOR.MINOR.PATCH` per entry (current series `2.11.x`). In-code change comments
|
|
follow `*!* DD.MM.YYYY` + author + short description directly above the changed code.
|
|
|
|
## Localization
|
|
|
|
Romanian is the built-in default. Keep new user-facing strings and code comments in Romanian to
|
|
match the existing codebase unless told otherwise.
|
|
|
|
## Reguli de lucru si testare
|
|
|
|
**Inainte de orice modificare de cod sau testare, citeste `COMUN\docs\reguli_lucru.md`.**
|
|
Nu e optional si nu e doar context: contine regulile de livrare (diff ca fisier + aprobare
|
|
inainte de write-back), comentariile (max o linie), modificarile minime, harnessul de testare
|
|
headless si — la punctul 7 — lista de conventii obligatorii per zona atinsa (encoding cp1252 la
|
|
editarea `.vc2`/`.sc2`, UX formulare/griduri, `GO` pe `Recno()`, `goExecutor` + `ALTER TABLE`,
|
|
testare UI, export Oracle). Fisierul e index: urmeaza linkurile relevante pentru sarcina curenta.
|
|
Depanare detaliata: `COMUN\docs\depanare_testare_vfp.md`.
|
|
|
|
## Mod de lucru: delegare catre subagenti + review inainte de commit
|
|
|
|
- **Orchestrare pe misiuni lungi**: niciodata un singur subagent care acumuleaza context pe multe
|
|
sarcini inlantuite — sesiunea principala orchestreaza subagenti proaspeti per sarcina (max
|
|
~200-250k tokens per subagent, apoi handoff + agent nou), cu handoff compact pe disc:
|
|
`COMUN\docs\orchestrare-subagenti.md`.
|
|
- **Delegare**: modificarile de cod de volum/rutina (aplicarea unei propuneri aprobate din `docs/`,
|
|
editari pe versiunile text `.??2` + write-back, actualizari de documentatie, rulari de teste) se
|
|
delega catre **subagenti Sonnet care lucreaza in background** (Agent tool cu `model: sonnet`),
|
|
iar sesiunea principala doar orchestreaza si verifica rezultatele.
|
|
- **Fara commit fara review**: nu da commit (git sau svn) din proprie initiativa pe modificari de
|
|
cod — diff-ul se livreaza intai ca fisier in `docs/`, iar commit-ul vine dupa aprobare.
|