{"id":29225463,"url":"https://github.com/sisoudev/academic-system-ui","last_synced_at":"2025-10-06T22:50:59.713Z","repository":{"id":301994413,"uuid":"1009153196","full_name":"SisouDev/academic-system-ui","owner":"SisouDev","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-30T01:33:32.000Z","size":261,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-30T02:35:34.170Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SisouDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-26T16:58:55.000Z","updated_at":"2025-06-30T01:33:35.000Z","dependencies_parsed_at":"2025-06-30T02:47:27.728Z","dependency_job_id":null,"html_url":"https://github.com/SisouDev/academic-system-ui","commit_stats":null,"previous_names":["sisoudev/academic-system-ui"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SisouDev/academic-system-ui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SisouDev%2Facademic-system-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SisouDev%2Facademic-system-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SisouDev%2Facademic-system-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SisouDev%2Facademic-system-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SisouDev","download_url":"https://codeload.github.com/SisouDev/academic-system-ui/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SisouDev%2Facademic-system-ui/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263279305,"owners_count":23441683,"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","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-07-03T07:10:20.453Z","updated_at":"2025-10-06T22:50:59.705Z","avatar_url":"https://github.com/SisouDev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎓 Academic System - Frontend\n\n![React](https://img.shields.io/badge/React-18.x-61DAFB?logo=react)\n![TypeScript](https://img.shields.io/badge/TypeScript-4.x-3178C6?logo=typescript)\n![Vite](https://img.shields.io/badge/Vite-4.x-646CFF?logo=vite\u0026logoColor=white)\n![SASS](https://img.shields.io/badge/SASS-%23CC6699?logo=sass\u0026logoColor=white)\n![Framer Motion](https://img.shields.io/badge/Framer--Motion-Animações-black?logo=framer\u0026label=Animations)\n![Status](https://img.shields.io/badge/Status-Em%20Desenvolvimento-yellow)\n\n## 📘 Sobre o Projeto\n\nEste repositório contém o **frontend do Academic System**, uma plataforma de gerenciamento acadêmico desenvolvida com **React**, **TypeScript** e **Vite**. A aplicação consome uma **API RESTful** construída em Spring Boot e oferece uma experiência moderna e responsiva para diferentes perfis de usuários: **Alunos**, **Professores**, **Administradores** e **Funcionários**.\n\n\u003e 🔧 O projeto está em desenvolvimento contínuo, com novas funcionalidades sendo implementadas regularmente.\n\n---\n\n## ✨ Funcionalidades Principais\n\nO sistema é baseado em perfis de usuário, cada um com seu próprio painel e permissões específicas:\n\n### 🔐 Autenticação Segura\n- Login via JWT.\n- Estado de autenticação gerenciado globalmente com React Context API.\n\n### 🔒 Roteamento Protegido\n- Controle de acesso baseado em perfis (`ROLE_ADMIN`, `ROLE_TEACHER`, `ROLE_STUDENT`, etc).\n\n### 📊 Dashboards Personalizados\n- **Administrador**: Estatísticas globais, gráficos com distribuição por curso, feed de atividades.\n- **Professor**: Acesso às turmas, planos de aula, agenda e conteúdos.\n- **Aluno**: Matérias, notas, frequência, avaliações futuras e calendário acadêmico.\n- **Funcionário**: Painel adaptado para bibliotecários, técnicos e RH, com widgets por função.\n\n### 📚 Gerenciamento de Aulas\n- Criação de aulas com editor avançado (**TinyMCE**) que suporta texto, imagens e links.\n\n### 📨 Notificações em Tempo Real\n- Integração com WebSockets (**STOMP/SockJS**) para alertas e atualizações instantâneas.\n\n### 💻 Interface Moderna e Reativa\n- Estilização com **React Bootstrap** e **SASS**.\n- Animações com **Framer Motion** e **AOS**.\n\n---\n\n## 🚀 Tecnologias Utilizadas\n\n### Core\n- React\n- TypeScript\n- Vite\n\n### Gerenciamento de Estado e Dados\n- React Query (`@tanstack/react-query`)\n- React Context API\n\n### Roteamento\n- React Router DOM\n\n### Comunicação com API\n- Axios\n- WebSockets com STOMP.js + SockJS\n\n### UI \u0026 Estilização\n- React Bootstrap\n- SASS/SCSS\n- Framer Motion\n- AOS (Animate on Scroll)\n- Lucide React (ícones)\n\n### Formulários\n- React Hook Form\n- Yup\n\n### Editor de Texto\n- TinyMCE (WYSIWYG)\n\n---\n\n## 🛠️ Instalação e Execução\n\n### ✅ Pré-requisitos\n\n- Node.js 18+\n- NPM ou Yarn\n\n### 📥 Passos para rodar o projeto localmente:\n\n```bash\n# Clone o repositório\ngit clone https://github.com/seu-usuario/seu-repositorio.git\ncd seu-repositorio\n\n# Instale as dependências\nnpm install\n```\n\n### ⚙ ️Variáveis de Ambiente\nCrie um arquivo `.env` na raiz do projeto com as seguintes variáveis:\n\n```env\nVITE_API_BASE_URL=http://localhost:8080\nVITE_TINYMCE_API_KEY=sua_chave_api_do_tinymce\n```\n### ▶️ Executando o projeto\n```bash\n# Inicie o servidor de desenvolvimento\nnpm run dev\n```\nA aplicação estará disponível em http://localhost:5173.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsisoudev%2Facademic-system-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsisoudev%2Facademic-system-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsisoudev%2Facademic-system-ui/lists"}