Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ccuffs/app-cc
Aplicativo móvel para uso de alunos, professores e técnicos do curso de Ciência da Computação da UFFS
https://github.com/ccuffs/app-cc
academic aplicativo flutter flutter-apps hacktoberfest hacktoberfest2020 uffs universidade
Last synced: about 1 month ago
JSON representation
Aplicativo móvel para uso de alunos, professores e técnicos do curso de Ciência da Computação da UFFS
- Host: GitHub
- URL: https://github.com/ccuffs/app-cc
- Owner: ccuffs
- License: mit
- Created: 2019-08-26T12:43:08.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-01-11T22:44:00.000Z (about 4 years ago)
- Last Synced: 2024-05-01T20:38:58.756Z (9 months ago)
- Topics: academic, aplicativo, flutter, flutter-apps, hacktoberfest, hacktoberfest2020, uffs, universidade
- Language: Dart
- Homepage: https://uffs.cc/app
- Size: 301 KB
- Stars: 20
- Watchers: 5
- Forks: 5
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
- [Projeto](#projeto)
- [Features](#features)
- [Telas](#telas)
- [Começando](#come%c3%a7ando)
- [Instalação](#instala%c3%a7%c3%a3o)
- [Iniciando o projeto](#iniciando-o-projeto)
- [Arquitetura](#arquitetura)
- [Bloc](#bloc)
- [Estrutura de Pastas](#estrutura%20de%20pastas)
- [Links úteis](#links%20%c3%bateis)
- [Licença](#licen%c3%a7a)
# Aplicativo CCUFFS
## Projeto
Esse repositório contém o código do aplicativo móvel para uso de alunos, professores e técnicos do curso de [Ciência da Computação](https://cc.uffs.edu.br) da [UFFS](http://www.uffs.edu.br), Chapecó/SC.
Veja o arquivo [ROADMAP](ROADMAP.md) para conhecer as funcionalidades esperadas para o aplicativo e um rascunho do plano de desenvolvimento.
> **IMPORTANTE:** Sempre consulte o [CONTRIBUTING](CONTRIBUTING.md) e o [ROADMAP](ROADMAP.md) antes de começar a desenvolver uma nova feature! Um bom começo pode envolver a consulta das [ISSUES](https://github.com/ccuffs/app-cc/issues) abertas.
## Features Implementadas
As principais features do projeto são:
* Login de usuários com IdUFFS;
* Visualização de noticias;
* Leitor de noticias personalizável;
* QrCode único de usuário;
* Exibição de notícias importantes (Mensagens Diretas);
## Telas
Segue abaixo algumas imagens das telas implementadas na versão atual do aplicativo
## Começando
Caso tenha interesse em rodar localmente o projeto, siga os passos abaixo. Levem em consideração que sera necessário a instalação do flutter em seu computador, bem como um emulador ou um dispositivo android conectado e configurado em seu computador para a utilização com o aplicativo.
## Instalação
Tenha certeza de que possui o flutter instalado em seu computador. Mais detalhes sobre a instalação do flutter podem ser encontrados em seu [site oficial](https://flutter.dev/docs/get-started/install).
## Iniciando o projeto
``` bash
git clone https://github.com/ccuffs/app-cc/
```
Vá até o diretório do projeto com o comando abaixo:
``` bash
cd app-cc/
```
Execute o projeto com:
``` bash
flutter run
```
## Arquitetura
### Bloc
Este projeto utiliza bloc como arquitetura de state management. Caso queira contribuir, leve em consideração que não sera admitido a utilização de outro state management (por exemplo providers).
### Estrutura de Pastas
Este projeto possui uma estrutura de pastas bem simples. Todos os blocs podem ser encontrados dentro de lib/blocs e novos blocs devem ser adicionados lá.
Todas as Telas devem ser adicionadas em lib/screens e seus nomes devem seguir o prefixo nome_tela_view. Caso seja necessário, pode-se dividir os widgets e criar novos arquivos de widgets que devem ser adicionados as suas respectivas pastas a não ser que sejam um widget compartilhado.
Widgets compartilhados (usados por varias views) devem ser salvos dentro da pasta shared/widgets
Este projeto não usa uma lógica de controllers para separar funções e da a liberdade de utilização de setState em conjunto ao bloC caso facilite a implementação de determinada feature e mantenha o código consiso.
### Links úteis
- [Bloc Tutoriais](https://flutter.dev/docs/development/data-and-backend/state-mgmt/options#bloc--rx)
- [Bloc biblioteca](https://pub.dev/packages/flutter_bloc)
- [Instalação do Flutter](https://flutter.dev/docs/get-started/install)
- [IDE](https://flutter.dev/docs/get-started/editor?tab=vscode)
## Licença
A [licença](https://github.com/ccuffs/app-cc/blob/master/LICENSE) desse projeto é a MIT License.