Navegação principalMain navigation
Escolha o nível de detalhe conforme o seu papel ou a pergunta que precisa responder. Choose the level of detail based on your role or the question you need to answer.
Visão de GestãoManagement Overview
Explicação simples para administração, direção e gestores de projeto.Simple explanation for administration, directors, and project managers.
Abrir visão de gestãoOpen management overview 🧭Arquitetura TécnicaTechnical Architecture
Mapa técnico para programadores, suporte, DevOps e futuros responsáveis de manutenção.Technical map for developers, support, DevOps, and future maintainers.
Abrir arquitetura técnicaOpen technical architecture 🖥️Análise Kiosk/POSKiosk/POS Deep Dive
POS, self-service, dinheiro, impressoras, leitores locais e fluxos com DSCore.POS, self-service, cash devices, printers, local readers, and DSCore flows.
Abrir módulo kioskOpen kiosk module 🍽️Análise CantinaCanteen Deep Dive
Validação de refeições, leitores locais/rede, UI, serviços e dados.Meal validation, local/network readers, UI, services, and data.
Abrir módulo cantinaOpen canteen module 🚪Análise PortõesGates Deep Dive
Entradas/saídas, GateEntries, DSCommServer, UDPManager e abertura manual.Entries/exits, GateEntries, DSCommServer, UDPManager, and manual opening.
Abrir módulo portõesOpen gates module 📌Portal OriginalOriginal Portal
Primeira versão do briefing HTML, com visão mista técnica e gestão.First HTML briefing version, with a mixed technical and management view.
Abrir portal originalOpen original portalPor onde começar?Where should I start?
Use estes percursos para reduzir o tempo de leitura e chegar rapidamente ao documento certo. Use these paths to reduce reading time and quickly reach the right document.
🏢 Para gestãoFor management
Comece pela visão de gestão para entender valor de negócio, riscos, complexidade e roadmap.Start with the management view to understand business value, risks, complexity, and roadmap.
Ir para GestãoGo to Management🧑💻 Para programadoresFor developers
Leia a arquitetura técnica e depois escolha o módulo: kiosk, cantina ou portões.Read the technical architecture and then choose a module: kiosk, canteen, or gates.
Ir para TécnicoGo to Technical🛠️ Para suporte/diagnósticoFor support/debugging
Use os deep dives para seguir fluxos, identificar dependências e aplicar checklists de diagnóstico.Use the deep dives to follow flows, identify dependencies, and apply diagnostic checklists.
Começar por PortõesStart with GatesÁreas-chave do sistemaKey system areas
O sistema é mais fácil de compreender quando separado por áreas de responsabilidade. The system is easier to understand when split by responsibility area.
Aplicações de utilizadorUser applications
POS/kiosk, monitores de portão, cantina, back-office e portal.POS/kiosk, gate monitors, canteen, back-office, and portal.
Serviços backendBackend services
DSCore decide regras; DSCommServer comunica com hardware; CloudSync sincroniza.DSCore decides rules; DSCommServer talks to hardware; CloudSync synchronizes.
Base de dadosDatabase
Memória oficial para utilizadores, cartões, saldos, vendas, configurações e histórico.Official memory for users, cards, balances, sales, configuration, and history.
Hardware localLocal hardware
Leitores USB/COM, validadores de moedas/notas, impressoras, scanners e webcams.USB/COM readers, coin/bill validators, printers, scanners, and webcams.
Hardware de redeNetwork hardware
Leitores RFID, portões/torniquetes e controladores de vending ligados por rede.RFID readers, gates/turnstiles, and vending controllers connected through the network.
ModernizaçãoModernization
Diagnóstico, observabilidade, interfaces de hardware e APIs modernas antes de reescrever UI.Diagnostics, observability, hardware interfaces, and modern APIs before rewriting UI.
flowchart LR
Pessoas["Alunos, staff, pais, operadores"]
Apps["Aplicações: POS, kiosk, cantina, back-office, portal"]
DSCore["DSCore: cérebro de negócio"]
DSComm["DSCommServer: tradutor de hardware"]
DB[("Base de dados local")]
Cloud["Cloud / web"]
Local["Hardware local: COM, dinheiro, impressora, webcam"]
Rede["Hardware rede: leitores, portões, vending"]
Pessoas --> Apps
Apps --> DSCore
Apps --> Local
DSCore --> DB
DSComm --> DSCore
DSComm --> Rede
DSCore --> Cloud
flowchart LR
People["Students, staff, parents, operators"]
Apps["Applications: POS, kiosk, canteen, back-office, portal"]
DSCore["DSCore: business brain"]
DSComm["DSCommServer: hardware translator"]
DB[("Local database")]
Cloud["Cloud / web"]
Local["Local hardware: COM, cash, printer, webcam"]
Network["Network hardware: readers, gates, vending"]
People --> Apps
Apps --> DSCore
Apps --> Local
DSCore --> DB
DSComm --> DSCore
DSComm --> Network
DSCore --> Cloud
Nota sobre a origem da documentaçãoGenerated from source-code analysis
Estes documentos foram gerados a partir da análise da solução existente e dos ficheiros de documentação já criados. These documents were generated from analysis of the existing solution and the documentation files already created.
ConfirmadoConfirmed
Projetos, serviços, classes, endpoints, dispositivos e fluxos descritos foram inferidos dos ficheiros analisados.Projects, services, classes, endpoints, devices, and flows were inferred from the analyzed files.
Assunções marcadasMarked assumptions
Quando o modelo físico exato ou caminho de execução não está totalmente provado, os documentos assinalam a incerteza.When the exact physical model or execution path is not fully proven, the documents mark the uncertainty.