{"id":27701942,"url":"https://github.com/vortex2jm/ata-manager","last_synced_at":"2025-09-02T17:44:05.546Z","repository":{"id":185377906,"uuid":"660804869","full_name":"vortex2jm/ata-manager","owner":"vortex2jm","description":"This is a script to manage meeting reports and notes automatically every week (using google API's)","archived":false,"fork":false,"pushed_at":"2023-10-30T14:59:49.000Z","size":184,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-25T20:40:22.018Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vortex2jm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-06-30T22:29:47.000Z","updated_at":"2023-11-12T22:47:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"1eff6bec-1072-4689-960b-392ba874b390","html_url":"https://github.com/vortex2jm/ata-manager","commit_stats":null,"previous_names":["vortex2jm/reports-manager","vortex2jm/ata-manager"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vortex2jm/ata-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vortex2jm%2Fata-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vortex2jm%2Fata-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vortex2jm%2Fata-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vortex2jm%2Fata-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vortex2jm","download_url":"https://codeload.github.com/vortex2jm/ata-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vortex2jm%2Fata-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273324428,"owners_count":25085483,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-02T02:00:09.530Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-25T20:34:15.868Z","updated_at":"2025-09-02T17:44:05.523Z","avatar_url":"https://github.com/vortex2jm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [PET](https://pet.inf.ufes.br/) Gerenciador de atas :gear:\n\n## Requisitos :arrow_down:\n - Primeiramente, crie um arquivo de crendenciais no Google Cloud Developers, nomeie como **credentials.json**, e insira-o na pasta *credentials/*.\n - Para criar este arquivo, ative as API`s do Google Drive e do Google Sheets.\n - Antes de rodar o container, é necessário a autenticação deste arquivo de credenciais. Dessa forma, após terminar a leitura desta sessão, vá para a sessão que ensina a executar o código fora do docker. Essa execução é necessária para você autorizar a aplicação a ter acesso ao seu *Google Drive* e a criação automática de um arquivo chamado *token.json*.\n - Copie o arquivo **.env.example** e renomeie a cópia como **.env**. Agora adicione as variáveis de ambiente correspondentes (no primeiro arquivo citado há o detalhamento de cada variável de ambiente).\n - Crie uma senha de aplicativo para o email que enviará as mensagens.\n - Este script deve ser utilizado no drive compartilhado do PET.\n\n## Como funciona?\n - Para utilizar este script é necessário a criação de uma planilha do seguinte modelo:\n    ![image](documentation/assets/planilha.png)\n - A primeira coluna contém o nome de todos os petianos.\n - A segunda coluna (STATUS) corresponde a quem já preencheu a ATA nesta respectiva rodada. Todos que estiverem com 1, já preencheram, e os que estiverem com 0, ainda não preencheram. Assim que todos estiverem o valor 1, a coluna reseta para 0.\n - A terceira coluna corresponde aos respectivos email dos petianos.\n - A quarta coluna (PRESENÇA) corresponde a quem está presente na reunião. Caso a pessoa não esteja presente e for sua vez de preencher a ATA, ela será pulada nesta rodada e acionada na próxima. **Nesta coluna o Rodrigo sempre terá o valor 0, pois ele não preenche a ATA**.\n - A quinta coluna corresponde ao horário em que o script irá funcionar. **Atente-se ao formato hh:mm**.\n - A sexta e última coluna possui o dia da reunião. **Só podem ser utilizados dias de segunda-feira à sexta-feira. Os nomes dos dias são com letra minúscula e separados por hífem**.\n - O script recolhe os dados da planilha toda vez que ele roda, ou seja, se deseja mudar algum parâmetro da planilha, o script só colherá os dados no dia em que foi agendado previamente (com valores antigos da planilha). **Caso precise mudar algo de imediato, pare a sua execução e inicie novamente**.\n - Esta planilha deve estar numa pasta acompanhada do **Modelo Ata** (O arquivo deve ter exatamente este nome) e de vários diretórios com o nome de todos os meses do ano com as iniciais maiúsculas. \n    ![image](documentation/assets/pasta.png)\n\n### Para usar com o docker :whale:\n - No diretório já possui um dockerfile, basta fazer o *build* da imagem utilizando o comando abaixo e inserindo o nome da imagem no local indicado:\n```bash\nsudo docker build -t \u003cnome da imagem\u003e . \n```\n - Com a imagem pronta, basta rodar o *container* com as flags de sua preferência, por exemplo:\n```bash\nsudo docker run --name \u003cnome do container\u003e -d --restart=always \u003cnome da imagem\u003e \n```\n#### OBS\n - Para fazer o *deploy* na nossa *VM*, utilizamos o portainer.\n - O *build* da imagem a é criado a partir deste repositório.\n\n### Para usar sem o docker\n - Para utilizar fora de um container, primeiramente é necessária a instalação das bibliotecas. Execute o comando abaixo a partir do diretório *root*: \n```bash\npip install -r documentation/requirements.txt\n```\n**Se preferir pode fazer a utilização do *virtualenv* do Python**\n\nPara executar basta estar no diretório *root* do script e executar o seguinte comando:\n```bash\npython3 src/main.py\n```\n#\n\n##### Em caso de dúvidas, entre em contato:\n\u003ca href = \"mailto:joaopaulomoura5328@gmail.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/-Gmail-%23333?style=for-the-badge\u0026logo=gmail\u0026logoColor=white\" target=\"_blank\"\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvortex2jm%2Fata-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvortex2jm%2Fata-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvortex2jm%2Fata-manager/lists"}