Přeskočit obsah

Vývoj AutoERP

Dokumentace vývojového procesu pro AI-asistovaný vývoj ERP systémů založených na EspoCRM. Proces kombinuje striktní Evidence-First analýzu s Server-First vývojovým workflow.

graph LR
    A[Záznam schůzky + e-mail] --> B[Evidence intake]
    B --> C[Architekt - Návrh]
    C --> D[Review Specifikace]
    D --> E[Vývoj na DEV Serveru]
    E --> F[Sync do Git & MR]
    F --> G[CI/CD & Deploy]
    G --> H[Release]

Klíčové principy

1. Evidence-first

  • Zadání bereme jen z nahraných schůzek (se sdílenou obrazovkou) a e-mailů.
  • Každý požadavek musí mít dohledatelný zdroj (source).

2. Server-First Development

  • Žádný lokální stack: Vývoj probíhá přímo na dev serverech (např. jano.deverp.cz).
  • Sync & Git: Kód se upravuje na serveru, ověří a následně kopíruje do gitu pro MR.
  • Main vs. Moduly: Striktní oddělení klientských customizací (Main) od znovupoužitelných modulů.

3. Automatizace s kvalitou

  • CI/CD Pipeline: Po merge MR probíhá automatický deploy zpět na server.
  • Gating: PHPStan, Lint a Testy běží v pipeline.

Dokumentace procesu

Fáze Dokumentace Popis
Evidence Klientská analýza Záznamy, transkripty, gap analýza se zdroji
Specifikace Specifikace First OpenSpec, Gherkin, manuální review
Implementace Vývojový proces Server-first workflow, Git sync, struktura modulů
Iterace Iterativní vývoj Sprinty, change proposals, release řízení
Změny Návrh změn Delta návrhy s důkazem + archivace

Technická dokumentace

Sekce Popis
Architektura agentů Multi-Agent AI architektura a Knowledge Core
Datový model Struktura specifikací a JSON schémat
Integrace Napojení na EspoCRM API a externí služby
Příklady analýz Ukázkové analýzy klientských projektů

Přehled procesu

1. Evidence + analýza

inputs:
  - Záznamy schůzek (video+screen)
  - E-mailové vlákno
outputs:
  - Transcript
  - Gap Analysis + Solution Proposal

2. Specifikace & review

outputs:
  - openspec/specs/<modul>/spec.md
validation:
  - Manuální kontrola architektem/PM

3. Server-First Implementace

workflow:
  - SSH na dev server
  - Úprava kódu (Main / Module)
  - Okamžitý test v prohlížeči
  - Copy to Local -> Git Push -> MR
➡️ Detailní postup vývoje a práce s moduly

4. Validace & Release

pipeline:
  - PHPStan (Level 8)
  - Auto-deploy na dev
qa:
  - Click-test scénáře

Rychlý start: Nový úkol

  1. Analýza: Pochop zadání z meetingu/mailu (Evidence).
  2. SSH: Připoj se na odpovídající dev server projektu.
  3. Edit:
    • Bug v modulu? Uprav public_html/application/Espo/Modules/<Modul>.
    • Nový report pro klienta? Uprav public_html/custom/Espo/Modules/Main.
  4. Test: Ověř hned v prohlížeči.
  5. Sync: Zkopíruj soubory do lokálního klonu repozitáře.
  6. MR: Pushni změny a vytvoř Merge Request.