How shirowei/ruoyi-oa-demo works
RuoYi OA is a workflow-centered office collaboration platform. Employees use the web client through the gateway to submit leave, reimbursement, or travel applications; approval creates a numbered application and flow, creates a linked todo, and later completes that todo when approved or rejected. Separate services provide the todo center, calendar, contacts, and portal dashboard/assistant; the portal aggregates business-service data. System administration and authentication support the platform. The README documents the cross-service links; only selected source excerpts were sampled, so other internal calls are not inferred.
Main entry points: gateway API gateway · dashboard Dashboard statistics · approval Approval service · oa Portal aggregator
Components 16
Access and identity
- OA web client
ruoyi-ui/src/main.js - API gateway
ruoyi-gateway/src/main/java/com/ruoyi/gateway - Authentication
ruoyi-auth/src/main/java/com/ruoyi/auth
Approval workflow
- Approval service
ruoyi-modules/ruoyi-approval/src/main/java/com/ruoyi/oa/approval - Todo service
ruoyi-modules/ruoyi-todo
Office collaboration
- Calendar service
ruoyi-modules/ruoyi-calendar/src/main/java/com/ruoyi/oa/calendar - Contacts service
ruoyi-modules/ruoyi-contacts/src/main/java/com/ruoyi/oa/contacts
Workplace portal
- Portal aggregator
ruoyi-modules/ruoyi-portal/src/main/java/com/ruoyi/oa - Dashboard statistics
ruoyi-modules/ruoyi-portal/src/main/java/com/ruoyi/oa/dashboard - Demo assistant
ruoyi-modules/ruoyi-portal/src/main/java/com/ruoyi/oa/ai
Platform administration
- System administration
ruoyi-modules/ruoyi-system/src/main/java/com/ruoyi/system - OA Feign clients
ruoyi-api/ruoyi-api-oa/src/main/java/com/ruoyi/oa/api - System Feign clients
ruoyi-api/ruoyi-api-system/src/main/java/com/ruoyi/system/api - Redis cache
ruoyi-common/ruoyi-common-redis/src/main/java/com/ruoyi/common/redis/service/RedisService.java - OA database
Other components
- Employee
Connections 25
- Employee → OA web client: uses
- OA web client → API gateway: sends requests
- API gateway → Authentication: routes auth
- API gateway → Approval service: routes OA
- API gateway → Todo service: routes OA
- API gateway → Calendar service: routes OA
- API gateway → Contacts service: routes OA
- API gateway → Portal aggregator: routes portal
- Authentication → System Feign clients: queries users
- Authentication → Redis cache: checks IP cache
- Approval service → OA Feign clients: uses clients
- Approval service → Todo service: creates or completes todo
- Portal aggregator → Dashboard statistics: dispatches dashboard
- Portal aggregator → Demo assistant: dispatches assistant
- Portal aggregator → OA Feign clients: uses clients
- Dashboard statistics → Approval service: aggregates statistics
- Dashboard statistics → Todo service: aggregates statistics
- Dashboard statistics → Calendar service: aggregates statistics
- Dashboard statistics → Contacts service: aggregates statistics
- Demo assistant → Dashboard statistics: uses business statistics
- System administration → OA database: persists administration
- Approval service → OA database: persists applications
- Todo service → OA database: persists todos
- Calendar service → OA database: persists events
- Contacts service → OA database: persists contacts