How joyslin-2006/civic-shield works
Civic Shield is a civic-issue reporting and response application: users register or log in, submit issues, and view workers and assignments. The React UI calls separate authentication, issue, and worker services; the issue and worker service trees also expose event, file, and assignment subsystems. UI routing and API calls are shown in excerpts. Backend internals and cross-service event wiring are represented only where the tree supports a meaningful component; unverified connections are dashed.
Main entry points: api.js API clients · App.jsx App routes · AssignmentService.java Assignment logic · AuthServiceImpl.java Auth logic
Components 27
Civic Shield UI
- App routes
civic-shield-ui/src/App.jsx - Login
civic-shield-ui/src/pages/Login.jsx - Registration
civic-shield-ui/src/pages/Register.jsx - Raise issue
civic-shield-ui/src/pages/RaiseIssue.jsx - Dashboard
civic-shield-ui/src/pages/Dashboard.jsx - Workers view
civic-shield-ui/src/pages/Workers.jsx - Assignments view
civic-shield-ui/src/pages/Assignments.jsx - API clients
civic-shield-ui/src/services/api.js
Authentication
- Auth endpoints
auth-service/src/main/java/com/example/auth_service/controller/AuthController.java - Auth logic
auth-service/src/main/java/com/example/auth_service/service/AuthServiceImpl.java - JWT service
auth-service/src/main/java/com/example/auth_service/security/JwtService.java - User repository
auth-service/src/main/java/com/example/auth_service/repository/UserRepository.java
Issue management
- Issue endpoints
issue-service/src/main/java/com/example/issue_service/controller/IssueController.java - Issue logic
issue-service/src/main/java/com/example/issue_service/service/IssueServiceImpl.java - Issue repository
issue-service/src/main/java/com/example/issue_service/repository/IssueRepository.java - File endpoints
issue-service/src/main/java/com/example/issue_service/controller/FileController.java - File service
issue-service/src/main/java/com/example/issue_service/service/FileService.java - Issue event producer
issue-service/src/main/java/com/example/issue_service/kafka/KafkaProducerService.java
Worker response
- Worker endpoints
worker-service/src/main/java/com/example/worker_service/controller/WorkerController.java - Assignment endpoints
worker-service/src/main/java/com/example/worker_service/controller/AssignmentController.java - Assignment logic
worker-service/src/main/java/com/example/worker_service/service/AssignmentService.java - Assignment repository
worker-service/src/main/java/com/example/worker_service/repository/AssignmentRepository.java - Worker repository
worker-service/src/main/java/com/example/worker_service/repository/WorkerRepository.java - Issue event consumer
worker-service/src/main/java/com/example/worker_service/kafka/IssueCreatedConsumer.java
Other components
- User
- Kafka
- MinIO
Connections 31
- User → App routes: uses
civic-shield-ui/src/App.jsx - App routes → Login: routes
civic-shield-ui/src/App.jsx - App routes → Registration: routes
civic-shield-ui/src/App.jsx - App routes → Dashboard: routes
civic-shield-ui/src/App.jsx - App routes → Raise issue: routes
civic-shield-ui/src/App.jsx - App routes → Workers view: routes
civic-shield-ui/src/App.jsx - App routes → Assignments view: routes
civic-shield-ui/src/App.jsx - Login → API clients: calls
civic-shield-ui/src/pages/Login.jsx - Registration → Auth endpoints: posts registration
civic-shield-ui/src/pages/Register.jsx - API clients → Auth endpoints: targets auth
civic-shield-ui/src/services/api.js - Raise issue → API clients: calls
civic-shield-ui/src/pages/RaiseIssue.jsx - API clients → Issue endpoints: targets issues
civic-shield-ui/src/services/api.js - Workers view → API clients: calls
civic-shield-ui/src/pages/Workers.jsx - Assignments view → API clients: calls
civic-shield-ui/src/pages/Assignments.jsx - API clients → Worker endpoints: targets workers
civic-shield-ui/src/services/api.js - API clients → Assignment endpoints: targets assignments
civic-shield-ui/src/services/api.js - Auth endpoints → Auth logic: delegates
- Auth logic → JWT service: uses token service
- Auth logic → User repository: accesses users
- Issue endpoints → Issue logic: delegates
- Issue logic → Issue repository: persists issues
- File endpoints → File service: delegates
- File service → MinIO: stores files
- Issue logic → Issue event producer: publishes event
- Issue event producer → Kafka: publishes
- Kafka → Issue event consumer: delivers event
- Issue event consumer → Assignment logic: triggers assignment
- Worker endpoints → Worker repository: reads workers
- Assignment endpoints → Assignment logic: delegates
- Assignment logic → Assignment repository: stores assignments
- Assignment logic → Worker repository: uses workers