Merge pull request #111 from ICEI-PUC-Minas-PMV-ADS/dev

Dev

Author: ricoamantino

.github/workflows/deploy-frontend.yml

@@ -0,0 +1,65 @@
+name: Deploy Frontend to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+      - dev
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 25
+
+      - name: Install pnpm
+        run: npm install -g pnpm@10.28.2
+
+      - name: Debug Versions
+        run: |
+          node -v
+          pnpm -v
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+        working-directory: src
+
+      - name: Build
+        run: pnpm --filter front build
+        working-directory: src
+        env:
+          NEXT_PUBLIC_API_URL: ${{ secrets.NEXT_PUBLIC_API_URL }}
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Fix 404 for SPA
+        run: cp src/apps/front/out/index.html src/apps/front/out/404.html
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: src/apps/front/out
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.hintrc

@@ -0,0 +1,8 @@
+{
+  "extends": [
+    "development"
+  ],
+  "hints": {
+    "typescript-config/is-valid": "off"
+  }
+}

README.md

@@ -1,56 +1,62 @@
 # MEUPJ
 
-`Análise e Desenvolvimento de Sistemas`
+Projeto acadêmico de um sistema para organização comercial e financeira de pequenos negócios, com backend, web e mobile no mesmo repositório.
 
-`Desenvolvimento de uma Aplicação Distribuída`
+## Curso
 
-`Etapa 4`
-
-O app reúne, em um só lugar, a organização comercial e financeira do negócio, ajuda o profissional a apresentar, registrar e formalizar vendas e serviços, com emissão de proposta, orçamento, pedido e ordem de serviço, além de personalização visual para transmitir mais profissionalismo (adicionar logo e editar cores). Também oferece um controle financeiro prático do caixa, permitindo acompanhar faturamento, recebimentos, valores em aberto ou atrasados, registrar custos e despesas e visualizar gráficos para comparar entradas, saídas e previsões financeiras.
+- Análise e Desenvolvimento de Sistemas
+- Desenvolvimento de uma Aplicação Distribuída
+- Etapa 4
 
 ## Integrantes
 
-* Frederico Furtado Amantino Vieira
-* Guilherme de Andrade Castro Vieira
-* Maria Julia Gonçalves Maia Sales
-* Eric Esteves Martins
-* Amanda Vitor Lopes
-* Bruna Bricio Alvarenga Sampaio
+- Frederico Furtado Amantino Vieira
+- Guilherme de Andrade Castro Vieira
+- Maria Julia Gonçalves Maia Sales
+- Eric Esteves Martins
+- Amanda Vitor Lopes
+- Bruna Bricio Alvarenga Sampaio
 
 ## Orientador
 
-* Carolina Stephanie Jerônimo de Almeida
+- Carolina Stephanie Jerônimo de Almeida
+
+## Estado Atual do Projeto
+
+O código ativo do sistema está centralizado em [`src/`](src/README.md), que hoje reúne:
+
+- API em Fastify com MongoDB, Better Auth e geração de documentos PDF
+- aplicação web em Next.js
+- aplicação mobile em Expo, com suporte web para desenvolvimento
 
-## Instruções de utilização
+As funcionalidades implementadas e verificáveis atualmente estão descritas no README técnico de [`src/`](src/README.md). Esse é o ponto de entrada canônico para entender a solução em funcionamento.
 
-Assim que a primeira versão do sistema estiver disponível, deverá complementar com as instruções de utilização. Descreva como instalar eventuais dependências e como executar a aplicação.
+## Como Rodar
 
-# Documentação
+Os comandos do sistema devem ser executados a partir de [`src/`](src/README.md):
 
-<ol>
-<li><a href="docs/01-Documentação de Contexto.md"> Documentação de Contexto</a></li>
-<li><a href="docs/02-Especificação do Projeto.md"> Especificação do Projeto</a></li>
-<li><a href="docs/03-Metodologia.md"> Metodologia</a></li>
-<li><a href="docs/04-Projeto de Interface.md"> Projeto de Interface</a></li>
-<li><a href="docs/05-Arquitetura da Solução.md"> Arquitetura da Solução</a></li>
-<li><a href="docs/06-Template Padrão da Aplicação.md"> Template Padrão da Aplicação</a></li>
-<li><a href="docs/07-Programação de Funcionalidades.md"> Programação de Funcionalidades</a></li>
-<li><a href="docs/08-Registro de Testes Unitários.md"> Registro de Testes Unitários</a></li>
-<li><a href="docs/09-Registro de Testes de Integração.md"> Registro de Testes de Integração</a></li>
-<li><a href="docs/10-Registro de Testes de Sistema.md"> Registro de Testes de Sistema</a></li>
-<li><a href="docs/11-Registro de Contribuição.md"> Registro de Contribuição</a></li>
-<li><a href="docs/12-Apresentação do Projeto.md"> Apresentação do Projeto</a></li>
-<li><a href="docs/13-Referências.md"> Referências</a></li>
-</ol>
+```bash
+cd src
+pnpm install
+pnpm dev
+```
 
-# Código
+Comandos principais do monorepo:
 
-<li><a href="src/README.md"> Código Fonte</a></li>
+```bash
+cd src
+pnpm build
+pnpm lint
+pnpm test
+```
 
 # Deploy
 
 <li><a href="https://meupj-api-student.delightfulwave-8b9abc5f.brazilsouth.azurecontainerapps.io/">meupj.azurecontainerapps.io</a></li>
 
 # Apresentação
 
-<li><a href="presentation/README.md"> Apresentação da solução</a></li>
+- [`src/README.md`](src/README.md): documentação técnica canônica do código atual
+- [`docs/`](docs): artefatos acadêmicos organizados por etapa
+- [`presentation/README.md`](presentation/README.md): orientação sobre os materiais de apresentação
+- [`videos/README.md`](videos/README.md): orientação sobre os registros em vídeo