Skip to content

Releases: Som3a99/company-management-system

CompanyFlow v1.0.0 – Initial Production Release

04 Mar 22:52

Choose a tag to compare

CompanyFlow v1.0.0 – Initial Production Release

The first stable release of CompanyFlow, a full-featured ASP.NET Core MVC enterprise management platform for centralized employee, department, project, and task management with role-based access control, AI-powered analytics, and real-time notifications.


Key Features

Organization Management

  • Department CRUD with unique code validation, manager assignment, and soft-delete
  • Employee lifecycle management with image upload, salary validation, phone sanitization, and file signature verification
  • User account management with secure password generation, role assignment, and activation/deactivation

Project & Task Management

  • Project CRUD with code format validation (PRJ-YYYY-XXX), team assignment, budget tracking, and status lifecycle
  • Kanban-style task board with priority levels, status transitions, @mention comments, and AI-powered description generation
  • RESTful Task API (/api/tasks) with optimistic concurrency via RowVersion

Role-Based Dashboards

  • CEO Executive Dashboard — Organization-wide KPIs, AI intelligence data, team health scores, anomaly alerts, weekly digest
  • IT Admin Dashboard — System health, security monitoring (failed logins, locked accounts), cache metrics, audit logs
  • Manager Dashboard — Team workload analysis, task metrics, project progress tracking
  • Employee Dashboard — Personal task list, overdue/due-soon alerts, project summaries

Reporting & Analytics

  • Task, Project, Department, Audit, and Estimation Accuracy reports
  • Multi-format export: CSV, PDF, Excel, HTML
  • Background report job queue with completion notifications
  • Saveable report filter presets
  • Scope-based access control (CEO → all, Manager → own scope)
  • Rate-limited reporting endpoints (token bucket, 30 req/min)

AI-Powered Intelligence

  • Executive report summaries via Google Gemini 2.0 Flash API (with template fallback)
  • AI task description generation (Goal, Steps, Definition of Done)
  • Task risk scoring (0–100) based on due date, priority, status, and assignment
  • Employee workload analysis and task assignment suggestions
  • Project completion forecasting based on team velocity
  • Team health scoring with risk factor identification
  • Audit anomaly detection (brute-force, suspicious activity patterns)
  • Executive weekly digest aggregation

Notifications

  • Real-time push notifications via SignalR
  • 12 notification types with Info / Warning / Critical severity levels
  • Per-user notification preferences with category-level mute controls
  • SMTP email notifications for critical events
  • Automated notification archiving (90 days) and hard deletion (365 days)

Background Processing

  • ReportJobWorkerService — Queued report generation
  • TaskDeadlineNotificationJob — Due-soon (48h) and overdue alerts every 6 hours
  • AnomalyDetectionNotificationJob — Audit anomaly scanning every 2 hours
  • NotificationArchiveJob / NotificationHardDeleteJob — Daily notification lifecycle
  • CacheWarmupHostedService / CacheTelemetryHostedService — Startup cache warming and hit/miss telemetry

Security & Administration

  • ASP.NET Core Identity with strong password policy (12+ chars, 6 unique)
  • Hybrid role-based + claim-based authorization (5 roles, 6 policies)
  • Custom ApplicationUserClaimsPrincipalFactory injecting domain claims at login
  • IT-admin-approved password reset workflow with ticket numbers
  • Account lockout (5 attempts → 15-min lockout)
  • Comprehensive audit logging with IP address and user agent tracking
  • HTTP security headers: CSP, HSTS, X-Frame-Options, X-Content-Type-Options, X-XSS-Protection
  • Anti-forgery tokens, CSRF protection, input sanitization, file upload validation

Architecture Highlights

  • Three-layer architecture: ERP.PL (Presentation) → ERP.BLL (Business Logic) → ERP.DAL (Data Access)
  • Repository + Unit of Work pattern with generic and specialized repositories
  • Dependency Injection throughout with scoped, singleton, and transient lifetimes
  • EF Core 8.0 with Fluent API configurations, global query filters (soft-delete), and optimistic concurrency
  • 7 background hosted services for scheduled and continuous processing
  • SignalR hub for real-time notification delivery
  • AutoMapper profiles for entity ↔ ViewModel mapping
  • In-memory caching with size limits, telemetry tracking, and prefix-based invalidation
  • Global exception handling middleware with environment-aware error responses
  • Environment-aware database seeding (Development sample data / Production admin-only)

Technology Stack

Category Technology
Runtime .NET 8.0
Web Framework ASP.NET Core MVC
ORM Entity Framework Core 8.0.24
Database SQL Server
Authentication ASP.NET Core Identity
Real-Time SignalR
Object Mapping AutoMapper 16.0
AI Google Gemini 2.0 Flash API
Email SMTP (System.Net.Mail)
Caching IMemoryCache
Testing xUnit · Moq · FluentAssertions · WebApplicationFactory · EF InMemory
Load Testing k6
Code Coverage Coverlet
CI/CD GitHub Actions
Frontend Razor Views · Bootstrap

CI/CD Pipelines

  • CI Tests & Coverage — Runs on all pushes/PRs; executes tests with XPlat Code Coverage and uploads artifacts
  • Security Scans — Dependency review on PRs + weekly NuGet vulnerability scanning

Notes

This is the first stable release of CompanyFlow. Future releases will expand functionality with API endpoints for mobile integration, advanced analytics, Docker containerization, multi-tenancy support, and two-factor authentication.