Fecha pendências de B01, B02, B03 e A01 (fundação)

.github/workflows/backend-ci.yml

@@ -0,0 +1,79 @@
+name: Backend CI
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'backend/**'
+      - '.github/workflows/backend-ci.yml'
+  pull_request:
+    paths:
+      - 'backend/**'
+      - '.github/workflows/backend-ci.yml'
+
+defaults:
+  run:
+    working-directory: backend
+
+jobs:
+  pint:
+    name: Pint
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v4
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.4'
+          coverage: none
+      - uses: ramsey/composer-install@v3
+        with:
+          working-directory: backend
+      - run: vendor/bin/pint --test
+
+  larastan:
+    name: Larastan
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.4'
+          coverage: none
+      - uses: ramsey/composer-install@v3
+        with:
+          working-directory: backend
+      - run: vendor/bin/phpstan analyse --no-progress
+
+  pest:
+    name: Pest
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.4'
+          coverage: pcov
+      - uses: ramsey/composer-install@v3
+        with:
+          working-directory: backend
+      - run: cp .env.example .env
+      - run: php artisan key:generate
+      - run: vendor/bin/pest --coverage --min=0
+
+  composer-audit:
+    name: Composer audit
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v4
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.4'
+          coverage: none
+      - uses: ramsey/composer-install@v3
+        with:
+          working-directory: backend
+      - run: composer audit --abandoned=report

.github/workflows/front-admin-ci.yml

@@ -0,0 +1,73 @@
+name: Front-admin CI
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'front-admin/**'
+      - '.github/workflows/front-admin-ci.yml'
+  pull_request:
+    paths:
+      - 'front-admin/**'
+      - '.github/workflows/front-admin-ci.yml'
+
+defaults:
+  run:
+    working-directory: front-admin
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+          cache-dependency-path: front-admin/package-lock.json
+      - run: npm ci
+      - run: npm run lint
+
+  typecheck:
+    name: Typecheck
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+          cache-dependency-path: front-admin/package-lock.json
+      - run: npm ci
+      - run: npm run typecheck
+
+  test:
+    name: Unit tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+          cache-dependency-path: front-admin/package-lock.json
+      - run: npm ci
+      - run: npm test
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+          cache-dependency-path: front-admin/package-lock.json
+      - run: npm ci
+      - run: npm run build

CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# Contribuindo com a PHPeste Platform
+
+Obrigado por ajudar. Este projeto é feito para o PHPeste e mantido em comunidade — qualquer pessoa pode propor melhorias.
+
+## Antes de abrir uma issue ou PR
+
+- Dá uma olhada no [board do projeto](https://github.com/orgs/PHPeste/projects/2) pra ver o que já está em andamento.
+- Pra contexto de produto e arquitetura, leia o [README](README.md) e [`docs/produto.md`](docs/produto.md).
+- As decisões de arquitetura ficam registradas em [`docs/adr/`](docs/adr/) — vale conferir antes de propor uma mudança estrutural, pra entender o porquê de uma decisão antes de revisitá-la.
+
+## Rodando o projeto localmente
+
+- **Backend** (`backend/`): `composer install && cp .env.example .env && php artisan key:generate && php artisan migrate`, ou `infra/dev.sh up` pra subir tudo via Docker (MySQL, Redis, Horizon, scheduler, Mailpit).
+- **Admin** (`front-admin/`): `npm install && cp .env.example .env && npm run dev`.
+
+Veja a seção "Como rodar" do [README](README.md#como-rodar) para o passo a passo completo.
+
+## Qualidade antes de abrir o PR
+
+Backend:
+
+```bash
+cd backend
+composer check   # pint + phpstan (nível 8) + rector --dry-run + pest
+composer audit
+```
+
+Front-admin:
+
+```bash
+cd front-admin
+npm run lint
+npm run typecheck
+npm test
+npm run build
+```
+
+O CI (`.github/workflows/`) roda os mesmos comandos em todo PR — rodar localmente antes evita ida e volta.
+
+## Convenções
+
+- **Backend**: módulo novo é `php artisan make:module <Nome>` seguido de `composer update phpeste/<nome>` — nunca uma pasta solta colada em `app/`. Ver `backend/CLAUDE.md` para a estrutura de pastas de um módulo (`Models/Actions/Data/Events/Listeners/Contracts/Http`) e a regra de isolamento entre módulos.
+- **Front-admin**: módulo novo segue o formato de `app/modules/login/` (types → services → composables → components → views). Ver `front-admin/CLAUDE.md` e `front-admin/docs/ARCHITECTURE.md`.
+- Commits em português, description curta e no imperativo (ex.: "Adiciona X", "Corrige Y").
+- PRs pequenos e focados batem mais rápido do que um PR gigante — quando der, prefira quebrar em commits/PRs por assunto.
+
+## Dúvidas
+
+Abra uma issue ou comente na issue existente — não tem burocracia.

README.md

@@ -116,7 +116,7 @@ composer update modules/<nome>
   ```bash
   cd front-admin
   npm install
-  cp .env.example .env   # NUXT_PUBLIC_API_BASE=http://localhost:8000/api/v1
+  cp .env.example .env   # NUXT_PUBLIC_API_URL=http://localhost:8000/api/v1
   npm run dev
   ```
 
@@ -139,4 +139,4 @@ Credenciais de gateway são criptografadas e nunca devolvidas pela API. Webhooks
 
 ## Contribuindo
 
-A definir: guia de contribuição, código de conduta e licença.
+Ver [`CONTRIBUTING.md`](CONTRIBUTING.md). Código de conduta e licença: a definir.