@codigodoleo/wp-kit 3.4.0 β 3.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -1,67 +1,160 @@
|
|
|
1
|
-
# π Pipefy WordPress Website
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
1
|
+
# π Pipefy WordPress Website
|
|
2
|
+
|
|
3
|
+
Bem-vindo à documentação oficial do site **pipefy.com** - um projeto WordPress robusto e moderno da Pipefy.
|
|
4
|
+
|
|
5
|
+
## π― **VisΓ£o Geral**
|
|
6
|
+
|
|
7
|
+
Este Γ© o repositΓ³rio principal do site institucional da Pipefy, construΓdo com **WordPress** e uma infraestrutura cloud-native moderna. O projeto utiliza tecnologias de ponta para garantir performance, escalabilidade e facilidade de manutenção.
|
|
8
|
+
|
|
9
|
+
### π **Status do Projeto**
|
|
10
|
+
- **VersΓ£o Atual**: `1.1.7` (2025-05-23)
|
|
11
|
+
- **WordPress**: Customizado com tema Pipefy 2020
|
|
12
|
+
- **Ambiente**: Multi-ambiente (Local, Development, Staging, Production)
|
|
13
|
+
- **Deploy**: Automatizado via GitLab CI/CD + Kubernetes
|
|
14
|
+
|
|
15
|
+
## π **Quick Start**
|
|
16
|
+
|
|
17
|
+
### PrΓ©-requisitos
|
|
18
|
+
- [Lando](https://lando.dev/) (para desenvolvimento local)
|
|
19
|
+
- [Docker](https://docker.com/)
|
|
20
|
+
- [Git](https://git-scm.com/)
|
|
21
|
+
- [Node.js](https://nodejs.org/) (versΓ£o especificada em `.nvmrc`)
|
|
22
|
+
|
|
23
|
+
### Setup RΓ‘pido
|
|
24
|
+
```bash
|
|
25
|
+
# 1. Clone o repositΓ³rio
|
|
26
|
+
git clone git@gitlab.com:pipefy/wordpress/pipefy-website.git
|
|
27
|
+
cd pipefy-website
|
|
28
|
+
|
|
29
|
+
# 2. Inicie o ambiente local
|
|
30
|
+
lando start
|
|
31
|
+
|
|
32
|
+
# 3. Configure WordPress
|
|
33
|
+
lando ssh -c "development/scripts/init-wp.sh --user=seu-email@pipefy.com"
|
|
34
|
+
|
|
35
|
+
# 4. Acesse o site
|
|
36
|
+
# Frontend: https://pipefy.lndo.site
|
|
37
|
+
# Admin: https://pipefy.lndo.site/wp-admin
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## ποΈ **Arquitetura**
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ
|
|
44
|
+
β Local ββββββ Development ββββββ Staging ββββββ Production β
|
|
45
|
+
β pipefy.lndo.siteβ βdevelopment-www β β staging-www β β www.pipefy.com β
|
|
46
|
+
β β β .pipefy.com β β .pipefy.com β β β
|
|
47
|
+
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ
|
|
48
|
+
β β β β
|
|
49
|
+
βββββββββββββββββββββββββΌββββββββββββββββββββββββΌββββββββββββββββββββββββ
|
|
50
|
+
β β
|
|
51
|
+
βββββββββββββββββββ βββββββββββββββββββ
|
|
52
|
+
β GitLab CI/CD β β Kubernetes β
|
|
53
|
+
β Pipelines β β + CloudFlare β
|
|
54
|
+
βββββββββββββββββββ βββββββββββββββββββ
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### π οΈ **Stack TecnolΓ³gico**
|
|
58
|
+
|
|
59
|
+
| Categoria | Tecnologia |
|
|
60
|
+
|-----------|------------|
|
|
61
|
+
| **CMS** | WordPress (customizado) |
|
|
62
|
+
| **Tema** | Pipefy 2020 (custom theme) |
|
|
63
|
+
| **Frontend** | PHP, JavaScript, Sass, Gutenberg Blocks |
|
|
64
|
+
| **Containerização** | Docker, Lando |
|
|
65
|
+
| **Orquestração** | Kubernetes, Helm |
|
|
66
|
+
| **CI/CD** | GitLab CI/CD |
|
|
67
|
+
| **Infraestrutura** | Terraform, OCI (Oracle Cloud) |
|
|
68
|
+
| **CDN/DNS** | CloudFlare |
|
|
69
|
+
| **Monitoramento** | Custom health checks |
|
|
70
|
+
|
|
71
|
+
## π **Estrutura do Projeto**
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
pipefy-website/
|
|
75
|
+
βββ π dist/ # WordPress core + customizaçáes
|
|
76
|
+
β βββ π wp-content/
|
|
77
|
+
β βββ π themes/pipefy-2020/ # Tema principal
|
|
78
|
+
β βββ π plugins/ # Plugins WordPress
|
|
79
|
+
β βββ π mu-plugins/ # Must-use plugins
|
|
80
|
+
βββ π development/ # Scripts e config. desenvolvimento
|
|
81
|
+
βββ π helm/ # Charts Kubernetes
|
|
82
|
+
βββ π k8s/ # Manifests Kubernetes
|
|
83
|
+
βββ π terraform/ # Infraestrutura como cΓ³digo
|
|
84
|
+
βββ π .gitlab/ # Templates GitLab CI/CD
|
|
85
|
+
βββ π .lando.yml # Configuração ambiente local
|
|
86
|
+
βββ π .gitlab-ci.yml # Pipeline CI/CD
|
|
87
|
+
βββ π CHANGELOG.md # HistΓ³rico de mudanΓ§as
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## π **Ambientes**
|
|
91
|
+
|
|
92
|
+
| Ambiente | URL | Branch | Namespace K8s | Finalidade |
|
|
93
|
+
|----------|-----|--------|---------------|------------|
|
|
94
|
+
| **Local** | `pipefy.lndo.site` | `feature/*` | - | Desenvolvimento local |
|
|
95
|
+
| **Development** | `development-www.pipefy.com` | `development` | `website-dev` | Testes contΓnuos |
|
|
96
|
+
| **Staging** | `staging-www.pipefy.com` | `staging` | `website-stg` | Homologação |
|
|
97
|
+
| **Production** | `www.pipefy.com` | `master` | `website-prod` | Site oficial |
|
|
98
|
+
|
|
99
|
+
## π **Workflow de Desenvolvimento**
|
|
100
|
+
|
|
101
|
+
```mermaid
|
|
102
|
+
graph LR
|
|
103
|
+
A[Feature Branch] --> B[Pull Request]
|
|
104
|
+
B --> C[Code Review]
|
|
105
|
+
C --> D[Merge to Development]
|
|
106
|
+
D --> E["π development-www.pipefy.com"]
|
|
107
|
+
E --> F[Merge to Staging]
|
|
108
|
+
F --> G["π staging-www.pipefy.com"]
|
|
109
|
+
G --> H[Tests + QA]
|
|
110
|
+
H --> I[Merge to Master]
|
|
111
|
+
I --> J["β
www.pipefy.com"]
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
## π **Documentação Principal**
|
|
115
|
+
|
|
116
|
+
### π **Para Desenvolvedores**
|
|
117
|
+
- [Getting Started](Getting-Started) - Setup completo do ambiente
|
|
118
|
+
- [Arquitetura](Arquitetura) - Estrutura tΓ©cnica detalhada
|
|
119
|
+
- [Desenvolvimento](Desenvolvimento) - Guias de desenvolvimento
|
|
120
|
+
- [Deploy Pipeline](Deploy-Pipeline) - Processo de deploy
|
|
121
|
+
|
|
122
|
+
### π§ **Para DevOps**
|
|
123
|
+
- [Infraestrutura](Infraestrutura) - Kubernetes, Terraform, AWS
|
|
124
|
+
- [Monitoramento](Monitoramento) - Health checks e observabilidade
|
|
125
|
+
- [Troubleshooting](Troubleshooting) - Resolução de problemas
|
|
126
|
+
|
|
127
|
+
### π¦ **Para GestΓ£o**
|
|
128
|
+
- [Plugins & Integraçáes](Plugins-Integracoes) - Componentes externos
|
|
129
|
+
- [Changelog](https://gitlab.com/pipefy/wordpress/pipefy-website/-/blob/master/CHANGELOG.md) - HistΓ³rico de versΓ΅es
|
|
130
|
+
- [CODEOWNERS](https://gitlab.com/pipefy/wordpress/pipefy-website/-/blob/master/CODEOWNERS) - Responsabilidades
|
|
131
|
+
|
|
132
|
+
## π **Precisa de Ajuda?**
|
|
133
|
+
|
|
134
|
+
### π **Problemas Comuns**
|
|
135
|
+
- [Troubleshooting](Troubleshooting) - Guia de resolução
|
|
136
|
+
- [FAQ](FAQ) - Perguntas frequentes
|
|
137
|
+
|
|
138
|
+
### π **Contatos**
|
|
139
|
+
- **Equipe**: @Approvers (conforme [CODEOWNERS](https://gitlab.com/pipefy/wordpress/pipefy-website/-/blob/master/CODEOWNERS))
|
|
140
|
+
- **Issues**: [GitLab Issues](https://gitlab.com/pipefy/wordpress/pipefy-website/-/issues)
|
|
141
|
+
- **Pipefy Cards**: Vinculados no [CHANGELOG.md](https://gitlab.com/pipefy/wordpress/pipefy-website/-/blob/master/CHANGELOG.md)
|
|
142
|
+
|
|
143
|
+
## π― **Links Importantes**
|
|
144
|
+
|
|
145
|
+
| Recurso | Link | Ambiente |
|
|
146
|
+
|---------|------|----------|
|
|
147
|
+
| **Site Produção** | [www.pipefy.com](https://www.pipefy.com) | π΄ Production |
|
|
148
|
+
| **Site Staging** | [staging-www.pipefy.com](https://staging-www.pipefy.com) | π‘ Staging |
|
|
149
|
+
| **Site Development** | [development-www.pipefy.com](https://development-www.pipefy.com) | π Development |
|
|
150
|
+
| **Site Local** | [pipefy.lndo.site](https://pipefy.lndo.site) | π΅ Local |
|
|
151
|
+
| **GitLab Project** | [pipefy/wordpress/pipefy-website](https://gitlab.com/pipefy/wordpress/pipefy-website) | - |
|
|
152
|
+
| **CI/CD Pipelines** | [Pipelines](https://gitlab.com/pipefy/wordpress/pipefy-website/-/pipelines) | - |
|
|
153
|
+
| **Kubernetes Dashboards** | *[Links internos conforme ambiente]* | - |
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
π **Γltima atualização**: Junho 2025
|
|
158
|
+
π **VersΓ£o da documentação**: 1.1
|
|
159
|
+
β¨ **Criado com**: AnΓ‘lise automatizada do projeto + GitHub Copilot
|
|
160
|
+
π **Ambientes atualizados**: Local, Development, Staging, Production
|
|
@@ -1,4 +1,14 @@
|
|
|
1
|
-
{
|
|
2
|
-
"
|
|
3
|
-
"
|
|
4
|
-
"
|
|
1
|
+
{
|
|
2
|
+
"scripts": {
|
|
3
|
+
"prepare": "husky",
|
|
4
|
+
"commit": "lando git-cz"
|
|
5
|
+
},
|
|
6
|
+
"devDependencies": {
|
|
7
|
+
"@commitlint/cli": "^19.7.1",
|
|
8
|
+
"@commitlint/config-conventional": "^19.7.1",
|
|
9
|
+
"@commitlint/prompt": "^19.5.0",
|
|
10
|
+
"commitizen": "^4.3.1",
|
|
11
|
+
"husky": "^9.0.11",
|
|
12
|
+
"lint-staged": "^15.5.0"
|
|
13
|
+
}
|
|
14
|
+
}
|
|
@@ -1,4 +1,16 @@
|
|
|
1
|
-
{
|
|
2
|
-
"
|
|
3
|
-
"
|
|
4
|
-
"
|
|
1
|
+
{
|
|
2
|
+
"scripts": {
|
|
3
|
+
"format": "prettier --write .",
|
|
4
|
+
"lint": "lando eslint .",
|
|
5
|
+
"lint:fix": "lando eslint . --fix"
|
|
6
|
+
},
|
|
7
|
+
"devDependencies": {
|
|
8
|
+
"globals": "^16.3.0",
|
|
9
|
+
"@eslint/eslintrc": "^3.3.1",
|
|
10
|
+
"@eslint/js": "^9.30.1",
|
|
11
|
+
"eslint": "^9.30.1",
|
|
12
|
+
"eslint-config-prettier": "^10.1.5",
|
|
13
|
+
"eslint-plugin-prettier": "^5.3.1",
|
|
14
|
+
"prettier": "^3.6.2"
|
|
15
|
+
}
|
|
16
|
+
}
|
package/package.json
CHANGED
|
@@ -1,5 +1,39 @@
|
|
|
1
|
-
root = true
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
1
|
+
root = true
|
|
2
|
+
|
|
3
|
+
[*]
|
|
4
|
+
charset = utf-8
|
|
5
|
+
indent_style = space
|
|
6
|
+
indent_size = 2
|
|
7
|
+
end_of_line = lf
|
|
8
|
+
insert_final_newline = true
|
|
9
|
+
trim_trailing_whitespace = true
|
|
10
|
+
|
|
11
|
+
[*.php]
|
|
12
|
+
indent_size = 4
|
|
13
|
+
max_line_length = 120
|
|
14
|
+
|
|
15
|
+
[*.blade.php]
|
|
16
|
+
indent_size = 4
|
|
17
|
+
insert_final_newline = true
|
|
18
|
+
trim_trailing_whitespace = true
|
|
19
|
+
|
|
20
|
+
[*.js]
|
|
21
|
+
indent_size = 2
|
|
22
|
+
|
|
23
|
+
[*.json]
|
|
24
|
+
indent_size = 2
|
|
25
|
+
|
|
26
|
+
[*.css]
|
|
27
|
+
indent_size = 2
|
|
28
|
+
|
|
29
|
+
[*.scss]
|
|
30
|
+
indent_size = 2
|
|
31
|
+
|
|
32
|
+
[*.md]
|
|
33
|
+
trim_trailing_whitespace = false
|
|
34
|
+
|
|
35
|
+
[*.yml]
|
|
36
|
+
indent_size = 2
|
|
37
|
+
|
|
38
|
+
[*.yaml]
|
|
39
|
+
indent_size = 2
|
package/templates/CLAUDE.md.hbs
CHANGED
|
@@ -1,28 +1,53 @@
|
|
|
1
|
-
#
|
|
2
|
-
{{projectName}}
|
|
1
|
+
# {{projectName}}
|
|
3
2
|
|
|
4
3
|
> WordPress project scaffolded by [wp-kit](https://github.com/codigodoleo/wp-kit), using the
|
|
5
|
-
[Roots](https://roots.io/) ecosystem: Bedrock, Sage, Acorn, and Lando.
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
-
|
|
10
|
-
{{
|
|
11
|
-
{{
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
4
|
+
> [Roots](https://roots.io/) ecosystem: Bedrock, Sage, Acorn, and Lando.
|
|
5
|
+
|
|
6
|
+
## Stack
|
|
7
|
+
|
|
8
|
+
- PHP {{phpVersion}}
|
|
9
|
+
- Node.js {{nodeVersion}}
|
|
10
|
+
- WordPress {{wpCoreVersion}}
|
|
11
|
+
{{#if useSage}}- Sage {{sageVersion}} + Acorn
|
|
12
|
+
{{/if}}- Lando (local development)
|
|
13
|
+
|
|
14
|
+
## Local Development
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
lando start
|
|
18
|
+
lando dev # HMR dev server (Vite)
|
|
19
|
+
lando theme-build # Production build
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## AI Co-Pilot
|
|
23
|
+
|
|
24
|
+
This project includes [superpowers-sage](https://github.com/codigodoleo/superpowers-sage) skills in `.claude/`.
|
|
25
|
+
Start a session with:
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
/sage-onboard
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Available commands:
|
|
32
|
+
|
|
33
|
+
| Command | Purpose |
|
|
34
|
+
|---|---|
|
|
35
|
+
| `/sage-onboard` | Project analysis and overview |
|
|
36
|
+
| `/sage-plan` | Architecture decision for a new feature |
|
|
37
|
+
| `/sage-scaffold` | Run generators and create stubs |
|
|
38
|
+
| `/sage-review` | Review code against conventions |
|
|
39
|
+
| `/sage-debug` | Guided troubleshooting |
|
|
40
|
+
|
|
41
|
+
## Theme
|
|
21
42
|
|
|
22
43
|
{{#if useSage}}
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
44
|
+
Theme located at `content/themes/{{themeName}}/`.
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
lando theme-bootstrap # Install theme dependencies
|
|
48
|
+
lando acorn make:component ComponentName
|
|
49
|
+
lando acorn acf:block BlockName
|
|
50
|
+
```
|
|
26
51
|
{{else}}
|
|
27
|
-
|
|
28
|
-
{{/if}}
|
|
52
|
+
No Sage theme configured.
|
|
53
|
+
{{/if}}
|