How 1babii1/ds works
dsPortfolio is a distributed organization-management platform, not a single application: its main user workflow manages departments, positions, locations, and employees, with rewards and other capabilities alongside it. The README also documents account security, notifications, cross-entity search, an AI assistant that proposes user-approved changes, and audit-based organization history. The graph captures those documented product branches and a few source-index-supported internal layers. Most service wiring was not sampled, so undocumented connections are omitted rather than inferred.
Main entry points: frontend Web application · McpServer Assistant tools · EmployeeController.cs Employee API · AuditController.cs Audit and history API
Components 18
Identity and access
- Authentication
backend/AuthService/AuthService.Web
Organization management
- Directory API
backend/DirectoryService/DirectoryService - Directory model
backend/DirectoryService/DirectoryService.Domain/Departments/Department.cs - Directory persistence
backend/DirectoryService/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs - Employee API
backend/EmployeeService/EmployeeService.Web/Controllers/EmployeeController.cs - Employee commands
backend/EmployeeService/EmployeeService.Application/Employees/Commands - Employee model
backend/EmployeeService/EmployeeService.Domain/Employee.cs
Rewards and notifications
- Rewards ledger
backend/RewardsService/RewardsService.Web/Controllers/RewardsController.cs - Notifications
backend/NotificationService/NotificationService.Web/Controllers/NotificationsController.cs
Search and history
- Cross-entity search
backend/SearchService - Audit and history API
backend/AuditService/AuditService.Web/Controllers/AuditController.cs - Audit event store
backend/AuditService/AuditService.Infrastructure/AuditDbContext.cs - Organization replay
backend/AuditService/AuditService.Domain/OrgReplay.cs
User experience
- Web application
frontend - AI assistant route
frontend/app/api/assistant/route.ts - Assistant tools
backend/McpServer
Other components
- User
- Event broker
Connections 25
- User → Web application: uses
- Web application → Authentication: authenticates
- Web application → Directory API: manages organization
- Web application → Employee API: manages employees
- Web application → Rewards ledger: uses rewards
- Web application → Notifications: receives updates
- Web application → Cross-entity search: searches
- Web application → Audit and history API: views history
README.md - User → AI assistant route: requests proposals
README.md - AI assistant route → Assistant tools: uses tools
- Assistant tools → Directory API: resolves organization data
README.md - Assistant tools → Employee API: proposes employee changes
README.md - Assistant tools → Rewards ledger: proposes grants
README.md - Assistant tools → Audit and history API: reads snapshots
README.md - Directory API → Directory model: uses model
backend/DirectoryService/DirectoryService/Controllers/DepartmentController.cs - Directory persistence → Directory model: persists entities
backend/DirectoryService/DirectoryService.Infrastructure.Postgres/DirectoryServiceDbContext.cs - Employee API → Employee commands: dispatches commands
backend/EmployeeService/EmployeeService.Web/Controllers/EmployeeController.cs - Employee commands → Employee model: updates employees
backend/EmployeeService/EmployeeService.Application/Employees/Commands/HireEmployeeHandler.cs - Employee API → Directory API: looks up directory
- Employee API → Rewards ledger: returns wallet copy
backend/EmployeeService/EmployeeService.Web/Controllers/EmployeeController.cs - Event broker → Audit event store: delivers events
README.md - Audit and history API → Audit event store: reads events
backend/AuditService/AuditService.Web/Controllers/AuditController.cs - Audit and history API → Organization replay: rebuilds snapshot
backend/AuditService/AuditService.Web/Controllers/AuditController.cs - Event broker → Notifications: delivers updates
- Event broker → Cross-entity search: feeds index