How joaovgomees/gerenciador-de-ordens-de-servico works
GestaoOsAPI is an ASP.NET Core service for managing service orders (OS) and users. Emitters create orders; managers sign for their sectors; administrators validate or cancel them; executants can view orders. Login validates credentials and issues a JWT, while protected API requests serve user and order operations. Order state advances from waiting for signatures to validation and then completion or cancellation. Repository and service excerpts support the storage and business-rule links; order-controller wiring is not shown, so that link is marked unverified.
Main entry points: OscService.cs Order rules · UsuarioService.cs User rules · UsuarioController.cs User endpoints · OscRepository.cs Order repository
Components 18
API and authentication
- User endpoints
GestaoOscAPI/GestaoOscAPI/Controllers/UsuarioController.cs - Login and JWT
GestaoOscAPI/GestaoOscAPI/Services/UsuarioService.cs - Token issuer
GestaoOscAPI/GestaoOscAPI/Services/TokenService.cs
Service orders
- Order endpoints
GestaoOscAPI/GestaoOscAPI/Controllers/OscController.cs - Order rules
GestaoOscAPI/GestaoOscAPI/Services/OscService.cs - Order record
GestaoOscAPI/GestaoOscAPI/Models/Entities/Osc.cs - Order lifecycle
GestaoOscAPI/GestaoOscAPI/Models/Enums/StatusOsc.cs - Order response
GestaoOscAPI/GestaoOscAPI/Models/Responses/OscResponse.cs
User management
- User rules
GestaoOscAPI/GestaoOscAPI/Services/UsuarioService.cs - User record
GestaoOscAPI/GestaoOscAPI/Models/Entities/Usuario.cs - Roles and sectors
GestaoOscAPI/GestaoOscAPI/Models/Enums/PerfilUsuario.cs - Sector values
GestaoOscAPI/GestaoOscAPI/Models/Enums/Setor.cs - User response
GestaoOscAPI/GestaoOscAPI/Models/Responses/UsuarioResponse.cs
Persistence and domain
- Order repository
GestaoOscAPI/GestaoOscAPI/Repositories/OscRepository.cs - User repository
GestaoOscAPI/GestaoOscAPI/Repositories/UsuarioRepository.cs - EF data context
GestaoOscAPI/GestaoOscAPI/Data/AppDbContext.cs - PostgreSQL store
Other components
- API client
Connections 20
- API client → User endpoints: calls
README.md - API client → Order endpoints: calls
README.md - User endpoints → User rules: calls
GestaoOscAPI/GestaoOscAPI/Controllers/UsuarioController.cs - User endpoints → Token issuer: issues token
GestaoOscAPI/GestaoOscAPI/Controllers/UsuarioController.cs - User endpoints → User response: maps response
GestaoOscAPI/GestaoOscAPI/Controllers/UsuarioController.cs - Order endpoints → Order rules: delegates to
GestaoOscAPI/GestaoOscAPI/Controllers/OscController.cs - Order rules → Order repository: reads and writes
GestaoOscAPI/GestaoOscAPI/Services/OscService.cs - Order rules → User rules: checks user
GestaoOscAPI/GestaoOscAPI/Services/OscService.cs - User rules → User repository: reads and writes
GestaoOscAPI/GestaoOscAPI/Services/UsuarioService.cs - Order repository → EF data context: queries and saves
GestaoOscAPI/GestaoOscAPI/Repositories/OscRepository.cs - User repository → EF data context: queries and saves
GestaoOscAPI/GestaoOscAPI/Repositories/UsuarioRepository.cs - EF data context → PostgreSQL store: persists entities
- Order repository → Order record: loads and stores
GestaoOscAPI/GestaoOscAPI/Repositories/OscRepository.cs - User repository → User record: loads and stores
GestaoOscAPI/GestaoOscAPI/Repositories/UsuarioRepository.cs - Order rules → Order lifecycle: checks and advances
GestaoOscAPI/GestaoOscAPI/Services/OscService.cs - Order rules → Sector values: checks signatures
GestaoOscAPI/GestaoOscAPI/Services/OscService.cs - User rules → Roles and sectors: checks role
GestaoOscAPI/GestaoOscAPI/Services/UsuarioService.cs - User rules → Sector values: filters users
GestaoOscAPI/GestaoOscAPI/Services/UsuarioService.cs - Order response → Order record: maps fields
GestaoOscAPI/GestaoOscAPI/Models/Responses/OscResponse.cs - User response → User record: maps fields
GestaoOscAPI/GestaoOscAPI/Models/Responses/UsuarioResponse.cs