Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs #41

Closed
wants to merge 72 commits into from
Closed

Docs #41

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
72 commits
Select commit Hold shift + click to select a range
f0c2228
Init Docs branch
viniciusvieira00 Nov 6, 2024
b81c3a4
Theme language adjustment
viniciusvieira00 Nov 6, 2024
1e88410
docs: updating yml file
BrunoBReis Nov 7, 2024
199695c
docs: creating an adding text to cenario-atual
BrunoBReis Nov 7, 2024
c295ae0
docs: fishbone asset
BrunoBReis Nov 7, 2024
cf7327a
docs: creating and adding texto to solucao-proposta
BrunoBReis Nov 7, 2024
1c06b24
docs: creating files for another topics
BrunoBReis Nov 7, 2024
8cc507a
docs: removing sobre page
BrunoBReis Nov 7, 2024
a86863e
Merge pull request #2 from mdsreq-fga-unb/1-atualizacao-da-documentacao
viniciusvieira00 Nov 8, 2024
a217bcf
style: adding css to mkdocs
BrunoBReis Nov 8, 2024
942cfe1
docs: adding docs to estrategias
BrunoBReis Nov 8, 2024
1186a5c
docs: updating date
BrunoBReis Nov 8, 2024
c635792
docs: Update cenario-atual
PauloFilho2 Nov 8, 2024
78160d0
docs: Update solucao-proposta
PauloFilho2 Nov 8, 2024
0e150c5
Merge pull request #16 from mdsreq-fga-unb/14-nova-versao-da-primeira…
PauloFilho2 Nov 8, 2024
aa4f483
ci: moving ci to docs branch
BrunoBReis Nov 8, 2024
43e2f63
docs: adding simple text to test
BrunoBReis Nov 8, 2024
4f84d4e
Merge pull request #18 from mdsreq-fga-unb/17-ci-nao-esta-funcionando
BrunoBReis Nov 8, 2024
69f7b10
docs: Creating and adding text to interacao-entre-equipe-e-cliente
PauloFilho2 Nov 8, 2024
4a98bea
Merge pull request #15 from mdsreq-fga-unb/7-33-justificativa
Stain19 Nov 8, 2024
e4f2cfb
Merge with docs
viniciusvieira00 Nov 11, 2024
1e5fb0b
docs: add tabela de versao
PauloFilho2 Nov 11, 2024
540653d
docs: date update
PauloFilho2 Nov 11, 2024
04ba961
Merge pull request #19 from mdsreq-fga-unb/10-51-composição-da-equipe
PauloFilho2 Nov 11, 2024
fc5cfbe
Cronograma de entregas
viniciusvieira00 Nov 11, 2024
dea20cf
ci: Retorno de arquivo previamente excluido
viniciusvieira00 Nov 11, 2024
7be44d7
docs: creating licoes aprendidas
BrunoBReis Nov 12, 2024
3bb00d2
docs: adicao da comunicacao/validacao
fabioaletorres Nov 12, 2024
c82f148
Merge pull request #23 from mdsreq-fga-unb/11-52-comunicação
fabioaletorres Nov 12, 2024
4a76c69
Merge pull request #20 from mdsreq-fga-unb/4-cronograma-e-entregas
Stain19 Nov 12, 2024
e5dc517
docs: fixing
BrunoBReis Nov 12, 2024
0b36c70
Merge pull request #22 from mdsreq-fga-unb/21-fazer-a-parte-de-licoes…
Stain19 Nov 12, 2024
cada5f6
docs: adding meet link
BrunoBReis Nov 12, 2024
c823af6
Merge pull request #25 from mdsreq-fga-unb/24-link-do-reuniao
viniciusvieira00 Nov 12, 2024
c8bfefe
docs: ajuste de requirements.txt
viniciusvieira00 Nov 18, 2024
24a7264
docs: Ajuste mkdocs.yml
viniciusvieira00 Nov 18, 2024
1fd1f7d
docs: Ajustes assets
viniciusvieira00 Nov 18, 2024
7a2d039
docs: Guia de contribuição, assets e página inicial
viniciusvieira00 Nov 18, 2024
699e430
Ajustes de documentação e estilização
viniciusvieira00 Nov 18, 2024
106a8f6
fix: Adjust on docs
viniciusvieira00 Nov 18, 2024
f6d2712
Merge pull request #27 from mdsreq-fga-unb/feature/ajustes-documentacao
viniciusvieira00 Nov 19, 2024
a050763
fix:deployment fix
viniciusvieira00 Nov 19, 2024
cdab23e
docs: add theoric references in the software engineering strategies d…
viniciusvieira00 Nov 19, 2024
7891234
docs: remove unused content on commits policy
viniciusvieira00 Nov 19, 2024
953c31b
docs: change in delivery schedule and sprints
viniciusvieira00 Nov 19, 2024
3e648cd
docs: remove unused text
viniciusvieira00 Nov 19, 2024
d1cb933
docs: updating fish bone diagram
BrunoBReis Nov 24, 2024
9d5d76a
docs: removing deprecated image
BrunoBReis Nov 24, 2024
179272c
docs: adding new image
BrunoBReis Nov 24, 2024
0c88fa0
docs: fixing name with kebab-case
BrunoBReis Nov 24, 2024
9d916df
docs: fixing name and update version
BrunoBReis Nov 24, 2024
54b8001
Merge pull request #37 from mdsreq-fga-unb/doc/30-cronograma-e-entregas
viniciusvieira00 Nov 25, 2024
32a3ab1
Merge pull request #36 from mdsreq-fga-unb/doc/29-estratégias-de-esw
viniciusvieira00 Nov 25, 2024
373f831
Merge pull request #38 from mdsreq-fga-unb/doc/32-cenario-atual
BrunoBReis Nov 25, 2024
cf1aea5
docs: updating gitignore with .venv
BrunoBReis Nov 26, 2024
e73c397
docs: updating politica commits to kabeb case
BrunoBReis Nov 26, 2024
648e60b
docs: updating politica branches to kabeb case
BrunoBReis Nov 26, 2024
82a40b7
docs: updating and translating codigo conduta to kabeb case
BrunoBReis Nov 26, 2024
ceaecbd
docs: simplify cronograma entregas
BrunoBReis Nov 26, 2024
8047a8d
docs: simplify interacao equipe cliente
BrunoBReis Nov 26, 2024
a49bcbd
docs: simplify estrategias ESW
BrunoBReis Nov 26, 2024
371dd9a
docs: updating mkdocs yml file
BrunoBReis Nov 26, 2024
98e8dbb
style: expand sprints
BrunoBReis Nov 27, 2024
6191ae6
docs: updating ferramentas de comunicacao
BrunoBReis Nov 27, 2024
b32d9f7
docs: small fix to branch name
BrunoBReis Nov 27, 2024
0cf23aa
docs:removed unused content
viniciusvieira00 Nov 27, 2024
7d1b991
docs: remove duplicate and unused content
viniciusvieira00 Nov 27, 2024
8394f50
docs: standardizing version control of documents
viniciusvieira00 Nov 27, 2024
2d018d1
Merge pull request #40 from mdsreq-fga-unb/doc/39-pequenas_alteracoes
BrunoBReis Nov 27, 2024
ee56a29
Atualização da composição da equipe
fabioaletorres Nov 30, 2024
6d8fe89
docs: update segmentacao-do-cliente
PauloFilho2 Nov 30, 2024
b788083
Merge pull request #42 from mdsreq-fga-unb/34-empresas-de-manutenção-…
PauloFilho2 Dec 1, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Empty file added .env.example
Empty file.
4 changes: 2 additions & 2 deletions .github/workflows/docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,5 +26,5 @@ jobs:
path: .cache
restore-keys: |
mkdocs-material-
- run: pip install mkdocs-material
- run: mkdocs gh-deploy --force
- run: pip install -r requirements.txt
- run: mkdocs gh-deploy --force
7 changes: 7 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
## Mkdocs ##
site/

## Virtual Environment ##
.env
.venv
venv/
65 changes: 65 additions & 0 deletions assets/home.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
{% extends "main.html" %}
{% block tabs %}
{{ super() }}
<style>
.md-main {
content-visibility: hidden;
}

</style>
<main>
<!-- Hero Section -->
<section class="hero">
<div class="container">
<h1 class="hero-title">Documentação do CRM-ProInjeção</h1>
<p class="hero-paragraph">
O CRM-ProInjeção é um sistema de gerenciamento de clientes e automação de orçamentos para oficinas mecânicas,
desenvolvido para otimizar a eficiência e os processos operacionais.
</p>
<a class="button-primary" href="/2024.2-T01-CRMProInjecao/cenario-atual/">Ver o projeto</a>
</div>
</section>

<!-- Team Section -->
<section class="team-section">
<div class="container">
<div class="team-header">
<h2>Equipe</h2>
<p>Conheça os membros do time responsável pelo CRM-ProInjeção.</p>
</div>
<div class="team-container">
<div class="team-member">
<img src="https://avatars.githubusercontent.com/u/62809606?v=4" alt="Bruno Bragança dos Reis">
<h4>Bruno Bragança</h4>
<p>Matrícula: 221007902</p>
<p>Desenvolvedor</p>
</div>
<div class="team-member">
<img src="https://avatars.githubusercontent.com/u/131913211?v=4" alt="Paulo André Valadão">
<h4>Paulo André Valadão</h4>
<p>Matrícula: 221031229</p>
<p>Desenvolvedor</p>
</div>
<div class="team-member">
<img src="https://avatars.githubusercontent.com/u/111324066?v=4" alt="Fábio Alessandro Torres">
<h4>Fábio Alessandro</h4>
<p>Matrícula: 200037170</p>
<p>Desenvolvedor</p>
</div>
<div class="team-member">
<img src="https://avatars.githubusercontent.com/u/98167728?v=4" alt="Pedro Henrique Braga">
<h4>Pedro Henrique Braga</h4>
<p>Matrícula: 211062384</p>
<p>Desenvolvedor</p>
</div>
<div class="team-member">
<img src="https://avatars.githubusercontent.com/u/64455111?v=4" alt="Vinicius Angelo">
<h4>Vinicius Angelo</h4>
<p>Matrícula: 190118059</p>
<p>Desenvolvedor</p>
</div>
</div>
</div>
</section>
</main>
{% endblock %}
Binary file added assets/images/apple-touch-icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/images/favicon.ico
Binary file not shown.
Binary file added assets/images/favicon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/images/illustration.webp
Binary file not shown.
Binary file added assets/images/logo-vetor.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions assets/javascripts/iconsearch_index.json

Large diffs are not rendered by default.

10 changes: 10 additions & 0 deletions assets/javascripts/main.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
document.addEventListener("DOMContentLoaded", () => {
// Exemplo de animação com anime.js
anime({
targets: ".hero-title",
translateY: [-50, 0],
opacity: [0, 1],
duration: 2000,
easing: "easeOutExpo",
});
});
8 changes: 8 additions & 0 deletions assets/javascripts/removeCredits.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
document.addEventListener("DOMContentLoaded", function() {
removeCredits();
});

function removeCredits(){
document.querySelectorAll('.md-footer')[0].getElementsByClassName("md-footer-meta")[0].remove();
document.querySelectorAll('.md-footer-meta')[0].childNodes[1].remove();
}
264 changes: 264 additions & 0 deletions assets/javascripts/termynal.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,264 @@
/**
* termynal.js
* A lightweight, modern and extensible animated terminal window, using
* async/await.
*
* @author Ines Montani <[email protected]>
* @version 0.0.1
* @license MIT
*/

'use strict';

/** Generate a terminal widget. */
class Termynal {
/**
* Construct the widget's settings.
* @param {(string|Node)=} container - Query selector or container element.
* @param {Object=} options - Custom settings.
* @param {string} options.prefix - Prefix to use for data attributes.
* @param {number} options.startDelay - Delay before animation, in ms.
* @param {number} options.typeDelay - Delay between each typed character, in ms.
* @param {number} options.lineDelay - Delay between each line, in ms.
* @param {number} options.progressLength - Number of characters displayed as progress bar.
* @param {string} options.progressChar – Character to use for progress bar, defaults to █.
* @param {number} options.progressPercent - Max percent of progress.
* @param {string} options.cursor – Character to use for cursor, defaults to ▋.
* @param {Object[]} lineData - Dynamically loaded line data objects.
* @param {boolean} options.noInit - Don't initialise the animation.
*/
constructor(container = '#termynal', options = {}) {
this.container = (typeof container === 'string') ? document.querySelector(container) : container;
this.pfx = `data-${options.prefix || 'ty'}`;
this.originalStartDelay = this.startDelay = options.startDelay
|| parseFloat(this.container.getAttribute(`${this.pfx}-startDelay`)) || 600;
this.originalTypeDelay = this.typeDelay = options.typeDelay
|| parseFloat(this.container.getAttribute(`${this.pfx}-typeDelay`)) || 90;
this.originalLineDelay = this.lineDelay = options.lineDelay
|| parseFloat(this.container.getAttribute(`${this.pfx}-lineDelay`)) || 1500;
this.progressLength = options.progressLength
|| parseFloat(this.container.getAttribute(`${this.pfx}-progressLength`)) || 40;
this.progressChar = options.progressChar
|| this.container.getAttribute(`${this.pfx}-progressChar`) || '█';
this.progressPercent = options.progressPercent
|| parseFloat(this.container.getAttribute(`${this.pfx}-progressPercent`)) || 100;
this.cursor = options.cursor
|| this.container.getAttribute(`${this.pfx}-cursor`) || '▋';
this.lineData = this.lineDataToElements(options.lineData || []);
this.loadLines()
if (!options.noInit) this.init()
}

loadLines() {
// Load all the lines and create the container so that the size is fixed
// Otherwise it would be changing and the user viewport would be constantly
// moving as she/he scrolls
const finish = this.generateFinish()
finish.style.visibility = 'hidden'
this.container.appendChild(finish)
// Appends dynamically loaded lines to existing line elements.
this.lines = [...this.container.querySelectorAll(`[${this.pfx}]`)].concat(this.lineData);
for (let line of this.lines) {
line.style.visibility = 'hidden'
this.container.appendChild(line)
}
const restart = this.generateRestart()
restart.style.visibility = 'hidden'
this.container.appendChild(restart)
this.container.setAttribute('data-termynal', '');
}

/**
* Initialise the widget, get lines, clear container and start animation.
*/
init() {
/**
* Calculates width and height of Termynal container.
* If container is empty and lines are dynamically loaded, defaults to browser `auto` or CSS.
*/
const containerStyle = getComputedStyle(this.container);
this.container.style.width = containerStyle.width !== '0px' ?
containerStyle.width : undefined;
this.container.style.minHeight = containerStyle.height !== '0px' ?
containerStyle.height : undefined;

this.container.setAttribute('data-termynal', '');
this.container.innerHTML = '';
for (let line of this.lines) {
line.style.visibility = 'visible'
}
this.start();
}

/**
* Start the animation and rener the lines depending on their data attributes.
*/
async start() {
this.addFinish()
await this._wait(this.startDelay);

for (let line of this.lines) {
const type = line.getAttribute(this.pfx);
const delay = line.getAttribute(`${this.pfx}-delay`) || this.lineDelay;

if (type == 'input') {
line.setAttribute(`${this.pfx}-cursor`, this.cursor);
await this.type(line);
await this._wait(delay);
}

else if (type == 'progress') {
await this.progress(line);
await this._wait(delay);
}

else {
this.container.appendChild(line);
await this._wait(delay);
}

line.removeAttribute(`${this.pfx}-cursor`);
}
this.addRestart()
this.finishElement.style.visibility = 'hidden'
this.lineDelay = this.originalLineDelay
this.typeDelay = this.originalTypeDelay
this.startDelay = this.originalStartDelay
}

generateRestart() {
const restart = document.createElement('a')
restart.onclick = (e) => {
e.preventDefault()
this.container.innerHTML = ''
this.init()
}
restart.href = '#'
restart.setAttribute('data-terminal-control', '')
restart.innerHTML = "restart ↻"
return restart
}

generateFinish() {
const finish = document.createElement('a')
finish.onclick = (e) => {
e.preventDefault()
this.lineDelay = 0
this.typeDelay = 0
this.startDelay = 0
}
finish.href = '#'
finish.setAttribute('data-terminal-control', '')
finish.innerHTML = "fast →"
this.finishElement = finish
return finish
}

addRestart() {
const restart = this.generateRestart()
this.container.appendChild(restart)
}

addFinish() {
const finish = this.generateFinish()
this.container.appendChild(finish)
}

/**
* Animate a typed line.
* @param {Node} line - The line element to render.
*/
async type(line) {
const chars = [...line.textContent];
line.textContent = '';
this.container.appendChild(line);

for (let char of chars) {
const delay = line.getAttribute(`${this.pfx}-typeDelay`) || this.typeDelay;
await this._wait(delay);
line.textContent += char;
}
}

/**
* Animate a progress bar.
* @param {Node} line - The line element to render.
*/
async progress(line) {
const progressLength = line.getAttribute(`${this.pfx}-progressLength`)
|| this.progressLength;
const progressChar = line.getAttribute(`${this.pfx}-progressChar`)
|| this.progressChar;
const chars = progressChar.repeat(progressLength);
const progressPercent = line.getAttribute(`${this.pfx}-progressPercent`)
|| this.progressPercent;
line.textContent = '';
this.container.appendChild(line);

for (let i = 1; i < chars.length + 1; i++) {
await this._wait(this.typeDelay);
const percent = Math.round(i / chars.length * 100);
line.textContent = `${chars.slice(0, i)} ${percent}%`;
if (percent > progressPercent) {
break;
}
}
}

/**
* Helper function for animation delays, called with `await`.
* @param {number} time - Timeout, in ms.
*/
_wait(time) {
return new Promise(resolve => setTimeout(resolve, time));
}

/**
* Converts line data objects into line elements.
*
* @param {Object[]} lineData - Dynamically loaded lines.
* @param {Object} line - Line data object.
* @returns {Element[]} - Array of line elements.
*/
lineDataToElements(lineData) {
return lineData.map(line => {
let div = document.createElement('div');
div.innerHTML = `<span ${this._attributes(line)}>${line.value || ''}</span>`;

return div.firstElementChild;
});
}

/**
* Helper function for generating attributes string.
*
* @param {Object} line - Line data object.
* @returns {string} - String of attributes.
*/
_attributes(line) {
let attrs = '';
for (let prop in line) {
// Custom add class
if (prop === 'class') {
attrs += ` class=${line[prop]} `
continue
}
if (prop === 'type') {
attrs += `${this.pfx}="${line[prop]}" `
} else if (prop !== 'value') {
attrs += `${this.pfx}-${prop}="${line[prop]}" `
}
}

return attrs;
}
}

/**
* HTML API: If current script has container(s) specified, initialise Termynal.
*/
if (document.currentScript.hasAttribute('data-termynal-container')) {
const containers = document.currentScript.getAttribute('data-termynal-container');
containers.split('|')
.forEach(container => new Termynal(container))
}
19 changes: 19 additions & 0 deletions assets/plugins/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Copyright (c) 2016-2024 Martin Donath <[email protected]>

# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to
# deal in the Software without restriction, including without limitation the
# rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
# sell copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:

# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.

# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
# IN THE SOFTWARE.
Loading