# Workflow: Markdown → Gitea → HTTP + PDF

Aquest document explica com automatitzar la publicació d'informes d'orientació professional en un site estàtic, utilitzant **Markdown**, **Gitea**, **hooks** i **generació de PDF**.

## 1️⃣ Perfil Professional
### 1.1 Competència General dels Estudis
Aquest apartat detalla les habilitats i coneixements generals que proporciona cada cicle formatiu. Inclou la visió global del sector i com encaixa en el mercat laboral.

### 1.2 Competències Professionals, Personals i Socials
L'informe destaca les capacitats tècniques, la relació amb l'entorn de treball i les habilitats socials requerides.

### 1.3 Fitxes Ocupacionals
Llistat d’ocupacions associades a la formació, amb detalls sobre funcions, responsabilitats i requisits específics.

### 1.4 Anàlisi del Cicle Formatiu
- **Accions Clau**: Objectius acadèmics i professionals que defineixen el cicle.
- **Mòduls Professionals**: Detall dels continguts acadèmics.
- **Unitats de Competència**: Relació amb certificats professionals.

### 1.5 Anàlisi del Sector Professional
- **Sortides Professionals**: Camps d’inserció laboral.
- **Relació d’Empreses de l’Entorn**: Xarxa empresarial vinculada al sector.
- **Competències Complementàries**: Altres habilitats necessàries per destacar en el sector.

## 2️⃣ Àrea d'Autoconeixement
Es treballen aspectes com l’autoconeixement professional, identificació d’habilitats i adaptació als perfils laborals més adequats.

### 2.1 Eines d'Autoconeixement
Eines i metodologies per ajudar a l'usuari a comprendre les seves capacitats, motivacions i interessos professionals.

### 2.2 Autoavaluació de Capacitats Clau
Un procés de reflexió sobre les habilitats tècniques i personals en relació amb el mercat laboral.

### 2.3 Anàlisi Personal: DAFO
Es realitza un estudi de **debilitats, amenaces, fortaleses i oportunitats** per entendre millor el punt de partida i traçar estratègies de millora.

## 3️⃣ Projecció Professional
Plans d’orientació a curt, mitjà i llarg termini basats en les necessitats del mercat i les capacitats individuals.

### 3.1 Currículum Standard
Un model de currículum clàssic amb les dades bàsiques de l'usuari, experiència laboral, formació acadèmica i competències generals.

### 3.2 Currículum per Competències
Una versió del currículum que posa èmfasi en les habilitats adquirides, la capacitat de resolució de problemes i la polivalència de l’usuari en diferents entorns laborals.

### 3.3 Auto-Candidatura
Estratègies per presentar-se a empreses sense una oferta prèvia, destacant el valor professional de l'usuari i creant una proposta de valor per a l'empresa.

## 4️⃣ Coneixement del Mercat
### 4.1 Tastet Professionalitzador
Experiència pràctica en un entorn laboral real o simulat per ajudar a comprendre millor les demandes del sector professional.

### 4.2 Cròniques d'Experiències Professionals
Quatre relats detallats de situacions professionals viscudes, explicant els aprenentatges adquirits i les competències desenvolupades.

### 4.3 Altres Experiències que Amplien el Coneixement Professional
Aquest apartat recull experiències complementàries que ajuden a entendre millor el món laboral:
- **Una lectura**: Un llibre rellevant per a la formació i desenvolupament professional.
- **Una activitat o joc**: Experimentació d’habilitats a través de dinàmiques interactives.
- **Una pel·lícula o sèrie**: Un contingut audiovisual que ofereixi una perspectiva sobre el sector professional.

## 5️⃣ Itinerari Personal i Especialització
### 5.1 Més Formació després del Cicle Formatiu
Opcions per ampliar coneixements i millorar la qualificació professional després de completar el cicle formatiu.

### 5.2 On Trobar Feina
Recursos i estratègies per a la recerca activa d’ocupació en el sector d’interès.

### 5.3 Opcions d'Auto-Ocupació
Possibilitats d’emprenedoria i creació del propi negoci dins del sector.

### 5.4 Tres Possibles Sortides Laborals
- **Curt Termini**: Opcions immediates després del cicle.
- **Mig Termini**: Formació addicional i experiència professional per a millorar la posició.
- **Llarg Termini**: Especialització o direcció dins del sector.

### 5.5 Activitats/Treballs que He Realitzat que em Poden Ajudar a Saber el que Podria Fer
Reflexió sobre experiències prèvies que han ajudat a definir el camí professional.

### 5.6 Les Meves Pràctiques
- **Lloc**: Empresa o institució on s’han realitzat.
- **Grup**: Equip de treball i dinàmica interna.
- **Aprenentatges fets**: Coneixements i habilitats adquirides durant les pràctiques.
- **Valoració**: Experiència global i punts de millora.

---

# Workflow: Markdown → Gitea → HTTP + PDF

Aquest document explica com automatitzar la publicació d'informes d'orientació professional en un site estàtic, utilitzant **Markdown**, **Gitea**, **hooks** i **generació de PDF**.

## 1️⃣ Escriu el contingut en Markdown

Crea els teus informes **IPOP** en `.md` i puja'ls a un repositori de **Gitea**.

### Exemple de `informe.md`
```md
# Informe Personal d’Orientació Professional

## Joan Garcia

- **Àrees professionals:** Enginyeria, Disseny Gràfic
- **Competències destacades:** Anàlisi, Creativitat, Resolució de Problemes
```

---

## 2️⃣ Puja els fitxers a Gitea

Executa:
```sh
git add informe.md
git commit -m "Afegit informe Joan Garcia"
git push origin main
```

---

## 3️⃣ Automatització amb Gitea Webhooks

Quan es detecta un canvi en el repo, un **hook automàtic** executa el generador de site estàtic.

### Exemple de Hook (`gitea-hooks.sh`)
```sh
#!/bin/bash
cd /var/www/informes
git pull origin main
hugo -D  # O jekyll build
systemctl restart nginx  # Si cal refrescar el servidor
```

Configura el webhook a **Gitea** per executar aquest script.

---

## 4️⃣ Site estàtic accessible via HTTP

Ara el teu site està **publicat automàticament** en:
- `http://empresa.com/informes/joan-garcia`
- `http://intranet/informes/`

**Frameworks recomanats:**
- **Hugo** → Lleuger i ràpid
- **Jekyll** → Suporta directament Markdown
- **Eleventy** → Molt flexible

---

## 5️⃣ Generació de PDFs sota demanda

Opcions per a la generació de PDF:

### ✅ Opció 1: Client-side (JavaScript - jsPDF)
```html
<button id="pdf">Descarrega PDF</button>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jspdf/2.4.0/jspdf.umd.min.js"></script>
<script>
document.getElementById('pdf').addEventListener('click', function () {
  var doc = new window.jspdf.jsPDF();
  doc.text(document.body.innerText, 10, 10);
  doc.save("informe.pdf");
});
</script>
```
✔️ No requereix backend, tot passa al navegador.

### ✅ Opció 2: Server-side (Puppeteer o Pandoc)

Generació amb Puppeteer (Node.js):
```js
const puppeteer = require('puppeteer');
(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('http://empresa.com/informes/joan-garcia', {waitUntil: 'networkidle2'});
  await page.pdf({path: 'informe.pdf', format: 'A4'});
  await browser.close();
})();
```
✔️ Millor formatació, però requereix configuració de servidor.

---

## 🔁 Flux del Workflow
```
Markdown (Gitea Repo) --> Webhook --> Site Estàtic (Hugo/Jekyll) --> Web HTML
                                 \
                                  --> API PDF (Puppeteer o jsPDF)
```

## 📌 Conclusió
✅ **Automatitzat**: `git push` i la web s'actualitza sola.  
✅ **Offline-ready**: HTML navegable + PDFs generats sota demanda.  
✅ **Eficient i segur**: Sense bases de dades, tot en fitxers.  

## 📌 Workflow Detallat
### Markdown → Gitea → HTTP + PDF

Aquest sistema permet escriure informes en Markdown, versionar-los a **Gitea**, i automàticament desplegar-los com una web estàtica amb opció de descarregar-los en PDF.

### 1️⃣ Escriu el contingut en Markdown
Cada informe es crea dins la carpeta `content/informes/` com un fitxer Markdown:
```md
# Informe Personal d’Orientació Professional

## Joan Garcia

- **Àrees professionals:** Enginyeria, Disseny Gràfic
- **Competències destacades:** Anàlisi, Creativitat, Resolució de Problemes
```

---

## 📌 Conclusió
✅ **Automatitzat**: `git push` i la web s'actualitza sola.  
✅ **Offline-ready**: HTML navegable + PDFs generats sota demanda.  
✅ **Eficient i segur**: Sense bases de dades, tot en fitxers.  

Aquest sistema és perfecte per a **centres educatius, institucions i empreses** que necessiten informes professionals accessibles de manera senzilla i eficient. 🚀