Files

Claude Agent e6c7bdbfb1 docs: CLAUDE.md spune de ce proiect apartine si unde e documentatia

Firele Discord porneau in acest director si nu aveau nicio indicatie ca fac
parte din ecosistemul Romfast documentat in /workspace/romfastsql/ -- cautau
prin disc sau raspundeau din nimic. Acum CLAUDE.md are:

- unde ruleaza agentul (LXC 171) si un tabel de trimiteri catre romfastsql
  (CLAUDE.md, proxmox/README.md, discord-bridge/, maria-whatsapp-bridge/,
  lxc108-oracle/, system_instructions/)
- nota despre memoria comuna cu proiectul romfastsql (symlink pe memory/) si
  despre faptul ca sesiunile raman per fir Discord
- sectiunea "Maria (RAG) - GRANITA OBLIGATORIE": ce NU are voie sa intre in
  depozitul de documente al Mariei (nimic de infrastructura)
- nota ca acest director e repo propriu, separat de romfast/workspace

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q4uzvgm7AyJch5WH8QHRhY

2026-08-31 15:52:31 +00:00

5.1 KiB

Raw Blame History

CLAUDE.md — claude-agent (spațiul punții Discord)

Vezi README.md pentru context general.

Unde ești

Rulezi pe LXC 171 (claude-agent, 10.0.20.171, nod pvemini), în ecosistemul Romfast: un cluster Proxmox de 3 noduri, Oracle XE 21c, ERP-ul ROA, plus punțile de chat (Discord, WhatsApp). Directorul acesta e doar spațiul de lucru al punții Discord — nu e tot ce știi.

Documentația reală a infrastructurii e în /workspace/romfastsql/, un repo separat (git@gitea.romfast.ro:romfast/ROMFASTSQL.git). Citește de acolo înainte să cauți cu find/grep prin tot discul:

Ai nevoie de…	Citește
Regulile proiectului + indexul complet de documentație	`/workspace/romfastsql/CLAUDE.md`
Infrastructură Proxmox (noduri, LXC, VM, rețea, incidente)	`/workspace/romfastsql/proxmox/README.md`
Codul punții Discord (acest bot)	`/workspace/romfastsql/proxmox/lxc171-claude-agent/discord-bridge/`
Codul Mariei (WhatsApp + RAG)	`/workspace/romfastsql/proxmox/lxc171-claude-agent/maria-whatsapp-bridge/`
Oracle (XE 21c/18c, migrări, cazuri clienți)	`/workspace/romfastsql/proxmox/lxc108-oracle/`
Reguli SQL de migrare (obligatoriu înainte de a scrie SQL)	`/workspace/romfastsql/system_instructions/system_prompt.md`

Rezumat rapid, dacă nu vrei să deschizi nimic: docs/infrastructure.md.

Memorie

Memoriile acestui director sunt comune cu cele ale proiectului romfastsql (~/.claude/projects/-workspace-claude-agent/memory e un symlink către ~/.claude/projects/-workspace-romfastsql/memory). Deci ce s-a învățat lucrând pe infrastructură e disponibil și în firele de pe Discord, și invers — scrie memorii acolo, nu în fișiere ad-hoc. Copia veche, dinainte de unificare: ~/.claude/projects/-workspace-claude-agent/memory.bak-2026-08-31.

Sesiunile Discord sunt totuși per fir: un fir nou pornește o sesiune Claude nouă, care are memoriile de mai sus dar nu conversația din alt fir. Ce trebuie să supraviețuiască între fire se scrie în memorie sau în documentație, nu se presupune.

Canal principal

Utilizatorul comunică cu acest agent în principal prin Discord, prin puntea Discord → Claude Code (vezi și docs/echo-roa2web.md pentru diferența față de Echo/MoltBot). Botul care răspunde pe Discord este acest agent (claude-agent, LXC 171), nu Echo. Atașamentele (imagini, fișiere) trimise pe Discord nu sunt încă citite automat de punte — doar textul mesajului ajunge la Claude.

Documentație locală

Subiect	Fișier
Infrastructură Proxmox — rezumat (noduri, LXC, VM, proiecte)	docs/infrastructure.md
Echo (LXC 110 moltbot) — acces și comenzi pentru roa2web	docs/echo-roa2web.md
Punte Discord → Claude Code — context	docs/discord-bridge-context.md
Maria — punte WhatsApp + RAG	docs/maria-whatsapp-rag-prototype.md

Maria (RAG) — GRANIȚĂ OBLIGATORIE

Maria e chatbot de suport tehnic pentru clienții ERP ROA. Nu are voie să vadă nimic din infrastructura Romfast.

Maria răspunde exclusiv din depozitul ei de documente (~/.maria-bridge/documents/, sincronizat din D:\GoogleDrive\romfast\document_store); prin construcție nu are shell, nici acces la fișiere în afara acelui depozit. Granița se poate rupe doar dacă tu pui acolo ce nu trebuie. Deci:

NU copia niciodată în ~/.maria-bridge/documents/ (sau în dosarul Drive document_store) fișiere din /workspace/romfastsql/proxmox/, docs/ de aici, docs/infrastructure.md, README-uri de infrastructură, runbook-uri, proceduri DR sau de failover.
NU pune acolo IP-uri interne, nume de noduri/containere, porturi, chei SSH, parole, token-uri, string-uri de conexiune Oracle, adrese de clienți sau orice altceva operațional.
În depozit intră doar material orientat spre client final: cum se folosește ROA, proceduri din aplicație, întrebări frecvente, mesaje de eroare din interfață.
Când utilizatorul cere „adaugă documentul X la Maria", verifică întâi conținutul cu acest filtru. Dacă e material de infrastructură, refuză și spune de ce.
Nu extinde DOCS_DIR, nu adăuga surse noi de indexare și nu adăuga unelte de fișiere/shell consumerului Mariei (rag/consumer.py) fără cerere explicită.

Pentru contrast: tu (punte Discord) ai voie la toată infrastructura, inclusiv SSH și pct exec — vezi memoriile. Maria, nu.

Convenții de lucru

Pentru sarcini care se pot repeta (ex: extragere transcript video, procesare de fișiere), scrie un script reutilizabil (bash/python) în tools/ în loc de comenzi ad-hoc de unică folosință.
Acest director e repo propriu (git@gitea.romfast.ro:romfast/claude-agent.git). Nu comite aici modificări la codul punții sau la documentația de infrastructură — alea aparțin repo-ului romfastsql. /workspace e la rândul lui alt repo (romfast/workspace) și ignoră acest director.

5.1 KiB Raw Blame History