152 Commits
Author SHA1 Message Date
khwezi 8688c752d6 Merge pull request 'Enforced relationships between activities and indicators, fixed actuals recording' (#151) from finishline into main
Reviewed-on: #151
2026-10-22 13:49:32 +02:00
khwezi 937a5595d8 Merge pull request 'Implemented audit logging' (#150) from finishline into main
Reviewed-on: #150
2026-10-22 12:37:14 +02:00
khwezi 58ce606410 Merge pull request 'Enforced approval rights' (#149) from finishline into main
Reviewed-on: #149
2026-10-22 11:26:49 +02:00
khwezi a98bfa4308 Merge pull request 'Refactored project view into modal' (#148) from finishline into main
Reviewed-on: #148
2026-10-22 09:42:26 +02:00
khwezi 6e56a4c223 Merge pull request 'Refactored projects page, fixed security user modal' (#147) from finishline into main
Reviewed-on: #147
2026-10-22 07:40:34 +02:00
khwezi e38edd24a0 Merge pull request 'Finishline' (#146) from finishline into main
Reviewed-on: #146
2026-10-22 06:24:18 +02:00
khwezi 1ac0018926 Merge pull request 'Finishline' (#145) from finishline into main
Reviewed-on: #145
2026-10-21 11:07:27 +02:00
khwezi 5ad59f6569 Merge pull request 'Restructured .net solutions' (#144) from finishline into main
Reviewed-on: #144
2026-10-21 10:41:52 +02:00
khwezi 71a0abf0b2 Merge pull request 'Fixed new user username formating' (#143) from finishline into main
Reviewed-on: #143
2026-10-21 10:18:50 +02:00
khwezi 627885e36b Merge pull request 'Finishline' (#142) from finishline into main
Reviewed-on: #142
2026-10-21 08:55:56 +02:00
khwezi 447ffb366e Merge pull request 'Implemented rbac' (#141) from finishline into main
Reviewed-on: #141
2026-10-11 11:17:48 +02:00
khwezi a9bb319eb1 Merge pull request 'Fixed skoruba api value assignment in docker compose' (#140) from finishline into main
Reviewed-on: #140
2026-10-11 08:29:59 +02:00
khwezi bbba869cdd Merge pull request 'Fixed skoruba api address configs' (#139) from finishline into main
Reviewed-on: #139
2026-10-11 08:18:06 +02:00
khwezi 5ae2622454 Merge pull request 'Finishline' (#138) from finishline into main
Reviewed-on: #138
2026-10-11 08:02:57 +02:00
khwezi bd0f03344d Merge pull request 'Finishline' (#137) from finishline into main
Reviewed-on: #137
2026-10-11 07:50:36 +02:00
khwezi 1af860fdc1 Merge pull request 'Redesigned nav bar' (#136) from finishline into main
Reviewed-on: #136
2026-10-04 18:27:34 +02:00
khwezi c04ae9a933 Merge pull request 'Refactored org modal logic' (#135) from finishline into main
Reviewed-on: #135
2026-10-04 18:22:13 +02:00
khwezi 0e853811a9 Merge pull request 'Finishline' (#134) from finishline into main
Reviewed-on: #134
2026-10-04 18:05:14 +02:00
khwezi 3a3d5daefc Merge pull request 'Refactored org create and update models' (#133) from finishline into main
Reviewed-on: #133
2026-10-04 11:13:57 +02:00
khwezi fe9b9052e9 Merge pull request 'Refactored tenant organisatio listing in tenant page' (#132) from finishline into main
Reviewed-on: #132
2026-10-04 11:09:29 +02:00
khwezi d25545ddad Merge pull request 'Corrected boolean logic on bypass filter logic' (#131) from finishline into main
Reviewed-on: #131
2026-10-04 10:58:11 +02:00
khwezi 7effc32498 Merge pull request 'Fine tuned organisation onboarding and tenant management' (#130) from finishline into main
Reviewed-on: #130
2026-10-04 10:35:31 +02:00
khwezi 8909bcf5c4 Merge pull request 'Refactored organisation entities and endpoints' (#129) from finishline into main
Reviewed-on: #129
2026-10-04 10:12:05 +02:00
khwezi 411e603f51 Merge pull request 'Added tenant management' (#128) from finishline into main
Reviewed-on: #128
2026-10-04 09:14:34 +02:00
khwezi 138ef84973 Merge pull request 'Hardened API and catered for Partner role query filter bypass' (#127) from finishline into main
Reviewed-on: #127
2026-10-04 08:19:48 +02:00
khwezi 312721bf51 Merge pull request 'Redesigned dash' (#126) from finishline into main
Reviewed-on: #126
2026-09-29 12:24:27 +02:00
khwezi dd59294911 Merge pull request 'Refactored dashboard' (#125) from finishline into main
Reviewed-on: #125
2026-09-29 11:53:13 +02:00
khwezi 28a3a17a15 Merge pull request 'Fixed missing dependency' (#124) from finishline into main
Reviewed-on: #124
2026-09-28 16:47:20 +02:00
khwezi 4c2b0cd7d5 Merge pull request 'Added dockerfile to partner ui' (#123) from finishline into main
Reviewed-on: #123
2026-09-28 16:33:44 +02:00
khwezi 275fd109e6 Merge pull request 'Finishline' (#122) from finishline into main
Reviewed-on: #122
2026-09-28 16:27:54 +02:00
khwezi 248cc2fa2d Merge pull request 'Fixed timeline height' (#121) from finishline into main
Reviewed-on: #121
2026-09-28 11:56:15 +02:00
khwezi 761d14beb9 Merge pull request 'Light projects page refactor' (#120) from finishline into main
Reviewed-on: #120
2026-09-28 11:45:35 +02:00
khwezi 931e1a8698 Merge pull request 'Refactored projects and milestones page' (#119) from finishline into main
Reviewed-on: #119
2026-09-28 11:34:32 +02:00
khwezi aff58caeb0 Merge pull request 'Removed duplicate filter in settings page' (#118) from finishline into main
Reviewed-on: #118
2026-09-28 11:13:41 +02:00
khwezi 1c5080bf04 Merge pull request 'Added Role column to user directory' (#117) from finishline into main
Reviewed-on: #117
2026-09-28 10:59:34 +02:00
khwezi 1fb157aa0a Merge pull request 'Finishline' (#116) from finishline into main
Reviewed-on: #116
2026-09-28 10:40:39 +02:00
khwezi 0adfae1616 Merge pull request 'Refactored get compliance item endpoint' (#115) from finishline into main
Reviewed-on: #115
2026-09-27 15:06:14 +02:00
khwezi 4856b6e6f4 Merge pull request 'fixed create site visit error' (#114) from finishline into main
Reviewed-on: #114
2026-09-27 14:41:30 +02:00
khwezi 0ba47269aa Merge pull request 'Finishline' (#113) from finishline into main
Reviewed-on: #113
2026-09-27 14:36:16 +02:00
khwezi 5e25fd7a11 Merge pull request 'fixed new change request logic' (#112) from finishline into main
Reviewed-on: #112
2026-09-27 14:16:31 +02:00
khwezi f8fff04065 Merge pull request 'Fixed mismatched endpoint calling' (#111) from finishline into main
Reviewed-on: #111
2026-09-27 14:08:14 +02:00
khwezi aca5882ad3 Merge pull request 'Fixed change management rendering error' (#110) from finishline into main
Reviewed-on: #110
2026-09-27 13:43:34 +02:00
khwezi 6b027193d1 Merge pull request 'Updated api usage, corrected table designs' (#109) from finishline into main
Reviewed-on: #109
2026-09-27 13:32:01 +02:00
khwezi 81702a4bf8 Merge pull request 'Refactored docker compose' (#108) from finishline into main
Reviewed-on: #108
2026-09-27 13:08:13 +02:00
khwezi 5eeb1cbfc7 Merge pull request 'Refactored endpoints' (#107) from finishline into main
Reviewed-on: #107
2026-09-27 13:07:18 +02:00
khwezi fb00986f59 Merge pull request 'Issue creation, reolution is optional' (#106) from finishline into main
Reviewed-on: #106
2026-09-27 12:56:05 +02:00
khwezi 0338737385 Merge pull request 'Fixed UI inconsistencies' (#105) from finishline into main
Reviewed-on: #105
2026-09-27 12:04:56 +02:00
khwezi 82c0936b4c Merge pull request 'Added, beneficiaries, site visits and change management' (#104) from finishline into main
Reviewed-on: #104
2026-09-27 11:42:03 +02:00
khwezi 5d2a886f6f Merge pull request 'Removed settings page mock data and replaced with api calls' (#103) from finishline into main
Reviewed-on: #103
2026-09-27 10:58:50 +02:00
khwezi dc4047ca6d Merge pull request 'Added audit log endpoint' (#102) from finishline into main
Reviewed-on: #102
2026-09-27 10:13:33 +02:00
khwezi 46fe14d9ef Merge pull request 'Revised all UIs' (#101) from finishline into main
Reviewed-on: #101
2026-09-26 16:37:16 +02:00
khwezi f17368d939 Merge pull request 'Added budget update' (#100) from finishline into main
Reviewed-on: #100
2026-09-26 15:15:08 +02:00
khwezi 7aea3fa8de Merge pull request 'Added postcss' (#99) from finishline into main
Reviewed-on: #99
2026-09-26 13:55:49 +02:00
khwezi d43eb17aa3 Merge pull request 'Implemented data export' (#98) from finishline into main
Reviewed-on: #98
2026-09-26 13:46:36 +02:00
khwezi 01547d8c3f Merge pull request 'Fixed portfolio retrieval' (#97) from finishline into main
Reviewed-on: #97
2026-09-26 12:04:37 +02:00
khwezi 18dd9131cb Merge pull request 'Added missing instrument endpoints' (#96) from finishline into main
Reviewed-on: #96
2026-09-26 11:21:27 +02:00
khwezi f82a5cef76 Merge pull request 'Fixed update organisation' (#95) from finishline into main
Reviewed-on: #95
2026-09-26 10:39:45 +02:00
khwezi 614730caab Merge pull request 'Fixed API calls on governance page' (#94) from finishline into main
Reviewed-on: #94
2026-09-26 10:29:52 +02:00
khwezi 9823cd7ea6 Merge pull request 'Surfaced programme rules' (#93) from finishline into main
Reviewed-on: #93
2026-09-26 07:56:38 +02:00
khwezi a7a68fc290 Merge pull request 'Finishline' (#92) from finishline into main
Reviewed-on: #92
2026-09-25 19:06:37 +02:00
khwezi 4dbc74e488 Merge pull request 'Finishline' (#91) from finishline into main
Reviewed-on: #91
2026-09-24 16:08:03 +02:00
khwezi d658497545 Merge pull request 'Finishline' (#90) from finishline into main
Reviewed-on: #90
2026-09-24 12:01:36 +02:00
khwezi b947959724 Merge pull request 'Added linkage to primary tenant entities' (#89) from finishline into main
Reviewed-on: #89
2026-09-22 07:09:20 +02:00
khwezi 58126e7573 Merge pull request 'Make retrieval of contract file auditable' (#88) from finishline into main
Reviewed-on: #88
2026-09-22 06:29:58 +02:00
khwezi 2fede443cc Merge pull request 'Added automatic audit feature' (#87) from finishline into main
Reviewed-on: #87
2026-09-22 06:11:18 +02:00
khwezi 80f220fcae Merge pull request 'Test 2 reoslutions' (#86) from garages3 into main
Reviewed-on: #86
2026-09-20 15:26:35 +02:00
khwezi 06e2c3ee6a Merge pull request 'Remediated test #1 results' (#85) from garages3 into main
Reviewed-on: #85
2026-09-20 13:52:03 +02:00
khwezi 3c0fd8844c Merge pull request 'Refactored UI endpoint usage' (#84) from garages3 into main
Reviewed-on: #84
2026-09-20 08:27:14 +02:00
khwezi b7c135f0fc Merge pull request 'Garages3' (#83) from garages3 into main
Reviewed-on: #83
2026-09-18 16:12:06 +02:00
khwezi db053e3e5f Merge pull request 'Garages3' (#82) from garages3 into main
Reviewed-on: #82
2026-09-17 07:39:34 +02:00
khwezi d7177e1a72 Merge pull request 'Removed package.json' (#81) from garages3 into main
Reviewed-on: #81
2026-09-17 07:23:54 +02:00
khwezi c67041faea Merge pull request 'Refactored UI and compose file' (#80) from garages3 into main
Reviewed-on: #80
2026-09-17 07:08:26 +02:00
khwezi 0e8a5e1169 Merge pull request 'Removed docker debug code' (#79) from garages3 into main
Reviewed-on: #79
2026-09-15 12:13:47 +02:00
khwezi 41fdb067fe Merge pull request 'Refactored ApiVersioning service registration' (#78) from garages3 into main
Reviewed-on: #78
2026-09-15 12:09:47 +02:00
khwezi b4b687dfcc Merge pull request 'Added OPTIONS header handling' (#77) from garages3 into main
Reviewed-on: #77
2026-09-15 08:52:23 +02:00
khwezi f200ccbf60 Merge pull request 'Added RequireCors() to RouteGroup' (#76) from garages3 into main
Reviewed-on: #76
2026-09-15 08:45:25 +02:00
khwezi 27f57150e1 Merge pull request 'Moved .RequireAuthentication() to endpoints, removed it from EndpointGroup' (#75) from garages3 into main
Reviewed-on: #75
2026-09-15 08:37:43 +02:00
khwezi 79c63107e9 Merge pull request 'Applied configurable CORS policy to API' (#74) from garages3 into main
Reviewed-on: #74
2026-09-15 07:30:29 +02:00
khwezi d945731252 Merge pull request 'Fixed UI' (#73) from garages3 into main
Reviewed-on: #73
2026-09-14 11:44:00 +02:00
khwezi c979a4632e Merge pull request 'Debug refactor' (#72) from garages3 into main
Reviewed-on: #72
2026-09-14 10:46:59 +02:00
khwezi 9eed3cff6b Merge pull request 'Debugs refactor' (#71) from garages3 into main
Reviewed-on: #71
2026-09-14 10:39:04 +02:00
khwezi 6db1a2f367 Merge pull request 'Garages3' (#70) from garages3 into main
Reviewed-on: #70
2026-09-14 10:34:46 +02:00
khwezi 06d9952cd7 Merge pull request 'Rebuilt pfm-api dockerfile' (#69) from garages3 into main
Reviewed-on: #69
2026-09-14 10:29:13 +02:00
khwezi 92d481f75d Merge pull request 'Light refactor' (#68) from garages3 into main
Reviewed-on: #68
2026-09-14 10:23:19 +02:00
khwezi 1c36602995 Merge pull request 'Simplified fpm-api dockerfile' (#67) from garages3 into main
Reviewed-on: #67
2026-09-14 10:21:10 +02:00
khwezi 5ae0c500ac Merge pull request 'Added debug code' (#66) from garages3 into main
Reviewed-on: #66
2026-09-14 10:13:58 +02:00
khwezi db04f800e9 Merge pull request 'Changed pfm-api dockerfile paths' (#65) from garages3 into main
Reviewed-on: #65
2026-09-14 10:10:49 +02:00
khwezi e7a19611f0 Merge pull request 'Simplified dockerfile (pfm-api)' (#64) from garages3 into main
Reviewed-on: #64
2026-09-14 10:04:10 +02:00
khwezi 5ad24da7cf Merge pull request 'Refactored compose file to assign same context to both services' (#63) from garages3 into main
Reviewed-on: #63
2026-09-14 10:02:01 +02:00
khwezi 156dae40b7 Merge pull request 'Fixed missing file copy' (#62) from garages3 into main
Reviewed-on: #62
2026-09-14 09:50:32 +02:00
khwezi 1b67d9cf8b Merge pull request 'Debug refactor on dockerfile' (#61) from garages3 into main
Reviewed-on: #61
2026-09-14 09:47:00 +02:00
khwezi 1bd05e64e5 Merge pull request 'Added better dotnet build handling' (#60) from garages3 into main
Reviewed-on: #60
2026-09-14 09:42:10 +02:00
khwezi 303dba3c6f Merge pull request 'Added more verbosity to dotnet build' (#59) from garages3 into main
Reviewed-on: #59
2026-09-14 09:35:30 +02:00
khwezi 1dd4f54a1d Merge pull request 'Added .dockerignore' (#58) from garages3 into main
Reviewed-on: #58
2026-09-14 09:32:21 +02:00
khwezi fae1e080c4 Merge pull request 'Added stream redirection to dotnet commands' (#57) from garages3 into main
Reviewed-on: #57
2026-09-14 09:14:17 +02:00
khwezi 4de23d27b3 Merge pull request 'Commented out pfm-console to see if the api image will build' (#56) from garages3 into main
Reviewed-on: #56
2026-09-14 09:06:50 +02:00
khwezi d4bce12dbb Merge pull request 'Removed stream redirection' (#55) from garages3 into main
Reviewed-on: #55
2026-09-13 18:15:33 +02:00
khwezi 299b876e1c Merge pull request 'Fixed Api docker file paths' (#54) from garages3 into main
Reviewed-on: #54
2026-09-13 18:13:13 +02:00
khwezi dde1dbe056 Merge pull request 'Added debug code to dotnet build and publish lines' (#53) from garages3 into main
Reviewed-on: #53
2026-09-13 18:09:51 +02:00
khwezi b81e6feb45 Merge pull request 'Moved api dockerfile to project folder' (#52) from garages3 into main
Reviewed-on: #52
2026-09-13 18:07:52 +02:00
khwezi 4138a1941f Merge pull request 'Corrected compose service contexts' (#51) from garages3 into main
Reviewed-on: #51
2026-09-13 18:01:52 +02:00
khwezi 17af31d810 Merge pull request 'Fixed dockerfile paths' (#50) from garages3 into main
Reviewed-on: #50
2026-09-13 17:56:19 +02:00
khwezi b85cf6a1cb Merge pull request 'Light refactor' (#49) from garages3 into main
Reviewed-on: #49
2026-09-13 17:51:45 +02:00
khwezi 81ddc11746 Merge pull request 'Refactored API dockerfile' (#48) from garages3 into main
Reviewed-on: #48
2026-09-13 17:50:29 +02:00
khwezi 5b94672ff5 Merge pull request 'Stable API run' (#47) from garages3 into main
Reviewed-on: #47
2026-09-13 17:41:42 +02:00
khwezi c535392ef1 Merge pull request 'Added debug term' (#46) from garages3 into main
Reviewed-on: #46
2026-09-12 12:22:43 +02:00
khwezi 0607de1802 Merge pull request 'Second fix' (#45) from garages3 into main
Reviewed-on: #45
2026-09-12 12:19:34 +02:00
khwezi 4c1e52e452 Merge pull request 'Light refactor' (#44) from garages3 into main
Reviewed-on: #44
2026-09-12 12:14:13 +02:00
khwezi 2414d74d1c Merge pull request 'Light refactor' (#43) from garages3 into main
Reviewed-on: #43
2026-09-12 12:10:17 +02:00
khwezi 93d9661a7f Merge pull request 'Rewrite pfm-api docker file' (#42) from garages3 into main
Reviewed-on: #42
2026-09-12 12:04:47 +02:00
khwezi dba401fe94 Merge pull request 'Fixed publish alias' (#41) from garages3 into main
Reviewed-on: #41
2026-09-12 11:58:37 +02:00
khwezi 42d73fe6cb Merge pull request 'Added error output to dotnet build line' (#40) from garages3 into main
Reviewed-on: #40
2026-09-12 11:54:57 +02:00
khwezi 1475887a7f Merge pull request 'Added working directory switch' (#39) from garages3 into main
Reviewed-on: #39
2026-09-12 11:49:52 +02:00
khwezi 730664d9c4 Merge pull request 'PFM Api docker refactor' (#38) from garages3 into main
Reviewed-on: #38
2026-09-12 11:45:32 +02:00
khwezi f38e569a34 Merge pull request 'Implemented missing file handling endpoints' (#37) from garages3 into main
Reviewed-on: #37
2026-09-12 11:26:45 +02:00
khwezi 7e79171f97 Merge pull request 'Added image name to compose file for console' (#36) from endpoints into main
Reviewed-on: #36
2026-09-11 16:24:11 +02:00
khwezi d7b868f2c1 Merge pull request 'Added more cors origins' (#35) from endpoints into main
Reviewed-on: #35
2026-09-11 16:17:07 +02:00
khwezi d43a09b371 Merge pull request 'Refactored console dockerfile' (#34) from endpoints into main
Reviewed-on: #34
2026-09-11 16:05:21 +02:00
khwezi 0dc0de1502 Merge pull request 'Fixed dockerfile paths' (#33) from endpoints into main
Reviewed-on: #33
2026-09-11 15:47:30 +02:00
khwezi de47dd4a4f Merge pull request 'Supplied defaults to compose env variables' (#32) from endpoints into main
Reviewed-on: #32
2026-09-11 15:33:47 +02:00
khwezi 2810cc669b Merge pull request 'Fixed compose syntax error' (#31) from endpoints into main
Reviewed-on: #31
2026-09-11 15:30:40 +02:00
khwezi 734af8c86f Merge pull request 'Refactored compose file to include the ui in deployment' (#30) from endpoints into main
Reviewed-on: #30
2026-09-11 15:29:21 +02:00
khwezi a754c42d14 Merge pull request 'Updated Console compose file to use variables' (#29) from endpoints into main
Reviewed-on: #29
2026-09-11 15:19:31 +02:00
khwezi bd7ca9372f Merge pull request 'Added specific origin' (#28) from endpoints into main
Reviewed-on: #28
2026-09-11 14:59:34 +02:00
khwezi 0d01d91ab4 Merge pull request 'Added cors after routes' (#27) from endpoints into main
Reviewed-on: #27
2026-09-11 14:54:47 +02:00
khwezi 2c817a8818 Merge pull request 'Endpoints' (#26) from endpoints into main
Reviewed-on: #26
2026-09-11 14:35:02 +02:00
khwezi 4c3a96917b Merge pull request 'Improved results handling in service layer' (#25) from endpoints into main
Reviewed-on: #25
2026-09-11 10:33:47 +02:00
khwezi e5c3a75795 Merge pull request 'Stable run with validations' (#24) from endpoints into main
Reviewed-on: #24
2026-09-06 10:49:57 +02:00
khwezi 1bc7e65960 Merge pull request 'Added tooling' (#23) from endpoints into main
Reviewed-on: #23
2026-09-05 18:27:35 +02:00
khwezi 094126d84b Merge pull request 'Fixed endpointname uniqueness' (#22) from endpoints into main
Reviewed-on: #22
2026-09-05 13:07:41 +02:00
khwezi 2506241a25 Merge pull request 'Fixed endpoint uniqueness' (#21) from endpoints into main
Reviewed-on: #21
2026-09-05 12:58:17 +02:00
khwezi cfe3530639 Merge pull request 'Endpoints' (#20) from endpoints into main
Reviewed-on: #20
2026-09-05 12:50:04 +02:00
khwezi 985557bee4 Merge pull request 'Implemented caching on all get endpoints and service layer' (#19) from endpoints into main
Reviewed-on: #19
2026-09-05 08:30:16 +02:00
khwezi f0b8b3051a Merge pull request 'Improved getusers cache key' (#18) from endpoints into main
Reviewed-on: #18
2026-09-04 06:08:39 +02:00
khwezi 6c88b9e533 Merge pull request 'Endpoints' (#17) from endpoints into main
Reviewed-on: #17
2026-09-04 05:54:30 +02:00
khwezi 7d67408d2c Merge pull request 'Additional redis configs' (#16) from endpoints into main
Reviewed-on: #16
2026-09-04 05:39:44 +02:00
khwezi d1d58a6183 Merge pull request 'Added service level caching to IdentityService, Communication and Evidence' (#15) from endpoints into main
Reviewed-on: #15
2026-09-03 16:38:08 +02:00
khwezi 60ad154841 Merge pull request 'Implemented distributed caching' (#14) from endpoints into main
Reviewed-on: #14
2026-09-03 11:09:52 +02:00
khwezi 2c13170859 Merge pull request 'Endpoints' (#13) from endpoints into main
Reviewed-on: #13
2026-09-02 16:14:34 +02:00
khwezi d87c8aa3c9 Merge pull request 'Updated configurations' (#12) from endpoints into main
Reviewed-on: #12
2026-09-02 09:45:38 +02:00
khwezi 6af7815ad1 Merge pull request 'Removed node tooling install' (#11) from endpoints into main
Reviewed-on: #11
2026-09-02 09:30:06 +02:00
khwezi a169f6c3f6 Merge pull request 'Endpoints' (#10) from endpoints into main
Reviewed-on: #10
2026-09-02 09:28:17 +02:00
khwezi 65ea753c19 Merge pull request 'Endpoints' (#9) from endpoints into main
Reviewed-on: #9
2026-09-01 12:29:47 +02:00
khwezi e6d2663265 Merge pull request 'Endpoints' (#8) from endpoints into main
Reviewed-on: #8
2026-08-30 17:47:24 +02:00
khwezi 91b5814b60 Merge pull request 'Endpoints' (#7) from endpoints into main
Reviewed-on: #7
2026-08-30 16:27:37 +02:00
khwezi 0c4c848568 Merge pull request 'Endpoints' (#6) from endpoints into main
Reviewed-on: #6
2026-08-30 16:11:53 +02:00
khwezi fb05150ebf Merge pull request 'Endpoints' (#5) from endpoints into main
Reviewed-on: #5
2026-08-30 15:47:32 +02:00
khwezi 2f9c20020b Merge pull request 'Reogranised API and Security assets' (#4) from endpoints into main
Reviewed-on: #4
2026-08-30 15:09:32 +02:00
khwezi a771957db3 Merge pull request 'Endpoints' (#3) from endpoints into main
Reviewed-on: #3
2026-08-30 14:54:58 +02:00
khwezi 46267a2a34 Merge pull request 'Endpoints' (#2) from endpoints into main
Reviewed-on: #2
2026-08-30 14:26:08 +02:00
khwezi a7f360cc2a Merge pull request 'Security' (#1) from security into main
Reviewed-on: #1
2026-08-21 11:47:36 +02:00
hermes 67c08b40ca Refactored gitignore 2026-08-21 11:45:33 +02:00
115 changed files with 2606 additions and 24755 deletions
@@ -1,36 +0,0 @@
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Extensions;
using PostFundManagement.Application.Services.Communications;
using PostFundManagement.Domain.Abstractions;
using PostFundManagement.Domain.Errors;
using PostFundManagement.Domain.Extensions;
using PostFundManagement.Domain.Models;
namespace PostFundManagement.Api.Endpoints.Communications;
[ApiVersionTarget(1)]
public sealed class CreateNotificationEndpoint : IEndpoint
{
public void Map(IEndpointRouteBuilder builder)
{
builder.MapPost("api/communications/notifications", async (CreateNotificationRequest request,
HttpContext context, ICommunicationsService service, CancellationToken cancellationToken = default) =>
await service.CreateNotificationAsync(request, context.GetUserId(), cancellationToken) switch
{
{ IsSuccess: true } => Results.Created(),
var r when r.HasError<ValidationError>() => Results.BadRequest(r.Errors.ToProblems()),
var r when r.HasError<CreateError>() => Results.BadRequest(r.Errors.ToProblems()),
var r => Results.InternalServerError(r.Errors.ToProblems())
})
.WithDescription("Creates a new in-app or outbound notification record")
.RequireAuthorization(Constants.MainScope)
.WithName(typeof(CreateNotificationEndpoint).ToEndpointName())
.MapToApiVersion(new ApiVersion(1))
.Produces(StatusCodes.Status201Created)
.Produces<Problems>(StatusCodes.Status400BadRequest)
.Produces<Problems>(StatusCodes.Status500InternalServerError)
.Produces(StatusCodes.Status401Unauthorized)
.WithTags(EndpointTags.Communications);
}
}
@@ -1,49 +0,0 @@
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Extensions;
using PostFundManagement.Domain.Abstractions;
using PostFundManagement.Domain.Extensions;
using PostFundManagement.Domain.Models;
namespace PostFundManagement.Api.Endpoints.Communications;
[ApiVersionTarget(1)]
public sealed class GetUserNotificationsEndpoint : IEndpoint
{
public void Map(IEndpointRouteBuilder builder)
{
builder.MapGet("api/communications/notifications/user/{userId:guid}", async (Guid userId,
ICommunicationsService service, CancellationToken cancellationToken = default) =>
await service.GetUserNotificationsAsync(userId, cancellationToken) switch
{
{ IsSuccess: true, Value: var notifications } => Results.Ok(notifications),
var r => Results.InternalServerError(r.Errors.ToProblems()),
})
.WithDescription("Retrieves all notifications targeted at a specific user")
.RequireAuthorization(Constants.MainScope)
.WithName(typeof(GetUserNotificationsEndpoint).ToEndpointName())
.MapToApiVersion(new ApiVersion(1))
.Produces<Notification[]>(StatusCodes.Status200OK)
.Produces(StatusCodes.Status401Unauthorized)
.Produces<Problems>(StatusCodes.Status500InternalServerError)
.WithTags(EndpointTags.Communications)
.CacheOutput();
builder.MapGet("api/communications/notifications/inbox", async (HttpContext context,
ICommunicationsService service, CancellationToken cancellationToken = default) =>
await service.GetUserNotificationsAsync(context.GetUserId(), cancellationToken) switch
{
{ IsSuccess: true, Value: var notifications } => Results.Ok(notifications),
var r => Results.InternalServerError(r.Errors.ToProblems()),
})
.WithDescription("Retrieves all in-app and system notifications targeted at the authenticated caller")
.RequireAuthorization(Constants.MainScope)
.WithName($"{typeof(GetUserNotificationsEndpoint).ToEndpointName()}Inbox")
.MapToApiVersion(new ApiVersion(1))
.Produces<Notification[]>(StatusCodes.Status200OK)
.Produces(StatusCodes.Status401Unauthorized)
.Produces<Problems>(StatusCodes.Status500InternalServerError)
.WithTags(EndpointTags.Communications)
.CacheOutput();
}
}
@@ -1,37 +0,0 @@
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Extensions;
using PostFundManagement.Application.Services.Communications;
using PostFundManagement.Domain.Abstractions;
using PostFundManagement.Domain.Errors;
using PostFundManagement.Domain.Extensions;
using PostFundManagement.Domain.Models;
namespace PostFundManagement.Api.Endpoints.Communications;
[ApiVersionTarget(1)]
public sealed class UpdateNotificationEndpoint : IEndpoint
{
public void Map(IEndpointRouteBuilder builder)
{
builder.MapPut("api/communications/notifications", async (UpdateNotificationRequest request,
ICommunicationsService service, CancellationToken cancellationToken = default) =>
await service.UpdateNotificationAsync(request, cancellationToken) switch
{
{ IsSuccess: true } => Results.NoContent(),
var r when r.HasError<NotFoundError>() => Results.NotFound(r.Errors.ToProblems()),
var r when r.HasError<UpdateError>() => Results.BadRequest(r.Errors.ToProblems()),
var r => Results.InternalServerError(r.Errors.ToProblems())
})
.WithDescription("Updates a notification status, delivery timestamp, or error state")
.RequireAuthorization(Constants.MainScope)
.WithName(typeof(UpdateNotificationEndpoint).ToEndpointName())
.MapToApiVersion(new ApiVersion(1))
.Produces(StatusCodes.Status204NoContent)
.Produces<Problems>(StatusCodes.Status404NotFound)
.Produces<Problems>(StatusCodes.Status400BadRequest)
.Produces<Problems>(StatusCodes.Status500InternalServerError)
.Produces(StatusCodes.Status401Unauthorized)
.WithTags(EndpointTags.Communications);
}
}
@@ -1,4 +1,4 @@
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Extensions;
using PostFundManagement.Application.Services.Projects;
using PostFundManagement.Domain.Abstractions;
@@ -12,7 +12,14 @@ public sealed class CreateOutcomeEndpoint : IEndpoint
{
public void Map(IEndpointRouteBuilder builder)
{
builder.MapPost("api/projects/beneficiaries/outcomes", HandleCreateAsync)
builder.MapPost("api/projects/beneficiaris/outcomes", async (CreateOutcomeRequest request, HttpContext context,
IProjectService service, CancellationToken cancellationToken = default) =>
await service.CreateOutcomeAsync(request, context.GetUserId(), cancellationToken) switch
{
{ IsSuccess: true } => Results.Ok(),
var r when r.HasError<CreateError>() => Results.BadRequest(r.Errors.ToProblems()),
var r => Results.InternalServerError(r.Errors.ToProblems())
})
.WithDescription("Add a new beneficiary outcome")
.RequireAuthorization(Constants.MainScope)
.WithName(typeof(CreateOutcomeEndpoint).ToEndpointName())
@@ -22,25 +29,6 @@ public sealed class CreateOutcomeEndpoint : IEndpoint
.Produces<Problems>(StatusCodes.Status500InternalServerError)
.Produces(StatusCodes.Status401Unauthorized)
.WithTags(EndpointTags.Projects);
builder.MapPost("api/projects/beneficiaris/outcomes", HandleCreateAsync)
.WithDescription("Add a new beneficiary outcome (legacy route)")
.RequireAuthorization(Constants.MainScope)
.WithName(typeof(CreateOutcomeEndpoint).ToEndpointName("TypoAlias"))
.MapToApiVersion(new ApiVersion(1))
.Produces(StatusCodes.Status200OK)
.Produces<Problems>(StatusCodes.Status400BadRequest)
.Produces<Problems>(StatusCodes.Status500InternalServerError)
.Produces(StatusCodes.Status401Unauthorized)
.WithTags(EndpointTags.Projects);
}
}
private static async Task<IResult> HandleCreateAsync(CreateOutcomeRequest request, HttpContext context,
IProjectService service, CancellationToken cancellationToken = default) =>
await service.CreateOutcomeAsync(request, context.GetUserId(), cancellationToken) switch
{
{ IsSuccess: true } => Results.Ok(),
var r when r.HasError<CreateError>() => Results.BadRequest(r.Errors.ToProblems()),
var r => Results.InternalServerError(r.Errors.ToProblems())
};
}
@@ -1,4 +1,4 @@
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Extensions;
using PostFundManagement.Domain.Abstractions;
using PostFundManagement.Domain.Errors;
@@ -12,7 +12,15 @@ public sealed class GetOutcomeEndpoint : IEndpoint
{
public void Map(IEndpointRouteBuilder builder)
{
builder.MapGet("api/projects/outcome/{outcomeId}", HandleGetAsync)
builder.MapGet("api/projects/outcomes/{outcomeId}", async (string outcomeId, IProjectService service,
CancellationToken cancellationToken = default) =>
await service.GetOutcomeAsync(outcomeId, cancellationToken) switch
{
{ IsSuccess: true, Value: var outcome } => Results.Ok(outcome),
var r when r.HasError<IdDecodeError>() => Results.Forbid(),
var r when r.HasError<NotFoundError>() => Results.NotFound(r.Errors.ToProblems()),
var r => Results.InternalServerError(r.Errors.ToProblems())
})
.WithDescription("Gets a specific project outcome")
.RequireAuthorization(Constants.MainScope)
.WithName(typeof(GetOutcomeEndpoint).ToEndpointName())
@@ -24,28 +32,5 @@ public sealed class GetOutcomeEndpoint : IEndpoint
.Produces<Problems>(StatusCodes.Status500InternalServerError)
.WithTags(EndpointTags.Projects)
.CacheOutput();
builder.MapGet("api/projects/outcomes/single/{outcomeId}", HandleGetAsync)
.WithDescription("Gets a specific project outcome")
.RequireAuthorization(Constants.MainScope)
.WithName(typeof(GetOutcomeEndpoint).ToEndpointName("Single"))
.MapToApiVersion(new ApiVersion(1))
.Produces<Outcome>(StatusCodes.Status200OK)
.Produces(StatusCodes.Status403Forbidden)
.Produces(StatusCodes.Status401Unauthorized)
.Produces<Problems>(StatusCodes.Status404NotFound)
.Produces<Problems>(StatusCodes.Status500InternalServerError)
.WithTags(EndpointTags.Projects)
.CacheOutput();
}
private static async Task<IResult> HandleGetAsync(string outcomeId, IProjectService service,
CancellationToken cancellationToken = default) =>
await service.GetOutcomeAsync(outcomeId, cancellationToken) switch
{
{ IsSuccess: true, Value: var outcome } => Results.Ok(outcome),
var r when r.HasError<IdDecodeError>() => Results.Forbid(),
var r when r.HasError<NotFoundError>() => Results.NotFound(r.Errors.ToProblems()),
var r => Results.InternalServerError(r.Errors.ToProblems())
};
}
@@ -1,4 +1,4 @@
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Extensions;
using PostFundManagement.Domain.Abstractions;
using PostFundManagement.Domain.Errors;
@@ -12,7 +12,15 @@ public sealed class GetOutcomesEndpoint : IEndpoint
{
public void Map(IEndpointRouteBuilder builder)
{
builder.MapGet("api/projects/beneficiaries/{beneficiaryId}/outcomes", HandleGetAsync)
builder.MapGet("api/projects/outcomes/{beneficiatyId}", async (string beneficiatyId, IProjectService service,
CancellationToken cancellationToken = default) =>
await service.GetOutcomesAsync(beneficiatyId, cancellationToken) switch
{
{ IsSuccess: true, Value: var outcomes } => Results.Ok(outcomes),
var r when r.HasError<IdDecodeError>() => Results.Forbid(),
var r when r.HasError<NotFoundError>() => Results.NotFound(r.Errors.ToProblems()),
var r => Results.InternalServerError(r.Errors.ToProblems())
})
.WithDescription("Gets project beneficiary outcomes")
.RequireAuthorization(Constants.MainScope)
.WithName(typeof(GetOutcomesEndpoint).ToEndpointName())
@@ -24,41 +32,5 @@ public sealed class GetOutcomesEndpoint : IEndpoint
.Produces<Problems>(StatusCodes.Status500InternalServerError)
.WithTags(EndpointTags.Projects)
.CacheOutput();
builder.MapGet("api/projects/beneficiaris/{beneficiaryId}/outcomes", HandleGetAsync)
.WithDescription("Gets project beneficiary outcomes")
.RequireAuthorization(Constants.MainScope)
.WithName(typeof(GetOutcomesEndpoint).ToEndpointName("TypoAlias"))
.MapToApiVersion(new ApiVersion(1))
.Produces<Outcome[]>(StatusCodes.Status200OK)
.Produces(StatusCodes.Status403Forbidden)
.Produces(StatusCodes.Status401Unauthorized)
.Produces<Problems>(StatusCodes.Status404NotFound)
.Produces<Problems>(StatusCodes.Status500InternalServerError)
.WithTags(EndpointTags.Projects)
.CacheOutput();
builder.MapGet("api/projects/outcomes/{beneficiaryId}", HandleGetAsync)
.WithDescription("Gets project beneficiary outcomes")
.RequireAuthorization(Constants.MainScope)
.WithName(typeof(GetOutcomesEndpoint).ToEndpointName("Legacy"))
.MapToApiVersion(new ApiVersion(1))
.Produces<Outcome[]>(StatusCodes.Status200OK)
.Produces(StatusCodes.Status403Forbidden)
.Produces(StatusCodes.Status401Unauthorized)
.Produces<Problems>(StatusCodes.Status404NotFound)
.Produces<Problems>(StatusCodes.Status500InternalServerError)
.WithTags(EndpointTags.Projects)
.CacheOutput();
}
private static async Task<IResult> HandleGetAsync(string beneficiaryId, IProjectService service,
CancellationToken cancellationToken = default) =>
await service.GetOutcomesAsync(beneficiaryId, cancellationToken) switch
{
{ IsSuccess: true, Value: var outcomes } => Results.Ok(outcomes),
var r when r.HasError<IdDecodeError>() => Results.Forbid(),
var r when r.HasError<NotFoundError>() => Results.NotFound(r.Errors.ToProblems()),
var r => Results.InternalServerError(r.Errors.ToProblems())
};
}
@@ -1,37 +0,0 @@
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Extensions;
using PostFundManagement.Domain.Abstractions;
using PostFundManagement.Domain.Errors;
using PostFundManagement.Domain.Extensions;
using PostFundManagement.Domain.Models;
namespace PostFundManagement.Api.Endpoints.Projects;
[ApiVersionTarget(1)]
public sealed class GetProjectOutcomesEndpoint : IEndpoint
{
public void Map(IEndpointRouteBuilder builder)
{
builder.MapGet("api/projects/{projectId}/outcomes", async (string projectId, IProjectService service,
CancellationToken cancellationToken = default) =>
await service.GetProjectOutcomesAsync(projectId, cancellationToken) switch
{
{ IsSuccess: true, Value: var outcomes } => Results.Ok(outcomes),
var r when r.HasError<IdDecodeError>() => Results.Forbid(),
var r when r.HasError<NotFoundError>() => Results.NotFound(r.Errors.ToProblems()),
var r => Results.InternalServerError(r.Errors.ToProblems())
})
.WithDescription("Gets project outcomes for all beneficiaries in a project")
.RequireAuthorization(Constants.MainScope)
.WithName(typeof(GetProjectOutcomesEndpoint).ToEndpointName())
.MapToApiVersion(new ApiVersion(1))
.Produces<Outcome[]>(StatusCodes.Status200OK)
.Produces(StatusCodes.Status403Forbidden)
.Produces(StatusCodes.Status401Unauthorized)
.Produces<Problems>(StatusCodes.Status404NotFound)
.Produces<Problems>(StatusCodes.Status500InternalServerError)
.WithTags(EndpointTags.Projects)
.CacheOutput();
}
}
@@ -1,4 +1,4 @@
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Extensions;
using PostFundManagement.Domain.Abstractions;
using PostFundManagement.Domain.Errors;
@@ -13,18 +13,12 @@ public sealed class SetUserLockoutEndpoint : IEndpoint
{
builder.MapPut("api/users/{userId:Guid}/session/lockout/{disable:bool}", async (Guid userId, bool disable, HttpContext context,
IUserService service, CancellationToken cancellationToken = default) =>
{
var (_, role) = context.User.GetUserRole();
if (role != null && role.Equals("Partner", StringComparison.OrdinalIgnoreCase))
return Results.Forbid();
return await service.SetUserLockoutAsync(userId, context.GetUserId(), disable, cancellationToken) switch
await service.SetUserLockoutAsync(userId, context.GetUserId(), disable, cancellationToken) switch
{
{ IsSuccess: true } => Results.Ok(),
var r when r.HasError<NotFoundError>() => Results.NotFound(r.Errors.ToProblems()),
var r when r.HasError<UpdateError>() => Results.BadRequest(r.Errors.ToProblems()),
var r => Results.InternalServerError(r.Errors.ToProblems())
};
})
.WithDescription("Lock user session")
.RequireAuthorization(Constants.MainScope)
@@ -32,7 +26,6 @@ public sealed class SetUserLockoutEndpoint : IEndpoint
.MapToApiVersion(new ApiVersion(1))
.Produces(StatusCodes.Status200OK)
.Produces(StatusCodes.Status401Unauthorized)
.Produces(StatusCodes.Status403Forbidden)
.Produces<Problems>(StatusCodes.Status404NotFound)
.Produces<Problems>(StatusCodes.Status400BadRequest)
.Produces<Problems>(StatusCodes.Status500InternalServerError)
@@ -11,8 +11,8 @@ public class SyncUserEndpoint : IEndpoint
{
public void Map(IEndpointRouteBuilder builder)
{
builder.MapPost("api/integration/sync", async (HttpContext context, IUserService service,
CancellationToken cancellationToken = default) =>
builder.MapPost("api/integration/sync", async (IJobOrchestrator jobOrchestrator,
HttpContext context, IUserService service, CancellationToken cancellationToken = default) =>
await service.SyncUserAsync(context.GetUserId(), context.GetUserEmail(), context.GetUserRole(), cancellationToken) switch
{
{ IsSuccess: true } => Results.Ok(),
+1 -25
View File
@@ -116,30 +116,7 @@ builder.Services.AddCors(options =>
{
options.AddPolicy(CorsPolicy, policy =>
{
policy.SetIsOriginAllowed(origin =>
{
if (string.IsNullOrWhiteSpace(origin)) return false;
var clean = origin.TrimEnd('/');
if (allowedOrigins.Any(a => string.Equals(a.TrimEnd('/'), clean, StringComparison.OrdinalIgnoreCase)))
return true;
try
{
var host = new Uri(origin).Host;
if (host.EndsWith("khongisa.co.za", StringComparison.OrdinalIgnoreCase) ||
host.Equals("localhost", StringComparison.OrdinalIgnoreCase) ||
host.Equals("127.0.0.1", StringComparison.OrdinalIgnoreCase))
{
return true;
}
}
catch
{
// ignore parse failure
}
return false;
})
policy.WithOrigins(allowedOrigins)
.AllowAnyHeader()
.AllowAnyMethod()
.AllowCredentials();
@@ -154,7 +131,6 @@ var scheduler = await schedulerFactory.GetScheduler();
if (scheduler!.Status != SchedulerStatus.Running)
await scheduler.Start();
app.UseCors(CorsPolicy);
app.UseHsts();
app.UseHttpsRedirection();
app.UseRouting();
-1
View File
@@ -1,7 +1,6 @@
{
"EnableServiceCaching": true,
"CorsOrigins": [
"https://partner.ifri.khongisa.co.za",
"https://console.ifri.khongisa.co.za",
"https://localhost:7208"
],
@@ -1,4 +1,4 @@
using PostFundManagement.Application.Services.Communications;
using PostFundManagement.Application.Services.Communications;
using PostFundManagement.Domain;
using PostFundManagement.Domain.Attributes;
using PostFundManagement.Domain.Models;
@@ -31,9 +31,6 @@ public interface ICommunicationsService
[Log]
Task<Result<Notification[]>> GetNotificationsAsync(string organisationIdHash, CancellationToken cancellationToken = default);
[Log]
Task<Result<Notification[]>> GetUserNotificationsAsync(Guid userId, CancellationToken cancellationToken = default);
[Log]
Task<Result<Notification>> GetNotificationAsync(string notificationIdHash, CancellationToken cancellationToken = default);
@@ -142,9 +142,6 @@ public interface IProjectService
[Log]
Task<Result<Outcome[]>> GetOutcomesAsync(string beneficiaryIdHash, CancellationToken cancellationToken = default);
[Log]
Task<Result<Outcome[]>> GetProjectOutcomesAsync(string projectIdHash, CancellationToken cancellationToken = default);
[Log]
Task<Result<Outcome>> GetOutcomeAsync(string outcomeIdHash, CancellationToken cancellationToken = default);
@@ -1,4 +1,4 @@
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Extensions;
using PostFundManagement.Application.Services.Shared;
using PostFundManagement.Domain;
@@ -152,9 +152,6 @@ public sealed class CommunicationsCacheService(CommunicationsService service, ID
return Result.Ok(cached.FromJson<Notification[]>());
}));
public async Task<Result<Notification[]>> GetUserNotificationsAsync(Guid userId, CancellationToken cancellationToken = default) =>
await service.GetUserNotificationsAsync(userId, cancellationToken);
public async Task<Result<Invite>> SendInviteAsync(InviteRequest request, Guid userId, CancellationToken cancellationToken = default) =>
await service.SendInviteAsync(request, userId, cancellationToken);
@@ -1,4 +1,4 @@
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Abstractions.Services;
using PostFundManagement.Application.Services.Shared;
using PostFundManagement.Domain;
using PostFundManagement.Domain.Abstractions;
@@ -94,8 +94,6 @@ public sealed class CommunicationsService(IDbContextFactory<ApplicationDbContext
{
await using var context = await contextFactory.CreateDbContextAsync(cancellationToken);
var initialStatus = request.Status ?? (request.Platform == NotificationPlatform.InApp ? NotificationStatus.Delivered : NotificationStatus.Queued);
context.Notifications.Add(new Domain.Entities.Notification
{
CreatedAt = DateTime.UtcNow,
@@ -105,7 +103,7 @@ public sealed class CommunicationsService(IDbContextFactory<ApplicationDbContext
Subject = request.Subject,
Message = request.Message,
Platform = request.Platform,
Status = initialStatus,
Status = NotificationStatus.Queued,
TenantId = tenantContext.TenantId
});
@@ -118,17 +116,16 @@ public sealed class CommunicationsService(IDbContextFactory<ApplicationDbContext
{
await using var context = await contextFactory.CreateDbContextAsync(cancellationToken);
var entity = await context.Notifications.FirstOrDefaultAsync(n => n.Id == request.NotificationId, cancellationToken);
if (entity is null)
return Result.Fail(NotFoundError.Create($"Notification #{request.NotificationId} not found"));
var changedTotal = await context.Notifications
.Where(n => n.Id == request.NotificationId)
.ExecuteUpdateAsync(f => f
.SetProperty(u => u.Destination, request.Destination)
.SetProperty(u => u.SentAt, request.SentAt)
.SetProperty(u => u.Error, request.Error)
.SetProperty(u => u.UpdatedAt, DateTime.UtcNow)
.SetProperty(u => u.Status, request.Status), cancellationToken);
entity.Status = request.Status;
entity.UpdatedAt = DateTime.UtcNow;
if (request.SentAt.HasValue) entity.SentAt = request.SentAt.Value;
if (!string.IsNullOrWhiteSpace(request.Destination)) entity.Destination = request.Destination;
if (!string.IsNullOrWhiteSpace(request.Error)) entity.Error = request.Error;
return Result.OkIf(await context.SaveChangesAsync(cancellationToken) > 0, UpdateError.Create($"Failed to update notification: {request.NotificationId}, contact support"));
return Result.OkIf(changedTotal > 0, UpdateError.Create($"Failed to update notification: {request.NotificationId}, contact support"));
}));
public async Task<Result<Notification[]>> GetNotificationsAsync(string organisationIdHash, CancellationToken cancellationToken = default) =>
@@ -150,19 +147,6 @@ public sealed class CommunicationsService(IDbContextFactory<ApplicationDbContext
return Result.Ok(notifications?.Select(i => i.Map()).ToArray() ?? []);
}));
public async Task<Result<Notification[]>> GetUserNotificationsAsync(Guid userId, CancellationToken cancellationToken = default) =>
await Result.Try((Func<Task<Result<Notification[]>>>)(async () =>
{
await using var context = await contextFactory.CreateDbContextAsync(cancellationToken);
var notifications = await context.Notifications.AsNoTracking()
.Where(n => n.Recipient == userId)
.OrderByDescending(o => o.CreatedAt)
.ToListAsync(cancellationToken);
return Result.Ok(notifications?.Select(i => i.Map()).ToArray() ?? []);
}));
public async Task<Result<Notification>> GetNotificationAsync(string notificationIdHash, CancellationToken cancellationToken = default) =>
await Result.Try((Func<Task<Result<Notification>>>)(async () =>
{
@@ -1,20 +1,18 @@
using PostFundManagement.Domain;
using PostFundManagement.Domain;
namespace PostFundManagement.Application.Services.Communications;
public sealed record UpdateNotificationRequest([Required] long NotificationId,
string? Destination = null,
[Required] NotificationStatus Status = NotificationStatus.Read,
DateTime? SentAt = null,
[MaxLength(TextLength)] string? Error = null);
public sealed record UpdateNotificationRequest([Required] long NotificationId, string? Destination,
[Required] NotificationStatus Status,
[Required] DateTime SentAt,
[MaxLength(TextLength)] string? Error);
public sealed record CreateNotificationRequest([Required] long OrganisationId,
[Required] Guid Recipient,
[Required] NotificationPlatform Platform,
[Required][MaxLength(LabelLength)] string? Subject,
[Required][MaxLength(LabelLength)] string? Destination,
[Required][MaxLength(LargeTextLength)] string Message,
NotificationStatus? Status = null);
[Required][MaxLength(TextLength)] string Message);
public sealed record InviteRequest([Required] long OrganisationId,
[Required] long InvitedOrganisationId,
@@ -94,16 +94,6 @@ public sealed class ExecutionService(IDbContextFactory<ApplicationDbContext> con
await using var context = await contextFactory.CreateDbContextAsync(cancellationToken);
var disbursement = await context.Disbursements.AsNoTracking()
.FirstOrDefaultAsync(d => d.Id == decodeResult.Value, cancellationToken);
if (disbursement is null)
return Result.Fail(NotFoundError.Create("Disbursement not found."));
var isAwardApproved = await context.Awards
.AnyAsync(a => a.ProjectId == disbursement.ProjectId && a.Status == ApprovalStatus.Approved, cancellationToken);
if (!isAwardApproved)
return Result.Fail(ValidationError.Create("Cannot approve disbursement: The project's linked award is not approved or does not exist."));
var changedTotal = await context.Disbursements.Where(d => d.Id == decodeResult.Value)
.ExecuteUpdateAsync(f => f
.SetProperty(f => f.Status, ApprovalStatus.Approved)
@@ -161,11 +161,6 @@ public sealed class GrantsService(IDbContextFactory<ApplicationDbContext> contex
if (!await context.Projects.AnyAsync(p => p.Id == request.ProjectId, cancellationToken))
return Result.Fail(NotFoundError.New);
var hasApprovedAward = await context.Awards
.AnyAsync(a => a.ProjectId == request.ProjectId && a.Status == ApprovalStatus.Approved, cancellationToken);
if (!hasApprovedAward)
return Result.Fail(ValidationError.Create("Cannot create budget: The project's linked award is not approved or does not exist."));
var budget = new Domain.Entities.Budget
{
ProjectId = request.ProjectId,
@@ -375,30 +375,6 @@ public sealed class ProjectCacheService(ProjectService service, IDistributedCach
return Result.Ok(cached.FromJson<Outcome[]>());
}));
public async Task<Result<Outcome[]>> GetProjectOutcomesAsync(string projectIdHash, CancellationToken cancellationToken = default) =>
await Result.Try((Func<Task<Result<Outcome[]>>>)(async () =>
{
if (!await featureManager.IsEnabledAsync(ServiceCachingFeature))
return await service.GetProjectOutcomesAsync(projectIdHash, cancellationToken);
var cacheKey = HashService.ToMd5Hash($"getprojectoutcomes-{projectIdHash}").Value;
var cached = await cache.GetStringAsync(cacheKey, cancellationToken);
if (string.IsNullOrWhiteSpace(cached))
{
var result = await service.GetProjectOutcomesAsync(projectIdHash, cancellationToken);
if (result.IsFailed) return result;
await cache.SetStringAsync(cacheKey, result.Value.ToJson(), cacheOptions, cancellationToken);
return result.Value;
}
return Result.Ok(cached.FromJson<Outcome[]>());
}));
public async Task<Result<Programme>> GetProgrammeAsync(string programmeIdHash, CancellationToken cancellationToken = default) =>
await Result.Try((Func<Task<Result<Programme>>>)(async () =>
{
@@ -20,27 +20,6 @@ public sealed class ProjectService(IDbContextFactory<ApplicationDbContext> conte
if (!await context.Users.AnyAsync(u => u.Id == userId, cancellationToken))
return Result.Fail(NotFoundError.New);
if (request.Status == ApprovalStatus.Approved)
{
var hasUnmetCompliance = await context.ComplianceItems
.AnyAsync(c => c.ProjectId == request.ProjectId && c.Status == ComplianceStatus.NotMet, cancellationToken);
if (hasUnmetCompliance)
return Result.Fail(ValidationError.Create("Project cannot be approved because some compliance items are not met."));
var projectBeneficiaryIds = await context.Beneficiaries
.Where(b => b.ProjectId == request.ProjectId)
.Select(b => b.Id)
.ToListAsync(cancellationToken);
if (projectBeneficiaryIds.Count > 0)
{
var hasUnmetOutcomes = await context.Outcomes
.AnyAsync(o => projectBeneficiaryIds.Contains(o.BeneficiaryId) && o.Status == ComplianceStatus.NotMet, cancellationToken);
if (hasUnmetOutcomes)
return Result.Fail(ValidationError.Create("Project cannot be approved because some beneficiary outcomes are not met."));
}
}
var changedTotal = await context.Projects
.Where(f => f.Id == request.ProjectId)
.ExecuteUpdateAsync(f => f
@@ -565,9 +544,8 @@ public sealed class ProjectService(IDbContextFactory<ApplicationDbContext> conte
CreatedAt = DateTime.UtcNow,
CreatedBy = userId,
ProjectId = request.ProjectId,
BeneficiaryId = request.BeneficiaryId,
Requirements = request.Requirements,
Status = request.Status,
Status = ApprovalStatus.Pending,
TenantId = tenantContext.TenantId,
Title = request.Title.Humanize(LetterCasing.Title).Trim()
});
@@ -585,10 +563,7 @@ public sealed class ProjectService(IDbContextFactory<ApplicationDbContext> conte
.ExecuteUpdateAsync(f => f
.SetProperty(u => u.Title, request.Title.Humanize(LetterCasing.Title).Trim())
.SetProperty(u => u.Requirements, request.Requirements)
.SetProperty(u => u.BeneficiaryId, request.BeneficiaryId)
.SetProperty(u => u.Status, request.Status)
.SetProperty(u => u.UpdatedAt, DateTime.UtcNow)
.SetProperty(u => u.VerifiedBy, userId), cancellationToken);
.SetProperty(u => u.Status, request.Status), cancellationToken);
return Result.OkIf(changedTotal > 0, UpdateError.Create("No records changed"));
}));
@@ -793,7 +768,6 @@ public sealed class ProjectService(IDbContextFactory<ApplicationDbContext> conte
CreatedBy = userId,
Description = request.Description,
Name = request.Name.Humanize(LetterCasing.Title).Trim(),
Status = request.Status,
TenantId = tenantContext.TenantId
});
@@ -809,8 +783,7 @@ public sealed class ProjectService(IDbContextFactory<ApplicationDbContext> conte
.Where(o => o.Id == request.OutcomeId)
.ExecuteUpdateAsync(f => f
.SetProperty(u => u.Description, request.Description)
.SetProperty(u => u.Name, request.Name.Humanize(LetterCasing.Title).Trim())
.SetProperty(u => u.Status, request.Status), cancellationToken);
.SetProperty(u => u.Name, request.Name.Humanize(LetterCasing.Title).Trim()), cancellationToken);
return Result.OkIf(changedTotal > 0, UpdateError.Create("No records changed"));
}));
@@ -834,25 +807,6 @@ public sealed class ProjectService(IDbContextFactory<ApplicationDbContext> conte
return Result.Ok(outcomes?.Select(o => o.Map()).ToArray() ?? []);
}));
public async Task<Result<Outcome[]>> GetProjectOutcomesAsync(string projectIdHash, CancellationToken cancellationToken = default) =>
await Result.Try((Func<Task<Result<Outcome[]>>>)(async () =>
{
var decodeResult = hashService.DecodeLongIdHash(projectIdHash);
if (decodeResult.IsFailed)
return Result.Fail<Outcome[]>(IdDecodeError.Create()
.CausedBy(decodeResult.Errors));
await using var context = await contextFactory.CreateDbContextAsync(cancellationToken);
var outcomes = await context.Outcomes.AsNoTracking()
.Where(o => o.Beneficiary!.ProjectId == decodeResult.Value)
.OrderByDescending(o => o.Id)
.ToListAsync(cancellationToken);
return Result.Ok(outcomes?.Select(o => o.Map()).ToArray() ?? []);
}));
public async Task<Result<Outcome>> GetOutcomeAsync(string outcomeIdHash, CancellationToken cancellationToken = default) =>
await Result.Try((Func<Task<Result<Outcome>>>)(async () =>
{
@@ -15,13 +15,11 @@ public sealed record CreateSiteVisitRequest([Required] long ProjectId,
public sealed record UpdateOutcomeRequest([Required] long OutcomeId,
[Required][MaxLength(LabelLength)] string Name,
[Required][MaxLength(TextLength)] string Description,
[Required] ComplianceStatus Status = ComplianceStatus.NotMet);
[Required][MaxLength(TextLength)] string Description);
public sealed record CreateOutcomeRequest([Required] long BeneficiaryId,
[Required][MaxLength(LabelLength)] string Name,
[Required][MaxLength(TextLength)] string Description,
ComplianceStatus Status = ComplianceStatus.NotMet);
[Required][MaxLength(TextLength)] string Description);
public sealed record UpdateIssueRequest([Required] long IssueId,
[Required][MaxLength(LabelLength)] string Title,
@@ -55,14 +53,11 @@ public sealed record CreateBeneficiaryRequest([Required] long ProjectId,
public sealed record UpdateComplianceItemRequest([Required] long ComplianceItemId,
[Required][MaxLength(LabelLength)] string Title,
[Required][MaxLength(TextLength)] string Requirements,
[Required] ComplianceStatus Status,
long? BeneficiaryId = null);
[Required] ApprovalStatus Status);
public sealed record CreateComplianceItemRequest([Required] long ProjectId,
[Required][MaxLength(LabelLength)] string Title,
[Required][MaxLength(TextLength)] string Requirements,
ComplianceStatus Status = ComplianceStatus.NotMet,
long? BeneficiaryId = null);
[Required][MaxLength(TextLength)] string Requirements);
public sealed record UpdateChangeRequest([Required] long ChangeRequestId,
[Required][MaxLength(LabelLength)] string Title,
@@ -12,6 +12,7 @@ APP_URL="MY_APP_URL"
VITE_OIDC_AUTHORITY="https://sts.security.khongisa.co.za"
VITE_OIDC_AUDIENCE="pfm-api-dev"
VITE_OIDC_CLIENT_ID="pfm-scalar-dev"
VITE_OIDC_CLIENT_SECRET="secret_71f88570a46eb22eb5270b47f69e3332c84d8db85d008f0276cb7431c8872d27"
# PFM Backend API Base URL
VITE_API_BASE_URL="https://api.ifri.khongisa.co.za/"
@@ -26,12 +26,15 @@ OIDC_AUDIENCE="${VITE_OIDC_AUDIENCE:-${OIDC_AUDIENCE:-${SecuritySettings__Audien
# 4. OIDC Client ID
OIDC_CLIENT_ID="${VITE_OIDC_CLIENT_ID:-${OIDC_CLIENT_ID:-${SecuritySettings__ClientId:-${SecuritySettings_ClientId:-${CLIENT_ID:-}}}}}"
# 5. OIDC Scope
# 5. OIDC Client Secret
OIDC_CLIENT_SECRET="${VITE_OIDC_CLIENT_SECRET:-${OIDC_CLIENT_SECRET:-${SecuritySettings__ClientSecret:-${SecuritySettings_ClientSecret:-${CLIENT_SECRET:-}}}}}"
# 6. OIDC Scope
OIDC_SCOPE="${VITE_OIDC_SCOPE:-${OIDC_SCOPE:-${SecuritySettings__Scope:-${SecuritySettings_Scope:-${SCOPE:-}}}}}"
# 6. Hasher Settings
HASHER_MIN_LENGTH="${VITE_HASHER_MIN_LENGTH:-${HASHER_MIN_LENGTH:-${HasherSettings__MinLength:-${HasherSettings_MinLength:-11}}}}}"
HASHER_SALT="${VITE_HASHER_SALT:-${HASHER_SALT:-${HasherSettings__Salt:-${HasherSettings_Salt:-TGlnaHQgQ2hhcm1zLCBNaWRyYW5kQm9va3MgbWFrZSBsb3RzIG9mIG1vbmV5IGFuZCBhcmUgYSBzdWNjZXNzZnVsIHZpcmFsIHN0b3J5IGluIFNvdXRoIEFmcmljYQ==}}}}"
# 7. Hasher Settings
HASHER_SALT="${VITE_HASHER_SALT:-${HASHER_SALT:-${HasherSettings__Salt:-${HasherSettings_Salt:-}}}}}"
HASHER_MIN_LENGTH="${VITE_HASHER_MIN_LENGTH:-${HASHER_MIN_LENGTH:-${HasherSettings__MinLength:-${HasherSettings_MinLength:-}}}}}"
if [ -d "$TARGET_DIR" ]; then
echo "[docker-entrypoint] Generating runtime configuration files in $TARGET_DIR..."
@@ -48,12 +51,14 @@ window.__RUNTIME_CONFIG__ = {
VITE_OIDC_AUDIENCE: "${OIDC_AUDIENCE}",
OIDC_CLIENT_ID: "${OIDC_CLIENT_ID}",
VITE_OIDC_CLIENT_ID: "${OIDC_CLIENT_ID}",
OIDC_CLIENT_SECRET: "${OIDC_CLIENT_SECRET}",
VITE_OIDC_CLIENT_SECRET: "${OIDC_CLIENT_SECRET}",
OIDC_SCOPE: "${OIDC_SCOPE}",
VITE_OIDC_SCOPE: "${OIDC_SCOPE}",
HASHER_MIN_LENGTH: "${HASHER_MIN_LENGTH}",
VITE_HASHER_MIN_LENGTH: "${HASHER_MIN_LENGTH}",
HASHER_SALT: "${HASHER_SALT}",
VITE_HASHER_SALT: "${HASHER_SALT}",
HASHER_MIN_LENGTH: "${HASHER_MIN_LENGTH}",
VITE_HASHER_MIN_LENGTH: "${HASHER_MIN_LENGTH}",
ApiSettings: {
BaseUrl: "${API_BASE_URL}"
},
@@ -61,6 +66,7 @@ window.__RUNTIME_CONFIG__ = {
Authority: "${OIDC_AUTHORITY}",
Audience: "${OIDC_AUDIENCE}",
ClientId: "${OIDC_CLIENT_ID}",
ClientSecret: "${OIDC_CLIENT_SECRET}",
Scope: "${OIDC_SCOPE}"
},
HasherSettings: {
@@ -80,6 +86,7 @@ EOF
"Authority": "${OIDC_AUTHORITY}",
"Audience": "${OIDC_AUDIENCE}",
"ClientId": "${OIDC_CLIENT_ID}",
"ClientSecret": "${OIDC_CLIENT_SECRET}",
"Scope": "${OIDC_SCOPE}"
},
"HasherSettings": {
@@ -6,10 +6,11 @@
"Authority": "",
"Audience": "",
"ClientId": "",
"ClientSecret": "",
"Scope": ""
},
"HasherSettings": {
"Salt": "TGlnaHQgQ2hhcm1zLCBNaWRyYW5kQm9va3MgbWFrZSBsb3RzIG9mIG1vbmV5IGFuZCBhcmUgYSBzdWNjZXNzZnVsIHZpcmFsIHN0b3J5IGluIFNvdXRoIEFmcmljYQ==",
"MinHashLength": "11"
"Salt": "",
"MinHashLength": ""
}
}
@@ -1,13 +1,4 @@
// Development and fallback runtime configuration.
// In Docker / Kubernetes / Cloud Run deployments, this file is dynamically
// populated at container startup by /docker-entrypoint.sh with deployment environment variables.
window.__RUNTIME_CONFIG__ = window.__RUNTIME_CONFIG__ || {
HASHER_SALT: "TGlnaHQgQ2hhcm1zLCBNaWRyYW5kQm9va3MgbWFrZSBsb3RzIG9mIG1vbmV5IGFuZCBhcmUgYSBzdWNjZXNzZnVsIHZpcmFsIHN0b3J5IGluIFNvdXRoIEFmcmljYQ==",
VITE_HASHER_SALT: "TGlnaHQgQ2hhcm1zLCBNaWRyYW5kQm9va3MgbWFrZSBsb3RzIG9mIG1vbmV5IGFuZCBhcmUgYSBzdWNjZXNzZnVsIHZpcmFsIHN0b3J5IGluIFNvdXRoIEFmcmljYQ==",
HASHER_MIN_LENGTH: "11",
VITE_HASHER_MIN_LENGTH: "11",
HasherSettings: {
Salt: "TGlnaHQgQ2hhcm1zLCBNaWRyYW5kQm9va3MgbWFrZSBsb3RzIG9mIG1vbmV5IGFuZCBhcmUgYSBzdWNjZXNzZnVsIHZpcmFsIHN0b3J5IGluIFNvdXRoIEFmcmljYQ==",
MinHashLength: "11"
}
};
window.__RUNTIME_CONFIG__ = window.__RUNTIME_CONFIG__ || {};
-20
View File
@@ -14,12 +14,10 @@ const ProjectsPage = lazy(() => import('./pages/ProjectsPage').then(m => ({ defa
const BeneficiariesPage = lazy(() => import('./pages/BeneficiariesPage').then(m => ({ default: m.BeneficiariesPage })));
const ChangeManagementPage = lazy(() => import('./pages/ChangeManagementPage').then(m => ({ default: m.ChangeManagementPage })));
const SiteVisitsPage = lazy(() => import('./pages/SiteVisitsPage').then(m => ({ default: m.SiteVisitsPage })));
const CompliancePage = lazy(() => import('./pages/CompliancePage').then(m => ({ default: m.CompliancePage })));
const GrantsPage = lazy(() => import('./pages/GrantsPage').then(m => ({ default: m.GrantsPage })));
const MonitoringPage = lazy(() => import('./pages/MonitoringPage').then(m => ({ default: m.MonitoringPage })));
const TenantManagementPage = lazy(() => import('./pages/TenantManagementPage').then(m => ({ default: m.TenantManagementPage })));
const SettingsPage = lazy(() => import('./pages/SettingsPage').then(m => ({ default: m.SettingsPage })));
const InboxPage = lazy(() => import('./pages/InboxPage').then(m => ({ default: m.InboxPage })));
const RouteLoading = () => (
<div className="flex items-center justify-center min-h-[400px] w-full text-slate-400">
@@ -134,22 +132,6 @@ export default function App() {
</ClaimProtectedRoute>
}
/>
<Route
path="/projects/compliance"
element={
<ClaimProtectedRoute claim="compliance">
<CompliancePage />
</ClaimProtectedRoute>
}
/>
<Route
path="/compliance"
element={
<ClaimProtectedRoute claim="compliance">
<CompliancePage />
</ClaimProtectedRoute>
}
/>
<Route
path="/grants"
element={
@@ -182,8 +164,6 @@ export default function App() {
</TenantManagementProtectedRoute>
}
/>
<Route path="/inbox" element={<InboxPage />} />
<Route path="/mailbox" element={<InboxPage />} />
<Route path="/settings" element={<SettingsPage />} />
</Route>
@@ -10,14 +10,13 @@ import {
isActivationPending,
getActivationPendingReason,
clearUserSyncInBrowser,
setActivationPending,
UserSyncResult,
} from '../services/userSyncService';
import { AccountActivationModal } from '../components/auth/AccountActivationModal';
import { PartnerAccessDeniedModal } from '../components/auth/PartnerAccessDeniedModal';
import { SessionExpiredModal } from '../components/auth/SessionExpiredModal';
import { encodeHashIdSync } from '../utils/hashids';
import { verifyTenantLockout, clearTenantLockoutCache } from '../services/tenantLockoutService';
import { encodeHashIdSync } from '../services/toolsService';
import { verifyTenantLockout } from '../services/tenantLockoutService';
import {
onSessionExpired,
triggerSessionExpired,
@@ -308,6 +307,11 @@ export function resetUserManager(): void {
userManagerInstance = null;
}
// Automatically reset UserManager when runtime configuration is updated
onConfigChanged(() => {
resetUserManager();
});
export function getUserManager(): UserManager {
if (!userManagerInstance && typeof window !== 'undefined') {
const sec = getSecuritySettings();
@@ -316,7 +320,7 @@ export function getUserManager(): UserManager {
userManagerInstance = new UserManager({
authority: sec.Authority,
client_id: sec.ClientId,
...(sec.ClientSecret ? { client_secret: sec.ClientSecret } : {}),
client_secret: sec.ClientSecret,
redirect_uri: `${origin}/dashboard`,
post_logout_redirect_uri: `${origin}/`,
response_type: 'code',
@@ -433,8 +437,8 @@ export const AuthProvider: React.FC<{ children: ReactNode }> = ({ children }) =>
localStorage.setItem(LOCAL_STORAGE_CLAIMS_KEY, JSON.stringify(mergedClaims));
const tenantClaimValues = extractTenantClaimValues(mergedClaims, token);
let tenantClaim = (mergedClaims.tenant as string) || (oidcUser.profile?.tenant as string) || tenantClaimValues.tenant || undefined;
let parsedTenantId = extractTenantId(mergedClaims, token);
const tenantClaim = (mergedClaims.tenant as string) || (oidcUser.profile?.tenant as string) || tenantClaimValues.tenant || undefined;
const parsedTenantId = extractTenantId(mergedClaims, token);
setTenantId(parsedTenantId);
const profile: AuthUserProfile = {
@@ -454,38 +458,7 @@ export const AuthProvider: React.FC<{ children: ReactNode }> = ({ children }) =>
// Clean up code and state from URL
window.history.replaceState({}, document.title, window.location.pathname);
// Step 1: Synchronize authenticated user profile with backend directory FIRST (/v1/api/integration/sync)
try {
const syncResult = await syncUserAccount(userSub, token, profile, true);
if (syncResult.isUnauthorized) {
await logout();
window.location.replace('/');
return;
}
// Step 2: Retrieve user roles, role claims, and user claims (Requirement 2 & 3 & 7)
try {
const resolved = await resolveUserRolesAndClaims(userSub, mergedClaims, profile);
if (resolved.primaryRole) {
profile.role = resolved.primaryRole;
}
if (resolved.tenant) {
profile.tenant = resolved.tenant;
tenantClaim = resolved.tenant;
setTenantName(resolved.tenant);
}
if (resolved.tenant_id !== undefined) {
profile.tenant_id = resolved.tenant_id;
parsedTenantId = resolved.tenant_id;
setTenantId(resolved.tenant_id);
}
setUser({ ...profile });
setClaims({ ...resolved.claims });
localStorage.setItem(LOCAL_STORAGE_USER_KEY, JSON.stringify(profile));
localStorage.setItem(LOCAL_STORAGE_CLAIMS_KEY, JSON.stringify(resolved.claims));
} catch {}
// Step 3: Verify tenant lockout now that user is synced and authenticated
// Verify tenant lockout at the instance tenant and tenant_id claims are retrieved
const tenantLockoutResult = await verifyTenantLockout(
parsedTenantId ?? tenantClaimValues.tenantId,
tenantClaim
@@ -507,6 +480,14 @@ export const AuthProvider: React.FC<{ children: ReactNode }> = ({ children }) =>
setTenantName(tenantClaim);
}
// Synchronize authenticated user profile with backend directory
try {
const syncResult = await syncUserAccount(userSub, token, profile, true);
if (syncResult.isUnauthorized) {
await logout();
window.location.replace('/');
return;
}
if (syncResult.isActivationPending) {
setIsPendingActivation(true);
setIsSynced(false);
@@ -515,6 +496,26 @@ export const AuthProvider: React.FC<{ children: ReactNode }> = ({ children }) =>
setIsPendingActivation(false);
setIsSynced(true);
setActivationError(null);
// Retrieve user roles, role claims, and user claims (Requirement 2 & 3 & 7)
try {
const resolved = await resolveUserRolesAndClaims(userSub, mergedClaims, profile);
if (resolved.primaryRole) {
profile.role = resolved.primaryRole;
}
if (resolved.tenant) {
profile.tenant = resolved.tenant;
setTenantName(resolved.tenant);
}
if (resolved.tenant_id !== undefined) {
profile.tenant_id = resolved.tenant_id;
setTenantId(resolved.tenant_id);
}
setUser({ ...profile });
setClaims({ ...resolved.claims });
localStorage.setItem(LOCAL_STORAGE_USER_KEY, JSON.stringify(profile));
localStorage.setItem(LOCAL_STORAGE_CLAIMS_KEY, JSON.stringify(resolved.claims));
} catch {}
}
} catch (syncErr: any) {
if (syncErr?.response?.status === 401) {
@@ -524,9 +525,7 @@ export const AuthProvider: React.FC<{ children: ReactNode }> = ({ children }) =>
}
setIsPendingActivation(true);
setIsSynced(false);
const rawMsg = syncErr?.message || 'Account activation pending';
const cleanMsg = /network\s*error/i.test(rawMsg) ? rawMsg.replace(/network\s*error/gi, 'Permission Check') : rawMsg;
setActivationError(cleanMsg);
setActivationError(syncErr?.message || 'Account activation pending');
}
setIsLoading(false);
@@ -562,10 +561,10 @@ export const AuthProvider: React.FC<{ children: ReactNode }> = ({ children }) =>
setSub(storedSub);
}
let storedTenantId = extractTenantId(parsedClaims, storedToken);
const storedTenantId = extractTenantId(parsedClaims, storedToken);
setTenantId(storedTenantId);
const tenantClaimValues = extractTenantClaimValues(parsedClaims, storedToken);
let storedTenantClaim = (parsedClaims.tenant as string) || tenantClaimValues.tenant || undefined;
const storedTenantClaim = (parsedClaims.tenant as string) || tenantClaimValues.tenant || undefined;
let resolvedUser: AuthUserProfile | null = null;
if (storedUser) {
@@ -589,53 +588,9 @@ export const AuthProvider: React.FC<{ children: ReactNode }> = ({ children }) =>
// Initial fast unblock: valid persisted session found, unblock UI immediately
setIsLoading(false);
// Asynchronous background revalidation (User Sync, Role Claims, Tenant Lockout)
// Asynchronous background revalidation (Tenant Lockout, User Sync, Role Claims)
(async () => {
try {
const wasPending = isActivationPending();
setIsPendingActivation(wasPending);
setActivationError(getActivationPendingReason());
// Step 1: Sync user account FIRST
const syncResult = await syncUserAccount(
storedSub || '',
storedToken,
resolvedUser || undefined,
false
);
if (syncResult.isUnauthorized) {
await logout();
return;
}
// Step 2: Retrieve user roles, role claims, and user claims
try {
const resolved = await resolveUserRolesAndClaims(
storedSub || '',
parsedClaims,
resolvedUser || {}
);
if (resolvedUser) {
if (resolved.primaryRole) resolvedUser.role = resolved.primaryRole;
if (resolved.tenant) {
resolvedUser.tenant = resolved.tenant;
storedTenantClaim = resolved.tenant;
setTenantName(resolved.tenant);
}
if (resolved.tenant_id !== undefined) {
resolvedUser.tenant_id = resolved.tenant_id;
storedTenantId = resolved.tenant_id;
setTenantId(resolved.tenant_id);
}
setUser({ ...resolvedUser });
localStorage.setItem(LOCAL_STORAGE_USER_KEY, JSON.stringify(resolvedUser));
}
setClaims({ ...resolved.claims });
localStorage.setItem(LOCAL_STORAGE_CLAIMS_KEY, JSON.stringify(resolved.claims));
} catch {}
// Step 3: Verify tenant lockout now that user is verified active
const tenantLockoutResult = await verifyTenantLockout(
storedTenantId ?? tenantClaimValues.tenantId,
storedTenantClaim
@@ -657,6 +612,22 @@ export const AuthProvider: React.FC<{ children: ReactNode }> = ({ children }) =>
setTenantName(tenantLockoutResult.tenant.name);
}
const wasPending = isActivationPending();
setIsPendingActivation(wasPending);
setActivationError(getActivationPendingReason());
const syncResult = await syncUserAccount(
storedSub || '',
storedToken,
resolvedUser || undefined,
false
);
if (syncResult.isUnauthorized) {
await logout();
return;
}
if (syncResult.isActivationPending) {
setIsPendingActivation(true);
setIsSynced(false);
@@ -668,6 +639,27 @@ export const AuthProvider: React.FC<{ children: ReactNode }> = ({ children }) =>
setIsPendingActivation(false);
setIsSynced(true);
setActivationError(null);
const resolved = await resolveUserRolesAndClaims(
storedSub || '',
parsedClaims,
resolvedUser || {}
);
if (resolvedUser) {
if (resolved.primaryRole) resolvedUser.role = resolved.primaryRole;
if (resolved.tenant) {
resolvedUser.tenant = resolved.tenant;
setTenantName(resolved.tenant);
}
if (resolved.tenant_id !== undefined) {
resolvedUser.tenant_id = resolved.tenant_id;
setTenantId(resolved.tenant_id);
}
setUser({ ...resolvedUser });
localStorage.setItem(LOCAL_STORAGE_USER_KEY, JSON.stringify(resolvedUser));
}
setClaims({ ...resolved.claims });
localStorage.setItem(LOCAL_STORAGE_CLAIMS_KEY, JSON.stringify(resolved.claims));
}
} catch (syncErr: any) {
if (syncErr?.response?.status === 401) {
@@ -676,9 +668,7 @@ export const AuthProvider: React.FC<{ children: ReactNode }> = ({ children }) =>
}
setIsPendingActivation(true);
setIsSynced(false);
const rawMsg = syncErr?.message || 'Account activation pending';
const cleanMsg = /network\s*error/i.test(rawMsg) ? rawMsg.replace(/network\s*error/gi, 'Permission Check') : rawMsg;
setActivationError(cleanMsg);
setActivationError(syncErr?.message || 'Account activation pending');
}
})();
@@ -697,65 +687,12 @@ export const AuthProvider: React.FC<{ children: ReactNode }> = ({ children }) =>
const syncUserSession = async (force = true): Promise<UserSyncResult> => {
try {
await loadRuntimeConfig();
clearTenantLockoutCache();
// Step 1: Proceed with user sync FIRST (/v1/api/integration/sync)
const result = await syncUserAccount(sub, accessToken, user || undefined, force);
if (result.isUnauthorized) {
await logout();
return result;
}
if (result.isActivationPending) {
setIsPendingActivation(true);
setIsSynced(false);
setActivationError(result.errorMessage || null);
return result;
}
// Step 2: Refresh user roles and claims from backend
let currentTenantId: number | string | null = tenantId;
let currentTenantClaim: string | undefined =
(claims.tenant as string) || user?.tenant || undefined;
try {
const resolved = await resolveUserRolesAndClaims(sub, claims, user || {});
const updatedProfile = user ? { ...user } : null;
if (updatedProfile && resolved.primaryRole) {
updatedProfile.role = resolved.primaryRole;
}
if (resolved.tenant) {
currentTenantClaim = resolved.tenant;
setTenantName(resolved.tenant);
if (updatedProfile) updatedProfile.tenant = resolved.tenant;
}
if (resolved.tenant_id !== undefined) {
currentTenantId = resolved.tenant_id;
setTenantId(resolved.tenant_id);
if (updatedProfile) updatedProfile.tenant_id = resolved.tenant_id;
}
if (updatedProfile) {
setUser(updatedProfile);
localStorage.setItem(LOCAL_STORAGE_USER_KEY, JSON.stringify(updatedProfile));
}
setClaims({ ...resolved.claims });
localStorage.setItem(LOCAL_STORAGE_CLAIMS_KEY, JSON.stringify(resolved.claims));
} catch {}
// Step 3: Re-verify tenant status via GetTenant now that user is synced
// Re-verify tenant status via GetTenant as part of the lockout resolution
const tenantClaimValues = extractTenantClaimValues(claims, accessToken);
const effectiveTenantId =
currentTenantId ??
result.data?.tenantId ??
result.data?.organisationId ??
tenantClaimValues.tenantId;
const effectiveTenantClaim = currentTenantClaim || tenantClaimValues.tenant || undefined;
const currentTenantId = tenantId ?? tenantClaimValues.tenantId;
const currentTenantClaim = (claims.tenant as string) || user?.tenant || tenantClaimValues.tenant || undefined;
const tenantLockoutResult = await verifyTenantLockout(
effectiveTenantId,
effectiveTenantClaim,
true
);
const tenantLockoutResult = await verifyTenantLockout(currentTenantId, currentTenantClaim);
if (!tenantLockoutResult.isActive) {
const msg = tenantLockoutResult.errorMessage || 'Tenant is not Active. Lockout active.';
setIsPendingActivation(true);
@@ -768,22 +705,28 @@ export const AuthProvider: React.FC<{ children: ReactNode }> = ({ children }) =>
};
}
if (tenantLockoutResult.tenant?.name) {
setTenantName(tenantLockoutResult.tenant.name);
// Tenant is verified Active: proceed with user sync
const result = await syncUserAccount(sub, accessToken, user || undefined, force);
if (result.isUnauthorized) {
await logout();
return result;
}
setActivationPending(false);
if (result.success) {
setIsPendingActivation(false);
setIsSynced(true);
setActivationError(null);
} else if (result.isActivationPending) {
setIsPendingActivation(true);
setIsSynced(false);
setActivationError(result.errorMessage || null);
}
return result;
} catch (err: any) {
if (err?.response?.status === 401) {
await logout();
return { success: false, isUnauthorized: true };
}
const rawMsg = err?.message || 'Sync failed';
const msg = /network\s*error/i.test(rawMsg) ? rawMsg.replace(/network\s*error/gi, 'Permission Check') : rawMsg;
const msg = err?.message || 'Sync failed';
setIsPendingActivation(true);
setIsSynced(false);
setActivationError(msg);
@@ -11,7 +11,6 @@ export type RoleClaim =
| 'beneficiaries'
| 'change_management'
| 'site_visits'
| 'compliance'
| 'settings_invites'
| 'settings_users'
| 'settings_auditlog'
@@ -37,7 +36,6 @@ export const ROLE_CLAIM_DEFINITIONS: RoleClaimDefinition[] = [
{ claim: 'beneficiaries', label: 'Beneficiaries', description: 'Target demographics, compliance tracking, and outcomes' },
{ claim: 'change_management', label: 'Change Management', description: 'Contractual change requests, issues, and enactments' },
{ claim: 'site_visits', label: 'Site Visits', description: 'Physical field inspection reports and inspector findings' },
{ claim: 'compliance', label: 'Compliance', description: 'Statutory compliance dashboard, outcome fulfillment, and risk monitoring' },
{ claim: 'settings_invites', label: 'Settings Invites', description: 'Statutory onboarding invitations and applicant notifications' },
{ claim: 'settings_users', label: 'Settings Users', description: 'Direct user account administration and role memberships' },
{ claim: 'settings_auditlog', label: 'Settings Audit Log', description: 'System-wide activity ledger and telemetry records' },
@@ -62,7 +60,6 @@ export const ROLE_CLAIM_MAP: Record<string, RoleClaim[]> = {
admin: ['unrestricted'],
executive: [
'dashboard',
'compliance',
'governance',
'projects_milestones',
'grant_financials',
@@ -71,7 +68,6 @@ export const ROLE_CLAIM_MAP: Record<string, RoleClaim[]> = {
],
supervisor: [
'dashboard',
'compliance',
'projects_milestones',
'grant_financials',
'evidence_risks',
@@ -83,7 +79,6 @@ export const ROLE_CLAIM_MAP: Record<string, RoleClaim[]> = {
],
manager: [
'dashboard',
'compliance',
'projects_milestones',
'grant_financials',
'evidence_risks',
@@ -396,7 +391,6 @@ export const ClaimProtectedRoute: React.FC<{
if (!allowed) {
let fallbackPath = '/dashboard';
if (canView('dashboard')) fallbackPath = '/dashboard';
else if (canView('compliance')) fallbackPath = '/compliance';
else if (canView('projects_milestones')) fallbackPath = '/projects';
else if (canView('grant_financials')) fallbackPath = '/grants';
else if (canView('evidence_risks')) fallbackPath = '/monitoring';
@@ -115,94 +115,141 @@ export const AccountActivationModal: React.FC<AccountActivationModalProps> = ({
navigate('/');
};
const isTenantIssue = !!errorMessage?.toLowerCase().includes('tenant');
const modalContent = (
<div
role="dialog"
aria-modal="true"
aria-labelledby="activation-modal-title"
className="fixed inset-0 z-[9999] flex items-center justify-center p-4 bg-[#060a12]/85 backdrop-blur-md animate-in fade-in duration-200 select-none overflow-y-auto"
className="fixed inset-0 z-[9999] flex items-center justify-center p-4 sm:p-6 bg-[#060a12]/90 backdrop-blur-md animate-in fade-in duration-200 select-none overflow-y-auto"
>
{/* Non-dismissable Card Container: No X button, no escape dismiss, no backdrop click */}
<div
className="relative w-full max-w-lg bg-[#0d1322] border border-slate-800 rounded-2xl shadow-2xl shadow-black/80 overflow-hidden flex flex-col text-slate-100 my-auto"
className="relative w-full max-w-xl bg-[#0d1322] border border-amber-500/30 rounded-2xl shadow-2xl shadow-black/80 overflow-hidden flex flex-col text-slate-100 my-auto"
onClick={(e) => e.stopPropagation()}
>
{/* Subtle accent top border */}
<div className={`h-1 w-full ${isTenantIssue ? 'bg-amber-500' : 'bg-blue-600'}`} />
{/* Amber accent top bar */}
<div className="h-1.5 w-full bg-gradient-to-r from-amber-500 via-amber-400 to-yellow-500" />
{/* Header */}
<div className="p-5 pb-4 border-b border-slate-800/80 bg-[#0f172a]/60">
{/* Modal Header */}
<div className="p-6 pb-4 border-b border-slate-800/80 bg-[#0f172a]/60">
<div className="flex items-start justify-between gap-4">
<div className="flex items-center gap-3">
<div className={`p-2.5 rounded-xl border ${isTenantIssue ? 'bg-amber-500/10 border-amber-500/20 text-amber-400' : 'bg-blue-500/10 border-blue-500/20 text-blue-400'}`}>
<ShieldAlert className="w-5 h-5" />
<div className="flex items-center gap-3.5">
<div className="relative p-2.5 rounded-xl bg-amber-500/10 border border-amber-500/20 text-amber-400">
<ShieldAlert className="w-6 h-6" />
<span className="absolute -top-1 -right-1 flex h-2.5 w-2.5">
<span className="animate-ping absolute inline-flex h-full w-full rounded-full bg-amber-400 opacity-75"></span>
<span className="relative inline-flex rounded-full h-2.5 w-2.5 bg-amber-500"></span>
</span>
</div>
<div>
<h2 id="activation-modal-title" className="text-base font-bold text-white tracking-tight">
{isTenantIssue ? 'Tenant Access Restricted' : 'Account Pending Activation'}
<span className="inline-flex items-center gap-1.5 text-[11px] font-semibold tracking-wider uppercase text-amber-400 bg-amber-500/10 border border-amber-500/20 px-2 py-0.5 rounded-full mb-1">
Access Restricted • Lockout Active
</span>
<h2 id="activation-modal-title" className="text-lg sm:text-xl font-bold text-white tracking-tight">
{errorMessage?.toLowerCase().includes('tenant')
? 'Tenant Lockout • Account Inactive'
: 'Account Pending Administrator Activation'}
</h2>
<p className="text-xs text-slate-400 mt-0.5">
{isTenantIssue
? 'The assigned tenant partition is currently inactive or restricted.'
: 'Your account is authenticated and awaiting administrator enablement.'}
</div>
</div>
<BrandLogo size={36} showGlow={false} animateOnHover={false} />
</div>
</div>
{/* Modal Body */}
<div className="p-6 space-y-5 overflow-y-auto max-h-[70vh]">
{/* Status notification block */}
<div className="bg-slate-900/80 border border-slate-800 rounded-xl p-4 space-y-2.5">
<div className="flex items-center gap-2 text-emerald-400 text-xs font-semibold">
<CheckCircle2 className="w-4 h-4 shrink-0" />
<span>Identity Verified & Signed In Successfully</span>
</div>
<p className="text-xs text-slate-300 leading-relaxed">
You are a registered user and have successfully authenticated via Enterprise Single Sign-On.
However, your account has not yet been enabled in the system directory by a system administrator.
</p>
<p className="text-xs text-slate-400 leading-relaxed border-t border-slate-800/80 pt-2 font-medium">
If your administrator informs you that your account has been activated, please click the{' '}
<strong className="text-white">Sync Account</strong> button below to refresh your status and unlock the system.
</p>
</div>
{/* User Profile Card */}
<div className="rounded-xl border border-slate-800 bg-[#090e1a]/60 p-4 space-y-3">
<div className="text-[11px] font-semibold text-slate-400 uppercase tracking-wider flex items-center justify-between">
<span>Authenticated User Profile</span>
<span className="text-amber-400/90 text-[10px] font-mono bg-amber-500/10 px-2 py-0.5 rounded border border-amber-500/20">
Lockout Active
</span>
</div>
<BrandLogo size={32} showGlow={false} animateOnHover={false} />
</div>
</div>
{/* Body */}
<div className="p-5 space-y-4">
{/* User Profile Summary */}
<div className="rounded-xl border border-slate-800/80 bg-slate-900/60 p-3.5 space-y-2 text-xs">
<div className="grid grid-cols-2 gap-2.5">
<div>
<span className="text-[10px] uppercase font-semibold text-slate-500 block">User</span>
<div className="grid grid-cols-1 sm:grid-cols-2 gap-3 text-xs">
<div className="flex items-center gap-2.5 bg-slate-900/60 p-2.5 rounded-lg border border-slate-800/60">
<UserCheck className="w-4 h-4 text-blue-400 shrink-0" />
<div className="min-w-0">
<span className="text-[10px] text-slate-500 block">Name</span>
<span className="font-semibold text-white truncate block">{displayName}</span>
</div>
<div>
<span className="text-[10px] uppercase font-semibold text-slate-500 block">Email</span>
<span className="text-slate-300 truncate block">{displayEmail || '—'}</span>
</div>
<div className="flex items-center gap-2.5 bg-slate-900/60 p-2.5 rounded-lg border border-slate-800/60">
<Mail className="w-4 h-4 text-blue-400 shrink-0" />
<div className="min-w-0">
<span className="text-[10px] text-slate-500 block">Email</span>
<span className="font-semibold text-slate-200 truncate block">{displayEmail || 'Not specified'}</span>
</div>
</div>
<div className="grid grid-cols-2 gap-2.5 border-t border-slate-800/60 pt-2">
<div>
<span className="text-[10px] uppercase font-semibold text-slate-500 block">Tenant</span>
<span className="text-slate-300 truncate block">{tenant}</span>
<div className="flex items-center gap-2.5 bg-slate-900/60 p-2.5 rounded-lg border border-slate-800/60">
<Building2 className="w-4 h-4 text-indigo-400 shrink-0" />
<div className="min-w-0">
<span className="text-[10px] text-slate-500 block">Tenant / Role</span>
<span className="font-semibold text-slate-200 truncate block">
{tenant} ({role})
</span>
</div>
</div>
<div className="flex items-center gap-2.5 bg-slate-900/60 p-2.5 rounded-lg border border-slate-800/60">
<Fingerprint className="w-4 h-4 text-slate-400 shrink-0" />
<div className="min-w-0">
<span className="text-[10px] text-slate-500 block">Subject ID</span>
<span className="font-mono text-[11px] text-slate-400 truncate block">{sub || 'SSO-Principal'}</span>
</div>
<div>
<span className="text-[10px] uppercase font-semibold text-slate-500 block">Role</span>
<span className="text-blue-400 font-medium truncate block">{role}</span>
</div>
</div>
</div>
{/* Feedback notice if sync failed */}
{/* Sync Attempt Feedback / Error Notice */}
{errorMessage && (
<div className="rounded-xl border border-amber-500/25 bg-amber-500/10 p-3 flex items-start gap-2.5 text-xs text-amber-200">
<AlertTriangle className="w-4 h-4 text-amber-400 shrink-0 mt-0.5" />
<div className="min-w-0">
<span className="font-semibold text-amber-300 block">Notice:</span>
<p className="text-[11px] text-amber-200/90 leading-relaxed mt-0.5">{errorMessage}</p>
<div className="rounded-xl border border-rose-500/30 bg-rose-500/10 p-3.5 flex items-start gap-3 animate-in fade-in duration-150">
<AlertTriangle className="w-4 h-4 text-rose-400 shrink-0 mt-0.5" />
<div className="space-y-1">
<p className="text-xs font-semibold text-rose-300">
{errorMessage?.toLowerCase().includes('tenant')
? 'Tenant Lockout In Effect'
: 'Account Not Activated Yet'}
</p>
<p className="text-xs text-rose-200/90 leading-relaxed">{errorMessage}</p>
{syncAttemptCount > 0 && (
<p className="text-[11px] text-rose-400/80 pt-1">
Attempt #{syncAttemptCount} checked at {new Date().toLocaleTimeString()}
</p>
)}
</div>
</div>
)}
<p className="text-[11px] text-slate-400 text-center">
Once your administrator enables your account, click <strong className="text-white">Sync Account</strong> to enter the console.
</p>
</div>
{/* Footer Actions */}
<div className="p-4 border-t border-slate-800 bg-[#0a0f1d] flex flex-col sm:flex-row items-center justify-between gap-2.5">
{/* Modal Actions */}
<div className="p-5 border-t border-slate-800/80 bg-[#0a0f1d] flex flex-col sm:flex-row items-center justify-between gap-3">
<div className="flex items-center gap-2 w-full sm:w-auto">
<button
onClick={handleNavigateLanding}
type="button"
className="flex-1 sm:flex-none inline-flex items-center justify-center gap-1.5 px-3 py-2 text-xs font-medium text-slate-400 hover:text-white bg-slate-900 hover:bg-slate-800 border border-slate-800 rounded-xl transition cursor-pointer"
className="flex-1 sm:flex-none inline-flex items-center justify-center gap-1.5 px-3.5 py-2 text-xs font-medium text-slate-400 hover:text-slate-200 bg-slate-900 hover:bg-slate-800 border border-slate-800 rounded-xl transition cursor-pointer"
title="View public landing page. Entering the console again will display this modal until enabled."
>
<ArrowLeft className="w-3.5 h-3.5" />
<span>Landing Page</span>
@@ -211,7 +258,8 @@ export const AccountActivationModal: React.FC<AccountActivationModalProps> = ({
<button
onClick={handleSignOut}
type="button"
className="flex-1 sm:flex-none inline-flex items-center justify-center gap-1.5 px-3 py-2 text-xs font-medium text-slate-400 hover:text-rose-400 bg-slate-900 hover:bg-rose-500/10 border border-slate-800 hover:border-rose-500/20 rounded-xl transition cursor-pointer"
className="flex-1 sm:flex-none inline-flex items-center justify-center gap-1.5 px-3.5 py-2 text-xs font-medium text-slate-400 hover:text-rose-400 bg-slate-900 hover:bg-rose-500/10 border border-slate-800 hover:border-rose-500/30 rounded-xl transition cursor-pointer"
title="Sign out of current SSO session"
>
<LogOut className="w-3.5 h-3.5" />
<span>Sign Out</span>
@@ -223,10 +271,10 @@ export const AccountActivationModal: React.FC<AccountActivationModalProps> = ({
disabled={isSyncing}
type="button"
id="activation-sync-btn"
className="w-full sm:w-auto inline-flex items-center justify-center gap-2 px-4 py-2 text-xs font-semibold text-white bg-blue-600 hover:bg-blue-500 active:bg-blue-700 disabled:opacity-50 rounded-xl shadow-md transition cursor-pointer"
className="w-full sm:w-auto inline-flex items-center justify-center gap-2 px-5 py-2.5 text-xs font-semibold text-white bg-blue-600 hover:bg-blue-500 active:bg-blue-700 disabled:opacity-50 disabled:pointer-events-none rounded-xl shadow-lg shadow-blue-600/30 transition cursor-pointer"
>
<RefreshCw className={`w-3.5 h-3.5 ${isSyncing ? 'animate-spin' : ''}`} />
<span>{isSyncing ? 'Checking...' : 'Sync Account'}</span>
<RefreshCw className={`w-4 h-4 ${isSyncing ? 'animate-spin' : ''}`} />
<span>{isSyncing ? 'Verifying Activation...' : 'Sync Account'}</span>
</button>
</div>
</div>
@@ -61,57 +61,114 @@ export const PartnerAccessDeniedModal: React.FC<PartnerAccessDeniedModalProps> =
aria-modal="true"
aria-labelledby="partner-denied-title"
aria-describedby="partner-denied-description"
className="fixed inset-0 z-[9999] flex items-center justify-center p-4 bg-black/80 backdrop-blur-md animate-in fade-in duration-150 overflow-y-auto"
className="fixed inset-0 z-[9999] flex items-center justify-center p-4 bg-black/85 backdrop-blur-md animate-in fade-in duration-200 overflow-y-auto"
>
<div className="relative w-full max-w-md overflow-hidden rounded-2xl bg-[#0d1322] border border-slate-800 shadow-2xl my-auto text-slate-100">
<div className="h-1 w-full bg-rose-600" />
<div className="relative w-full max-w-lg overflow-hidden rounded-2xl bg-[#0e1424] border border-rose-900/60 shadow-2xl shadow-rose-950/50 my-auto">
{/* Glow Header Accent */}
<div className="h-2 w-full bg-linear-to-r from-rose-600 via-red-500 to-amber-500" />
<div className="p-5 space-y-4">
<div className="flex items-start gap-3">
<div className="flex h-10 w-10 shrink-0 items-center justify-center rounded-xl bg-rose-500/10 border border-rose-500/20 text-rose-400">
<Ban className="h-5 w-5" />
<div className="p-6 sm:p-8 space-y-6">
{/* Header */}
<div className="flex items-start gap-4">
<div className="flex h-12 w-12 shrink-0 items-center justify-center rounded-2xl bg-rose-500/15 border border-rose-500/30 text-rose-400">
<Ban className="h-6 w-6 text-rose-400" />
</div>
<div>
<h2 id="partner-denied-title" className="text-base font-bold text-white tracking-tight">
Partner Portal Required
<div className="space-y-1">
<div className="flex items-center gap-2">
<span className="inline-flex items-center gap-1 text-[11px] font-semibold text-rose-400 bg-rose-950/60 px-2 py-0.5 rounded-md border border-rose-800/60">
<Lock className="w-3 h-3" />
Restricted Role
</span>
<span className="text-xs text-slate-500">Security Policy</span>
</div>
<h2 id="partner-denied-title" className="text-lg font-bold text-white tracking-tight">
Access Denied: Partner Role
</h2>
<p id="partner-denied-description" className="text-xs text-slate-400 mt-0.5">
Accounts with the Partner role must access the Partner Portal.
<p id="partner-denied-description" className="text-xs text-slate-400 leading-relaxed">
Users assigned the <strong className="text-rose-300">Partner</strong> role by security are not permitted to access the PFM Backoffice Console.
</p>
</div>
</div>
<div className="rounded-xl bg-slate-900/60 border border-slate-800 p-3.5 space-y-2 text-xs">
<div className="flex items-center justify-between">
<span className="text-slate-500 text-[11px] uppercase font-semibold">User</span>
<span className="text-white font-medium">{displayName}</span>
{/* User & Identity Summary Card */}
<div className="rounded-xl bg-slate-900/80 border border-slate-800 p-4 space-y-3 text-xs">
<div className="flex items-center justify-between pb-2 border-b border-slate-800/80">
<span className="text-slate-400 font-medium">Account Name</span>
<span className="text-white font-semibold">{displayName}</span>
</div>
{displayEmail && (
<div className="flex items-center justify-between border-t border-slate-800/60 pt-2">
<span className="text-slate-500 text-[11px] uppercase font-semibold">Email</span>
<span className="text-slate-300 font-mono text-[11px]">{displayEmail}</span>
<div className="flex items-center justify-between pb-2 border-b border-slate-800/80">
<span className="text-slate-400 font-medium flex items-center gap-1.5">
<Mail className="w-3.5 h-3.5 text-slate-500" />
Email
</span>
<span className="text-slate-200 font-mono">{displayEmail}</span>
</div>
)}
<div className="flex items-center justify-between border-t border-slate-800/60 pt-2">
<span className="text-slate-500 text-[11px] uppercase font-semibold">Role</span>
<span className="text-rose-400 font-medium">{role}</span>
</div>
<div className="flex items-center justify-between pb-2 border-b border-slate-800/80">
<span className="text-slate-400 font-medium flex items-center gap-1.5">
<Building2 className="w-3.5 h-3.5 text-slate-500" />
Assigned Role
</span>
<span className="text-rose-400 font-semibold bg-rose-950/60 px-2 py-0.5 rounded border border-rose-800/50">
{role}
</span>
</div>
<p className="text-[11px] text-slate-400 text-center leading-relaxed">
The Console is reserved for statutory administrators and programme managers.
{tenant && (
<div className="flex items-center justify-between pb-2 border-b border-slate-800/80">
<span className="text-slate-400 font-medium flex items-center gap-1.5">
<Building2 className="w-3.5 h-3.5 text-slate-500" />
Tenant Context
</span>
<span className="text-slate-200 font-medium truncate max-w-[220px]">{tenant}</span>
</div>
)}
{sub && (
<div className="flex items-center justify-between text-[11px] text-slate-500">
<span className="flex items-center gap-1">
<Fingerprint className="w-3 h-3" />
Subject Key
</span>
<span className="font-mono text-slate-400 truncate max-w-[200px]">{sub}</span>
</div>
)}
</div>
{/* Security Policy Information */}
<div className="p-4 rounded-xl bg-rose-950/20 border border-rose-900/40 text-xs text-rose-200 leading-relaxed space-y-1.5">
<p className="font-semibold text-rose-300 flex items-center gap-1.5">
<ShieldAlert className="w-4 h-4 text-rose-400" />
Administrative Boundary Notice
</p>
<p className="text-[11px] text-rose-300/90">
The PFM Console is reserved for statutory administrators, sponsors, programme managers, and governance officers. Partner credentials cannot access this environment. If you require backoffice administrative access, please request an updated role assignment from your system administrator.
</p>
</div>
<div className="pt-1">
{/* Actions */}
<div className="pt-2">
<button
onClick={handleLogoutClick}
className="w-full flex items-center justify-center gap-2 py-2.5 px-4 rounded-xl bg-blue-600 hover:bg-blue-500 text-white text-xs font-semibold shadow-md transition cursor-pointer"
className="w-full flex items-center justify-center gap-2 py-2.5 px-4 rounded-xl bg-slate-800 hover:bg-slate-700 text-slate-200 hover:text-white text-xs font-semibold border border-slate-700 transition cursor-pointer shadow-sm"
>
<LogOut className="w-4 h-4" />
<span>Sign Out & Return Home</span>
<LogOut className="w-4 h-4 text-rose-400" />
<span>Sign Out & Return to Home</span>
</button>
</div>
</div>
{/* Footer Brand watermark */}
<div className="px-6 py-3 bg-[#0a0f1d] border-t border-slate-800/80 flex items-center justify-between text-[11px] text-slate-500">
<div className="flex items-center gap-2">
<BrandLogo size={16} showGlow={false} animateOnHover={false} />
<span>Post Fund Management (PFM)</span>
</div>
<span>National Security Gateway</span>
</div>
</div>
</div>
);
@@ -87,7 +87,7 @@ export const SessionExpiredModal: React.FC<SessionExpiredModalProps> = ({
const modalContent = (
<div
id="session-expired-modal-backdrop"
className="fixed inset-0 z-[9999] flex items-center justify-center bg-black/80 backdrop-blur-md p-4 animate-in fade-in duration-150 overflow-y-auto"
className="fixed inset-0 z-[9999] flex items-center justify-center bg-black/85 backdrop-blur-md p-4 animate-in fade-in duration-200 overflow-y-auto"
onMouseEnter={() => setIsPaused(true)}
onMouseLeave={() => setIsPaused(false)}
role="dialog"
@@ -96,20 +96,27 @@ export const SessionExpiredModal: React.FC<SessionExpiredModalProps> = ({
>
<div
id="session-expired-modal-content"
className="relative w-full max-w-md bg-[#0d1322] border border-slate-800 rounded-2xl shadow-2xl p-5 overflow-hidden text-slate-200 space-y-4 my-auto"
className="relative w-full max-w-md bg-[#0c121e] border border-amber-500/40 rounded-2xl shadow-2xl shadow-black/90 p-6 overflow-hidden text-slate-200 space-y-5 my-auto"
>
<div className="absolute top-0 left-0 right-0 h-1 bg-amber-500" />
{/* Subtle decorative top accent bar */}
<div className="absolute top-0 left-0 right-0 h-1 bg-gradient-to-r from-amber-500 via-orange-500 to-rose-500" />
{/* Top bar with close button */}
<div className="flex items-start justify-between pt-1">
<div className="flex items-center gap-3">
<div className="w-10 h-10 rounded-xl bg-amber-500/10 border border-amber-500/20 flex items-center justify-center text-amber-400 shrink-0">
<ShieldAlert className="w-5 h-5" />
<div className="w-12 h-12 rounded-2xl bg-amber-500/10 border border-amber-500/30 flex items-center justify-center text-amber-400 shrink-0 shadow-lg shadow-amber-500/10">
<ShieldAlert className="w-6 h-6" />
</div>
<div>
<div className="flex items-center gap-2">
<h3 id="session-expired-title" className="text-base font-bold text-white tracking-tight">
Session Expired
</h3>
<p className="text-xs text-slate-400">Authorization credentials expired</p>
<span className="text-[10px] font-mono font-semibold px-2 py-0.5 rounded bg-rose-950/60 text-rose-300 border border-rose-800/60">
HTTP 401
</span>
</div>
<p className="text-xs text-slate-400 mt-0.5">Authorization token invalidated</p>
</div>
</div>
@@ -118,46 +125,60 @@ export const SessionExpiredModal: React.FC<SessionExpiredModalProps> = ({
type="button"
onClick={handleAction}
aria-label="Dismiss and return to landing page"
className="p-1.5 text-slate-400 hover:text-white rounded-lg hover:bg-slate-800 transition-colors cursor-pointer"
className="p-1.5 text-slate-400 hover:text-white rounded-lg hover:bg-slate-800/80 transition-colors"
>
<X className="w-4 h-4" />
</button>
</div>
<div className="text-xs text-slate-300 leading-relaxed bg-slate-900/60 p-3.5 rounded-xl border border-slate-800/80 space-y-1.5">
{/* Informative Explanation (non-technical and clear) */}
<div className="space-y-2.5 text-xs text-slate-300 leading-relaxed bg-slate-900/60 p-4 rounded-xl border border-slate-800/80">
<p>
Your active session has ended to protect account security. Please sign in again to continue working.
Your active working session has ended or your security credentials have expired. To protect your data and prevent unauthorized changes, your session has been closed.
</p>
{reason && (
<div className="flex items-start gap-1.5 pt-1 text-[11px] text-amber-300/90 font-mono">
<div className="flex items-start gap-2 pt-1 text-[11px] text-amber-300/90 font-mono">
<AlertTriangle className="w-3.5 h-3.5 shrink-0 mt-0.5 text-amber-400" />
<span className="break-words">{reason}</span>
</div>
)}
</div>
<div className="flex items-center justify-between text-xs text-slate-400">
<span className="flex items-center gap-1.5">
{/* Progress Bar Countdown */}
<div className="space-y-2">
<div className="flex items-center justify-between text-xs">
<span className="text-slate-400 flex items-center gap-1.5">
<Clock className="w-3.5 h-3.5 text-amber-400" />
Redirecting in <strong className="text-white font-mono">{secondsRemaining}s</strong>
Returning to landing page in{' '}
<strong className="text-white font-mono">{secondsRemaining}s</strong>
</span>
{isPaused && (
<span className="text-[10px] text-amber-400/80 px-1.5 py-0.5 rounded bg-amber-500/10 border border-amber-500/20">
Paused
<span className="text-[10px] text-amber-400/80 font-medium px-1.5 py-0.2 rounded bg-amber-950/40 border border-amber-900/60">
Paused on hover
</span>
)}
</div>
<div className="pt-1">
{/* Progress bar line */}
<div className="w-full h-2 bg-slate-800/90 rounded-full overflow-hidden border border-slate-700/60 p-0.5">
<div
className="h-full rounded-full bg-gradient-to-r from-amber-500 via-orange-500 to-rose-500 transition-all duration-75 ease-linear"
style={{ width: `${progressPercent}%` }}
/>
</div>
</div>
{/* Actions */}
<div className="pt-2 flex flex-col sm:flex-row items-center gap-2.5">
<button
id="session-expired-return-btn"
type="button"
onClick={handleAction}
className="w-full py-2.5 px-4 text-xs font-semibold text-white bg-blue-600 hover:bg-blue-500 rounded-xl shadow-md transition-all flex items-center justify-center gap-2 cursor-pointer"
className="w-full py-2.5 px-4 text-xs font-semibold text-white bg-gradient-to-r from-blue-600 to-indigo-600 hover:from-blue-500 hover:to-indigo-500 rounded-xl shadow-lg shadow-blue-500/20 transition-all flex items-center justify-center gap-2"
>
<LogOut className="w-4 h-4" />
<span>Return to Landing Page</span>
<ArrowRight className="w-3.5 h-3.5" />
<span>Return to Landing Page Now</span>
<ArrowRight className="w-3.5 h-3.5 ml-0.5" />
</button>
</div>
</div>
@@ -48,7 +48,7 @@ const instrumentSchema = z.object({
name: z.string().min(3, 'Funding instrument title must be at least 3 characters'),
code: z.string().optional(),
description: z.string().min(5, 'Description is required (minimum 5 characters)'),
status: z.coerce.number(),
status: z.coerce.number().default(ActivityStatus.Active),
});
type InstrumentFormValues = z.infer<typeof instrumentSchema>;
@@ -46,8 +46,8 @@ const ruleSchema = z.object({
programmeId: z.coerce.number().min(1, 'Please select an associated programme from the dropdown'),
name: z.string().min(3, 'Rule name must be at least 3 characters'),
description: z.string().min(5, 'Description is required (minimum 5 characters)'),
version: z.coerce.number().min(1, 'Version must be at least 1'),
status: z.coerce.number(),
version: z.coerce.number().min(1, 'Version must be at least 1').default(1),
status: z.coerce.number().default(ActivityStatus.Active),
});
type RuleFormValues = z.infer<typeof ruleSchema>;
@@ -1,8 +1,6 @@
import React, { useState } from 'react';
import { NavLink, Outlet, useNavigate, Link } from 'react-router-dom';
import { NotificationBell } from './NotificationBell';
import {
Inbox,
LayoutDashboard,
Building2,
FolderKanban,
@@ -93,13 +91,6 @@ const navItems: NavItem[] = [
help: 'Log physical site visits, field observations, inspector findings, and project feedback.',
claim: 'site_visits',
},
{
name: 'Compliance',
path: '/compliance',
icon: ShieldCheck,
help: 'Portfolio & programme compliance dashboard, statutory requirements, beneficiary outcome fulfillment, and risk monitoring.',
claim: 'compliance',
},
],
},
{
@@ -123,12 +114,6 @@ const navItems: NavItem[] = [
help: 'Multi-tenant partition directory, organizational onboarding, status lifecycle controls, and system-wide isolation boundaries.',
claim: 'tenant_management',
},
{
name: 'Inbox',
path: '/inbox',
icon: Inbox,
help: 'In-app notifications, communications, deliverable messages, drafts, and replies across active tenant users.',
},
{
name: 'Settings & Communications',
path: '/settings',
@@ -533,8 +518,6 @@ export const AppLayout: React.FC = () => {
{/* User Profile and Controls */}
<div className="relative flex items-center gap-3">
{/* Notification Bell in close proximity to username */}
<NotificationBell />
<div className="text-right hidden sm:block">
<div className="flex items-center justify-end gap-1.5">
<p className="text-xs font-semibold text-white truncate max-w-[150px]" title={tokenUserName}>
@@ -572,14 +555,6 @@ export const AppLayout: React.FC = () => {
<p className="text-[10px] text-slate-400 mt-1">Role: <strong className="text-blue-300">{userRole}</strong></p>
</div>
<Link
to="/inbox"
onClick={() => setUserMenuOpen(false)}
className="flex items-center gap-2 px-3 py-2 text-xs text-slate-300 hover:text-white hover:bg-slate-800/60 rounded-xl transition"
>
<Inbox className="w-3.5 h-3.5 text-blue-400" />
<span>In-App Mailbox</span>
</Link>
<Link
to="/"
onClick={() => setUserMenuOpen(false)}
@@ -1,216 +0,0 @@
import React, { useState, useRef, useEffect } from 'react';
import { useNavigate } from 'react-router-dom';
import {
Bell,
Mail,
CheckCheck,
ChevronRight,
Inbox,
Clock,
Sparkles,
} from 'lucide-react';
import { useInAppNotifications } from '../../hooks/useInAppNotifications';
import { formatDate } from '../../lib/formatters';
import { stripMarkdown } from '../../lib/markdownUtils';
export const NotificationBell: React.FC = () => {
const navigate = useNavigate();
const { top5Unread, unreadCount, markAsRead, markAllAsRead } = useInAppNotifications();
const [isOpen, setIsOpen] = useState(false);
const leaveTimerRef = useRef<number | null>(null);
const containerRef = useRef<HTMLDivElement>(null);
// Clear timer on unmount
useEffect(() => {
return () => {
if (leaveTimerRef.current) {
window.clearTimeout(leaveTimerRef.current);
}
};
}, []);
const handleMouseEnter = () => {
if (leaveTimerRef.current) {
window.clearTimeout(leaveTimerRef.current);
leaveTimerRef.current = null;
}
setIsOpen(true);
};
const handleMouseLeave = () => {
leaveTimerRef.current = window.setTimeout(() => {
setIsOpen(false);
}, 250);
};
const handleNotificationClick = async (id: number | string) => {
await markAsRead(id);
setIsOpen(false);
navigate(`/inbox?id=${id}`);
};
const handleViewAll = () => {
setIsOpen(false);
navigate('/inbox');
};
// Format relative timestamp
const getRelativeTime = (dateStr?: string) => {
if (!dateStr) return '';
try {
const now = new Date();
const date = new Date(dateStr);
const diffMs = now.getTime() - date.getTime();
const diffMins = Math.floor(diffMs / (1000 * 60));
const diffHours = Math.floor(diffMs / (1000 * 60 * 60));
const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
if (diffMins < 1) return 'Just now';
if (diffMins < 60) return `${diffMins}m ago`;
if (diffHours < 24) return `${diffHours}h ago`;
if (diffDays < 7) return `${diffDays}d ago`;
return formatDate(dateStr);
} catch {
return '';
}
};
return (
<div
ref={containerRef}
className="relative"
onMouseEnter={handleMouseEnter}
onMouseLeave={handleMouseLeave}
>
{/* Bell Button */}
<button
type="button"
onClick={() => setIsOpen(prev => !prev)}
id="header-notification-bell-btn"
className={`relative h-9 w-9 rounded-full flex items-center justify-center transition cursor-pointer ${
isOpen
? 'bg-blue-600/30 text-white border border-blue-400/50 shadow-md shadow-blue-500/20'
: 'bg-slate-900/80 hover:bg-slate-800 text-slate-300 hover:text-white border border-slate-700/80 hover:border-slate-600 shadow-xs'
}`}
title={`Notifications • ${unreadCount} unread`}
aria-label="In-App Notifications"
>
<Bell className="w-4 h-4" />
{/* Unread Count Badge */}
{unreadCount > 0 && (
<span
id="notification-unread-count-badge"
className="absolute -top-1 -right-1 flex items-center justify-center min-w-[18px] h-[18px] px-1 rounded-full bg-rose-600 text-[10px] font-extrabold text-white shadow-lg ring-2 ring-[#0d121f] animate-pulse"
>
{unreadCount > 99 ? '99+' : unreadCount}
</span>
)}
</button>
{/* Floating Hover Popover */}
{isOpen && (
<div
id="notification-bell-dropdown"
className="absolute right-0 top-full mt-2 w-80 sm:w-96 bg-[#0d1322] border border-slate-700/80 rounded-2xl shadow-2xl p-0 z-50 backdrop-blur-xl animate-in fade-in slide-in-from-top-2 overflow-hidden"
>
{/* Popover Header */}
<div className="px-4 py-3 border-b border-slate-800 flex items-center justify-between bg-gradient-to-r from-blue-950/40 via-slate-900/40 to-slate-900/30">
<div className="flex items-center gap-2">
<Mail className="w-4 h-4 text-blue-400" />
<h4 className="text-xs font-bold text-white tracking-tight">In-App Notifications</h4>
{unreadCount > 0 && (
<span className="text-[10px] font-semibold text-rose-300 bg-rose-500/20 border border-rose-500/30 px-1.5 py-0.2 rounded-full">
{unreadCount} unread
</span>
)}
</div>
{unreadCount > 0 && (
<button
type="button"
onClick={markAllAsRead}
className="flex items-center gap-1 text-[11px] text-blue-400 hover:text-blue-300 transition cursor-pointer"
title="Mark all notifications as read"
>
<CheckCheck className="w-3.5 h-3.5" />
<span>Mark read</span>
</button>
)}
</div>
{/* Top 5 Notifications List */}
<div className="max-h-80 overflow-y-auto divide-y divide-slate-800/60">
{top5Unread.length === 0 ? (
<div className="py-8 px-4 text-center">
<div className="w-10 h-10 mx-auto rounded-full bg-emerald-500/10 border border-emerald-500/20 flex items-center justify-center text-emerald-400 mb-2">
<Sparkles className="w-5 h-5" />
</div>
<p className="text-xs font-semibold text-slate-200">All caught up!</p>
<p className="text-[11px] text-slate-400 mt-0.5">
No unread in-app notifications at this time.
</p>
</div>
) : (
top5Unread.map(item => {
const relativeTime = getRelativeTime(item.createdAt);
return (
<div
key={item.id}
onClick={() => handleNotificationClick(item.id)}
className="p-3.5 hover:bg-slate-800/60 transition cursor-pointer group flex items-start gap-3 relative"
>
{/* Unread Accent Indicator */}
<div className="w-2 h-2 rounded-full bg-blue-500 mt-1.5 shrink-0 shadow-sm shadow-blue-500" />
<div className="flex-1 min-w-0">
<div className="flex items-center justify-between gap-1 mb-0.5">
<p className="text-xs font-semibold text-white group-hover:text-blue-400 transition truncate">
{item.subject || 'In-App Notification'}
</p>
{relativeTime && (
<span className="text-[10px] text-slate-400 shrink-0 font-mono flex items-center gap-1">
<Clock className="w-2.5 h-2.5" />
{relativeTime}
</span>
)}
</div>
<p className="text-[11px] text-slate-300 line-clamp-2 leading-relaxed">
{stripMarkdown(item.message || 'No additional message content.')}
</p>
{item.destination && (
<p className="text-[10px] text-slate-400 font-mono mt-1 truncate">
{item.destination}
</p>
)}
</div>
<ChevronRight className="w-4 h-4 text-slate-400 group-hover:text-white group-hover:translate-x-0.5 transition shrink-0 mt-1" />
</div>
);
})
)}
</div>
{/* Popover Footer: Open Inbox */}
<div className="p-2.5 border-t border-slate-800 bg-[#090d16]/90 flex items-center justify-between">
<button
type="button"
onClick={handleViewAll}
id="view-mailbox-btn"
className="w-full flex items-center justify-center gap-1.5 py-1.5 px-3 rounded-xl bg-blue-600/20 hover:bg-blue-600/30 text-blue-300 hover:text-white border border-blue-500/30 text-xs font-semibold transition cursor-pointer shadow-xs"
>
<Inbox className="w-3.5 h-3.5" />
<span>Go to Mailbox ({unreadCount} unread)</span>
<ChevronRight className="w-3 h-3 ml-0.5" />
</button>
</div>
</div>
)}
</div>
);
};
@@ -36,7 +36,7 @@ import {
getAllProgrammes,
getProjects,
} from '../../services/api';
import { toolsService } from '../../utils/hashids';
import { toolsService } from '../../services/toolsService';
import { Modal } from '../ui/Modal';
import { useToast } from '../ui/Toast';
import { ProblemDetailsAlert } from '../ui/ProblemDetailsAlert';
@@ -898,7 +898,7 @@ export const ContractsManagement: React.FC<ContractsManagementProps> = ({
className="space-y-4"
>
{/* ProblemDetails Error Alert */}
{Boolean(createApiError) && (
{createApiError && (
<ProblemDetailsAlert
error={createApiError}
onDismiss={() => setCreateApiError(null)}
@@ -1126,7 +1126,7 @@ export const ContractsManagement: React.FC<ContractsManagementProps> = ({
}}
className="space-y-4"
>
{Boolean(uploadApiError) && (
{uploadApiError && (
<ProblemDetailsAlert
error={uploadApiError}
onDismiss={() => setUploadApiError(null)}
@@ -1228,7 +1228,7 @@ export const ContractsManagement: React.FC<ContractsManagementProps> = ({
}}
className="space-y-4"
>
{Boolean(updateApiError) && (
{updateApiError && (
<ProblemDetailsAlert
error={updateApiError}
onDismiss={() => setUpdateApiError(null)}
@@ -1,711 +0,0 @@
import React, { useState, useEffect, useRef } from 'react';
import {
Send,
Save,
Trash2,
X,
Mail,
AlertCircle,
CheckCircle2,
Bold,
Italic,
Underline,
Heading2,
List,
ListOrdered,
Quote,
Table,
Minus,
Sparkles,
Eye,
Edit3,
Smartphone,
ShieldCheck,
} from 'lucide-react';
import { UserSearchPicker, SelectedUser } from './UserSearchPicker';
import { useInAppNotifications, DraftMessage } from '../../hooks/useInAppNotifications';
import { NotificationPlatform } from '../../types';
import {
renderMarkdownToHtml,
parseMarkdownToHtml,
isHtmlContent,
stripMarkdown,
PFM_LOGO_DATA_URI,
} from '../../lib/markdownUtils';
import { BrandLogo } from '../ui/BrandLogo';
import { useAuth } from '../../auth/AuthProvider';
interface ComposeMessageModalProps {
isOpen: boolean;
onClose: () => void;
initialRecipient?: SelectedUser;
initialSubject?: string;
initialMessage?: string;
initialPlatform?: NotificationPlatform;
draftToEdit?: DraftMessage | null;
}
export const ComposeMessageModal: React.FC<ComposeMessageModalProps> = ({
isOpen,
onClose,
initialRecipient,
initialSubject = '',
initialMessage = '',
initialPlatform = NotificationPlatform.InApp,
draftToEdit,
}) => {
const { user, claims } = useAuth();
const currentUserId = String(user?.id || claims?.sub || '').trim().toLowerCase();
const currentUserEmail = String(user?.email || claims?.email || '').trim().toLowerCase();
const tenantName =
(claims?.tenant as string) ||
user?.tenant ||
'Department of Science, Innovation & Technology';
const { sendMessage, isSending, saveDraft, deleteDraft } = useInAppNotifications();
const [selectedUsers, setSelectedUsers] = useState<SelectedUser[]>([]);
const [subject, setSubject] = useState('');
const [message, setMessage] = useState('');
const [platform, setPlatform] = useState<NotificationPlatform>(initialPlatform);
const [activeTab, setActiveTab] = useState<'write' | 'preview'>('write');
const [error, setError] = useState<string | null>(null);
const [successNotice, setSuccessNotice] = useState<string | null>(null);
const editorRef = useRef<HTMLDivElement>(null);
const isCurrentUser = (candidate?: { id?: string; email?: string }) => {
if (!candidate) return false;
const cid = String(candidate.id || '').trim().toLowerCase();
const cemail = String(candidate.email || '').trim().toLowerCase();
if (currentUserId && cid === currentUserId) return true;
if (currentUserEmail && cemail === currentUserEmail) return true;
return false;
};
const toInitialRichHtml = (raw: string): string => {
if (!raw || !raw.trim()) return '';
if (isHtmlContent(raw)) return raw;
return parseMarkdownToHtml(raw);
};
// Initialize or populate from draft or props
useEffect(() => {
if (!isOpen) return;
let initialHtml = '';
if (draftToEdit) {
const candidate = draftToEdit.recipientId
? {
id: draftToEdit.recipientId,
email: draftToEdit.recipientEmail,
name: draftToEdit.recipientName,
}
: undefined;
setSelectedUsers(candidate && !isCurrentUser(candidate) ? [candidate] : []);
setSubject(draftToEdit.subject || '');
initialHtml = toInitialRichHtml(draftToEdit.message || '');
setMessage(initialHtml);
setPlatform(draftToEdit.platform || NotificationPlatform.InApp);
} else {
setSelectedUsers(
initialRecipient && !isCurrentUser(initialRecipient) ? [initialRecipient] : []
);
setSubject(initialSubject || '');
initialHtml = toInitialRichHtml(initialMessage || '');
setMessage(initialHtml);
setPlatform(initialPlatform);
}
setActiveTab('write');
setError(null);
setSuccessNotice(null);
setTimeout(() => {
if (editorRef.current) {
editorRef.current.innerHTML = initialHtml;
}
}, 0);
}, [isOpen, initialRecipient, initialSubject, initialMessage, initialPlatform, draftToEdit]);
// Restore editor innerHTML when switching back from preview tab
useEffect(() => {
if (activeTab === 'write' && editorRef.current) {
if (editorRef.current.innerHTML !== message) {
editorRef.current.innerHTML = message;
}
}
}, [activeTab]);
if (!isOpen) return null;
const handleSelectUser = (selected: SelectedUser) => {
if (isCurrentUser(selected)) {
setError('You cannot send a message to yourself.');
return;
}
setSelectedUsers([selected]);
setError(null);
};
const handleRemoveUser = () => {
setSelectedUsers([]);
};
const syncEditorContent = () => {
if (editorRef.current) {
setMessage(editorRef.current.innerHTML);
}
};
const applyFormat = (command: string, value?: string) => {
const editor = editorRef.current;
if (!editor) return;
editor.focus();
document.execCommand(command, false, value);
syncEditorContent();
};
const insertHtmlBlock = (htmlSnippet: string) => {
const editor = editorRef.current;
if (!editor) return;
editor.focus();
const inserted = document.execCommand('insertHTML', false, htmlSnippet);
if (!inserted) {
editor.innerHTML += htmlSnippet;
}
syncEditorContent();
};
// Quick insertions for PFM branding and templates
const insertBrandedCallout = () => {
insertHtmlBlock(
`<div style="background:rgba(12,74,110,0.25);border-left:4px solid #38bdf8;padding:10px 14px;border-radius:8px;margin:10px 0;color:#bae6fd;font-size:12px;"><strong>Post-Fund Management Official Notice</strong><br/>Please verify all supporting evidence documentation before tranche disbursement sign-off.</div><p><br/></p>`
);
};
const insertMilestoneTable = () => {
insertHtmlBlock(
`<div style="overflow-x:auto;margin:12px 0;"><table style="width:100%;border-collapse:collapse;border:1px solid #334155;font-size:12px;text-align:left;"><thead><tr style="background:#1e293b;color:#f8fafc;"><th style="padding:8px 12px;border:1px solid #334155;">Deliverable Code</th><th style="padding:8px 12px;border:1px solid #334155;">Milestone Name</th><th style="padding:8px 12px;border:1px solid #334155;">Status</th><th style="padding:8px 12px;border:1px solid #334155;">Due Date</th></tr></thead><tbody><tr style="background:#0f172a;color:#cbd5e1;"><td style="padding:8px 12px;border:1px solid #334155;">DEL-01</td><td style="padding:8px 12px;border:1px solid #334155;">Technical Architecture Review</td><td style="padding:8px 12px;border:1px solid #334155;">Verified</td><td style="padding:8px 12px;border:1px solid #334155;">2026-11-15</td></tr><tr style="background:#0f172a;color:#cbd5e1;"><td style="padding:8px 12px;border:1px solid #334155;">DEL-02</td><td style="padding:8px 12px;border:1px solid #334155;">Financial Expenditure Proof</td><td style="padding:8px 12px;border:1px solid #334155;">Under Review</td><td style="padding:8px 12px;border:1px solid #334155;">2026-12-01</td></tr></tbody></table></div><p><br/></p>`
);
};
const insertPlatformLogo = () => {
insertHtmlBlock(
`<p><img src="${PFM_LOGO_DATA_URI}" alt="PFM Platform Logo" width="48" height="48" style="display:inline-block;border-radius:10px;margin:6px 0;" /></p><p><br/></p>`
);
};
const hasMeaningfulContent = (html: string) => {
if (!html) return false;
if (stripMarkdown(html).trim().length > 0) return true;
return /<(img|table|hr)\b/i.test(html);
};
const handleSaveDraft = () => {
const currentHtml = editorRef.current ? editorRef.current.innerHTML : message;
if (!subject.trim() && !hasMeaningfulContent(currentHtml)) {
setError('Please add a subject or message to save as draft');
return;
}
const firstUser = selectedUsers[0];
saveDraft({
id: draftToEdit?.id,
recipientId: firstUser?.id || '',
recipientEmail: firstUser?.email || '',
recipientName: firstUser?.name || '',
subject: subject.trim() || 'Untitled Draft',
message: currentHtml.trim(),
platform,
});
setSuccessNotice('Draft saved successfully in Drafts folder');
setTimeout(() => {
onClose();
}, 600);
};
const handleSend = async (e: React.FormEvent) => {
e.preventDefault();
const currentHtml = editorRef.current ? editorRef.current.innerHTML : message;
if (selectedUsers.length === 0) {
setError('Please select a recipient from the tenant directory');
return;
}
if (selectedUsers.length > 1) {
setError('Only one recipient is allowed per message');
return;
}
if (isCurrentUser(selectedUsers[0])) {
setError('You cannot send a message to yourself');
return;
}
if (!subject.trim()) {
setError('Please enter a subject');
return;
}
if (!hasMeaningfulContent(currentHtml)) {
setError('Please enter a message body');
return;
}
setError(null);
try {
const recipient = selectedUsers[0];
const finalMessage =
platform === NotificationPlatform.Email
? renderMarkdownToHtml(currentHtml.trim(), {
applyBranding: true,
emailFormat: true,
subject: subject.trim(),
tenantName,
})
: currentHtml.trim();
await sendMessage({
recipientId: recipient.id,
recipientEmail: recipient.email,
recipientName: recipient.name,
subject: subject.trim(),
message: finalMessage,
platform,
draftId: draftToEdit?.id,
});
setSuccessNotice(
platform === NotificationPlatform.Email
? 'Email notification dispatched!'
: 'In-App message sent successfully!'
);
setTimeout(() => {
onClose();
}, 700);
} catch (err: any) {
setError(err?.message || 'Failed to dispatch notification');
}
};
const handleDiscard = () => {
if (draftToEdit?.id) {
deleteDraft(draftToEdit.id);
}
onClose();
};
// Preview content based on chosen platform
const livePreviewHtml =
platform === NotificationPlatform.Email
? renderMarkdownToHtml(message, {
applyBranding: true,
emailFormat: true,
subject: subject || 'Notice Preview',
tenantName,
})
: message;
const plainCharCount = stripMarkdown(message).length;
return (
<div className="fixed inset-0 z-50 flex items-center justify-center p-4 bg-slate-950/85 backdrop-blur-md animate-in fade-in duration-150">
<div className="w-full max-w-3xl bg-[#0d1322] border border-slate-700/80 rounded-3xl shadow-2xl overflow-hidden flex flex-col max-h-[92vh]">
{/* Modal Header */}
<div className="px-6 py-4 border-b border-slate-800 flex items-center justify-between bg-gradient-to-r from-blue-950/50 via-slate-900/60 to-slate-900/40">
<div className="flex items-center gap-3">
<BrandLogo size={28} showGlow animateOnHover={false} />
<div>
<div className="flex items-center gap-2">
<h3 className="text-sm font-bold text-white tracking-tight">
{draftToEdit
? 'Edit Saved Draft'
: initialSubject.startsWith('Re:')
? 'Reply to Message'
: 'Compose New Communication'}
</h3>
<span className="text-[10px] font-semibold text-blue-300 bg-blue-500/15 border border-blue-500/30 px-2 py-0.5 rounded-full">
Rich Text Composer
</span>
</div>
<p className="text-[11px] text-slate-400">
Type and format your message using the toolbar for In-App or branded Email delivery
</p>
</div>
</div>
<button
onClick={onClose}
className="p-1.5 rounded-lg text-slate-400 hover:text-white hover:bg-slate-800 transition cursor-pointer"
>
<X className="w-4 h-4" />
</button>
</div>
{/* Form Body */}
<form onSubmit={handleSend} className="p-6 space-y-4 overflow-y-auto flex-1">
{error && (
<div className="p-3 rounded-xl bg-rose-500/10 border border-rose-500/25 text-rose-300 text-xs flex items-center gap-2">
<AlertCircle className="w-4 h-4 shrink-0 text-rose-400" />
<span>{error}</span>
</div>
)}
{successNotice && (
<div className="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/25 text-emerald-300 text-xs flex items-center gap-2">
<CheckCircle2 className="w-4 h-4 shrink-0 text-emerald-400" />
<span>{successNotice}</span>
</div>
)}
{/* Platform Selector (InApp vs Email) */}
<div className="p-3 rounded-2xl bg-slate-900/60 border border-slate-800 flex flex-col sm:flex-row sm:items-center justify-between gap-3">
<div>
<label className="text-xs font-semibold text-slate-200 block">
Dispatch Platform Mode
</label>
<p className="text-[11px] text-slate-400">
Select target transmission protocol for this notification
</p>
</div>
<div className="flex items-center rounded-xl bg-slate-950 p-1 border border-slate-700/80">
<button
type="button"
onClick={() => setPlatform(NotificationPlatform.InApp)}
className={`flex items-center gap-2 px-3 py-1.5 rounded-lg text-xs font-semibold transition cursor-pointer ${
platform === NotificationPlatform.InApp
? 'bg-blue-600 text-white shadow-md shadow-blue-600/30'
: 'text-slate-400 hover:text-slate-200'
}`}
>
<Smartphone className="w-3.5 h-3.5" />
<span>In-App</span>
</button>
<button
type="button"
onClick={() => setPlatform(NotificationPlatform.Email)}
className={`flex items-center gap-2 px-3 py-1.5 rounded-lg text-xs font-semibold transition cursor-pointer ${
platform === NotificationPlatform.Email
? 'bg-emerald-600 text-white shadow-md shadow-emerald-600/30'
: 'text-slate-400 hover:text-slate-200'
}`}
>
<Mail className="w-3.5 h-3.5" />
<span>Email</span>
</button>
</div>
</div>
{/* Platform Description Indicator */}
<div className="px-1 text-[11px]">
{platform === NotificationPlatform.InApp ? (
<span className="text-blue-300 flex items-center gap-1.5">
<span className="w-2 h-2 rounded-full bg-blue-400 animate-pulse" />
Delivered instantly to the recipient's <strong>In-App</strong> Mailbox & Notification Bell.
</span>
) : (
<span className="text-emerald-300 flex items-center gap-1.5">
<span className="w-2 h-2 rounded-full bg-emerald-400 animate-pulse" />
Formatted with <strong>PFM Executive Branding</strong> and embedded logo before dispatching via email.
</span>
)}
</div>
{/* Recipient Picker */}
<div>
<label className="block text-xs font-semibold text-slate-300 mb-1.5">
To (Recipient) <span className="text-rose-400">*</span>
</label>
<UserSearchPicker
selectedUsers={selectedUsers}
onSelectUser={handleSelectUser}
onRemoveUser={handleRemoveUser}
multiple={false}
placeholder="Search tenant users by name, email, or functional role..."
/>
</div>
{/* Subject Field */}
<div>
<label className="block text-xs font-semibold text-slate-300 mb-1.5">
Subject Line <span className="text-rose-400">*</span>
</label>
<input
type="text"
value={subject}
onChange={e => setSubject(e.target.value)}
placeholder="e.g. Funding Award Contract Review & Milestone Verification Notice"
className="w-full px-3.5 py-2.5 rounded-xl bg-slate-900/90 border border-slate-700/80 hover:border-slate-600 focus:border-blue-500 text-slate-100 placeholder-slate-400 text-xs focus:outline-none transition shadow-inner font-medium"
/>
</div>
{/* Rich Text Editor / Branded Preview Tabs */}
<div className="space-y-2">
<div className="flex items-center justify-between">
<label className="text-xs font-semibold text-slate-300">
Message Content <span className="text-rose-400">*</span>
</label>
{/* Compose vs Email Preview Tabs */}
<div className="flex items-center rounded-lg bg-slate-900 p-0.5 border border-slate-700/80">
<button
type="button"
onClick={() => setActiveTab('write')}
className={`flex items-center gap-1.5 px-3 py-1 rounded-md text-xs font-medium transition cursor-pointer ${
activeTab === 'write'
? 'bg-blue-600 text-white font-semibold shadow-xs'
: 'text-slate-400 hover:text-white'
}`}
>
<Edit3 className="w-3 h-3" />
<span>Compose</span>
</button>
<button
type="button"
onClick={() => {
syncEditorContent();
setActiveTab('preview');
}}
className={`flex items-center gap-1.5 px-3 py-1 rounded-md text-xs font-medium transition cursor-pointer ${
activeTab === 'preview'
? 'bg-blue-600 text-white font-semibold shadow-xs'
: 'text-slate-400 hover:text-white'
}`}
>
<Eye className="w-3 h-3" />
<span>Preview Delivery</span>
</button>
</div>
</div>
{activeTab === 'write' ? (
<div className="rounded-2xl border border-slate-700/80 bg-slate-900/90 overflow-hidden shadow-inner focus-within:border-blue-500 transition">
{/* WYSIWYG Formatting Toolbar */}
<div className="px-3 py-2 border-b border-slate-800 bg-slate-950/70 flex flex-wrap items-center gap-1">
<button
type="button"
onMouseDown={e => e.preventDefault()}
onClick={() => applyFormat('bold')}
className="p-1.5 rounded-lg text-slate-300 hover:text-white hover:bg-slate-800 transition cursor-pointer"
title="Bold"
>
<Bold className="w-3.5 h-3.5" />
</button>
<button
type="button"
onMouseDown={e => e.preventDefault()}
onClick={() => applyFormat('italic')}
className="p-1.5 rounded-lg text-slate-300 hover:text-white hover:bg-slate-800 transition cursor-pointer"
title="Italic"
>
<Italic className="w-3.5 h-3.5" />
</button>
<button
type="button"
onMouseDown={e => e.preventDefault()}
onClick={() => applyFormat('underline')}
className="p-1.5 rounded-lg text-slate-300 hover:text-white hover:bg-slate-800 transition cursor-pointer"
title="Underline"
>
<Underline className="w-3.5 h-3.5" />
</button>
<button
type="button"
onMouseDown={e => e.preventDefault()}
onClick={() => applyFormat('formatBlock', 'H3')}
className="p-1.5 rounded-lg text-slate-300 hover:text-white hover:bg-slate-800 transition cursor-pointer"
title="Heading"
>
<Heading2 className="w-3.5 h-3.5" />
</button>
<span className="w-px h-4 bg-slate-800 mx-1" />
<button
type="button"
onMouseDown={e => e.preventDefault()}
onClick={() => applyFormat('insertUnorderedList')}
className="p-1.5 rounded-lg text-slate-300 hover:text-white hover:bg-slate-800 transition cursor-pointer"
title="Bullet List"
>
<List className="w-3.5 h-3.5" />
</button>
<button
type="button"
onMouseDown={e => e.preventDefault()}
onClick={() => applyFormat('insertOrderedList')}
className="p-1.5 rounded-lg text-slate-300 hover:text-white hover:bg-slate-800 transition cursor-pointer"
title="Numbered List"
>
<ListOrdered className="w-3.5 h-3.5" />
</button>
<button
type="button"
onMouseDown={e => e.preventDefault()}
onClick={() => applyFormat('formatBlock', 'BLOCKQUOTE')}
className="p-1.5 rounded-lg text-slate-300 hover:text-white hover:bg-slate-800 transition cursor-pointer"
title="Quote Block"
>
<Quote className="w-3.5 h-3.5" />
</button>
<span className="w-px h-4 bg-slate-800 mx-1" />
<button
type="button"
onMouseDown={e => e.preventDefault()}
onClick={insertMilestoneTable}
className="p-1.5 rounded-lg text-slate-300 hover:text-white hover:bg-slate-800 transition cursor-pointer"
title="Insert Deliverable Table"
>
<Table className="w-3.5 h-3.5" />
</button>
<button
type="button"
onMouseDown={e => e.preventDefault()}
onClick={() => applyFormat('insertHorizontalRule')}
className="p-1.5 rounded-lg text-slate-300 hover:text-white hover:bg-slate-800 transition cursor-pointer"
title="Insert Divider Line"
>
<Minus className="w-3.5 h-3.5" />
</button>
<span className="w-px h-4 bg-slate-800 mx-1" />
{/* Platform Brand Insertions */}
<button
type="button"
onMouseDown={e => e.preventDefault()}
onClick={insertBrandedCallout}
className="flex items-center gap-1 px-2 py-1 rounded-lg bg-blue-500/10 hover:bg-blue-500/20 text-blue-300 text-[11px] font-medium border border-blue-500/25 transition cursor-pointer"
title="Insert official PFM callout block"
>
<Sparkles className="w-3 h-3 text-blue-400" />
<span>PFM Notice</span>
</button>
<button
type="button"
onMouseDown={e => e.preventDefault()}
onClick={insertPlatformLogo}
className="flex items-center gap-1 px-2 py-1 rounded-lg bg-emerald-500/10 hover:bg-emerald-500/20 text-emerald-300 text-[11px] font-medium border border-emerald-500/25 transition cursor-pointer"
title="Embed official PFM logo"
>
<BrandLogo size={14} showGlow={false} animateOnHover={false} />
<span>Embed Logo</span>
</button>
</div>
{/* Rich Text WYSIWYG Surface */}
<div className="relative">
{!hasMeaningfulContent(message) && (
<div className="pointer-events-none absolute top-4 left-4 right-4 text-slate-500 text-xs select-none">
Type your message here and highlight text or use the toolbar above to format headings, bullet points, tables, and official notices...
</div>
)}
<div
ref={editorRef}
contentEditable
suppressContentEditableWarning
onInput={syncEditorContent}
onBlur={syncEditorContent}
className="w-full min-h-[200px] max-h-[320px] overflow-y-auto p-4 bg-transparent text-slate-100 text-xs focus:outline-none leading-relaxed font-sans [&_h1]:text-lg [&_h1]:font-bold [&_h1]:text-white [&_h1]:my-2 [&_h2]:text-base [&_h2]:font-bold [&_h2]:text-white [&_h2]:my-2 [&_h3]:text-sm [&_h3]:font-bold [&_h3]:text-white [&_h3]:my-1.5 [&_ul]:list-disc [&_ul]:pl-5 [&_ul]:my-1.5 [&_ol]:list-decimal [&_ol]:pl-5 [&_ol]:my-1.5 [&_blockquote]:border-l-4 [&_blockquote]:border-blue-500 [&_blockquote]:pl-3 [&_blockquote]:italic [&_blockquote]:text-slate-300 [&_blockquote]:my-2 [&_hr]:border-slate-700 [&_hr]:my-3"
/>
</div>
</div>
) : (
/* Live Fully-Rendered Delivery Preview */
<div className="rounded-2xl border border-slate-700/80 bg-slate-950/80 p-5 overflow-y-auto max-h-72 min-h-56">
<div className="mb-3 pb-2 border-b border-slate-800 flex items-center justify-between text-[11px] text-slate-400">
<span className="flex items-center gap-1.5 text-blue-300 font-semibold">
<ShieldCheck className="w-3.5 h-3.5 text-blue-400" />
Delivery Preview ({platform === NotificationPlatform.Email ? 'Email' : 'In-App'})
</span>
<span className="text-[10px] text-slate-400 font-mono">
Subject: {subject || 'Untitled'}
</span>
</div>
{hasMeaningfulContent(message) ? (
<div
className="prose prose-invert max-w-none text-xs leading-relaxed [&_h1]:text-white [&_h2]:text-white [&_h3]:text-white [&_ul]:list-disc [&_ul]:pl-5 [&_ol]:list-decimal [&_ol]:pl-5 [&_blockquote]:border-l-4 [&_blockquote]:border-blue-500 [&_blockquote]:pl-3 [&_blockquote]:italic"
dangerouslySetInnerHTML={{ __html: livePreviewHtml }}
/>
) : (
<div className="py-12 text-center text-slate-400 text-xs italic">
Type your message in the Compose tab to preview how it will appear upon delivery.
</div>
)}
</div>
)}
</div>
{/* Footer Metadata */}
<div className="flex items-center justify-between text-[11px] text-slate-400 px-1 pt-1">
<span className="flex items-center gap-1">
<span>Tenant Partition:</span>
<strong className="text-slate-300">{tenantName}</strong>
</span>
<span className="font-mono">{plainCharCount} characters</span>
</div>
{/* Modal Footer Action Buttons */}
<div className="pt-4 border-t border-slate-800 flex items-center justify-between">
<div className="flex items-center gap-2">
<button
type="button"
onClick={handleDiscard}
className="flex items-center gap-1.5 px-3 py-2 rounded-xl text-slate-400 hover:text-rose-400 hover:bg-rose-950/20 text-xs font-medium transition cursor-pointer"
title="Discard draft"
>
<Trash2 className="w-3.5 h-3.5" />
<span>Discard</span>
</button>
<button
type="button"
onClick={handleSaveDraft}
className="flex items-center gap-1.5 px-3.5 py-2 rounded-xl bg-slate-800 hover:bg-slate-700 text-slate-200 text-xs font-medium border border-slate-700 transition cursor-pointer"
title="Save as Draft"
>
<Save className="w-3.5 h-3.5 text-blue-400" />
<span>Save Draft</span>
</button>
</div>
<div className="flex items-center gap-2">
<button
type="button"
onClick={onClose}
className="px-4 py-2 rounded-xl bg-slate-900 hover:bg-slate-800 text-slate-300 text-xs font-medium border border-slate-800 transition cursor-pointer"
>
Cancel
</button>
<button
type="submit"
disabled={isSending}
className="flex items-center gap-2 px-5 py-2 rounded-xl bg-blue-600 hover:bg-blue-500 text-white text-xs font-semibold shadow-lg shadow-blue-600/30 transition disabled:opacity-50 cursor-pointer"
>
{isSending ? (
<div className="w-3.5 h-3.5 border-2 border-white border-t-transparent rounded-full animate-spin" />
) : (
<Send className="w-3.5 h-3.5" />
)}
<span>
{platform === NotificationPlatform.Email
? 'Dispatch Email'
: 'Send In-App Message'}
</span>
</button>
</div>
</div>
</form>
</div>
</div>
);
};
@@ -1,100 +0,0 @@
import React, { useState, useMemo } from 'react';
import {
Copy,
Check,
ShieldCheck,
} from 'lucide-react';
import { BrandLogo } from '../ui/BrandLogo';
import { parseMarkdownToHtml, isHtmlContent, stripMarkdown } from '../../lib/markdownUtils';
interface MarkdownViewerProps {
content: string;
subject?: string;
showBrandingHeader?: boolean;
className?: string;
}
export const MarkdownViewer: React.FC<MarkdownViewerProps> = ({
content,
showBrandingHeader = true,
className = '',
}) => {
const [copied, setCopied] = useState(false);
const isHtml = useMemo(() => isHtmlContent(content), [content]);
const renderedHtml = useMemo(() => {
if (!content) return '<p class="text-slate-400 italic">No content</p>';
if (isHtml) return content;
return parseMarkdownToHtml(content);
}, [content, isHtml]);
const handleCopy = () => {
navigator.clipboard.writeText(stripMarkdown(content) || content);
setCopied(true);
setTimeout(() => setCopied(false), 2000);
};
return (
<div className={`flex flex-col rounded-2xl bg-slate-900/40 border border-slate-800/80 overflow-hidden ${className}`}>
{/* Top Controls Bar */}
<div className="px-4 py-2 border-b border-slate-800 bg-[#0d1322]/80 flex items-center justify-between text-xs text-slate-400">
<div className="flex items-center gap-2">
{showBrandingHeader && (
<div className="flex items-center gap-1.5 text-slate-300 font-semibold pr-2 border-r border-slate-700/60">
<BrandLogo size={18} showGlow={false} animateOnHover={false} />
<span className="text-[11px] tracking-tight">PFM Communications</span>
</div>
)}
<span className="text-[10px] text-blue-400 font-mono">
In-App Message
</span>
</div>
<div className="flex items-center gap-2">
{/* Copy Button */}
<button
type="button"
onClick={handleCopy}
className="flex items-center gap-1 px-2 py-1 rounded-lg bg-slate-800 hover:bg-slate-700 text-slate-300 hover:text-white text-[11px] font-medium transition cursor-pointer border border-slate-700/60"
title="Copy message text to clipboard"
>
{copied ? (
<>
<Check className="w-3 h-3 text-emerald-400" />
<span className="text-emerald-300">Copied</span>
</>
) : (
<>
<Copy className="w-3 h-3" />
<span>Copy</span>
</>
)}
</button>
</div>
</div>
{/* Content Rendering */}
<div className="p-6 overflow-x-auto text-sm leading-relaxed text-slate-200 font-sans">
<div
className="prose prose-invert max-w-none [&_h1]:text-white [&_h1]:text-xl [&_h1]:font-bold [&_h1]:mb-3 [&_h2]:text-white [&_h2]:text-lg [&_h2]:font-bold [&_h2]:mb-2 [&_h3]:text-white [&_h3]:text-base [&_h3]:font-bold [&_h3]:mb-2 [&_h4]:text-white [&_h4]:font-semibold [&_a]:text-blue-400 [&_a:hover]:underline [&_ul]:list-disc [&_ul]:pl-5 [&_ul]:my-2 [&_ol]:list-decimal [&_ol]:pl-5 [&_ol]:my-2 [&_table]:w-full [&_table]:border-collapse [&_th]:border [&_th]:border-slate-700 [&_th]:bg-slate-800/80 [&_th]:p-2 [&_td]:border [&_td]:border-slate-800 [&_td]:p-2 [&_blockquote]:border-l-4 [&_blockquote]:border-blue-500 [&_blockquote]:pl-4 [&_blockquote]:italic [&_blockquote]:my-2 [&_code]:bg-slate-800 [&_code]:px-1.5 [&_code]:py-0.5 [&_code]:rounded [&_code]:text-blue-300"
dangerouslySetInnerHTML={{ __html: renderedHtml }}
/>
</div>
{/* Branded Footer Stamp */}
{showBrandingHeader && (
<div className="px-5 py-2.5 border-t border-slate-800/80 bg-[#0a0f1b] flex items-center justify-between text-[11px] text-slate-400">
<div className="flex items-center gap-1.5">
<ShieldCheck className="w-3.5 h-3.5 text-blue-400" />
<span>Verified PFM Secure Platform Formatting</span>
</div>
<span className="font-mono text-[10px] text-slate-400">
{stripMarkdown(content).length} characters
</span>
</div>
)}
</div>
);
};
@@ -1,380 +0,0 @@
import React, { useState, useMemo } from 'react';
import { useQuery } from '@tanstack/react-query';
import {
Search,
User as UserIcon,
Check,
X,
Shield,
Briefcase,
Coins,
ShieldAlert,
Users,
ChevronDown,
ChevronUp,
} from 'lucide-react';
import { getUsers } from '../../services/api';
import { User, ActivityStatus } from '../../types';
import { useAuth } from '../../auth/AuthProvider';
export interface SelectedUser {
id: string;
email: string;
name?: string;
role?: string;
}
interface UserSearchPickerProps {
selectedUsers: SelectedUser[];
onSelectUser: (user: SelectedUser) => void;
onRemoveUser: (userId: string) => void;
multiple?: boolean;
placeholder?: string;
}
interface UserGroup {
id: string;
label: string;
icon: React.ElementType;
color: string;
users: User[];
}
export const UserSearchPicker: React.FC<UserSearchPickerProps> = ({
selectedUsers,
onSelectUser,
onRemoveUser,
placeholder = 'Search by name, email, or role...',
}) => {
const { user, claims } = useAuth();
const currentUserId = String(user?.id || claims?.sub || '').trim().toLowerCase();
const currentUserEmail = String(user?.email || claims?.email || '').trim().toLowerCase();
const [searchTerm, setSearchTerm] = useState('');
const [isDropdownOpen, setIsDropdownOpen] = useState(false);
const [collapsedGroups, setCollapsedGroups] = useState<Record<string, boolean>>({});
// Query tenant users
const { data: users = [], isLoading } = useQuery<User[]>({
queryKey: ['users-directory'],
queryFn: () => getUsers(1, 200),
staleTime: 5 * 60 * 1000,
});
// Filter active users and exclude the current logged-in user so they can never message themselves
const activeUsers = useMemo(() => {
return users.filter(u => {
if (u.status !== ActivityStatus.Active || !u.email) return false;
const uid = String(u.id || '').trim().toLowerCase();
const uemail = u.email.trim().toLowerCase();
if (currentUserId && uid === currentUserId) return false;
if (currentUserEmail && uemail === currentUserEmail) return false;
return true;
});
}, [users, currentUserId, currentUserEmail]);
// Organize users into intuitive functional groups
const groupedUsers = useMemo(() => {
const term = searchTerm.toLowerCase().trim();
const filtered = activeUsers.filter(u => {
if (!term) return true;
const email = (u.email || '').toLowerCase();
const role = String(u.role ?? '').toLowerCase();
return email.includes(term) || role.includes(term);
});
const adminUsers: User[] = [];
const pmUsers: User[] = [];
const financeUsers: User[] = [];
const meUsers: User[] = [];
const otherUsers: User[] = [];
filtered.forEach(u => {
const r = String(u.role ?? '').toLowerCase();
if (r.includes('admin') || r.includes('executive') || r.includes('director')) {
adminUsers.push(u);
} else if (r.includes('programme') || r.includes('project') || r.includes('manager')) {
pmUsers.push(u);
} else if (r.includes('finance') || r.includes('disbursement') || r.includes('accountant') || r.includes('budget')) {
financeUsers.push(u);
} else if (r.includes('m&e') || r.includes('monitoring') || r.includes('eval') || r.includes('risk') || r.includes('compliance')) {
meUsers.push(u);
} else {
otherUsers.push(u);
}
});
const groups: UserGroup[] = [];
if (adminUsers.length > 0) {
groups.push({
id: 'admin',
label: 'Leadership & Administration',
icon: Shield,
color: 'text-amber-400 bg-amber-500/10 border-amber-500/20',
users: adminUsers,
});
}
if (pmUsers.length > 0) {
groups.push({
id: 'pm',
label: 'Programme & Project Management',
icon: Briefcase,
color: 'text-blue-400 bg-blue-500/10 border-blue-500/20',
users: pmUsers,
});
}
if (financeUsers.length > 0) {
groups.push({
id: 'finance',
label: 'Finance & Disbursements',
icon: Coins,
color: 'text-emerald-400 bg-emerald-500/10 border-emerald-500/20',
users: financeUsers,
});
}
if (meUsers.length > 0) {
groups.push({
id: 'me',
label: 'M&E, Compliance & Risks',
icon: ShieldAlert,
color: 'text-purple-400 bg-purple-500/10 border-purple-500/20',
users: meUsers,
});
}
if (otherUsers.length > 0) {
groups.push({
id: 'team',
label: 'Tenant Staff & Team Members',
icon: Users,
color: 'text-slate-400 bg-slate-500/10 border-slate-500/20',
users: otherUsers,
});
}
return groups;
}, [activeUsers, searchTerm]);
const toggleGroupCollapse = (groupId: string) => {
setCollapsedGroups(prev => ({
...prev,
[groupId]: !prev[groupId],
}));
};
const isUserSelected = (userId: string) => {
return selectedUsers.some(u => u.id === userId);
};
const handleUserClick = (u: User) => {
if (!u.email) return;
if (isUserSelected(u.id)) {
onRemoveUser(u.id);
} else {
const displayName = u.email.split('@')[0].replace(/[._-]/g, ' ');
const formattedName = displayName
.split(' ')
.map(w => w.charAt(0).toUpperCase() + w.slice(1))
.join(' ');
// Strictly single-recipient selection
onSelectUser({
id: u.id,
email: u.email,
name: formattedName,
role: String(u.role ?? 'User'),
});
setSearchTerm('');
setIsDropdownOpen(false);
}
};
const singleSelectedUser = selectedUsers[0];
return (
<div className="relative w-full">
{/* Single Selected Recipient or Search Input Box */}
{singleSelectedUser ? (
<div className="flex items-center justify-between px-3 py-2 rounded-xl bg-blue-500/10 border border-blue-500/30 text-blue-100 text-xs shadow-xs">
<div className="flex items-center gap-2.5 min-w-0">
<div className="w-6 h-6 rounded-full bg-blue-600/40 text-[10px] font-bold flex items-center justify-center text-blue-200 shrink-0 border border-blue-400/30">
{(singleSelectedUser.name || singleSelectedUser.email).slice(0, 2).toUpperCase()}
</div>
<div className="flex items-center gap-2 min-w-0">
<span className="font-semibold text-white truncate">
{singleSelectedUser.name || singleSelectedUser.email}
</span>
<span className="text-[11px] text-slate-400 font-mono truncate">
&lt;{singleSelectedUser.email}&gt;
</span>
{singleSelectedUser.role && (
<span className="text-[10px] text-blue-300 bg-blue-900/40 px-1.5 py-0.5 rounded border border-blue-800/40 shrink-0">
{singleSelectedUser.role}
</span>
)}
</div>
</div>
<button
type="button"
onClick={() => onRemoveUser(singleSelectedUser.id)}
className="flex items-center gap-1 text-[11px] text-blue-300 hover:text-white hover:bg-blue-600/30 px-2 py-1 rounded-lg transition cursor-pointer shrink-0"
title="Remove recipient to select another user"
>
<X className="w-3.5 h-3.5" />
<span>Change</span>
</button>
</div>
) : (
<div className="relative">
<div className="absolute inset-y-0 left-0 pl-3 flex items-center pointer-events-none text-slate-400">
<Search className="w-4 h-4" />
</div>
<input
type="text"
value={searchTerm}
onChange={e => {
setSearchTerm(e.target.value);
if (!isDropdownOpen) setIsDropdownOpen(true);
}}
onFocus={() => setIsDropdownOpen(true)}
placeholder={placeholder}
className="w-full pl-9 pr-8 py-2 rounded-xl bg-slate-900/90 border border-slate-700/80 hover:border-slate-600 focus:border-blue-500 text-slate-100 placeholder-slate-400 text-xs focus:outline-none transition shadow-inner"
/>
{searchTerm && (
<button
type="button"
onClick={() => setSearchTerm('')}
className="absolute inset-y-0 right-0 pr-3 flex items-center text-slate-400 hover:text-white"
>
<X className="w-3.5 h-3.5" />
</button>
)}
</div>
)}
{/* Organized User Directory Dropdown (only when no recipient is locked in) */}
{isDropdownOpen && !singleSelectedUser && (
<div className="absolute left-0 right-0 top-full mt-1.5 max-h-72 overflow-y-auto bg-[#0d1322] border border-slate-700/80 rounded-2xl shadow-2xl z-50 p-2 space-y-3 backdrop-blur-md animate-in fade-in slide-in-from-top-1">
{isLoading ? (
<div className="py-6 text-center text-xs text-slate-400 flex items-center justify-center gap-2">
<div className="w-4 h-4 border-2 border-blue-500 border-t-transparent rounded-full animate-spin" />
<span>Loading tenant users directory...</span>
</div>
) : groupedUsers.length === 0 ? (
<div className="py-6 text-center text-xs text-slate-400">
No matching users found for "{searchTerm}".
</div>
) : (
groupedUsers.map(group => {
const GroupIcon = group.icon;
const isCollapsed = collapsedGroups[group.id];
return (
<div key={group.id} className="space-y-1">
{/* Category Header */}
<button
type="button"
onClick={() => toggleGroupCollapse(group.id)}
className="w-full flex items-center justify-between px-2.5 py-1.5 rounded-lg bg-slate-900/60 hover:bg-slate-800/60 text-slate-300 text-[11px] font-semibold transition cursor-pointer border border-slate-800/60"
>
<div className="flex items-center gap-2">
<span className={`p-1 rounded-md border ${group.color}`}>
<GroupIcon className="w-3 h-3" />
</span>
<span>{group.label}</span>
<span className="text-[10px] text-slate-400 bg-slate-800 px-1.5 py-0.2 rounded-full border border-slate-700 font-mono">
{group.users.length}
</span>
</div>
{isCollapsed ? (
<ChevronDown className="w-3.5 h-3.5 text-slate-400" />
) : (
<ChevronUp className="w-3.5 h-3.5 text-slate-400" />
)}
</button>
{/* Users inside group */}
{!isCollapsed && (
<div className="grid grid-cols-1 gap-1 pl-1 pr-1 pt-0.5">
{group.users.map(u => {
const selected = isUserSelected(u.id);
const displayName = (u.email || '').split('@')[0].replace(/[._-]/g, ' ');
const formattedName = displayName
.split(' ')
.map(w => w.charAt(0).toUpperCase() + w.slice(1))
.join(' ');
return (
<div
key={u.id}
onClick={() => handleUserClick(u)}
className={`flex items-center justify-between px-3 py-2 rounded-xl text-xs transition cursor-pointer border ${
selected
? 'bg-blue-600/20 border-blue-500/40 text-white'
: 'bg-slate-900/40 hover:bg-slate-800/70 border-slate-800/40 text-slate-200'
}`}
>
<div className="flex items-center gap-2.5 min-w-0">
<div
className={`w-7 h-7 shrink-0 rounded-full flex items-center justify-center font-bold text-[10px] border ${
selected
? 'bg-blue-600 border-blue-400 text-white'
: 'bg-slate-800 border-slate-700 text-slate-300'
}`}
>
{formattedName.slice(0, 2).toUpperCase()}
</div>
<div className="min-w-0">
<p className="font-medium text-xs truncate text-white">{formattedName}</p>
<p className="text-[10px] text-slate-400 font-mono truncate">{u.email}</p>
</div>
</div>
<div className="flex items-center gap-2 shrink-0">
{u.role && (
<span className="text-[10px] font-semibold text-blue-400 bg-blue-500/10 border border-blue-500/20 px-1.5 py-0.5 rounded truncate max-w-[120px]">
{u.role}
</span>
)}
<div
className={`w-4 h-4 rounded-md border flex items-center justify-center ${
selected
? 'bg-blue-600 border-blue-500 text-white'
: 'border-slate-700 bg-slate-950/60'
}`}
>
{selected && <Check className="w-3 h-3 stroke-[3]" />}
</div>
</div>
</div>
);
})}
</div>
)}
</div>
);
})
)}
{/* Close button at bottom */}
<div className="pt-2 border-t border-slate-800 flex justify-end">
<button
type="button"
onClick={() => setIsDropdownOpen(false)}
className="text-[11px] text-slate-400 hover:text-white px-3 py-1 rounded-lg hover:bg-slate-800 transition cursor-pointer"
>
Done Selecting
</button>
</div>
</div>
)}
</div>
);
};
@@ -1,496 +0,0 @@
import React from 'react';
import { useQuery } from '@tanstack/react-query';
import {
ShieldCheck,
ShieldAlert,
AlertTriangle,
Users,
Target,
Coins,
CheckCircle2,
} from 'lucide-react';
import { Modal } from '../ui/Modal';
import { ComplianceStatusBadge } from '../ui/StatusBadge';
import {
Project,
Programme,
Outcome,
ComplianceStatus,
ApprovalStatus,
} from '../../types';
import {
getProjectComplianceItems,
getProjectBeneficiaries,
getBeneficiaryOutcomes,
getProjectRisks,
getMilestones,
getActivities,
getBudgets,
} from '../../services/api';
import {
formatDate,
formatZAR,
getRiskScoreColor,
} from '../../lib/formatters';
interface ProjectComplianceModalProps {
isOpen: boolean;
onClose: () => void;
project: Project | null;
programme: Programme | null;
}
export const ProjectComplianceModal: React.FC<ProjectComplianceModalProps> = ({
isOpen,
onClose,
project,
programme,
}) => {
const projectId = project?.id;
// Queries
const { data: complianceItems = [], isLoading: loadingCompliance } = useQuery({
queryKey: ['complianceItems', projectId],
queryFn: () => (projectId ? getProjectComplianceItems(projectId) : Promise.resolve([])),
enabled: isOpen && !!projectId,
});
const { data: projectBeneficiaries = [], isLoading: loadingBeneficiaries } = useQuery({
queryKey: ['projectBeneficiaries', projectId],
queryFn: () => (projectId ? getProjectBeneficiaries(projectId) : Promise.resolve([])),
enabled: isOpen && !!projectId,
});
const { data: risks = [], isLoading: loadingRisks } = useQuery({
queryKey: ['risks', projectId],
queryFn: () => (projectId ? getProjectRisks(projectId) : Promise.resolve([])),
enabled: isOpen && !!projectId,
});
const { data: milestones = [] } = useQuery({
queryKey: ['milestones', projectId],
queryFn: () => (projectId ? getMilestones(projectId) : Promise.resolve([])),
enabled: isOpen && !!projectId,
});
const { data: activities = [] } = useQuery({
queryKey: ['activities', projectId],
queryFn: () => (projectId ? getActivities(projectId) : Promise.resolve([])),
enabled: isOpen && !!projectId,
});
const { data: allBudgets = [] } = useQuery({
queryKey: ['budgets'],
queryFn: () => getBudgets(1, 100),
enabled: isOpen && !!projectId,
});
// Beneficiary outcomes query
const { data: outcomes = [], isLoading: loadingOutcomes } = useQuery({
queryKey: ['beneficiaryOutcomes', projectBeneficiaries.map((b) => b.id)],
queryFn: async (): Promise<Outcome[]> => {
if (projectBeneficiaries.length === 0) return [];
const results = await Promise.all(
projectBeneficiaries.map(async (b) => {
try {
return await getBeneficiaryOutcomes(b.id);
} catch {
return [];
}
})
);
return results.flat();
},
enabled: isOpen && projectBeneficiaries.length > 0,
});
if (!project) return null;
// Compliance calculations
const totalCompCount = complianceItems.length;
const metCompCount = complianceItems.filter(
(c) => Number(c.status) === ComplianceStatus.Met || Number(c.status) === ComplianceStatus.Exceeded
).length;
const unmetCompCount = totalCompCount - metCompCount;
// Outcomes calculations
const totalOutcomesCount = outcomes.length;
const metOutcomesCount = outcomes.filter(
(o) => Number(o.status) === ComplianceStatus.Met || Number(o.status) === ComplianceStatus.Exceeded
).length;
const unmetOutcomesCount = totalOutcomesCount - metOutcomesCount;
// Overall compliance verdict (Invariant: 100% met required for approval)
const is100PercentCompliant =
unmetCompCount === 0 && unmetOutcomesCount === 0;
// Financial calculations
const projectBudgets = allBudgets.filter((b) => String(b.projectId) === String(projectId));
const approvedBudgetTotal = projectBudgets
.filter((b) => Number(b.status) === ApprovalStatus.Approved || b.status === undefined)
.reduce((sum, b) => sum + (Number(b.amount) || 0), 0);
const totalActivityBudget = activities.reduce((sum, a) => sum + (Number(a.amount) || 0), 0);
const financialVariance = approvedBudgetTotal - totalActivityBudget;
const isWithinBudget = financialVariance >= 0;
// Milestone Progress
const verifiedMilestonesCount = milestones.filter((m) => m.status === ApprovalStatus.Approved).length;
const milestoneProgress = milestones.length > 0 ? Math.round((verifiedMilestonesCount / milestones.length) * 100) : 0;
return (
<Modal
isOpen={isOpen}
onClose={onClose}
title={`Risk & Compliance Status: ${project.name}`}
subtitle={`Project #${project.id} • ${programme?.name || 'Programme'} • Statutory Governance Audit`}
helpText="Comprehensive audit of project compliance items, beneficiary outcomes fulfillment, ISO 31000 risk register, and statutory approval eligibility."
maxWidth="5xl"
>
<div className="space-y-6 text-slate-200">
{/* Top Verdict Banner */}
<div
className={`p-4 sm:p-5 rounded-2xl border flex flex-col sm:flex-row sm:items-center justify-between gap-4 ${
is100PercentCompliant
? 'bg-emerald-950/30 border-emerald-500/40'
: 'bg-rose-950/30 border-rose-500/40'
}`}
>
<div className="flex items-start gap-3">
<div
className={`p-2.5 rounded-xl border mt-0.5 ${
is100PercentCompliant
? 'bg-emerald-500/20 text-emerald-400 border-emerald-500/30'
: 'bg-rose-500/20 text-rose-400 border-rose-500/30'
}`}
>
{is100PercentCompliant ? (
<ShieldCheck className="w-6 h-6" />
) : (
<ShieldAlert className="w-6 h-6" />
)}
</div>
<div>
<div className="flex items-center gap-2">
<h4 className="text-sm font-bold text-white">
{is100PercentCompliant
? '100% Fully Compliant — Approved for Project Governance'
: 'Action Required: Project is Noncompliant'}
</h4>
<span
className={`text-[10px] uppercase font-bold px-2 py-0.5 rounded-full border ${
is100PercentCompliant
? 'bg-emerald-500/20 text-emerald-300 border-emerald-500/40'
: 'bg-rose-500/20 text-rose-300 border-rose-500/40 animate-pulse'
}`}
>
{is100PercentCompliant ? 'Eligible for Approval' : 'Approvals Blocked'}
</span>
</div>
<p className="text-xs text-slate-300 mt-1">
{is100PercentCompliant
? 'All statutory compliance requirements and beneficiary impact outcomes have met or exceeded threshold requirements.'
: `This project has ${unmetCompCount} unmet compliance item(s) and ${unmetOutcomesCount} unmet beneficiary outcome(s). Per governance policy, projects cannot be approved until all compliance items and outcomes are 100% met.`}
</p>
</div>
</div>
<div className="shrink-0 flex items-center gap-3">
<div className="text-right">
<span className="text-[10px] text-slate-400 block uppercase font-semibold">Budget At Risk</span>
<span className={`text-base font-bold font-mono ${is100PercentCompliant ? 'text-emerald-400' : 'text-rose-400'}`}>
{is100PercentCompliant ? 'R 0.00' : formatZAR(approvedBudgetTotal)}
</span>
</div>
</div>
</div>
{/* 4 Summary Metric Cards */}
<div className="grid grid-cols-2 lg:grid-cols-4 gap-3.5">
<div className="bg-[#0b101c] p-3.5 rounded-xl border border-slate-800">
<span className="text-[10px] uppercase font-bold text-slate-400 flex items-center gap-1.5">
<ShieldCheck className="w-3.5 h-3.5 text-cyan-400" />
Compliance Requirements
</span>
<div className="flex items-baseline gap-2 mt-1">
<span className="text-xl font-bold font-mono text-cyan-400">
{metCompCount}/{totalCompCount}
</span>
<span className="text-xs text-slate-400 font-semibold">
({totalCompCount > 0 ? Math.round((metCompCount / totalCompCount) * 100) : 100}%)
</span>
</div>
<span className="text-[10px] text-slate-500">
{unmetCompCount === 0 ? 'All items satisfied' : `${unmetCompCount} pending fulfillment`}
</span>
</div>
<div className="bg-[#0b101c] p-3.5 rounded-xl border border-slate-800">
<span className="text-[10px] uppercase font-bold text-slate-400 flex items-center gap-1.5">
<Target className="w-3.5 h-3.5 text-purple-400" />
Beneficiary Outcomes
</span>
<div className="flex items-baseline gap-2 mt-1">
<span className="text-xl font-bold font-mono text-purple-400">
{metOutcomesCount}/{totalOutcomesCount}
</span>
<span className="text-xs text-slate-400 font-semibold">
({totalOutcomesCount > 0 ? Math.round((metOutcomesCount / totalOutcomesCount) * 100) : 100}%)
</span>
</div>
<span className="text-[10px] text-slate-500">
Across {projectBeneficiaries.length} beneficiary group{projectBeneficiaries.length === 1 ? '' : 's'}
</span>
</div>
<div className="bg-[#0b101c] p-3.5 rounded-xl border border-slate-800">
<span className="text-[10px] uppercase font-bold text-slate-400 flex items-center gap-1.5">
<Coins className="w-3.5 h-3.5 text-emerald-400" />
Financial Variance
</span>
<div className="flex items-baseline gap-2 mt-1">
<span
className={`text-xl font-bold font-mono ${
isWithinBudget ? 'text-emerald-400' : 'text-rose-400'
}`}
>
{isWithinBudget ? `+${formatZAR(financialVariance)}` : `-${formatZAR(Math.abs(financialVariance))}`}
</span>
</div>
<span className="text-[10px] text-slate-500">
Budget: {formatZAR(approvedBudgetTotal)}
</span>
</div>
<div className="bg-[#0b101c] p-3.5 rounded-xl border border-slate-800">
<span className="text-[10px] uppercase font-bold text-slate-400 flex items-center gap-1.5">
<AlertTriangle className="w-3.5 h-3.5 text-amber-400" />
Active Project Risks
</span>
<div className="flex items-baseline gap-2 mt-1">
<span className="text-xl font-bold font-mono text-amber-400">{risks.length}</span>
<span className="text-xs text-slate-400">
({risks.filter((r) => (Number(r.likelihood) || 1) * (Number(r.impact) || 1) >= 12).length} High)
</span>
</div>
<span className="text-[10px] text-slate-500 flex items-center gap-1">
<CheckCircle2 className="w-3 h-3 text-cyan-400 inline" /> Milestones: {milestoneProgress}%
</span>
</div>
</div>
{/* Section 1: Statutory Compliance Requirements */}
<div className="bg-[#0b101c] rounded-2xl border border-slate-800 overflow-hidden shadow-sm">
<div className="p-4 border-b border-slate-800 flex items-center justify-between bg-[#0d1322]">
<div className="flex items-center gap-2">
<ShieldCheck className="w-4 h-4 text-cyan-400" />
<h4 className="text-xs font-bold uppercase tracking-wider text-white">
Statutory Compliance Requirements ({complianceItems.length})
</h4>
</div>
<span className="text-[11px] text-slate-400">
{metCompCount} of {complianceItems.length} Met / Exceeded
</span>
</div>
{loadingCompliance ? (
<div className="p-8 text-center text-xs text-slate-400">Loading compliance register...</div>
) : complianceItems.length === 0 ? (
<div className="p-6 text-center text-xs text-slate-500">
No specific statutory compliance requirements captured for this project yet.
</div>
) : (
<div className="overflow-x-auto">
<table className="w-full text-left text-xs border-collapse">
<thead>
<tr className="bg-slate-900/60 border-b border-slate-800 text-slate-400 text-[11px] font-semibold">
<th className="py-2.5 px-4">Title</th>
<th className="py-2.5 px-4">Requirements Specification</th>
<th className="py-2.5 px-4">Linked Beneficiary</th>
<th className="py-2.5 px-4">Status</th>
<th className="py-2.5 px-4 text-right">Created</th>
</tr>
</thead>
<tbody className="divide-y divide-slate-800/60">
{complianceItems.map((ci) => {
const linkedBen = projectBeneficiaries.find(
(b) => String(b.id) === String(ci.beneficiaryId)
);
return (
<tr key={ci.id} className="hover:bg-slate-900/30 transition">
<td className="py-2.5 px-4 font-semibold text-white">{ci.title || 'Untitled Item'}</td>
<td className="py-2.5 px-4 text-slate-300 max-w-sm truncate" title={ci.requirements || ''}>
{ci.requirements || 'N/A'}
</td>
<td className="py-2.5 px-4 text-slate-300">
{linkedBen ? (
<span className="px-2 py-0.5 rounded bg-blue-500/10 border border-blue-500/20 text-blue-300 text-[11px]">
{linkedBen.name || 'Beneficiary'}
</span>
) : (
<span className="text-slate-500 italic">Project-Wide</span>
)}
</td>
<td className="py-2.5 px-4">
<ComplianceStatusBadge status={ci.status} />
</td>
<td className="py-2.5 px-4 text-right text-slate-400 font-mono text-[11px]">
{formatDate(ci.createdAt)}
</td>
</tr>
);
})}
</tbody>
</table>
</div>
)}
</div>
{/* Section 2: Affected Beneficiaries & Mapped Outcomes */}
<div className="bg-[#0b101c] rounded-2xl border border-slate-800 overflow-hidden shadow-sm">
<div className="p-4 border-b border-slate-800 flex items-center justify-between bg-[#0d1322]">
<div className="flex items-center gap-2">
<Users className="w-4 h-4 text-blue-400" />
<h4 className="text-xs font-bold uppercase tracking-wider text-white">
Affected Beneficiaries & Mapped Impact Outcomes ({projectBeneficiaries.length})
</h4>
</div>
<span className="text-[11px] text-slate-400">
Total Target: {projectBeneficiaries.reduce((sum, b) => sum + (Number(b.targetCount) || 0), 0)} Reached:{' '}
{projectBeneficiaries.reduce((sum, b) => sum + (Number(b.reachedCount) || 0), 0)}
</span>
</div>
{loadingBeneficiaries || loadingOutcomes ? (
<div className="p-8 text-center text-xs text-slate-400">Loading beneficiaries & outcomes...</div>
) : projectBeneficiaries.length === 0 ? (
<div className="p-6 text-center text-xs text-slate-500">
No target beneficiaries mapped to this project yet.
</div>
) : (
<div className="p-4 space-y-4">
{projectBeneficiaries.map((b) => {
const benOutcomes = outcomes.filter((o) => String(o.beneficiaryId) === String(b.id));
return (
<div
key={b.id}
className="p-3.5 rounded-xl bg-slate-900/60 border border-slate-800 space-y-3"
>
<div className="flex items-center justify-between flex-wrap gap-2">
<div>
<span className="font-bold text-white text-xs mr-2">{b.name || 'Beneficiary Group'}</span>
<span className="text-[11px] text-slate-400 bg-slate-800 px-2 py-0.5 rounded border border-slate-700/60">
{b.category || 'General'}{b.location ? ` • ${b.location}` : ''}
</span>
</div>
<div className="flex items-center gap-3 text-xs font-mono">
<span className="text-slate-400">
Target: <strong className="text-white">{b.targetCount ?? 0}</strong>
</span>
<span className="text-slate-600">&bull;</span>
<span className="text-slate-400">
Reached: <strong className="text-emerald-400">{b.reachedCount ?? 0}</strong>
</span>
</div>
</div>
{/* Mapped Outcomes */}
<div className="pt-2 border-t border-slate-800/80">
<span className="text-[10px] uppercase font-bold text-slate-400 block mb-1.5">
Mapped Expected Outcomes ({benOutcomes.length})
</span>
{benOutcomes.length === 0 ? (
<p className="text-[11px] text-slate-500 italic">No expected outcomes recorded for this group.</p>
) : (
<div className="grid grid-cols-1 sm:grid-cols-2 gap-2">
{benOutcomes.map((o) => (
<div
key={o.id}
className="p-2.5 rounded-lg bg-slate-950/60 border border-slate-800/80 flex items-start justify-between gap-2"
>
<div className="min-w-0">
<span className="font-semibold text-slate-200 text-xs block truncate">{o.name || 'Outcome'}</span>
<span className="text-[10px] text-slate-400 line-clamp-1">{o.description || 'No description'}</span>
</div>
<ComplianceStatusBadge status={o.status} />
</div>
))}
</div>
)}
</div>
</div>
);
})}
</div>
)}
</div>
{/* Section 3: Risk Profile (ISO 31000) */}
<div className="bg-[#0b101c] rounded-2xl border border-slate-800 overflow-hidden shadow-sm">
<div className="p-4 border-b border-slate-800 flex items-center justify-between bg-[#0d1322]">
<div className="flex items-center gap-2">
<AlertTriangle className="w-4 h-4 text-amber-400" />
<h4 className="text-xs font-bold uppercase tracking-wider text-white">
Active Project Risks Register ({risks.length})
</h4>
</div>
<span className="text-[11px] text-slate-400">ISO 31000 Risk Management</span>
</div>
{loadingRisks ? (
<div className="p-8 text-center text-xs text-slate-400">Loading risk register...</div>
) : risks.length === 0 ? (
<div className="p-6 text-center text-xs text-slate-500">
No active risks logged on this project register.
</div>
) : (
<div className="overflow-x-auto">
<table className="w-full text-left text-xs border-collapse">
<thead>
<tr className="bg-slate-900/60 border-b border-slate-800 text-slate-400 text-[11px] font-semibold">
<th className="py-2.5 px-4">Risk Name</th>
<th className="py-2.5 px-4">Category / Status</th>
<th className="py-2.5 px-4 text-center">Score</th>
<th className="py-2.5 px-4">Mitigation Strategy</th>
</tr>
</thead>
<tbody className="divide-y divide-slate-800/60">
{risks.map((r) => {
const score = (Number(r.likelihood) || 1) * (Number(r.impact) || 1);
const scoreColor = getRiskScoreColor(r.likelihood, r.impact);
return (
<tr key={r.id} className="hover:bg-slate-900/30 transition">
<td className="py-2.5 px-4 font-semibold text-white">{r.name || r.title || 'Unnamed Risk'}</td>
<td className="py-2.5 px-4 text-slate-300">{r.category || r.status || 'Operational'}</td>
<td className="py-2.5 px-4 text-center">
<span
className={`px-2 py-0.5 rounded text-[10px] font-bold ${scoreColor.badge}`}
>
{scoreColor.level} ({score})
</span>
</td>
<td className="py-2.5 px-4 text-slate-300 max-w-sm truncate" title={r.mitigationAction || r.mitigation || r.description || ''}>
{r.mitigationAction || r.mitigation || r.description || 'No mitigation recorded'}
</td>
</tr>
);
})}
</tbody>
</table>
</div>
)}
</div>
{/* Footer Actions */}
<div className="flex justify-end pt-3 border-t border-slate-800">
<button
type="button"
onClick={onClose}
className="px-4 py-2 rounded-xl text-xs font-semibold text-slate-300 hover:text-white bg-slate-800 hover:bg-slate-700 transition"
>
Close Audit Inspector
</button>
</div>
</div>
</Modal>
);
};
@@ -214,78 +214,53 @@ export const ProjectMilestonesModal: React.FC<ProjectMilestonesModalProps> = ({
title={`Milestones & Deliverables: ${project.name}`}
subtitle={`Project #${project.id} • Statutory Work Breakdown Schedule`}
helpText="Contractual milestones represent formal deliverables. The monetary value of each milestone is dynamically aggregated from its scheduled activities vs indicator actuals. The project's total value is the sum of all milestones."
maxWidth="4xl"
maxWidth="xl"
>
<div className="space-y-5">
{/* KPI Cards: Project Value Roll-Up & Performance */}
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-3.5">
<div className="bg-[#0b101c] p-4 rounded-xl border border-slate-800 hover:border-slate-700 transition flex flex-col justify-between min-w-0 shadow-sm">
<div className="flex items-center justify-between gap-1 mb-1">
<span className="text-[10px] uppercase font-bold text-slate-400 flex items-center gap-1.5 truncate">
<Coins className="w-3.5 h-3.5 text-blue-400 shrink-0" />
<div className="grid grid-cols-1 sm:grid-cols-4 gap-3">
<div className="bg-[#0b101c] p-3.5 rounded-xl border border-slate-800">
<span className="text-[10px] uppercase font-bold text-slate-400 flex items-center gap-1.5">
<Coins className="w-3.5 h-3.5 text-blue-400" />
Total Project Value
</span>
<div className="flex items-baseline gap-2 mt-1">
<span className="text-xl font-bold font-mono text-blue-400">{formatZAR(totalProjectMilestonesValue)}</span>
</div>
<div className="my-1.5">
<div
className="text-lg sm:text-xl font-bold font-mono text-blue-400 truncate tracking-tight"
title={formatZAR(totalProjectMilestonesValue)}
>
{formatZAR(totalProjectMilestonesValue)}
</div>
</div>
<span className="text-[10px] text-slate-500 truncate">Sum of all milestones</span>
<span className="text-[10px] text-slate-500">Sum of all milestones</span>
</div>
<div className="bg-[#0b101c] p-4 rounded-xl border border-slate-800 hover:border-slate-700 transition flex flex-col justify-between min-w-0 shadow-sm">
<div className="flex items-center justify-between gap-1 mb-1">
<span className="text-[10px] uppercase font-bold text-slate-400 flex items-center gap-1.5 truncate">
<Coins className="w-3.5 h-3.5 text-emerald-400 shrink-0" />
<div className="bg-[#0b101c] p-3.5 rounded-xl border border-slate-800">
<span className="text-[10px] uppercase font-bold text-slate-400 flex items-center gap-1.5">
<Coins className="w-3.5 h-3.5 text-emerald-400" />
Approved Budget
</span>
<div className="flex items-baseline gap-2 mt-1">
<span className="text-xl font-bold font-mono text-emerald-400">{formatZAR(approvedBudgetTotal)}</span>
</div>
<div className="my-1.5">
<div
className="text-lg sm:text-xl font-bold font-mono text-emerald-400 truncate tracking-tight"
title={formatZAR(approvedBudgetTotal)}
>
{formatZAR(approvedBudgetTotal)}
</div>
</div>
<span className="text-[10px] text-slate-500 truncate">Allocated budget ceiling</span>
<span className="text-[10px] text-slate-500">Allocated budget ceiling</span>
</div>
<div className="bg-[#0b101c] p-4 rounded-xl border border-slate-800 hover:border-slate-700 transition flex flex-col justify-between min-w-0 shadow-sm">
<div className="flex items-center justify-between gap-1 mb-1">
<span className="text-[10px] uppercase font-bold text-slate-400 flex items-center gap-1.5 truncate">
<TrendingUp className="w-3.5 h-3.5 text-cyan-400 shrink-0" />
<div className="bg-[#0b101c] p-3.5 rounded-xl border border-slate-800">
<span className="text-[10px] uppercase font-bold text-slate-400 flex items-center gap-1.5">
<TrendingUp className="w-3.5 h-3.5 text-cyan-400" />
Partner Actuals
</span>
<div className="flex items-baseline gap-2 mt-1">
<span className="text-xl font-bold font-mono text-cyan-400">{formatZAR(totalProjectActuals)}</span>
</div>
<div className="my-1.5">
<div
className="text-lg sm:text-xl font-bold font-mono text-cyan-400 truncate tracking-tight"
title={formatZAR(totalProjectActuals)}
>
{formatZAR(totalProjectActuals)}
</div>
</div>
<span className="text-[10px] text-slate-500 truncate">Incurred material costs</span>
<span className="text-[10px] text-slate-500">Incurred material costs</span>
</div>
<div className="bg-[#0b101c] p-4 rounded-xl border border-slate-800 hover:border-slate-700 transition flex flex-col justify-between min-w-0 shadow-sm">
<div className="flex items-center justify-between gap-1 mb-1">
<span className="text-[10px] uppercase font-bold text-slate-400 flex items-center gap-1.5 truncate">
<CheckCircle2 className="w-3.5 h-3.5 text-indigo-400 shrink-0" />
<div className="bg-[#0b101c] p-3.5 rounded-xl border border-slate-800">
<span className="text-[10px] uppercase font-bold text-slate-400 flex items-center gap-1.5">
<CheckCircle2 className="w-3.5 h-3.5 text-indigo-400" />
Milestone Progress
</span>
<div className="flex items-baseline gap-2 mt-1">
<span className="text-xl font-bold text-white font-mono">{progressPct}%</span>
</div>
<div className="my-1.5">
<div className="text-lg sm:text-xl font-bold text-white font-mono truncate tracking-tight">
{progressPct}%
</div>
</div>
<span className="text-[10px] text-slate-500 truncate">
<span className="text-[10px] text-slate-500">
{verifiedCount} of {milestones.length} verified
</span>
</div>
@@ -239,26 +239,14 @@ export const ProjectViewModal: React.FC<ProjectViewModalProps> = ({
{formatDate(project.startedAt)} &rarr; {formatDate(project.endedAt)} ({durationDays} Days)
</span>
</div>
{approvedBudgetTotal > 0 && (
<>
<span className="text-slate-600">&bull;</span>
<span className="text-emerald-400 font-mono font-bold">
Budget: {formatZAR(approvedBudgetTotal)}
</span>
<span className="text-slate-600">&bull;</span>
<span className="text-blue-400 font-mono font-bold">
Project Value: {formatZAR(totalActivityBudget)}
</span>
<span className="text-slate-600">&bull;</span>
<span
className={`font-mono font-bold px-2 py-0.5 rounded text-[11px] border ${
approvedBudgetTotal - totalActivityBudget >= 0
? 'text-emerald-400 bg-emerald-500/10 border-emerald-500/30'
: 'text-rose-400 bg-rose-500/10 border-rose-500/30'
}`}
title="Approved Budget minus Total Project Value"
>
Variance: {approvedBudgetTotal - totalActivityBudget >= 0 ? '+' : ''}
{formatZAR(approvedBudgetTotal - totalActivityBudget)}
</span>
</>
)}
</div>
</div>
@@ -517,16 +505,6 @@ export const ProjectViewModal: React.FC<ProjectViewModalProps> = ({
</span>
<span className="text-slate-500">#{m.id}</span>
</div>
{(() => {
const mActivities = activities.filter((a) => String(a.milestoneId) === String(m.id));
const mValue = mActivities.reduce((sum, a) => sum + (Number(a.amount) || 0), 0);
return (
<div className="flex items-center justify-between text-[10px] font-mono pt-1 border-t border-slate-800/60">
<span className="text-slate-400">Milestone Value:</span>
<span className="font-bold text-blue-400">{formatZAR(mValue)}</span>
</div>
);
})()}
</div>
);
})}
@@ -571,33 +549,10 @@ export const ProjectViewModal: React.FC<ProjectViewModalProps> = ({
key={act.id}
className="p-2.5 rounded-xl bg-slate-900/80 border border-slate-800 text-xs space-y-1 hover:border-slate-700 transition"
>
{(() => {
const actAmount = Number(act.amount) || 0;
const actIndicators = indicators.filter((ind) => String(ind.activityId) === String(act.id));
const actActuals = actIndicators.reduce((sum, ind) => sum + (Number(ind.actualCost) || 0), 0);
const actVariance = actAmount - actActuals;
const isPositive = actVariance >= 0;
return (
<>
<div className="flex items-start justify-between gap-2">
<span className="font-semibold text-slate-200 truncate block">{act.title}</span>
<div className="flex items-center gap-1.5 shrink-0 font-mono text-xs">
<span className="font-bold text-cyan-400">{formatZAR(actAmount)}</span>
<span
className={`text-[9px] font-bold px-1.5 py-0.2 rounded border ${
isPositive
? 'text-emerald-400 bg-emerald-500/10 border-emerald-500/30'
: 'text-rose-400 bg-rose-500/10 border-rose-500/30'
}`}
title={`Budgeted: ${formatZAR(actAmount)} | Incurred Actuals: ${formatZAR(actActuals)} | Variance: ${isPositive ? '+' : ''}${formatZAR(actVariance)}`}
>
{isPositive ? `+${formatZAR(actVariance)}` : `-${formatZAR(Math.abs(actVariance))}`}
</span>
<span className="font-mono text-cyan-400 font-bold shrink-0">{formatZAR(act.amount)}</span>
</div>
</div>
</>
);
})()}
<div className="flex items-center justify-between text-[10px] text-slate-400">
<span>{act.category || 'Operations'}</span>
<span>{formatDate(act.performedAt)}</span>
@@ -83,7 +83,7 @@ export const RiskHeatmapMatrix: React.FC<RiskHeatmapMatrixProps> = ({
const projectMap = useMemo(() => {
const map: Record<string, string> = {};
projects.forEach((p) => {
map[String(p.id)] = p.name || '';
map[String(p.id)] = p.name;
});
return map;
}, [projects]);
@@ -1,11 +1,10 @@
import React from 'react';
import { ApprovalStatus, Priority, ActivityStatus, UserRole, ComplianceStatus } from '../../types';
import { ApprovalStatus, Priority, ActivityStatus, UserRole } from '../../types';
import {
getApprovalStatusBadge,
getPriorityBadge,
getActivityStatusBadge,
getUserRoleBadge,
getComplianceStatusBadge,
} from '../../lib/formatters';
export const ApprovalStatusBadge: React.FC<{ status: ApprovalStatus | number | null | undefined }> = ({ status }) => {
@@ -18,16 +17,6 @@ export const ApprovalStatusBadge: React.FC<{ status: ApprovalStatus | number | n
);
};
export const ComplianceStatusBadge: React.FC<{ status: ComplianceStatus | number | null | undefined }> = ({ status }) => {
const badge = getComplianceStatusBadge(status ?? ComplianceStatus.NotMet);
return (
<span className={`inline-flex items-center gap-1.5 px-2.5 py-0.5 rounded-full text-[11px] font-semibold border whitespace-nowrap ${badge.className}`}>
{badge.dot && <span className={`w-1.5 h-1.5 rounded-full ${badge.dot}`} />}
<span>{badge.label}</span>
</span>
);
};
export const PriorityBadge: React.FC<{ priority: Priority | number | null | undefined }> = ({ priority }) => {
const badge = getPriorityBadge(priority ?? Priority.Medium);
return (
@@ -6,17 +6,10 @@ import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
import { UserPlus, Shield, Hash, Mail, Phone, Lock, Building, CheckCircle2 } from 'lucide-react';
import { Modal } from '../ui/Modal';
import { useToast } from '../ui/Toast';
import {
createUser,
getSystemRoles,
assignUserRole,
getTenants,
getUsers,
notifyNewUserCreated,
} from '../../services/api';
import { createUser, getSystemRoles, assignUserRole, getTenants, getUsers } from '../../services/api';
import { useAuth } from '../../auth/AuthProvider';
import { useRbac } from '../../auth/rbac';
import { CreateUserRequest, Role, Tenant, User } from '../../types';
import { CreateUserRequest, Role, Tenant } from '../../types';
const createUserSchema = z.object({
tenantId: z.string().min(1, 'Tenant is required'),
@@ -29,8 +22,8 @@ const createUserSchema = z.object({
userName: z.string().optional(),
phoneNumber: z.string().optional(),
initialRoleId: z.string().optional(),
lockoutEnabled: z.boolean(),
twoFactorEnabled: z.boolean(),
lockoutEnabled: z.boolean().default(false),
twoFactorEnabled: z.boolean().default(false),
});
type CreateUserFormValues = z.infer<typeof createUserSchema>;
@@ -105,9 +98,7 @@ export const CreateUserModal: React.FC<CreateUserModalProps> = ({
// Filter out Admin role if user has access to tenant self-help (Requirement 1)
const assignableRoles = React.useMemo(() => {
return systemRoles.filter((r) => {
const rName = r.name || r.Name || '';
const rId = r.id || r.Id || '';
const isRoleAdmin = rName.toLowerCase() === 'admin' || rId === '1';
const isRoleAdmin = r.name.toLowerCase() === 'admin' || r.id === '1';
if (isRoleAdmin && hasTenantSelfHelpAccess) {
return false;
}
@@ -126,10 +117,8 @@ export const CreateUserModal: React.FC<CreateUserModalProps> = ({
mutationFn: async (values: CreateUserFormValues) => {
// Security enforcement: Users with tenant self-help access cannot create admin users
if (values.initialRoleId && hasTenantSelfHelpAccess) {
const selectedRole = systemRoles.find((r) => (r.id || r.Id) === values.initialRoleId);
const selName = selectedRole?.name || selectedRole?.Name || '';
const selId = selectedRole?.id || selectedRole?.Id || '';
if (selectedRole && (selName.toLowerCase() === 'admin' || selId === '1')) {
const selectedRole = systemRoles.find((r) => r.id === values.initialRoleId);
if (selectedRole && (selectedRole.name.toLowerCase() === 'admin' || selectedRole.id === '1')) {
throw new Error('Users who have access to tenant self-help are restricted from creating Admin users.');
}
}
@@ -152,39 +141,21 @@ export const CreateUserModal: React.FC<CreateUserModalProps> = ({
await createUser(values.tenantId, values.idNumber.trim(), payload);
let createdUser: User | undefined;
if (values.initialRoleId) {
try {
await queryClient.invalidateQueries({ queryKey: ['users-directory'] });
await queryClient.invalidateQueries({ queryKey: ['users'] });
const freshUsers = await getUsers(1, 1000, { email: values.email.trim() });
createdUser = freshUsers.find(
const createdUser = freshUsers.find(
(u) => u.email && u.email.toLowerCase() === values.email.trim().toLowerCase()
);
if (createdUser && values.initialRoleId) {
if (createdUser) {
await assignUserRole(createdUser.id, values.initialRoleId);
}
} catch {
// Graceful fallback
}
// RULE 3: Issue InApp and Email message directing new user to appropriate portal
const selectedRole = systemRoles.find((r) => (r.id || r.Id) === values.initialRoleId);
const roleName = selectedRole?.name || selectedRole?.Name || '';
const isPartner =
roleName.toLowerCase().trim() === 'partner' ||
String(values.initialRoleId || '').toLowerCase().trim() === 'partner';
const targetUserId = createdUser?.id || values.idNumber.trim();
await notifyNewUserCreated({
userId: targetUserId,
email: rawEmail,
isPartner,
roleName,
tenantId: values.tenantId,
}).catch(console.warn);
queryClient.invalidateQueries({ queryKey: ['inapp-notifications'] });
queryClient.invalidateQueries({ queryKey: ['notifications'] });
}
return values;
},
@@ -315,15 +286,11 @@ export const CreateUserModal: React.FC<CreateUserModalProps> = ({
className="w-full bg-slate-900 border border-slate-800 rounded-xl px-3 py-2 text-white focus:outline-none focus:border-blue-500 disabled:opacity-50"
>
<option value="">Select Initial Role (Optional)</option>
{assignableRoles.map((r) => {
const roleId = r.id || r.Id || '';
const roleLabel = r.name || r.Name || '';
return (
<option key={roleId} value={roleId}>
{roleLabel}
{assignableRoles.map((r) => (
<option key={r.id} value={r.id}>
{r.name}
</option>
);
})}
))}
</select>
{hasTenantSelfHelpAccess && (
<p className="text-[10px] text-amber-400 mt-1">
@@ -237,26 +237,16 @@ export const UserSecurityModal: React.FC<UserSecurityModalProps> = ({
onError: (err: unknown) => toastError('Logout Failed', err),
});
const lockUserMutation = useMutation({
mutationFn: () => setUserLockout(userId, true),
onSuccess: () => {
success('Account Locked', 'User account lockout enabled (disable = true).');
const lockoutMutation = useMutation({
mutationFn: (disableLock: boolean) => setUserLockout(userId, disableLock),
onSuccess: (_, disableLock) => {
success(
disableLock ? 'Account Unlocked' : 'Account Locked',
`User account lockout status successfully modified.`
);
refetchUser();
queryClient.invalidateQueries({ queryKey: ['users'] });
queryClient.invalidateQueries({ queryKey: ['user-detail', userId] });
},
onError: (err: unknown) => toastError('Lock User Failed', err),
});
const unlockUserMutation = useMutation({
mutationFn: () => setUserLockout(userId, false),
onSuccess: () => {
success('Account Unlocked', 'User account lockout disabled (disable = false).');
refetchUser();
queryClient.invalidateQueries({ queryKey: ['users'] });
queryClient.invalidateQueries({ queryKey: ['user-detail', userId] });
},
onError: (err: unknown) => toastError('Unlock User Failed', err),
onError: (err: unknown) => toastError('Lockout Update Failed', err),
});
const statusMutation = useMutation({
@@ -290,18 +280,18 @@ export const UserSecurityModal: React.FC<UserSecurityModalProps> = ({
<Modal
isOpen={isOpen}
onClose={onClose}
title={`User Security: ${effectiveUser.email || effectiveUser.id}`}
subtitle="Manage account status, role assignment, permissions, and active sessions."
title={`User Administration: ${effectiveUser.email || effectiveUser.id}`}
subtitle="Direct tenant-level user, role, claims, and session administration without database intervention."
>
<div className="space-y-4 text-xs">
{/* Navigation Tabs */}
<div className="flex gap-1.5 border-b border-slate-800 pb-2">
<div className="flex gap-2 border-b border-slate-800 pb-2">
<button
type="button"
onClick={() => setActiveTab('overview')}
className={`px-3 py-1.5 rounded-lg font-medium transition cursor-pointer ${
className={`px-3 py-1.5 rounded-lg font-semibold transition cursor-pointer ${
activeTab === 'overview'
? 'bg-blue-600 text-white font-semibold'
? 'bg-blue-600 text-white'
: 'text-slate-400 hover:text-white hover:bg-slate-800'
}`}
>
@@ -310,21 +300,21 @@ export const UserSecurityModal: React.FC<UserSecurityModalProps> = ({
<button
type="button"
onClick={() => setActiveTab('roles')}
className={`px-3 py-1.5 rounded-lg font-medium transition cursor-pointer flex items-center gap-1.5 ${
className={`px-3 py-1.5 rounded-lg font-semibold transition cursor-pointer flex items-center gap-1.5 ${
activeTab === 'roles'
? 'bg-blue-600 text-white font-semibold'
? 'bg-blue-600 text-white'
: 'text-slate-400 hover:text-white hover:bg-slate-800'
}`}
>
<Shield className="w-3.5 h-3.5" />
<span>Role ({(Array.isArray(userRoles) ? userRoles : []).length})</span>
<span>Roles ({(Array.isArray(userRoles) ? userRoles : []).length})</span>
</button>
<button
type="button"
onClick={() => setActiveTab('claims')}
className={`px-3 py-1.5 rounded-lg font-medium transition cursor-pointer flex items-center gap-1.5 ${
className={`px-3 py-1.5 rounded-lg font-semibold transition cursor-pointer flex items-center gap-1.5 ${
activeTab === 'claims'
? 'bg-blue-600 text-white font-semibold'
? 'bg-blue-600 text-white'
: 'text-slate-400 hover:text-white hover:bg-slate-800'
}`}
>
@@ -334,9 +324,9 @@ export const UserSecurityModal: React.FC<UserSecurityModalProps> = ({
<button
type="button"
onClick={() => setActiveTab('sessions')}
className={`px-3 py-1.5 rounded-lg font-medium transition cursor-pointer flex items-center gap-1.5 ${
className={`px-3 py-1.5 rounded-lg font-semibold transition cursor-pointer flex items-center gap-1.5 ${
activeTab === 'sessions'
? 'bg-blue-600 text-white font-semibold'
? 'bg-blue-600 text-white'
: 'text-slate-400 hover:text-white hover:bg-slate-800'
}`}
>
@@ -602,66 +592,70 @@ export const UserSecurityModal: React.FC<UserSecurityModalProps> = ({
</div>
)}
{/* TAB 4: Sessions & Security Interventions */}
{/* TAB 4: Sessions & Direct Account Interventions */}
{activeTab === 'sessions' && (
<div className="space-y-3">
<div className="p-4 bg-slate-900/60 rounded-xl border border-slate-800 space-y-4">
{/* Force Logout Action */}
<div className="flex items-center justify-between border-b border-slate-800/80 pb-3 gap-3">
<div className="flex items-center justify-between border-b border-slate-800/80 pb-3">
<div>
<h4 className="text-white font-semibold flex items-center gap-1.5">
<LogOut className="w-4 h-4 text-amber-400" />
<span>Revoke Active User Session</span>
<HelpTooltip
title="User Session Invalidation"
content="Enables a tenant self-service user to immediately logout a user if they are currently logged in, terminating their active token and session."
size="sm"
placement="top"
/>
</h4>
<p className="text-[11px] text-slate-400 mt-0.5">
Immediately invalidates active JWT tokens and logs the user out.
Terminates all active JWT tokens and sessions immediately without direct database intervention.
</p>
</div>
<button
type="button"
onClick={() => logoutMutation.mutate()}
disabled={logoutMutation.isPending || !canManageSessions}
className="px-3 py-1.5 bg-amber-500/10 hover:bg-amber-500/20 text-amber-400 border border-amber-500/20 rounded-xl font-semibold transition cursor-pointer disabled:opacity-50 shrink-0"
className="px-3 py-1.5 bg-amber-500/10 hover:bg-amber-500/20 text-amber-400 border border-amber-500/20 rounded-xl font-semibold transition cursor-pointer disabled:opacity-50"
>
{logoutMutation.isPending ? 'Revoking...' : 'Force Logout'}
</button>
</div>
{/* Lock / Unlock Account */}
<div className="flex items-center justify-between gap-3">
<div className="flex items-center justify-between">
<div>
<h4 className="text-white font-semibold flex items-center gap-1.5">
<Lock className="w-4 h-4 text-rose-400" />
<span>Account Lockout</span>
<span>Account Lockout Control</span>
<HelpTooltip
title="Account Lockout Control"
content="Enables a tenant self-service user to change a user's lockout status. The system defaults to a lockout period of 100 years when locking a user account."
size="sm"
placement="top"
/>
</h4>
<p className="text-[11px] text-slate-400 mt-0.5">
Control tenant login authorization for this account.
Temporarily lock out or re-enable the user from logging into this tenant. The system defaults to a lockout period of 100 years.
</p>
</div>
<div className="flex items-center gap-2 shrink-0">
<div className="flex items-center gap-2">
<button
type="button"
onClick={(e) => {
e.preventDefault();
e.stopPropagation();
lockUserMutation.mutate();
}}
disabled={lockUserMutation.isPending || unlockUserMutation.isPending || !canManageSessions}
onClick={() => lockoutMutation.mutate(false)}
disabled={lockoutMutation.isPending || !canManageSessions}
className="px-3 py-1.5 bg-rose-500/10 hover:bg-rose-500/20 text-rose-400 border border-rose-500/20 rounded-xl font-semibold transition cursor-pointer disabled:opacity-50"
>
{lockUserMutation.isPending ? 'Locking...' : 'Lock User'}
Lock User
</button>
<button
type="button"
onClick={(e) => {
e.preventDefault();
e.stopPropagation();
unlockUserMutation.mutate();
}}
disabled={unlockUserMutation.isPending || lockUserMutation.isPending || !canManageSessions}
onClick={() => lockoutMutation.mutate(true)}
disabled={lockoutMutation.isPending || !canManageSessions}
className="px-3 py-1.5 bg-emerald-500/10 hover:bg-emerald-500/20 text-emerald-400 border border-emerald-500/20 rounded-xl font-semibold transition cursor-pointer disabled:opacity-50"
>
{unlockUserMutation.isPending ? 'Unlocking...' : 'Unlock User'}
Unlock User
</button>
</div>
</div>
+12 -14
View File
@@ -1,10 +1,10 @@
import { updateHasherSettings } from './utils/hashids';
import { updateHasherSettings } from './services/toolsService';
export interface SecuritySettings {
Authority: string;
Audience: string;
ClientId: string;
ClientSecret?: string;
ClientSecret: string;
Scope?: string;
}
@@ -13,7 +13,7 @@ export interface ApiSettings {
}
export interface HasherSettings {
Salt?: string;
Salt: string;
MinHashLength: number;
}
@@ -36,6 +36,7 @@ export const defaultSecuritySettings: SecuritySettings = {
Authority: 'https://sts.security.khongisa.co.za',
Audience: 'pfm-api-dev',
ClientId: 'pfm-console-dev',
ClientSecret: 'secret_dcaeaa28097d9ba5b06ec324d9eac9d9c81de96e0a203cf2c6154c6dd7c89e94',
Scope: 'openid profile roles email address pfm-api-dev',
};
@@ -48,10 +49,6 @@ export const defaultHasherSettings: HasherSettings = {
MinHashLength: 11,
};
function syncAllHasherSettings(salt: string | undefined, minHashLength: number): void {
updateHasherSettings(salt, minHashLength);
}
/**
* Extracts first non-empty, trimmed string from candidate values.
*/
@@ -258,8 +255,9 @@ function resolveConfig(fetchedJson?: Record<string, any>): AppConfig {
const clientSecret = pickFirstNonEmpty(
windowConfig.clientSecret,
fetchedConfig.clientSecret,
buildEnvConfig.clientSecret
);
buildEnvConfig.clientSecret,
defaultSecuritySettings.ClientSecret
)!;
const scope = pickFirstNonEmpty(
windowConfig.scope,
@@ -280,7 +278,7 @@ function resolveConfig(fetchedJson?: Record<string, any>): AppConfig {
fetchedConfig.hasherSalt,
buildEnvConfig.hasherSalt,
defaultHasherSettings.Salt
);
)!;
const minHashLength =
windowConfig.hasherMinLength ||
@@ -293,14 +291,14 @@ function resolveConfig(fetchedJson?: Record<string, any>): AppConfig {
Authority: normalizeAuthorityUrl(authority),
Audience: audience,
ClientId: clientId,
...(clientSecret ? { ClientSecret: clientSecret } : {}),
ClientSecret: clientSecret,
Scope: scope,
},
ApiSettings: {
BaseUrl: normalizeBaseUrl(baseUrl),
},
HasherSettings: {
Salt: salt || defaultHasherSettings.Salt,
Salt: salt,
MinHashLength: minHashLength,
},
ConfigSource: source,
@@ -312,7 +310,7 @@ function resolveConfig(fetchedJson?: Record<string, any>): AppConfig {
let runtimeConfig: AppConfig = resolveConfig();
// Immediately apply deterministic hasher settings
syncAllHasherSettings(runtimeConfig.HasherSettings.Salt, runtimeConfig.HasherSettings.MinHashLength);
updateHasherSettings(runtimeConfig.HasherSettings.Salt, runtimeConfig.HasherSettings.MinHashLength);
const configListeners: Array<(config: AppConfig) => void> = [];
@@ -362,7 +360,7 @@ export async function loadRuntimeConfig(): Promise<AppConfig> {
runtimeConfig = resolveConfig(fetchedJson);
// Synchronize deterministic hasher settings
syncAllHasherSettings(runtimeConfig.HasherSettings.Salt, runtimeConfig.HasherSettings.MinHashLength);
updateHasherSettings(runtimeConfig.HasherSettings.Salt, runtimeConfig.HasherSettings.MinHashLength);
console.info(
`[Config] Active runtime configuration: source=${runtimeConfig.ConfigSource}, API=${runtimeConfig.ApiSettings.BaseUrl}, STS=${runtimeConfig.SecuritySettings.Authority}`
@@ -1,382 +0,0 @@
import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
import { useState, useEffect, useMemo, useCallback } from 'react';
import { useAuth } from '../auth/AuthProvider';
import {
getUserNotifications,
getNotifications,
createNotification,
markNotificationAsRead,
updateNotification,
getCurrentUserTenantId,
} from '../services/api';
import {
Notification,
NotificationPlatform,
NotificationStatus,
CreateNotificationRequest,
} from '../types';
export interface DraftMessage {
id: string;
recipientId: string;
recipientEmail: string;
recipientName?: string;
subject: string;
message: string;
platform?: NotificationPlatform;
updatedAt: string;
}
export function useInAppNotifications() {
const { user, claims } = useAuth();
const queryClient = useQueryClient();
const userId = (user?.id || claims?.sub || '') as string;
const userEmail = (user?.email || claims?.email || '') as string;
// Local storage keys for client-side starred and drafts
const draftsStorageKey = `pfm_mailbox_drafts_${userId || 'default'}`;
const starredStorageKey = `pfm_mailbox_starred_${userId || 'default'}`;
const trashStorageKey = `pfm_mailbox_trash_${userId || 'default'}`;
const sentStorageKey = `pfm_mailbox_sent_${userId || 'default'}`;
const readStorageList = useCallback(<T,>(key: string, fallbackKey?: string): T[] => {
try {
const stored = localStorage.getItem(key);
const parsed: T[] = stored ? JSON.parse(stored) : [];
if (fallbackKey && fallbackKey !== key) {
const fallbackStored = localStorage.getItem(fallbackKey);
const fallbackParsed: T[] = fallbackStored ? JSON.parse(fallbackStored) : [];
if (fallbackParsed.length > 0) {
const merged = [...parsed];
for (const item of fallbackParsed) {
const itemId = (item as any)?.id ?? item;
if (!merged.some(m => ((m as any)?.id ?? m) === itemId)) {
merged.push(item);
}
}
localStorage.setItem(key, JSON.stringify(merged));
localStorage.removeItem(fallbackKey);
return merged;
}
}
return parsed;
} catch {
return [];
}
}, []);
// Starred messages set
const [starredIds, setStarredIds] = useState<string[]>(() =>
readStorageList<string>(starredStorageKey, 'pfm_mailbox_starred_default')
);
// Trashed messages set
const [trashedIds, setTrashedIds] = useState<string[]>(() =>
readStorageList<string>(trashStorageKey, 'pfm_mailbox_trash_default')
);
// Local drafts list
const [drafts, setDrafts] = useState<DraftMessage[]>(() =>
readStorageList<DraftMessage>(draftsStorageKey, 'pfm_mailbox_drafts_default')
);
// Local sent messages history
const [localSent, setLocalSent] = useState<Notification[]>(() =>
readStorageList<Notification>(sentStorageKey, 'pfm_mailbox_sent_default')
);
// Synchronize across hook instances and userId changes
const syncFromStorage = useCallback(() => {
setStarredIds(readStorageList<string>(starredStorageKey, 'pfm_mailbox_starred_default'));
setTrashedIds(readStorageList<string>(trashStorageKey, 'pfm_mailbox_trash_default'));
setDrafts(readStorageList<DraftMessage>(draftsStorageKey, 'pfm_mailbox_drafts_default'));
setLocalSent(readStorageList<Notification>(sentStorageKey, 'pfm_mailbox_sent_default'));
}, [readStorageList, starredStorageKey, trashStorageKey, draftsStorageKey, sentStorageKey]);
useEffect(() => {
syncFromStorage();
}, [syncFromStorage]);
useEffect(() => {
const handleSync = () => syncFromStorage();
window.addEventListener('pfm-mailbox-sync', handleSync);
window.addEventListener('storage', handleSync);
return () => {
window.removeEventListener('pfm-mailbox-sync', handleSync);
window.removeEventListener('storage', handleSync);
};
}, [syncFromStorage]);
// Fetch notifications from backend
const { data: rawNotifications = [], isLoading, refetch } = useQuery<Notification[]>({
queryKey: ['inapp-notifications', userId],
queryFn: async () => {
// 1. Try user-specific notifications
let list = await getUserNotifications(userId || undefined);
// 2. If list is empty or fallback needed, also check organisation notifications
if (!list || list.length === 0) {
const orgList = await getNotifications();
if (orgList && orgList.length > 0) {
list = orgList;
}
}
return list || [];
},
// Live polling every 30 seconds
refetchInterval: 30000,
staleTime: 10000,
});
// InApp notifications (strictly platform === InApp 5) for Bell & Counters
const inAppNotifications = useMemo(() => {
return rawNotifications.filter(
n => Number(n.platform) === NotificationPlatform.InApp || n.platform === (NotificationPlatform.InApp as any)
);
}, [rawNotifications]);
// Active in-app notifications in inbox (excluding trashed and drafts)
const inboxNotifications = useMemo(() => {
return inAppNotifications.filter(
n => !trashedIds.includes(String(n.id)) && Number(n.status) !== NotificationStatus.Draft
);
}, [inAppNotifications, trashedIds]);
// Active mailbox notifications (always In-App notifications)
const allMailboxNotifications = inboxNotifications;
// Unread InApp notifications: status !== Read && status !== Draft && status !== Cancelled && status !== Failed
const unreadNotifications = useMemo(() => {
return inboxNotifications.filter(
n =>
Number(n.status) !== NotificationStatus.Read &&
Number(n.status) !== NotificationStatus.Cancelled &&
Number(n.status) !== NotificationStatus.Failed
);
}, [inboxNotifications]);
const unreadCount = unreadNotifications.length;
const top5Unread = useMemo(() => unreadNotifications.slice(0, 5), [unreadNotifications]);
// Starred notifications (In-App only)
const starredNotifications = useMemo(() => {
return inAppNotifications.filter(
n =>
starredIds.includes(String(n.id)) &&
!trashedIds.includes(String(n.id))
);
}, [inAppNotifications, starredIds, trashedIds]);
// Trashed notifications (In-App only)
const trashedNotifications = useMemo(() => {
return inAppNotifications.filter(n => trashedIds.includes(String(n.id)));
}, [inAppNotifications, trashedIds]);
// Mutation to mark notification as read
const markAsReadMutation = useMutation({
mutationFn: async (id: number | string) => {
await markNotificationAsRead(id);
},
onMutate: async (id) => {
await queryClient.cancelQueries({ queryKey: ['inapp-notifications', userId] });
queryClient.setQueryData<Notification[]>(['inapp-notifications', userId], (old = []) =>
old.map(n => (String(n.id) === String(id) ? { ...n, status: NotificationStatus.Read } : n))
);
},
onSettled: () => {
queryClient.invalidateQueries({ queryKey: ['inapp-notifications'] });
},
});
// Mark all unread as read
const markAllAsRead = useCallback(async () => {
const unread = unreadNotifications;
for (const item of unread) {
try {
await markNotificationAsRead(item.id);
} catch {}
}
queryClient.invalidateQueries({ queryKey: ['inapp-notifications'] });
}, [unreadNotifications, queryClient]);
// Toggle star
const toggleStar = useCallback((id: string | number) => {
const strId = String(id);
setStarredIds(prev => {
const next = prev.includes(strId) ? prev.filter(x => x !== strId) : [...prev, strId];
try {
localStorage.setItem(starredStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
}, [starredStorageKey]);
// Delete message (move to trash)
const deleteMessage = useCallback((id: string | number) => {
const strId = String(id);
setTrashedIds(prev => {
const next = prev.includes(strId) ? prev : [...prev, strId];
try {
localStorage.setItem(trashStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
}, [trashStorageKey]);
// Restore from trash
const restoreMessage = useCallback((id: string | number) => {
const strId = String(id);
setTrashedIds(prev => {
const next = prev.filter(x => x !== strId);
try {
localStorage.setItem(trashStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
}, [trashStorageKey]);
// Permanent delete
const permanentDelete = useCallback((id: string | number) => {
const strId = String(id);
setTrashedIds(prev => {
const next = prev.filter(x => x !== strId);
try {
localStorage.setItem(trashStorageKey, JSON.stringify(next));
} catch {}
return next;
});
setLocalSent(prev => {
const next = prev.filter(n => String(n.id) !== strId);
try {
localStorage.setItem(sentStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
}, [trashStorageKey, sentStorageKey]);
// Draft management
const saveDraft = useCallback((draft: Omit<DraftMessage, 'id' | 'updatedAt'> & { id?: string }) => {
const draftId = draft.id || `draft_${Date.now()}`;
const newDraft: DraftMessage = {
...draft,
id: draftId,
updatedAt: new Date().toISOString(),
};
setDrafts(prev => {
const current = readStorageList<DraftMessage>(draftsStorageKey, 'pfm_mailbox_drafts_default');
const base = current.length >= prev.length ? current : prev;
const filtered = base.filter(d => d.id !== draftId);
const next = [newDraft, ...filtered];
try {
localStorage.setItem(draftsStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
return draftId;
}, [draftsStorageKey, readStorageList]);
const deleteDraft = useCallback((id: string) => {
setDrafts(prev => {
const current = readStorageList<DraftMessage>(draftsStorageKey, 'pfm_mailbox_drafts_default');
const base = current.length >= prev.length ? current : prev;
const next = base.filter(d => d.id !== id);
try {
localStorage.setItem(draftsStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
}, [draftsStorageKey, readStorageList]);
// Send new notification (InApp or Email)
const sendMessageMutation = useMutation({
mutationFn: async (payload: {
recipientId: string;
recipientEmail: string;
recipientName?: string;
subject: string;
message: string;
platform?: NotificationPlatform;
draftId?: string;
}) => {
const orgId = getCurrentUserTenantId() || 1;
const targetPlatform = payload.platform || NotificationPlatform.InApp;
const formattedDestination = `To: ${payload.recipientEmail} | From: ${userEmail || 'System User'}`;
const req: CreateNotificationRequest = {
organisationId: orgId,
recipient: payload.recipientId,
platform: targetPlatform,
subject: payload.subject,
destination: formattedDestination,
message: payload.message,
status: targetPlatform === NotificationPlatform.InApp ? NotificationStatus.Delivered : NotificationStatus.Queued,
};
await createNotification(req);
// Record in local sent messages
const sentItem: Notification = {
id: `sent_${Date.now()}`,
organisationId: orgId,
recipient: payload.recipientId,
platform: targetPlatform,
status: NotificationStatus.Sent,
subject: payload.subject,
message: payload.message,
destination: formattedDestination,
createdAt: new Date().toISOString(),
sentAt: new Date().toISOString(),
};
setLocalSent(prev => {
const next = [sentItem, ...prev];
try {
localStorage.setItem(sentStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
// If sending a draft, remove the draft
if (payload.draftId) {
deleteDraft(payload.draftId);
}
},
onSuccess: () => {
queryClient.invalidateQueries({ queryKey: ['inapp-notifications'] });
},
});
return {
rawNotifications,
inAppNotifications,
allMailboxNotifications,
inboxNotifications,
unreadNotifications,
unreadCount,
top5Unread,
starredNotifications,
trashedNotifications,
sentNotifications: localSent,
drafts,
starredIds,
trashedIds,
isLoading,
refetch,
markAsRead: (id: string | number) => markAsReadMutation.mutate(id),
markAllAsRead,
toggleStar,
deleteMessage,
restoreMessage,
permanentDelete,
saveDraft,
deleteDraft,
sendMessage: sendMessageMutation.mutateAsync,
isSending: sendMessageMutation.isPending,
};
}
@@ -1,6 +1,5 @@
import {
ApprovalStatus,
ComplianceStatus,
ContractStatus,
ActivityStatus,
Priority,
@@ -79,7 +78,6 @@ export const NOTIFICATION_STATUS_OPTIONS = [
{ value: NotificationStatus.Failed, label: 'Failed' },
{ value: NotificationStatus.Cancelled, label: 'Cancelled' },
{ value: NotificationStatus.Bounced, label: 'Bounced' },
{ value: NotificationStatus.Draft, label: 'Draft' },
];
export const NOTIFICATION_PLATFORM_OPTIONS = [
@@ -273,37 +271,6 @@ export const getApprovalStatusBadge = (status: ApprovalStatus | number) => {
}
};
export const getComplianceStatusBadge = (status: ComplianceStatus | number) => {
const s = Number(status);
switch (s) {
case ComplianceStatus.Exceeded:
return {
label: 'Exceeded Expectation',
className: 'bg-purple-500/15 text-purple-300 border-purple-500/30 font-semibold',
dot: 'bg-purple-400',
};
case ComplianceStatus.Met:
return {
label: 'Met',
className: 'bg-emerald-500/15 text-emerald-300 border-emerald-500/30 font-semibold',
dot: 'bg-emerald-400',
};
case ComplianceStatus.NotMet:
default:
return {
label: 'Not Met',
className: 'bg-rose-500/15 text-rose-300 border-rose-500/30 font-semibold',
dot: 'bg-rose-400',
};
}
};
export const COMPLIANCE_STATUS_OPTIONS = [
{ value: ComplianceStatus.NotMet, label: 'Not Met' },
{ value: ComplianceStatus.Met, label: 'Met' },
{ value: ComplianceStatus.Exceeded, label: 'Exceeded Expectation' },
];
export const getContractStatusBadge = (status: ContractStatus | number) => {
const s = Number(status);
switch (s) {
@@ -510,8 +477,6 @@ export const getEmailStatusBadge = (status?: EmailStatuses | number | null) => {
export const getNotificationStatusBadge = (status?: NotificationStatus | number | null) => {
const s = Number(status);
switch (s) {
case NotificationStatus.Draft:
return { label: 'Draft', className: 'bg-purple-50 text-purple-800 border-purple-300 font-semibold' };
case NotificationStatus.Delivered:
case NotificationStatus.Read:
return { label: getNotificationStatusLabel(s), className: 'bg-emerald-50 text-emerald-800 border-emerald-300 font-semibold' };
@@ -1,325 +0,0 @@
/**
* Markdown & Branded HTML Formatting Utilities for PostFundManagement (PFM)
*/
export const PFM_BRAND_LOGO_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="40" height="40" fill="none">
<defs>
<radialGradient id="pfm-ambient" cx="50%" cy="50%" r="50%">
<stop offset="0%" stop-color="#38bdf8" stop-opacity="0.4" />
<stop offset="70%" stop-color="#2563eb" stop-opacity="0.1" />
<stop offset="100%" stop-color="#1e1b4b" stop-opacity="0" />
</radialGradient>
<linearGradient id="pfm-top" x1="12" y1="8" x2="52" y2="26" gradientUnits="userSpaceOnUse">
<stop offset="0%" stop-color="#a5b4fc" />
<stop offset="35%" stop-color="#6366f1" />
<stop offset="100%" stop-color="#4338ca" />
</linearGradient>
<linearGradient id="pfm-left" x1="10" y1="22" x2="30" y2="56" gradientUnits="userSpaceOnUse">
<stop offset="0%" stop-color="#38bdf8" />
<stop offset="45%" stop-color="#2563eb" />
<stop offset="100%" stop-color="#1e40af" />
</linearGradient>
<linearGradient id="pfm-right" x1="34" y1="28" x2="54" y2="56" gradientUnits="userSpaceOnUse">
<stop offset="0%" stop-color="#22d3ee" />
<stop offset="50%" stop-color="#06b6d4" />
<stop offset="100%" stop-color="#10b981" />
</linearGradient>
<linearGradient id="pfm-core" x1="27" y1="27" x2="37" y2="37" gradientUnits="userSpaceOnUse">
<stop offset="0%" stop-color="#ffffff" />
<stop offset="40%" stop-color="#e0f2fe" />
<stop offset="100%" stop-color="#38bdf8" />
</linearGradient>
</defs>
<circle cx="32" cy="32" r="31" fill="#090d16" />
<circle cx="32" cy="32" r="30" stroke="#1e293b" stroke-width="1" />
<circle cx="32" cy="32" r="28" fill="url(#pfm-ambient)" />
<path d="M32 6.5 L53.5 19 C55 19.8 56 21.5 56 23.2 L56 40.8 C56 42.5 55 44.2 53.5 45 L32 57.5 C30.5 58.3 28.5 58.3 27 57.5 L5.5 45 C4 44.2 3 42.5 3 40.8 L3 23.2 C3 21.5 4 19.8 5.5 19 L27 6.5 C28.5 5.7 30.5 5.7 32 6.5 Z" stroke="#3b82f6" stroke-opacity="0.3" stroke-width="1.2" fill="none" />
<path d="M32 9 L51.5 20.2 L43 25.2 L32 18.8 L21 25.2 L12.5 20.2 Z" fill="url(#pfm-top)" />
<path d="M10 23 L19.2 28.4 L19.2 44.5 L30 50.8 L30 55.5 L10 43.8 Z" fill="url(#pfm-left)" />
<path d="M54 23 L54 43.8 L34 55.5 L34 50.8 L44.8 44.5 L44.8 28.4 Z" fill="url(#pfm-right)" />
<path d="M22 28.5 L32 22.8 L42 28.5 L42 35.5 L32 41.2 L22 35.5 Z" fill="#0b1120" stroke="#334155" stroke-width="1" />
<path d="M25 31.5 L32 27.5 L39 31.5 L32 35.5 Z" fill="url(#pfm-top)" opacity="0.9" />
<path d="M25 37 L32 41 L39 37 L32 33 L25 37 Z" fill="url(#pfm-right)" opacity="0.9" />
<polygon points="32,27 36.5,32 32,37 27.5,32" fill="url(#pfm-core)" />
<circle cx="32" cy="32" r="1.5" fill="#ffffff" />
</svg>`;
export const PFM_LOGO_DATA_URI = `data:image/svg+xml;utf8,${encodeURIComponent(PFM_BRAND_LOGO_SVG)}`;
export interface MarkdownRenderOptions {
applyBranding?: boolean;
emailFormat?: boolean;
subject?: string;
tenantName?: string;
}
/**
* Checks if the content string is formatted HTML or Markdown.
*/
export function isHtmlContent(content: string): boolean {
if (!content) return false;
const trimmed = content.trim();
return (
trimmed.startsWith('<!DOCTYPE') ||
trimmed.startsWith('<html') ||
trimmed.startsWith('<div') ||
trimmed.startsWith('<table') ||
trimmed.startsWith('<p') ||
trimmed.startsWith('<h') ||
trimmed.startsWith('<ul') ||
trimmed.startsWith('<ol') ||
trimmed.startsWith('<blockquote') ||
(trimmed.includes('</') && trimmed.includes('>')) ||
/<(strong|b|em|i|u|h[1-6]|ul|ol|li|table|blockquote|div|p|img|hr|br)\b/i.test(trimmed)
);
}
/**
* Extracts raw plain text from markdown or HTML for concise notification snippets.
*/
export function stripMarkdown(text: string): string {
if (!text) return '';
return text
.replace(/<[^>]*>/g, ' ') // Strip HTML tags
.replace(/!\[.*?\]\(.*?\)/g, '') // Strip images
.replace(/\[(.*?)\]\(.*?\)/g, '$1') // Extract link text
.replace(/#{1,6}\s+/g, '') // Strip headers
.replace(/(\*\*|__)(.*?)\1/g, '$2') // Strip bold
.replace(/(\*|_)(.*?)\1/g, '$2') // Strip italic
.replace(/~~(.*?)~~/g, '$1') // Strip strikethrough
.replace(/`{1,3}.*?`{1,3}/gs, '') // Strip code blocks
.replace(/^>\s+/gm, '') // Strip blockquotes
.replace(/^[-*+]\s+/gm, '') // Strip list markers
.replace(/^\d+\.\s+/gm, '') // Strip ordered list markers
.replace(/\|/g, ' ') // Replace table pipes
.replace(/\s+/g, ' ')
.trim();
}
/**
* Parses markdown text into semantic HTML.
*/
export function parseMarkdownToHtml(markdown: string): string {
if (!markdown) return '';
let html = markdown
// Sanitize script tags
.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
// Normalize line endings
.replace(/\r\n/g, '\n');
// 1. Code blocks (```lang\ncode\n```)
html = html.replace(/```([a-zA-Z0-9_-]*)\n([\s\S]*?)```/g, (_match, _lang, code) => {
const escaped = code
.replace(/&/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;');
return `<pre style="background:#0b1120;border:1px solid #1e293b;border-radius:12px;padding:14px;overflow-x:auto;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:12px;color:#e2e8f0;margin:12px 0;"><code>${escaped}</code></pre>`;
});
// 2. Inline code (`code`)
html = html.replace(/`([^`]+)`/g, (_match, code) => {
const escaped = code
.replace(/&/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;');
return `<code style="background:#1e293b;color:#38bdf8;padding:2px 6px;border-radius:6px;font-family:monospace;font-size:12px;">${escaped}</code>`;
});
// 3. Tables (| A | B |\n|---|---|\n| C | D |)
html = html.replace(/((?:\|[^\n]+\|\n?)+)/g, (match) => {
const rows = match.trim().split('\n');
if (rows.length < 2) return match;
const hasSeparator = rows[1] && rows[1].includes('---');
if (!hasSeparator) return match;
const parseCells = (row: string) =>
row
.split('|')
.slice(1, -1)
.map((c) => c.trim());
const headers = parseCells(rows[0]);
const bodyRows = rows.slice(2);
let tableHtml = `<div style="overflow-x:auto;margin:14px 0;"><table style="width:100%;border-collapse:collapse;border:1px solid #334155;border-radius:8px;font-size:12px;text-align:left;">`;
tableHtml += `<thead><tr style="background:#1e293b;color:#f8fafc;">`;
headers.forEach((h) => {
tableHtml += `<th style="padding:8px 12px;border:1px solid #334155;font-weight:600;">${h}</th>`;
});
tableHtml += `</tr></thead><tbody>`;
bodyRows.forEach((row, i) => {
const cells = parseCells(row);
const bg = i % 2 === 0 ? '#0f172a' : '#1e293b/40';
tableHtml += `<tr style="background:${bg};color:#cbd5e1;">`;
cells.forEach((c) => {
tableHtml += `<td style="padding:8px 12px;border:1px solid #334155;">${c}</td>`;
});
tableHtml += `</tr>`;
});
tableHtml += `</tbody></table></div>`;
return tableHtml;
});
// 4. Headers (# through ####)
html = html.replace(/^#### (.*?)$/gm, '<h4 style="font-size:14px;font-weight:700;color:#f8fafc;margin:12px 0 6px 0;">$1</h4>');
html = html.replace(/^### (.*?)$/gm, '<h3 style="font-size:16px;font-weight:700;color:#f8fafc;margin:14px 0 8px 0;">$1</h3>');
html = html.replace(/^## (.*?)$/gm, '<h2 style="font-size:18px;font-weight:800;color:#ffffff;margin:16px 0 8px 0;border-bottom:1px solid #1e293b;padding-bottom:6px;">$1</h2>');
html = html.replace(/^# (.*?)$/gm, '<h1 style="font-size:22px;font-weight:800;color:#ffffff;margin:18px 0 10px 0;border-bottom:1px solid #334155;padding-bottom:8px;">$1</h1>');
// 5. Blockquotes and GitHub alerts (> [!NOTE], > [!IMPORTANT], etc.)
html = html.replace(/^>\s*\[!NOTE\]\s*(.*?)$/gim, '<div style="background:#0c4a6e22;border-left:4px solid #0284c7;padding:10px 14px;border-radius:8px;margin:10px 0;color:#bae6fd;font-size:12px;"><strong>NOTE:</strong> $1</div>');
html = html.replace(/^>\s*\[!IMPORTANT\]\s*(.*?)$/gim, '<div style="background:#83184322;border-left:4px solid #db2777;padding:10px 14px;border-radius:8px;margin:10px 0;color:#fbcfe8;font-size:12px;"><strong>IMPORTANT:</strong> $1</div>');
html = html.replace(/^>\s*\[!WARNING\]\s*(.*?)$/gim, '<div style="background:#713f1222;border-left:4px solid #d97706;padding:10px 14px;border-radius:8px;margin:10px 0;color:#fef08a;font-size:12px;"><strong>WARNING:</strong> $1</div>');
html = html.replace(/^>\s*\[!TIP\]\s*(.*?)$/gim, '<div style="background:#064e3b22;border-left:4px solid #059669;padding:10px 14px;border-radius:8px;margin:10px 0;color:#a7f3d0;font-size:12px;"><strong>TIP:</strong> $1</div>');
html = html.replace(/^>\s*(.*?)$/gm, '<blockquote style="border-left:3px solid #3b82f6;padding-left:12px;margin:8px 0;color:#94a3b8;font-style:italic;">$1</blockquote>');
// 6. Horizontal Rules (---)
html = html.replace(/^(?:---|\*\*\*|___)\s*$/gm, '<hr style="border:none;border-top:1px solid #334155;margin:16px 0;" />');
// 7. Bold & Italic
html = html.replace(/\*\*\*(.*?)\*\*\*/g, '<strong><em>$1</em></strong>');
html = html.replace(/\*\*(.*?)\*\*/g, '<strong style="color:#ffffff;">$1</strong>');
html = html.replace(/__(.*?)__/g, '<strong style="color:#ffffff;">$1</strong>');
html = html.replace(/\*(.*?)\*/g, '<em style="color:#cbd5e1;">$1</em>');
html = html.replace(/_(.*?)_/g, '<em style="color:#cbd5e1;">$1</em>');
html = html.replace(/~~(.*?)~~/g, '<del style="color:#64748b;">$1</del>');
// 8. Images and Links
html = html.replace(/!\[(.*?)\]\((.*?)\)/g, '<img src="$2" alt="$1" style="max-width:100%;border-radius:8px;margin:10px 0;box-shadow:0 4px 12px rgba(0,0,0,0.5);" />');
html = html.replace(/\[(.*?)\]\((.*?)\)/g, '<a href="$2" target="_blank" rel="noopener noreferrer" style="color:#38bdf8;text-decoration:underline;">$1</a>');
// 9. Unordered Lists (- or *)
html = html.replace(/^[-*+]\s+(.*?)$/gm, '<li style="margin-left:20px;list-style-type:disc;color:#cbd5e1;padding:2px 0;">$1</li>');
// 10. Ordered Lists (1. 2.)
html = html.replace(/^\d+\.\s+(.*?)$/gm, '<li style="margin-left:20px;list-style-type:decimal;color:#cbd5e1;padding:2px 0;">$1</li>');
// 11. Paragraphs
const paragraphs = html.split(/\n{2,}/);
html = paragraphs
.map((p) => {
const trimmed = p.trim();
if (!trimmed) return '';
if (
trimmed.startsWith('<h') ||
trimmed.startsWith('<div') ||
trimmed.startsWith('<table') ||
trimmed.startsWith('<pre') ||
trimmed.startsWith('<blockquote') ||
trimmed.startsWith('<hr') ||
trimmed.startsWith('<li')
) {
return trimmed;
}
return `<p style="margin:8px 0;line-height:1.6;color:#cbd5e1;">${trimmed.replace(/\n/g, '<br />')}</p>`;
})
.join('\n');
return html;
}
/**
* Transforms Markdown into full branded executive HTML for email notifications.
*/
export function renderMarkdownToHtml(
markdown: string,
options?: MarkdownRenderOptions
): string {
const trimmed = (markdown || '').trim();
if (trimmed.startsWith('<!DOCTYPE') || trimmed.startsWith('<html')) {
return trimmed;
}
const contentHtml = isHtmlContent(trimmed)
? trimmed.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
: parseMarkdownToHtml(trimmed);
if (!options?.applyBranding && !options?.emailFormat) {
return contentHtml;
}
const subject = options?.subject || 'Statutory Platform Notification';
const tenantName = options?.tenantName || 'Post-Fund Management (PFM) Platform';
const dateFormatted = new Date().toLocaleDateString('en-ZA', {
day: 'numeric',
month: 'short',
year: 'numeric',
});
return `<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>${subject}</title>
</head>
<body style="margin:0;padding:24px 12px;background-color:#090d16;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;color:#cbd5e1;">
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="max-width:640px;margin:0 auto;background-color:#0d1322;border:1px solid #1e293b;border-radius:16px;overflow:hidden;box-shadow:0 12px 36px rgba(0,0,0,0.6);">
<!-- Executive Brand Header -->
<tr>
<td style="padding:20px 24px;background:linear-gradient(135deg, #0b1120 0%, #1e1b4b 50%, #0f172a 100%);border-bottom:1px solid #1e293b;">
<table role="presentation" width="100%" cellpadding="0" cellspacing="0">
<tr>
<td width="48" style="vertical-align:middle;">
<img src="${PFM_LOGO_DATA_URI}" alt="PFM Logo" width="40" height="40" style="display:block;border-radius:10px;" />
</td>
<td style="padding-left:14px;vertical-align:middle;">
<div style="font-size:14px;font-weight:800;color:#ffffff;letter-spacing:-0.02em;text-transform:uppercase;">
Post-Fund Management (PFM)
</div>
<div style="font-size:11px;color:#38bdf8;font-weight:600;margin-top:2px;">
${tenantName}
</div>
</td>
<td align="right" style="vertical-align:middle;">
<span style="font-size:10px;font-weight:700;color:#38bdf8;background-color:rgba(56,189,248,0.12);border:1px solid rgba(56,189,248,0.25);padding:4px 8px;border-radius:20px;text-transform:uppercase;letter-spacing:0.04em;">
Official Notice
</span>
</td>
</tr>
</table>
</td>
</tr>
<!-- Subject Banner -->
<tr>
<td style="padding:16px 24px;background-color:#0b101b;border-bottom:1px solid #1e293b;">
<h2 style="margin:0;font-size:16px;font-weight:700;color:#ffffff;line-height:1.4;">
${subject}
</h2>
<div style="font-size:11px;color:#64748b;margin-top:4px;">
Dispatched on ${dateFormatted} • Electronic System Communication
</div>
</td>
</tr>
<!-- Message Content Body -->
<tr>
<td style="padding:24px;font-size:13px;line-height:1.65;color:#e2e8f0;">
${contentHtml}
</td>
</tr>
<!-- Executive Footer -->
<tr>
<td style="padding:18px 24px;background-color:#080c14;border-top:1px solid #1e293b;font-size:11px;color:#64748b;text-align:center;">
<div style="font-weight:600;color:#94a3b8;margin-bottom:4px;">
Post-Fund Management, Performance & Impact Governance Platform
</div>
<div>
This message was transmitted securely under active multi-tenant encryption. Please do not reply directly to automated dispatch notices.
</div>
<div style="margin-top:8px;font-size:10px;color:#475569;">
&copy; ${new Date().getFullYear()} PFM Governance Architecture. All rights reserved.
</div>
</td>
</tr>
</table>
</body>
</html>`;
}
File diff suppressed because it is too large Load Diff
@@ -1,529 +0,0 @@
import React, { useState, useMemo } from 'react';
import { useQuery } from '@tanstack/react-query';
import {
ShieldCheck,
ShieldAlert,
AlertTriangle,
Users,
Search,
Filter,
RefreshCw,
Eye,
CheckCircle2,
Coins,
Building2,
FileSpreadsheet,
Download,
AlertCircle,
} from 'lucide-react';
import {
getProjects,
getAllProgrammes,
getAllPortfolios,
getBudgets,
getProjectComplianceItems,
getProjectBeneficiaries,
getBeneficiaryOutcomes,
getProjectRisks,
} from '../services/api';
import {
Project,
Programme,
Portfolio,
ComplianceItem,
Beneficiary,
Outcome,
ComplianceStatus,
ApprovalStatus,
} from '../types';
import {
formatDate,
formatZAR,
formatCompactZAR,
getIndustrySectorLabel,
getProjectTypeLabel,
getApprovalStatusBadge,
} from '../lib/formatters';
import { HelpTooltip } from '../components/ui/HelpTooltip';
import { ComplianceStatusBadge } from '../components/ui/StatusBadge';
import { ProjectComplianceModal } from '../components/projects/ProjectComplianceModal';
import { ExportButton } from '../components/ui/ExportButton';
import { ExportColumn } from '../utils/exportUtils';
export const CompliancePage: React.FC = () => {
const [searchTerm, setSearchTerm] = useState('');
const [selectedProgramme, setSelectedProgramme] = useState('All');
const [selectedComplianceFilter, setSelectedComplianceFilter] = useState<'All' | 'Compliant' | 'Noncompliant'>('All');
const [selectedProjectForAudit, setSelectedProjectForAudit] = useState<Project | null>(null);
const [isAuditModalOpen, setIsAuditModalOpen] = useState(false);
// Queries
const { data: projects = [], isLoading: loadingProjects, refetch: refetchProjects, isFetching } = useQuery({
queryKey: ['projects'],
queryFn: () => getProjects(),
});
const { data: programmes = [] } = useQuery({
queryKey: ['programmes'],
queryFn: () => getAllProgrammes(),
});
const { data: portfolios = [] } = useQuery({
queryKey: ['portfolios'],
queryFn: () => getAllPortfolios(),
});
const { data: allBudgets = [] } = useQuery({
queryKey: ['budgets'],
queryFn: () => getBudgets(1, 200),
});
const { data: beneficiariesMap = new Map<string | number, Beneficiary[]>() } = useQuery({
queryKey: ['allProjectBeneficiaries', projects.map((p) => p.id)],
queryFn: async () => {
const map = new Map<string | number, Beneficiary[]>();
await Promise.all(
projects.map(async (p) => {
try {
const bens = await getProjectBeneficiaries(p.id);
map.set(p.id, bens);
} catch {
map.set(p.id, []);
}
})
);
return map;
},
enabled: projects.length > 0,
});
// Query compliance items for all projects
const { data: complianceMap = new Map<string | number, ComplianceItem[]>(), isLoading: loadingComps } = useQuery({
queryKey: ['allProjectCompliance', projects.map((p) => p.id)],
queryFn: async () => {
const map = new Map<string | number, ComplianceItem[]>();
await Promise.all(
projects.map(async (p) => {
try {
const items = await getProjectComplianceItems(p.id);
map.set(p.id, items);
} catch {
map.set(p.id, []);
}
})
);
return map;
},
enabled: projects.length > 0,
});
// Query beneficiary outcomes
const allBensList = useMemo(() => {
const list: Beneficiary[] = [];
beneficiariesMap.forEach((bList) => list.push(...bList));
return list;
}, [beneficiariesMap]);
const { data: outcomesMap = new Map<string | number, Outcome[]>() } = useQuery({
queryKey: ['allBeneficiaryOutcomes', allBensList.map((b) => b.id)],
queryFn: async () => {
const map = new Map<string | number, Outcome[]>();
await Promise.all(
allBensList.map(async (b) => {
try {
const outs = await getBeneficiaryOutcomes(b.id);
map.set(b.id, outs);
} catch {
map.set(b.id, []);
}
})
);
return map;
},
enabled: allBensList.length > 0,
});
// Lookups
const programmeMap = useMemo(() => {
const map = new Map<string | number, Programme>();
programmes.forEach((pr) => map.set(pr.id, pr));
return map;
}, [programmes]);
// Aggregate project compliance records
const projectComplianceStats = useMemo(() => {
return projects.map((p) => {
const prog = programmeMap.get(p.programmeId);
const items = complianceMap.get(p.id) || [];
const projectBens = beneficiariesMap.get(p.id) || [];
let totalOutcomes = 0;
let metOutcomes = 0;
projectBens.forEach((b) => {
const bOutcomes = outcomesMap.get(b.id) || [];
totalOutcomes += bOutcomes.length;
metOutcomes += bOutcomes.filter(
(o) => Number(o.status) === ComplianceStatus.Met || Number(o.status) === ComplianceStatus.Exceeded
).length;
});
const totalItems = items.length;
const metItems = items.filter(
(i) => Number(i.status) === ComplianceStatus.Met || Number(i.status) === ComplianceStatus.Exceeded
).length;
const unmetItems = totalItems - metItems;
const unmetOutcomes = totalOutcomes - metOutcomes;
const isCompliant = unmetItems === 0 && unmetOutcomes === 0;
const projectBudgets = allBudgets.filter((b) => String(b.projectId) === String(p.id));
const approvedBudget = projectBudgets
.filter((b) => Number(b.status) === ApprovalStatus.Approved || b.status === undefined)
.reduce((sum, b) => sum + (Number(b.amount) || 0), 0);
const budgetAtRisk = isCompliant ? 0 : approvedBudget;
return {
project: p,
programme: prog,
totalItems,
metItems,
unmetItems,
totalOutcomes,
metOutcomes,
unmetOutcomes,
beneficiariesCount: projectBens.length,
isCompliant,
approvedBudget,
budgetAtRisk,
};
});
}, [projects, programmeMap, complianceMap, beneficiariesMap, outcomesMap, allBudgets]);
// Filtered rows
const filteredRows = useMemo(() => {
return projectComplianceStats.filter((row) => {
if (selectedProgramme !== 'All' && String(row.project.programmeId) !== selectedProgramme) {
return false;
}
if (selectedComplianceFilter === 'Compliant' && !row.isCompliant) {
return false;
}
if (selectedComplianceFilter === 'Noncompliant' && row.isCompliant) {
return false;
}
if (searchTerm.trim()) {
const q = searchTerm.toLowerCase();
const pName = (row.project.name || '').toLowerCase();
const prName = (row.programme?.name || '').toLowerCase();
const idStr = String(row.project.id);
if (!pName.includes(q) && !prName.includes(q) && !idStr.includes(q)) {
return false;
}
}
return true;
});
}, [projectComplianceStats, selectedProgramme, selectedComplianceFilter, searchTerm]);
// Aggregate KPI figures
const totalProjectsCount = projectComplianceStats.length;
const compliantProjectsCount = projectComplianceStats.filter((r) => r.isCompliant).length;
const noncompliantProjectsCount = totalProjectsCount - compliantProjectsCount;
const overallComplianceRate = totalProjectsCount > 0 ? Math.round((compliantProjectsCount / totalProjectsCount) * 100) : 100;
const totalBudgetAtRisk = projectComplianceStats.reduce((sum, r) => sum + r.budgetAtRisk, 0);
const totalBeneficiaries = allBensList.length;
const complianceExportColumns: ExportColumn<any>[] = [
{ header: 'Project ID', accessor: (r) => r.project.id },
{ header: 'Project Name', accessor: (r) => r.project.name },
{ header: 'Programme', accessor: (r) => r.programme?.name || `Prog #${r.project.programmeId}` },
{ header: 'Sector', accessor: (r) => getIndustrySectorLabel(r.project.sector) },
{ header: 'Compliance Status', accessor: (r) => (r.isCompliant ? '100% Compliant' : 'Noncompliant') },
{ header: 'Requirements Met', accessor: (r) => `${r.metItems}/${r.totalItems}` },
{ header: 'Outcomes Met', accessor: (r) => `${r.metOutcomes}/${r.totalOutcomes}` },
{ header: 'Approved Budget', accessor: (r) => formatZAR(r.approvedBudget) },
{ header: 'Budget At Risk', accessor: (r) => formatZAR(r.budgetAtRisk) },
];
return (
<div className="space-y-6">
{/* Header Banner */}
<div className="bg-gradient-to-r from-[#0d1322] via-[#0f172a] to-[#0d1322] p-6 rounded-3xl border border-slate-800 shadow-xl relative overflow-hidden flex flex-col md:flex-row md:items-center justify-between gap-4">
<div className="space-y-1 relative z-10">
<div className="flex items-center gap-2">
<div className="p-2 bg-blue-500/10 border border-blue-500/20 rounded-xl text-blue-400">
<ShieldCheck className="w-5 h-5" />
</div>
<span className="text-xs font-bold uppercase tracking-wider text-blue-400">
Statutory Governance & Compliance
</span>
</div>
<h1 className="text-2xl sm:text-3xl font-extrabold text-white tracking-tight">
Portfolio Compliance Dashboard
</h1>
<p className="text-xs sm:text-sm text-slate-400 max-w-2xl">
Enterprise-wide compliance audit across all funded projects, beneficiary impact outcomes, and capital at risk.
</p>
</div>
<div className="flex items-center gap-2.5 relative z-10 self-start md:self-center">
<ExportButton
claim="compliance"
data={filteredRows}
columns={complianceExportColumns}
filename={`portfolio_compliance_${new Date().toISOString().split('T')[0]}`}
title="Portfolio Compliance Register"
/>
<button
type="button"
onClick={() => refetchProjects()}
disabled={isFetching}
className="inline-flex items-center gap-1.5 px-3.5 py-2 text-xs font-semibold text-white bg-blue-600 hover:bg-blue-500 rounded-xl transition cursor-pointer shadow-md shadow-blue-600/30 disabled:opacity-50"
>
<RefreshCw className={`w-3.5 h-3.5 ${isFetching ? 'animate-spin' : ''}`} />
<span>Refresh</span>
</button>
</div>
</div>
{/* 5 Headline KPI Cards */}
<div className="grid grid-cols-2 md:grid-cols-3 lg:grid-cols-5 gap-4">
{/* Card 1: Overall Rate */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 shadow-md backdrop-blur-sm flex flex-col justify-between">
<div className="flex items-center justify-between text-slate-400">
<span className="text-[11px] font-semibold uppercase tracking-wider text-slate-400">Compliance Rate</span>
<div className="p-1.5 rounded-lg bg-blue-500/10 text-blue-400 border border-blue-500/20">
<ShieldCheck className="w-4 h-4" />
</div>
</div>
<div className="mt-3">
<p className="text-2xl font-bold text-white tracking-tight">{overallComplianceRate}%</p>
<p className="text-[10px] text-emerald-400 font-mono mt-1">100% threshold target</p>
</div>
</div>
{/* Card 2: Compliant Projects */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 shadow-md backdrop-blur-sm flex flex-col justify-between">
<div className="flex items-center justify-between text-slate-400">
<span className="text-[11px] font-semibold uppercase tracking-wider text-slate-400">Compliant</span>
<div className="p-1.5 rounded-lg bg-emerald-500/10 text-emerald-400 border border-emerald-500/20">
<CheckCircle2 className="w-4 h-4" />
</div>
</div>
<div className="mt-3">
<p className="text-2xl font-bold text-emerald-400 tracking-tight">{compliantProjectsCount}</p>
<p className="text-[10px] text-slate-400 font-mono mt-1">Eligible for approval</p>
</div>
</div>
{/* Card 3: Noncompliant Projects */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 shadow-md backdrop-blur-sm flex flex-col justify-between">
<div className="flex items-center justify-between text-slate-400">
<span className="text-[11px] font-semibold uppercase tracking-wider text-slate-400">Noncompliant</span>
<div className="p-1.5 rounded-lg bg-rose-500/10 text-rose-400 border border-rose-500/20">
<ShieldAlert className="w-4 h-4" />
</div>
</div>
<div className="mt-3">
<p className="text-2xl font-bold text-rose-400 tracking-tight">{noncompliantProjectsCount}</p>
<p className="text-[10px] text-rose-400 font-mono mt-1">Approvals blocked</p>
</div>
</div>
{/* Card 4: Total Capital At Risk */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 shadow-md backdrop-blur-sm flex flex-col justify-between">
<div className="flex items-center justify-between text-slate-400">
<span className="text-[11px] font-semibold uppercase tracking-wider text-slate-400">Capital At Risk</span>
<div className="p-1.5 rounded-lg bg-amber-500/10 text-amber-400 border border-amber-500/20">
<AlertTriangle className="w-4 h-4" />
</div>
</div>
<div className="mt-3">
<p className="text-2xl font-bold text-amber-400 tracking-tight">{formatCompactZAR(totalBudgetAtRisk)}</p>
<p className="text-[10px] text-slate-400 font-mono mt-1">{formatZAR(totalBudgetAtRisk)}</p>
</div>
</div>
{/* Card 5: Beneficiaries Monitored */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 shadow-md backdrop-blur-sm flex flex-col justify-between">
<div className="flex items-center justify-between text-slate-400">
<span className="text-[11px] font-semibold uppercase tracking-wider text-slate-400">Beneficiaries</span>
<div className="p-1.5 rounded-lg bg-purple-500/10 text-purple-400 border border-purple-500/20">
<Users className="w-4 h-4" />
</div>
</div>
<div className="mt-3">
<p className="text-2xl font-bold text-white tracking-tight">{totalBeneficiaries}</p>
<p className="text-[10px] text-slate-400 font-mono mt-1">Impact groups monitored</p>
</div>
</div>
</div>
{/* Filter Toolbar */}
<div className="bg-[#0f1523]/80 backdrop-blur-md p-4 rounded-2xl border border-slate-800/80 shadow-lg flex flex-wrap items-center justify-between gap-3">
<div className="flex items-center gap-3 flex-wrap">
<div className="relative">
<Search className="w-3.5 h-3.5 absolute left-3 top-1/2 -translate-y-1/2 text-slate-500" />
<input
type="text"
placeholder="Search project, programme, ID..."
value={searchTerm}
onChange={(e) => setSearchTerm(e.target.value)}
className="pl-9 pr-3 py-1.5 bg-[#090d16] border border-slate-700/80 rounded-xl text-xs text-white placeholder-slate-500 focus:outline-none focus:border-blue-500 w-64 transition"
/>
</div>
<div className="flex items-center bg-[#090d16] border border-slate-700/80 rounded-xl px-3 py-1.5 text-xs">
<span className="text-slate-400 mr-2 text-[11px] font-semibold uppercase">Programme:</span>
<select
value={selectedProgramme}
onChange={(e) => setSelectedProgramme(e.target.value)}
className="bg-transparent text-white focus:outline-none cursor-pointer max-w-[180px] truncate"
>
<option value="All" className="bg-slate-900">All Programmes</option>
{programmes.map((pr) => (
<option key={pr.id} value={pr.id} className="bg-slate-900">
{pr.name}
</option>
))}
</select>
</div>
<div className="flex items-center bg-[#090d16] border border-slate-700/80 rounded-xl px-3 py-1.5 text-xs">
<span className="text-slate-400 mr-2 text-[11px] font-semibold uppercase">Compliance:</span>
<select
value={selectedComplianceFilter}
onChange={(e) => setSelectedComplianceFilter(e.target.value as any)}
className="bg-transparent text-white focus:outline-none cursor-pointer"
>
<option value="All" className="bg-slate-900">All Statuses</option>
<option value="Compliant" className="bg-slate-900">Compliant (100%)</option>
<option value="Noncompliant" className="bg-slate-900">Noncompliant (Blocked)</option>
</select>
</div>
</div>
<span className="text-xs text-slate-400 font-medium">
Showing <strong className="text-white">{filteredRows.length}</strong> of {projectComplianceStats.length} projects
</span>
</div>
{/* Projects Compliance Register Table */}
<div className="bg-[#0f1523]/80 rounded-2xl border border-slate-800/80 overflow-hidden shadow-xl backdrop-blur-sm">
<div className="p-4 border-b border-slate-800/80 flex items-center justify-between bg-[#0d121f]/90">
<div className="flex items-center gap-2">
<ShieldCheck className="w-4 h-4 text-cyan-400" />
<h3 className="text-xs font-bold uppercase tracking-wider text-white">
Project Compliance Matrix & Audit Register
</h3>
</div>
<span className="text-[11px] text-slate-400">
Invariant: 100% compliance required for formal project approval
</span>
</div>
<div className="overflow-x-auto">
<table className="w-full text-left text-xs border-collapse">
<thead>
<tr className="bg-[#090d16] border-b border-slate-800 text-slate-400 text-[11px] font-semibold select-none">
<th className="py-3.5 px-5">Project Name & ID</th>
<th className="py-3.5 px-4">Programme</th>
<th className="py-3.5 px-4">Compliance Status</th>
<th className="py-3.5 px-4 text-center">Requirements Met</th>
<th className="py-3.5 px-4 text-center">Outcomes Met</th>
<th className="py-3.5 px-4 text-right">Approved Budget</th>
<th className="py-3.5 px-4 text-right">Capital At Risk</th>
<th className="py-3.5 px-5 text-right font-medium">Actions</th>
</tr>
</thead>
<tbody className="divide-y divide-slate-800/60 font-medium">
{loadingProjects || loadingComps ? (
<tr>
<td colSpan={8} className="py-12 text-center text-slate-400 text-xs">
<div className="flex flex-col items-center gap-2">
<div className="w-6 h-6 border-2 border-blue-500 border-t-transparent rounded-full animate-spin" />
<span>Loading compliance matrix...</span>
</div>
</td>
</tr>
) : filteredRows.length === 0 ? (
<tr>
<td colSpan={8} className="py-10 text-center text-slate-500 text-xs">
No projects matching active compliance filters.
</td>
</tr>
) : (
filteredRows.map((r) => (
<tr key={r.project.id} className="hover:bg-slate-800/40 transition-colors">
<td className="py-3.5 px-5">
<span className="font-semibold text-white block">{r.project.name}</span>
<span className="text-[10px] text-slate-500 font-mono">ID #{r.project.id} &bull; {getIndustrySectorLabel(r.project.sector)}</span>
</td>
<td className="py-3.5 px-4 text-slate-300">
{r.programme?.name || `Prog #${r.project.programmeId}`}
</td>
<td className="py-3.5 px-4">
{r.isCompliant ? (
<span className="inline-flex items-center gap-1.5 px-2.5 py-0.5 rounded-full text-[10px] font-semibold bg-emerald-500/10 text-emerald-400 border border-emerald-500/30">
<CheckCircle2 className="w-3 h-3 text-emerald-400" />
<span>100% Compliant</span>
</span>
) : (
<span className="inline-flex items-center gap-1.5 px-2.5 py-0.5 rounded-full text-[10px] font-semibold bg-rose-500/10 text-rose-400 border border-rose-500/30">
<AlertTriangle className="w-3 h-3 text-rose-400" />
<span>Noncompliant ({r.unmetItems + r.unmetOutcomes} Unmet)</span>
</span>
)}
</td>
<td className="py-3.5 px-4 text-center font-mono font-semibold">
<span className={r.unmetItems === 0 ? 'text-emerald-400' : 'text-rose-400'}>
{r.metItems}/{r.totalItems}
</span>
</td>
<td className="py-3.5 px-4 text-center font-mono font-semibold">
<span className={r.unmetOutcomes === 0 ? 'text-emerald-400' : 'text-purple-400'}>
{r.metOutcomes}/{r.totalOutcomes}
</span>
</td>
<td className="py-3.5 px-4 text-right font-mono text-slate-300">
{formatZAR(r.approvedBudget)}
</td>
<td className="py-3.5 px-4 text-right font-mono font-bold">
<span className={r.budgetAtRisk > 0 ? 'text-rose-400' : 'text-emerald-400'}>
{formatZAR(r.budgetAtRisk)}
</span>
</td>
<td className="py-3.5 px-5 text-right whitespace-nowrap">
<button
type="button"
onClick={() => {
setSelectedProjectForAudit(r.project);
setIsAuditModalOpen(true);
}}
className="inline-flex items-center gap-1 text-xs font-semibold text-emerald-300 hover:text-white bg-emerald-950/40 hover:bg-emerald-900/60 border border-emerald-500/30 px-3 py-1.5 rounded-xl transition cursor-pointer shadow-xs active:scale-95"
>
<ShieldCheck className="w-3.5 h-3.5 text-emerald-400" />
<span>Inspect Compliance</span>
</button>
</td>
</tr>
))
)}
</tbody>
</table>
</div>
</div>
{/* Compliance Audit Modal */}
<ProjectComplianceModal
isOpen={isAuditModalOpen}
onClose={() => {
setIsAuditModalOpen(false);
setSelectedProjectForAudit(null);
}}
project={selectedProjectForAudit}
programme={selectedProjectForAudit ? programmeMap.get(selectedProjectForAudit.programmeId) || null : null}
/>
</div>
);
};
@@ -15,7 +15,6 @@ import {
ShieldAlert,
RotateCcw,
LayoutDashboard,
ShieldCheck,
} from 'lucide-react';
import {
getDashboard,
@@ -27,10 +26,9 @@ import {
getDisbursements,
getAllRisks,
getAllIndicators,
getProjectComplianceItems,
} from '../services/api';
import { formatCompactZAR, formatZAR, getIndustrySectorLabel } from '../lib/formatters';
import { ApprovalStatus, ComplianceStatus } from '../types';
import { ApprovalStatus } from '../types';
import { RiskHeatmapMatrix } from '../components/ui/RiskHeatmapMatrix';
import { HelpTooltip } from '../components/ui/HelpTooltip';
import { useTableSort, SortableTh } from '../utils/tableSort';
@@ -41,10 +39,6 @@ interface AttentionProject {
programme: string;
status: string;
risk: string;
complianceStatus: string;
isCompliant: boolean;
unmetCount: number;
budgetAtRisk: number;
financialVariance: string;
varianceType: string;
maxScore: number;
@@ -114,6 +108,11 @@ export const ExecutiveDashboard: React.FC = () => {
queryFn: () => getAllIndicators(),
});
const refetchAll = () => {
refetchDashboard();
queryClient.invalidateQueries();
};
// Filtered projects according to active Programme and Sector dropdown selections
const filteredProjects = useMemo(() => {
return projects.filter((p) => {
@@ -128,30 +127,6 @@ export const ExecutiveDashboard: React.FC = () => {
});
}, [projects, selectedProgramme, selectedSector]);
const { data: projectComplianceMap = new Map<string | number, any[]>() } = useQuery({
queryKey: ['projectComplianceMap', filteredProjects.map((p) => p.id)],
queryFn: async () => {
const map = new Map<string | number, any[]>();
await Promise.all(
filteredProjects.map(async (p) => {
try {
const items = await getProjectComplianceItems(p.id);
map.set(p.id, items);
} catch {
map.set(p.id, []);
}
})
);
return map;
},
enabled: filteredProjects.length > 0,
});
const refetchAll = () => {
refetchDashboard();
queryClient.invalidateQueries();
};
// Filtered risks associated with the filtered project set
const filteredRisks = useMemo(() => {
if (selectedProgramme === 'All' && selectedSector === 'All') {
@@ -214,11 +189,6 @@ export const ExecutiveDashboard: React.FC = () => {
return dashboard?.disbursed || 0;
}, [dashboard, disbursements, filteredProjects, selectedProgramme, selectedSector]);
const disbursedPercentage = useMemo(() => {
if (!portfolioValue || portfolioValue <= 0) return 0;
return Math.min(100, Math.round((disbursed / portfolioValue) * 1000) / 10);
}, [disbursed, portfolioValue]);
const onTrackPercentage = useMemo(() => {
const targetProjects = filteredProjects.length > 0 ? filteredProjects : projects;
if (targetProjects.length === 0) return 0;
@@ -247,34 +217,6 @@ export const ExecutiveDashboard: React.FC = () => {
return dashboard?.atRiskCount ?? 0;
}, [dashboard, filteredRisks]);
// Compliance and Capital at Risk calculations
const totalBudgetAtRisk = useMemo(() => {
const targetProjects = filteredProjects.length > 0 ? filteredProjects : projects;
return targetProjects.reduce((sum, p) => {
const pComps = projectComplianceMap.get(p.id) || [];
const hasUnmet = pComps.some((c) => Number(c.status) === ComplianceStatus.NotMet || Number(c.status) === 1);
const isPendingOrRejected = p.status === ApprovalStatus.Rejected || p.status === ApprovalStatus.Pending;
if (hasUnmet || isPendingOrRejected) {
const pBudgets = budgets.filter((b) => String(b.projectId) === String(p.id));
const pApproved = pBudgets
.filter((b) => Number(b.status) === ApprovalStatus.Approved || b.status === undefined)
.reduce((bSum, b) => bSum + (Number(b.amount) || 0), 0);
return sum + pApproved;
}
return sum;
}, 0);
}, [filteredProjects, projects, projectComplianceMap, budgets]);
const complianceRate = useMemo(() => {
const targetProjects = filteredProjects.length > 0 ? filteredProjects : projects;
if (targetProjects.length === 0) return 100;
const compliantCount = targetProjects.filter((p) => {
const pComps = projectComplianceMap.get(p.id) || [];
return !pComps.some((c) => Number(c.status) === ComplianceStatus.NotMet || Number(c.status) === 1);
}).length;
return Math.round((compliantCount / targetProjects.length) * 100);
}, [filteredProjects, projects, projectComplianceMap]);
const beneficiariesReached = useMemo(() => {
if (dashboard?.beneficiariesReached && dashboard.beneficiariesReached > 0) {
return dashboard.beneficiariesReached;
@@ -346,7 +288,7 @@ export const ExecutiveDashboard: React.FC = () => {
}, [disbursements]);
// Projects requiring management attention based on risk profile
const attentionProjects = useMemo<AttentionProject[]>(() => {
const attentionProjects = useMemo(() => {
const targetProjects = filteredProjects.length > 0 ? filteredProjects : projects;
if (targetProjects.length === 0) return [];
@@ -361,7 +303,7 @@ export const ExecutiveDashboard: React.FC = () => {
});
return targetProjects
.map((p): AttentionProject => {
.map((p) => {
const maxScore = projectMaxRisk[String(p.id)] || 0;
const isRejected = p.status === ApprovalStatus.Rejected;
const isPending = p.status === ApprovalStatus.Pending || p.status === ApprovalStatus.Review;
@@ -383,38 +325,21 @@ export const ExecutiveDashboard: React.FC = () => {
varianceType = 'negative';
}
const pComps = projectComplianceMap.get(p.id) || [];
const unmetCount = pComps.filter(
(c) => Number(c.status) === ComplianceStatus.NotMet || Number(c.status) === 1
).length;
const isCompliant = unmetCount === 0;
const pBudgets = budgets.filter((b) => String(b.projectId) === String(p.id));
const pApprovedBudget = pBudgets
.filter((b) => Number(b.status) === ApprovalStatus.Approved || b.status === undefined)
.reduce((sum, b) => sum + (Number(b.amount) || 0), 0);
const projectBudgetAtRisk = !isCompliant || riskLevel === 'RED' || riskLevel === 'AMBER' ? pApprovedBudget : 0;
return {
id: p.id,
name: p.name || 'Unnamed Project',
name: p.name,
programme: p.programmeName || `Programme ${p.programmeId}`,
status: statusLabel,
risk: riskLevel,
complianceStatus: isCompliant ? 'Compliant' : `Noncompliant (${unmetCount} Unmet)`,
isCompliant,
unmetCount,
budgetAtRisk: projectBudgetAtRisk,
financialVariance: variance,
varianceType,
maxScore,
};
})
.filter((p) => p.risk === 'RED' || p.risk === 'AMBER' || !p.isCompliant)
.sort((a, b) => b.budgetAtRisk - a.budgetAtRisk || b.maxScore - a.maxScore)
.slice(0, 8);
}, [projects, filteredProjects, risks, projectComplianceMap, budgets]);
.filter((p) => p.risk === 'RED' || p.risk === 'AMBER')
.sort((a, b) => b.maxScore - a.maxScore)
.slice(0, 5);
}, [projects, filteredProjects, risks]);
const {
sortedData: sortedAttentionProjects,
@@ -573,31 +498,13 @@ export const ExecutiveDashboard: React.FC = () => {
</div>
</div>
{/* Executive Portfolio KPIs: Structured 2-Tier Balanced Grid */}
<div className="space-y-6">
{/* Tier 1: Capital Commitments & Deployment Scale */}
<div className="space-y-3">
<div className="flex items-center justify-between px-1">
<div className="flex items-center gap-2">
<span className="text-[11px] font-bold uppercase tracking-widest text-slate-400">
Capital Deployment & Scale
</span>
<span className="h-1 w-1 rounded-full bg-slate-600" />
<span className="text-xs text-slate-500 hidden sm:inline">Portfolio commitments, disbursements & capital exposure</span>
</div>
<span className="text-[10px] font-semibold text-blue-400/90 bg-blue-500/10 px-2 py-0.5 rounded-full border border-blue-500/20">
Financial Governance
</span>
</div>
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-4">
{/* 6 Headline Portfolio KPI Cards */}
<div className="grid grid-cols-2 md:grid-cols-3 lg:grid-cols-6 gap-4">
{/* Card 1: Portfolio Value */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-blue-500/40 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm relative overflow-hidden">
<div className="flex items-start justify-between gap-3">
<div className="flex items-center gap-1.5 min-w-0 flex-1">
<span className="text-xs font-semibold uppercase tracking-wider text-slate-400 truncate">
Portfolio Value
</span>
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-blue-500/30 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm">
<div className="flex items-center justify-between text-slate-400">
<div className="flex items-center gap-1.5">
<span className="text-[11px] font-semibold uppercase tracking-wider text-slate-400">Portfolio Value</span>
<HelpTooltip
title="Total Portfolio Value"
content="Aggregated statutory grant commitment amount approved across all active grant awards and contracts."
@@ -605,72 +512,21 @@ export const ExecutiveDashboard: React.FC = () => {
placement="top"
/>
</div>
<div className="shrink-0 p-2 rounded-xl bg-blue-500/10 text-blue-400 border border-blue-500/20 group-hover:scale-105 transition-transform">
<Coins className="w-4 h-4" />
<div className="p-1.5 rounded-lg bg-blue-500/10 text-blue-400 border border-blue-500/20 group-hover:scale-110 transition">
<Coins className="w-3.5 h-3.5" />
</div>
</div>
<div className="mt-3">
<p className="text-2xl sm:text-3xl font-bold text-white tracking-tight">
{formatCompactZAR(portfolioValue)}
</p>
<div className="flex items-center justify-between mt-3 pt-2.5 border-t border-slate-800/70 text-xs">
<span className="text-slate-400 font-mono text-[11px] truncate mr-2" title={formatZAR(portfolioValue)}>
{formatZAR(portfolioValue)}
</span>
<span className="text-[10px] font-medium text-blue-400 bg-blue-500/10 px-1.5 py-0.5 rounded border border-blue-500/20 shrink-0">
Statutory Total
</span>
</div>
<p className="text-2xl font-bold text-white tracking-tight">{formatCompactZAR(portfolioValue)}</p>
<p className="text-[10px] text-slate-400 font-mono mt-1">{formatZAR(portfolioValue)}</p>
</div>
</div>
{/* Card 2: Disbursed */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-teal-500/40 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm relative overflow-hidden">
<div className="flex items-start justify-between gap-3">
<div className="flex items-center gap-1.5 min-w-0 flex-1">
<span className="text-xs font-semibold uppercase tracking-wider text-slate-400 truncate">
Disbursed
</span>
<HelpTooltip
title="Disbursed Funds"
content="Actual funds paid out to implementing grantees following verified milestone proof-of-performance."
size="sm"
placement="top"
/>
</div>
<div className="shrink-0 p-2 rounded-xl bg-teal-500/10 text-teal-400 border border-teal-500/20 group-hover:scale-105 transition-transform">
<TrendingUp className="w-4 h-4" />
</div>
</div>
<div className="mt-3">
<div className="flex items-baseline justify-between gap-2">
<p className="text-2xl sm:text-3xl font-bold text-teal-400 tracking-tight">
{formatCompactZAR(disbursed)}
</p>
<span className="text-xs font-semibold text-teal-400 bg-teal-500/10 px-2 py-0.5 rounded-full border border-teal-500/20 shrink-0 font-mono">
{disbursedPercentage}%
</span>
</div>
<div className="w-full h-1.5 bg-slate-800/90 rounded-full overflow-hidden mt-3">
<div
className="h-full bg-gradient-to-r from-teal-500 to-emerald-400 rounded-full transition-all duration-500"
style={{ width: `${disbursedPercentage}%` }}
/>
</div>
<div className="flex items-center justify-between mt-2.5 pt-2 border-t border-slate-800/70 text-xs text-slate-400">
<span className="text-[11px]">Tranches released</span>
<span className="font-mono text-slate-300 text-[11px]">{disbursedPercentage}% deployed</span>
</div>
</div>
</div>
{/* Card 3: Active Awards */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-indigo-500/40 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm relative overflow-hidden">
<div className="flex items-start justify-between gap-3">
<div className="flex items-center gap-1.5 min-w-0 flex-1">
<span className="text-xs font-semibold uppercase tracking-wider text-slate-400 truncate">
Active Awards
</span>
{/* Card 2: Active Awards */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-blue-500/30 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm">
<div className="flex items-center justify-between text-slate-400">
<div className="flex items-center gap-1.5">
<span className="text-[11px] font-semibold uppercase tracking-wider text-slate-400">Active Awards</span>
<HelpTooltip
title="Active Grant Awards"
content="Total legally executed statutory agreements currently undergoing active disbursement and implementation."
@@ -678,85 +534,47 @@ export const ExecutiveDashboard: React.FC = () => {
placement="top"
/>
</div>
<div className="shrink-0 p-2 rounded-xl bg-indigo-500/10 text-indigo-400 border border-indigo-500/20 group-hover:scale-105 transition-transform">
<Layers className="w-4 h-4" />
<div className="p-1.5 rounded-lg bg-indigo-500/10 text-indigo-400 border border-indigo-500/20 group-hover:scale-110 transition">
<Layers className="w-3.5 h-3.5" />
</div>
</div>
<div className="mt-3">
<p className="text-2xl sm:text-3xl font-bold text-white tracking-tight">
{activeAwards}
<p className="text-2xl font-bold text-white tracking-tight">{activeAwards}</p>
<p className="text-[10px] text-emerald-400 font-mono mt-1">
Across {portfolios.length} portfolio{portfolios.length === 1 ? '' : 's'}
</p>
<div className="flex items-center justify-between mt-3 pt-2.5 border-t border-slate-800/70 text-xs">
<span className="text-slate-400 text-[11px]">Under implementation</span>
<span className="font-medium text-indigo-400 bg-indigo-500/10 px-1.5 py-0.5 rounded border border-indigo-500/20 shrink-0 text-[10px]">
{portfolios.length} Portfolio{portfolios.length === 1 ? '' : 's'}
</span>
</div>
</div>
</div>
{/* Card 4: Budget At Risk */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-rose-500/40 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm relative overflow-hidden">
<div className="flex items-start justify-between gap-3">
<div className="flex items-center gap-1.5 min-w-0 flex-1">
<span className="text-xs font-semibold uppercase tracking-wider text-slate-400 truncate">
Budget At Risk
</span>
{/* Card 3: Disbursed */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-teal-500/30 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm">
<div className="flex items-center justify-between text-slate-400">
<div className="flex items-center gap-1.5">
<span className="text-[11px] font-semibold uppercase tracking-wider text-slate-400">Disbursed</span>
<HelpTooltip
title="Total Budgeted Capital At Risk"
content="Aggregated approved budget across all projects currently flagged as noncompliant or carrying unmitigated high risks."
title="Disbursed Funds"
content="Actual funds paid out to implementing grantees following verified milestone proof-of-performance."
size="sm"
placement="top"
/>
</div>
<div className="shrink-0 p-2 rounded-xl bg-rose-500/10 text-rose-400 border border-rose-500/20 group-hover:scale-105 transition-transform">
<ShieldAlert className="w-4 h-4" />
<div className="p-1.5 rounded-lg bg-teal-500/10 text-teal-400 border border-teal-500/20 group-hover:scale-110 transition">
<TrendingUp className="w-3.5 h-3.5" />
</div>
</div>
<div className="mt-3">
<p className="text-2xl sm:text-3xl font-bold text-rose-400 tracking-tight">
{formatCompactZAR(totalBudgetAtRisk)}
<p className="text-2xl font-bold text-teal-400 tracking-tight">{formatCompactZAR(disbursed)}</p>
<p className="text-[10px] text-slate-400 font-mono mt-1">
{portfolioValue > 0 ? `${((disbursed / portfolioValue) * 100).toFixed(1)}% of commitments` : '0.0% of commitments'}
</p>
<div className="flex items-center justify-between mt-3 pt-2.5 border-t border-slate-800/70 text-xs">
<span className="text-slate-400 font-mono text-[11px] truncate mr-2" title={formatZAR(totalBudgetAtRisk)}>
{formatZAR(totalBudgetAtRisk)}
</span>
<span className={`text-[10px] font-medium px-1.5 py-0.5 rounded border shrink-0 ${
totalBudgetAtRisk > 0
? 'text-rose-400 bg-rose-500/10 border-rose-500/20'
: 'text-emerald-400 bg-emerald-500/10 border-emerald-500/20'
}`}>
{totalBudgetAtRisk > 0 ? 'Exposed' : 'Clear'}
</span>
</div>
</div>
</div>
</div>
</div>
{/* Tier 2: Operational Health, Risk & Beneficiary Impact */}
<div className="space-y-3">
<div className="flex items-center justify-between px-1">
<div className="flex items-center gap-2">
<span className="text-[11px] font-bold uppercase tracking-widest text-slate-400">
Operational Performance & Impact
</span>
<span className="h-1 w-1 rounded-full bg-slate-600" />
<span className="text-xs text-slate-500 hidden sm:inline">Milestone pace, compliance gate health & direct beneficiaries</span>
</div>
<span className="text-[10px] font-semibold text-emerald-400/90 bg-emerald-500/10 px-2 py-0.5 rounded-full border border-emerald-500/20">
Delivery Health
</span>
</div>
<div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-4">
{/* Card 5: On Track */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-emerald-500/40 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm relative overflow-hidden">
<div className="flex items-start justify-between gap-3">
<div className="flex items-center gap-1.5 min-w-0 flex-1">
<span className="text-xs font-semibold uppercase tracking-wider text-slate-400 truncate">
On Track
</span>
{/* Card 4: On Track */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-emerald-500/30 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm">
<div className="flex items-center justify-between text-slate-400">
<div className="flex items-center gap-1.5">
<span className="text-[11px] font-semibold uppercase tracking-wider text-slate-400">On Track</span>
<HelpTooltip
title="On-Track Progress Ratio"
content="Percentage of active projects meeting schedule deadlines and deliverable acceptance criteria without critical deviations."
@@ -764,79 +582,21 @@ export const ExecutiveDashboard: React.FC = () => {
placement="top"
/>
</div>
<div className="shrink-0 p-2 rounded-xl bg-emerald-500/10 text-emerald-400 border border-emerald-500/20 group-hover:scale-105 transition-transform">
<CheckCircle className="w-4 h-4" />
<div className="p-1.5 rounded-lg bg-emerald-500/10 text-emerald-400 border border-emerald-500/20 group-hover:scale-110 transition">
<CheckCircle className="w-3.5 h-3.5" />
</div>
</div>
<div className="mt-3">
<div className="flex items-baseline justify-between gap-2">
<p className="text-2xl sm:text-3xl font-bold text-emerald-400 tracking-tight">
{onTrackPercentage}%
</p>
<span className="text-xs font-semibold text-emerald-400 bg-emerald-500/10 px-2 py-0.5 rounded-full border border-emerald-500/20 shrink-0 font-mono">
{onTrackPercentage >= 80 ? 'Optimal' : onTrackPercentage >= 60 ? 'Moderate' : 'Critical'}
</span>
</div>
<div className="w-full h-1.5 bg-slate-800/90 rounded-full overflow-hidden mt-3">
<div
className="h-full bg-gradient-to-r from-emerald-500 to-teal-400 rounded-full transition-all duration-500"
style={{ width: `${Math.min(100, onTrackPercentage)}%` }}
/>
</div>
<div className="flex items-center justify-between mt-2.5 pt-2 border-t border-slate-800/70 text-xs text-slate-400">
<span className="text-[11px]">Milestones verified</span>
<span className="font-mono text-slate-300 text-[11px]">Pace index</span>
</div>
<p className="text-2xl font-bold text-emerald-400 tracking-tight">{onTrackPercentage}%</p>
<p className="text-[10px] text-slate-400 font-mono mt-1">Milestones verified</p>
</div>
</div>
{/* Card 6: Compliance Health */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-emerald-500/40 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm relative overflow-hidden">
<div className="flex items-start justify-between gap-3">
<div className="flex items-center gap-1.5 min-w-0 flex-1">
<span className="text-xs font-semibold uppercase tracking-wider text-slate-400 truncate">
Compliance
</span>
<HelpTooltip
title="Portfolio Compliance Health"
content="Percentage of active projects meeting 100% statutory compliance and beneficiary outcome criteria."
size="sm"
placement="top"
/>
</div>
<div className="shrink-0 p-2 rounded-xl bg-emerald-500/10 text-emerald-400 border border-emerald-500/20 group-hover:scale-105 transition-transform">
<ShieldCheck className="w-4 h-4" />
</div>
</div>
<div className="mt-3">
<div className="flex items-baseline justify-between gap-2">
<p className="text-2xl sm:text-3xl font-bold text-emerald-400 tracking-tight">
{complianceRate}%
</p>
<span className="text-xs font-semibold text-emerald-400 bg-emerald-500/10 px-2 py-0.5 rounded-full border border-emerald-500/20 shrink-0 font-mono">
{complianceRate >= 90 ? 'Passed' : 'Gated'}
</span>
</div>
<div className="w-full h-1.5 bg-slate-800/90 rounded-full overflow-hidden mt-3">
<div
className="h-full bg-gradient-to-r from-emerald-500 to-cyan-400 rounded-full transition-all duration-500"
style={{ width: `${Math.min(100, complianceRate)}%` }}
/>
</div>
<div className="flex items-center justify-between mt-2.5 pt-2 border-t border-slate-800/70 text-xs text-slate-400">
<span className="text-[11px]">Statutory gate check</span>
<span className="font-mono text-slate-300 text-[11px]">100% requirement</span>
</div>
</div>
</div>
{/* Card 7: At Risk */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-amber-500/40 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm relative overflow-hidden">
<div className="flex items-start justify-between gap-3">
<div className="flex items-center gap-1.5 min-w-0 flex-1">
<span className="text-xs font-semibold uppercase tracking-wider text-slate-400 truncate">
At Risk
</span>
{/* Card 5: At Risk */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-amber-500/30 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm">
<div className="flex items-center justify-between text-slate-400">
<div className="flex items-center gap-1.5">
<span className="text-[11px] font-semibold uppercase tracking-wider text-slate-400">At Risk</span>
<HelpTooltip
title="At-Risk Projects"
content="Count of projects with high residual risk scores (≥12), schedule slippage >30 days, or adverse financial variance."
@@ -844,34 +604,21 @@ export const ExecutiveDashboard: React.FC = () => {
placement="top"
/>
</div>
<div className="shrink-0 p-2 rounded-xl bg-amber-500/10 text-amber-400 border border-amber-500/20 group-hover:scale-105 transition-transform">
<AlertTriangle className="w-4 h-4" />
<div className="p-1.5 rounded-lg bg-amber-500/10 text-amber-400 border border-amber-500/20 group-hover:scale-110 transition">
<AlertTriangle className="w-3.5 h-3.5" />
</div>
</div>
<div className="mt-3">
<p className="text-2xl sm:text-3xl font-bold text-amber-400 tracking-tight">
{atRiskCount}
</p>
<div className="flex items-center justify-between mt-3 pt-2.5 border-t border-slate-800/70 text-xs">
<span className="text-slate-400 text-[11px]">{atRiskCount === 1 ? 'Project flagged' : 'Projects flagged'}</span>
<span className={`text-[10px] font-medium px-1.5 py-0.5 rounded border shrink-0 ${
atRiskCount > 0
? 'text-amber-400 bg-amber-500/10 border-amber-500/20'
: 'text-emerald-400 bg-emerald-500/10 border-emerald-500/20'
}`}>
{atRiskCount > 0 ? 'Requires PM Action' : 'Nominal'}
</span>
</div>
<p className="text-2xl font-bold text-amber-400 tracking-tight">{atRiskCount}</p>
<p className="text-[10px] text-rose-400 font-mono mt-1">Requires PM action</p>
</div>
</div>
{/* Card 8: Beneficiaries Reached */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-purple-500/40 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm relative overflow-hidden">
<div className="flex items-start justify-between gap-3">
<div className="flex items-center gap-1.5 min-w-0 flex-1">
<span className="text-xs font-semibold uppercase tracking-wider text-slate-400 truncate">
Beneficiaries
</span>
{/* Card 6: Beneficiaries Reached */}
<div className="bg-[#0f1523]/80 p-5 rounded-2xl border border-slate-800/80 hover:border-indigo-500/30 transition-all flex flex-col justify-between shadow-md group backdrop-blur-sm">
<div className="flex items-center justify-between text-slate-400">
<div className="flex items-center gap-1.5">
<span className="text-[11px] font-semibold uppercase tracking-wider text-slate-400">Beneficiaries</span>
<HelpTooltip
title="Beneficiaries Impacted"
content="Cumulative count of direct beneficiaries reached through projects, verified against national M&E indicator targets."
@@ -879,22 +626,15 @@ export const ExecutiveDashboard: React.FC = () => {
placement="top"
/>
</div>
<div className="shrink-0 p-2 rounded-xl bg-purple-500/10 text-purple-400 border border-purple-500/20 group-hover:scale-105 transition-transform">
<Users className="w-4 h-4" />
<div className="p-1.5 rounded-lg bg-indigo-500/10 text-indigo-400 border border-indigo-500/20 group-hover:scale-110 transition">
<Users className="w-3.5 h-3.5" />
</div>
</div>
<div className="mt-3">
<p className="text-2xl sm:text-3xl font-bold text-white tracking-tight">
{beneficiariesReached >= 1000 ? `${(beneficiariesReached / 1000).toFixed(1)}k` : beneficiariesReached}
<p className="text-2xl font-bold text-white tracking-tight">
{beneficiariesReached >= 1000 ? `${(beneficiariesReached / 1000).toFixed(0)}k` : beneficiariesReached}
</p>
<div className="flex items-center justify-between mt-3 pt-2.5 border-t border-slate-800/70 text-xs">
<span className="text-slate-400 text-[11px]">Directly impacted</span>
<span className="text-[10px] font-medium text-purple-400 bg-purple-500/10 px-1.5 py-0.5 rounded border border-purple-500/20 shrink-0">
M&E Verified
</span>
</div>
</div>
</div>
<p className="text-[10px] text-slate-400 font-mono mt-1">Directly impacted</p>
</div>
</div>
</div>
@@ -1034,7 +774,7 @@ export const ExecutiveDashboard: React.FC = () => {
<div className="p-5 border-b border-slate-800/80 flex flex-col sm:flex-row sm:items-center justify-between gap-2 bg-[#0d121f]/90">
<div>
<div className="flex items-center gap-2">
<h3 className="text-base font-semibold text-white">Projects Flagged At Risk & Noncompliant</h3>
<h3 className="text-base font-semibold text-white">Projects Requiring Attention</h3>
<HelpTooltip
title="Exception Escalations"
content="Identifies projects breaching risk thresholds, schedule deadlines, or financial variances (>10%) requiring executive steering committee action."
@@ -1067,14 +807,11 @@ export const ExecutiveDashboard: React.FC = () => {
<SortableTh column="status" currentColumn={projectSortCol} direction={projectSortDir} onSort={handleProjectSort} className="py-3.5 px-4">
Status
</SortableTh>
<SortableTh column="complianceStatus" currentColumn={projectSortCol} direction={projectSortDir} onSort={handleProjectSort} className="py-3.5 px-4">
Compliance
</SortableTh>
<SortableTh column="risk" currentColumn={projectSortCol} direction={projectSortDir} onSort={handleProjectSort} align="center" className="py-3.5 px-4 text-center">
Risk
</SortableTh>
<SortableTh column="budgetAtRisk" currentColumn={projectSortCol} direction={projectSortDir} onSort={handleProjectSort} align="right" className="py-3.5 px-4 text-right">
Budget At Risk
<SortableTh column="financialVariance" currentColumn={projectSortCol} direction={projectSortDir} onSort={handleProjectSort} align="right" className="py-3.5 px-4 text-right">
Financial Variance
</SortableTh>
<th className="py-3.5 px-5 text-right font-medium">Action</th>
</tr>
@@ -1082,7 +819,7 @@ export const ExecutiveDashboard: React.FC = () => {
<tbody className="divide-y divide-slate-800/60">
{sortedAttentionProjects.length === 0 ? (
<tr>
<td colSpan={7} className="py-8 text-center text-xs text-slate-500">
<td colSpan={6} className="py-8 text-center text-xs text-slate-500">
No active projects currently flagged for executive attention. All projects are operating within target thresholds.
</td>
</tr>
@@ -1107,19 +844,6 @@ export const ExecutiveDashboard: React.FC = () => {
{p.status}
</span>
</td>
<td className="py-3.5 px-4">
{p.isCompliant ? (
<span className="inline-flex items-center gap-1 px-2.5 py-0.5 rounded-full text-[10px] font-semibold bg-emerald-500/10 text-emerald-400 border border-emerald-500/30">
<CheckCircle className="w-3 h-3 text-emerald-400" />
<span>Compliant</span>
</span>
) : (
<span className="inline-flex items-center gap-1 px-2.5 py-0.5 rounded-full text-[10px] font-semibold bg-rose-500/10 text-rose-400 border border-rose-500/30">
<AlertTriangle className="w-3 h-3 text-rose-400" />
<span>Noncompliant ({p.unmetCount} Unmet)</span>
</span>
)}
</td>
<td className="py-3.5 px-4 text-center">
<span
className={`inline-flex items-center justify-center font-bold px-2.5 py-0.5 rounded-md text-[10px] shadow-xs ${
@@ -1133,9 +857,13 @@ export const ExecutiveDashboard: React.FC = () => {
{p.risk}
</span>
</td>
<td className="py-3.5 px-4 text-right font-mono font-bold text-xs">
<span className={p.budgetAtRisk > 0 ? 'text-rose-400' : 'text-emerald-400'}>
{formatZAR(p.budgetAtRisk)}
<td className="py-3.5 px-4 text-right">
<span
className={`font-mono font-bold text-xs ${
p.varianceType === 'negative' ? 'text-rose-400' : 'text-emerald-400'
}`}
>
{p.financialVariance}
</span>
</td>
<td className="py-3.5 px-5 text-right">
@@ -60,7 +60,6 @@ import {
assignUserRole,
getSystemRoles,
getCurrentUserTenantId,
notifyNewUserCreated,
} from '../services/api';
import { Modal } from '../components/ui/Modal';
import { HelpTooltip } from '../components/ui/HelpTooltip';
@@ -252,7 +251,7 @@ export const GovernancePage: React.FC = () => {
const assignableRolesForOrg = React.useMemo(() => {
return systemRoles.filter(
(r) => (r.name || r.Name || '').toLowerCase() !== 'admin' && (r.id || r.Id) !== '1'
(r) => r.name.toLowerCase() !== 'admin' && r.id !== '1'
);
}, [systemRoles]);
@@ -275,9 +274,9 @@ export const GovernancePage: React.FC = () => {
React.useEffect(() => {
if (!quickUserRoleId && assignableRolesForOrg.length > 0) {
const execRole = assignableRolesForOrg.find((r) => (r.name || r.Name || '').toLowerCase() === 'executive');
if (execRole) setQuickUserRoleId(execRole.id || execRole.Id || '');
else setQuickUserRoleId(assignableRolesForOrg[0].id || assignableRolesForOrg[0].Id || '');
const execRole = assignableRolesForOrg.find((r) => r.name.toLowerCase() === 'executive');
if (execRole) setQuickUserRoleId(execRole.id);
else setQuickUserRoleId(assignableRolesForOrg[0].id);
}
}, [assignableRolesForOrg, quickUserRoleId]);
@@ -335,19 +334,6 @@ export const GovernancePage: React.FC = () => {
orgForm.setValue('organisationUser', createdUser.id, { shouldValidate: true });
}
// RULE 3: Notify created Executive/Manager user via InApp and Email (directs to Console)
if (createdUser) {
await notifyNewUserCreated({
userId: createdUser.id,
email: quickUserEmail,
isPartner: false,
roleName: 'Executive',
tenantId,
}).catch(console.warn);
queryClient.invalidateQueries({ queryKey: ['inapp-notifications'] });
queryClient.invalidateQueries({ queryKey: ['notifications'] });
}
success('Executive User Created', `User ${quickUserEmail} successfully created and linked.`);
setQuickUserEmail('');
setQuickUserName('');
@@ -658,7 +644,7 @@ export const GovernancePage: React.FC = () => {
programmeId: editingProgramme.id,
name: data.name,
portfolioId: Number(data.portfolioId),
status: (data.status !== undefined ? Number(data.status) : 1) as ApprovalStatus,
status: data.status !== undefined ? Number(data.status) : undefined,
ownerId: resolvedOwnerId,
});
}
@@ -875,7 +861,7 @@ export const GovernancePage: React.FC = () => {
key: 'portfolioId',
format: (val) => {
const port = portfolios.find((p) => String(p.id) === String(val));
return port && port.name ? port.name : `Portfolio #${val}`;
return port ? port.name : `Portfolio #${val}`;
},
},
{ header: 'Governance Status', key: 'status', format: (val) => getApprovalStatusBadge(val).label },
@@ -1267,8 +1253,8 @@ export const GovernancePage: React.FC = () => {
<div className="mt-4 pt-3 border-t border-slate-800/80 space-y-2.5">
<div className="flex items-center justify-between text-xs text-slate-400">
<span className="truncate max-w-[200px] font-medium text-slate-300" title={org && org.name ? org.name : `Org #${p.organisationId}`}>
{org && org.name ? org.name : `Org #${p.organisationId}`}
<span className="truncate max-w-[200px] font-medium text-slate-300" title={org ? org.name : `Org #${p.organisationId}`}>
{org ? org.name : `Org #${p.organisationId}`}
</span>
<span className="font-mono text-[11px] text-slate-500 shrink-0">{formatDate(p.createdAt)}</span>
</div>
@@ -1,978 +0,0 @@
import React, { useState, useEffect, useMemo } from 'react';
import { useSearchParams } from 'react-router-dom';
import { useQuery } from '@tanstack/react-query';
import {
Inbox,
Send,
FileText,
Star,
Trash2,
Mail,
MailOpen,
Search,
PenSquare,
RefreshCw,
Reply,
CheckCircle2,
Clock,
RotateCcw,
X,
Smartphone,
ShieldAlert,
} from 'lucide-react';
import { useInAppNotifications, DraftMessage } from '../hooks/useInAppNotifications';
import { ComposeMessageModal } from '../components/notifications/ComposeMessageModal';
import { MarkdownViewer } from '../components/notifications/MarkdownViewer';
import { formatDate } from '../lib/formatters';
import { Notification, NotificationPlatform, NotificationStatus, User } from '../types';
import { useAuth } from '../auth/AuthProvider';
import { stripMarkdown } from '../lib/markdownUtils';
import { getUsers } from '../services/api';
type MailboxFolder = 'inbox' | 'starred' | 'sent' | 'drafts' | 'trash';
export const InboxPage: React.FC = () => {
const [searchParams, setSearchParams] = useSearchParams();
const targetIdParam = searchParams.get('id');
const { user, claims } = useAuth();
const currentUserId = String(user?.id || claims?.sub || '').trim().toLowerCase();
const currentUserEmail = (user?.email || claims?.email || '') as string;
const { data: directoryUsers = [] } = useQuery<User[]>({
queryKey: ['users-directory'],
queryFn: () => getUsers(1, 200),
staleTime: 5 * 60 * 1000,
});
const {
allMailboxNotifications,
inboxNotifications,
unreadCount,
starredNotifications,
trashedNotifications,
sentNotifications,
drafts,
starredIds,
isLoading,
refetch,
markAsRead,
toggleStar,
deleteMessage,
restoreMessage,
permanentDelete,
deleteDraft,
sendMessage,
isSending,
} = useInAppNotifications();
// Active folder
const [activeFolder, setActiveFolder] = useState<MailboxFolder>('inbox');
// Search query
const [searchTerm, setSearchTerm] = useState('');
// Filter for unread only in Inbox
const [showUnreadOnly, setShowUnreadOnly] = useState(false);
// Selected message to view in detail
const [selectedMessage, setSelectedMessage] = useState<Notification | null>(null);
// Selected draft to edit/resume
const [selectedDraft, setSelectedDraft] = useState<DraftMessage | null>(null);
// Compose modal state
const [isComposeOpen, setIsComposeOpen] = useState(false);
const [composeInitialRecipient, setComposeInitialRecipient] = useState<any>(undefined);
const [composeInitialSubject, setComposeInitialSubject] = useState('');
const [composeInitialMessage, setComposeInitialMessage] = useState('');
const [composeInitialPlatform, setComposeInitialPlatform] = useState<NotificationPlatform>(NotificationPlatform.InApp);
// Inline quick reply state
const [inlineReplyText, setInlineReplyText] = useState('');
const [inlineReplySuccess, setInlineReplySuccess] = useState(false);
// Self-reply prevention modal state
const [isSelfReplyModalOpen, setIsSelfReplyModalOpen] = useState(false);
// Active folder message items (always In-App notifications)
const folderMessages = useMemo(() => {
switch (activeFolder) {
case 'inbox':
return inboxNotifications;
case 'starred':
return starredNotifications;
case 'sent':
return sentNotifications;
case 'trash':
return trashedNotifications;
case 'drafts':
return [];
default:
return inboxNotifications;
}
}, [activeFolder, inboxNotifications, starredNotifications, sentNotifications, trashedNotifications]);
// Filtered by search and unread toggle
const filteredMessages = useMemo(() => {
return folderMessages.filter(item => {
// Unread only filter
if (activeFolder === 'inbox' && showUnreadOnly) {
if (Number(item.status) === NotificationStatus.Read) return false;
}
// Search term
if (!searchTerm.trim()) return true;
const term = searchTerm.toLowerCase();
const subject = (item.subject || '').toLowerCase();
const message = (item.message || '').toLowerCase();
const dest = (item.destination || '').toLowerCase();
return subject.includes(term) || message.includes(term) || dest.includes(term);
});
}, [folderMessages, activeFolder, showUnreadOnly, searchTerm]);
// Filtered drafts for Drafts folder
const filteredDrafts = useMemo(() => {
if (activeFolder !== 'drafts') return [];
if (!searchTerm.trim()) return drafts;
const term = searchTerm.toLowerCase();
return drafts.filter(
d =>
d.subject.toLowerCase().includes(term) ||
d.message.toLowerCase().includes(term) ||
d.recipientEmail.toLowerCase().includes(term)
);
}, [drafts, activeFolder, searchTerm]);
// Automatically select message when URL param ?id=... is present
useEffect(() => {
if (targetIdParam) {
const found = folderMessages.find(m => String(m.id) === targetIdParam);
if (found) {
setSelectedMessage(found);
if (Number(found.status) !== NotificationStatus.Read) {
markAsRead(found.id);
}
}
} else if (!selectedMessage && folderMessages.length > 0 && activeFolder !== 'drafts') {
setSelectedMessage(folderMessages[0]);
}
}, [targetIdParam, folderMessages, activeFolder]);
// Handle message selection
const handleSelectMessage = (item: Notification) => {
setSelectedMessage(item);
setSearchParams({ id: String(item.id) });
if (Number(item.status) !== NotificationStatus.Read) {
markAsRead(item.id);
}
setInlineReplyText('');
setInlineReplySuccess(false);
};
// Open Compose Modal for a new message
const handleOpenCompose = (defaultPlatform: NotificationPlatform = NotificationPlatform.InApp) => {
setSelectedDraft(null);
setComposeInitialRecipient(undefined);
setComposeInitialSubject('');
setComposeInitialMessage('');
setComposeInitialPlatform(defaultPlatform);
setIsComposeOpen(true);
};
const extractSenderEmail = (msg: Notification): string => {
const rawDest = msg.destination || '';
if (rawDest.includes('From:')) {
const fromPart = rawDest.split('From:')[1]?.split('|')[0]?.trim() || '';
return fromPart.replace(/[<>]/g, '').trim();
}
if (!rawDest.includes('To:') && rawDest.includes('@')) {
return rawDest.trim();
}
return '';
};
const isNotificationFromSelf = (msg: Notification): boolean => {
if (activeFolder === 'sent' || String(msg.id).startsWith('sent_')) {
return true;
}
const senderEmail = extractSenderEmail(msg).toLowerCase();
const myEmail = currentUserEmail.trim().toLowerCase();
if (myEmail && senderEmail && senderEmail === myEmail) {
return true;
}
if (!senderEmail && String(msg.recipient || '').trim().toLowerCase() === currentUserId) {
return true;
}
return false;
};
// Open Compose Modal for a Reply
const handleReplyMessage = (msg: Notification) => {
if (isNotificationFromSelf(msg)) {
setIsSelfReplyModalOpen(true);
return;
}
const replyEmail = extractSenderEmail(msg);
const matchedSender = replyEmail
? directoryUsers.find(u => (u.email || '').trim().toLowerCase() === replyEmail.toLowerCase())
: undefined;
if (
(matchedSender && String(matchedSender.id).trim().toLowerCase() === currentUserId) ||
(replyEmail && replyEmail.toLowerCase() === currentUserEmail.trim().toLowerCase())
) {
setIsSelfReplyModalOpen(true);
return;
}
const replySubject = msg.subject?.startsWith('Re:') ? msg.subject : `Re: ${msg.subject || 'Communication'}`;
const quotedBody = `\n\n--- Original Message (${formatDate(msg.createdAt)}) ---\n> ${stripMarkdown(msg.message || '')}`;
setSelectedDraft(null);
setComposeInitialRecipient(
replyEmail && matchedSender
? {
id: String(matchedSender.id),
email: replyEmail,
name: replyEmail.split('@')[0],
}
: undefined
);
setComposeInitialSubject(replySubject);
setComposeInitialMessage(quotedBody);
setComposeInitialPlatform(msg.platform as NotificationPlatform || NotificationPlatform.InApp);
setIsComposeOpen(true);
};
// Resume editing a saved draft
const handleEditDraft = (draft: DraftMessage) => {
setSelectedDraft(draft);
setComposeInitialRecipient(
draft.recipientId
? {
id: draft.recipientId,
email: draft.recipientEmail,
name: draft.recipientName,
}
: undefined
);
setComposeInitialSubject(draft.subject);
setComposeInitialMessage(draft.message);
setComposeInitialPlatform(draft.platform || NotificationPlatform.InApp);
setIsComposeOpen(true);
};
// Send inline quick reply
const handleSendInlineReply = async () => {
if (!selectedMessage || !inlineReplyText.trim()) return;
if (isNotificationFromSelf(selectedMessage)) {
setIsSelfReplyModalOpen(true);
return;
}
const replyEmail = extractSenderEmail(selectedMessage);
const matchedSender = replyEmail
? directoryUsers.find(u => (u.email || '').trim().toLowerCase() === replyEmail.toLowerCase())
: undefined;
const targetRecipientId = matchedSender ? String(matchedSender.id) : String(selectedMessage.recipient);
if (
targetRecipientId.trim().toLowerCase() === currentUserId ||
(replyEmail && replyEmail.toLowerCase() === currentUserEmail.trim().toLowerCase())
) {
setIsSelfReplyModalOpen(true);
return;
}
try {
await sendMessage({
recipientId: targetRecipientId,
recipientEmail: replyEmail || 'team@dsi.gov.za',
subject: selectedMessage.subject?.startsWith('Re:')
? selectedMessage.subject
: `Re: ${selectedMessage.subject || 'Notification'}`,
message: inlineReplyText.trim(),
platform: selectedMessage.platform as NotificationPlatform || NotificationPlatform.InApp,
});
setInlineReplySuccess(true);
setInlineReplyText('');
setTimeout(() => {
setInlineReplySuccess(false);
}, 3000);
} catch (err) {
console.error('Failed to send inline reply:', err);
}
};
return (
<div className="flex-1 flex flex-col h-full bg-[#090d16] text-slate-100 overflow-hidden font-sans">
{/* Top Mailbox Breadcrumb & Action Banner */}
<div className="h-14 px-6 border-b border-slate-800/80 bg-[#0d121f]/90 backdrop-blur-md flex items-center justify-between shrink-0">
<div className="flex items-center gap-3">
<div className="w-8 h-8 rounded-xl bg-blue-600/20 border border-blue-500/30 flex items-center justify-center text-blue-400">
<Mail className="w-4 h-4" />
</div>
<div>
<div className="flex items-center gap-2">
<h1 className="text-sm font-bold text-white tracking-tight">Mailbox & Communications</h1>
<span className="text-[10px] font-semibold text-blue-300 bg-blue-500/10 border border-blue-500/30 px-2 py-0.5 rounded-full flex items-center gap-1">
In-App Messaging
</span>
</div>
<p className="text-[11px] text-slate-400">
In-App notifications and internal platform communications
</p>
</div>
</div>
<div className="flex items-center gap-2">
<button
type="button"
onClick={() => refetch()}
className="flex items-center gap-1.5 px-3 py-1.5 rounded-xl bg-slate-900/80 hover:bg-slate-800 border border-slate-700/80 text-xs font-medium text-slate-300 hover:text-white transition cursor-pointer shadow-xs"
title="Refresh mailbox messages"
>
<RefreshCw className={`w-3.5 h-3.5 ${isLoading ? 'animate-spin text-blue-400' : ''}`} />
<span>Refresh</span>
</button>
<button
type="button"
onClick={() => handleOpenCompose()}
id="compose-message-main-btn"
className="flex items-center gap-2 px-4 py-1.5 rounded-xl bg-blue-600 hover:bg-blue-500 text-white text-xs font-semibold shadow-lg shadow-blue-600/30 transition cursor-pointer"
>
<PenSquare className="w-3.5 h-3.5" />
<span>Compose</span>
</button>
</div>
</div>
{/* Main Mailbox Three-Pane Layout */}
<div className="flex-1 flex overflow-hidden">
{/* ======================================================== */}
{/* PANE 1: Mailbox Folders Sidebar */}
{/* ======================================================== */}
<aside className="w-60 shrink-0 border-r border-slate-800/80 bg-[#0b101b]/95 p-3 flex flex-col justify-between">
<div className="space-y-4">
{/* Primary Compose Action */}
<button
type="button"
onClick={() => handleOpenCompose()}
className="w-full flex items-center justify-center gap-2 py-2.5 px-4 rounded-2xl bg-gradient-to-r from-blue-600 to-indigo-600 hover:from-blue-500 hover:to-indigo-500 text-white text-xs font-bold shadow-lg shadow-blue-600/25 transition cursor-pointer"
>
<PenSquare className="w-4 h-4" />
<span>New Message</span>
</button>
{/* Folder Navigation */}
<nav className="space-y-1">
{/* Inbox */}
<button
type="button"
onClick={() => {
setActiveFolder('inbox');
setSelectedDraft(null);
}}
className={`w-full flex items-center justify-between px-3 py-2 rounded-xl text-xs font-medium transition cursor-pointer ${
activeFolder === 'inbox'
? 'bg-blue-600/20 text-white border border-blue-500/30'
: 'text-slate-300 hover:text-white hover:bg-slate-800/60'
}`}
>
<div className="flex items-center gap-2.5">
<Inbox className="w-4 h-4 text-blue-400" />
<span>Inbox</span>
</div>
{unreadCount > 0 ? (
<span className="text-[10px] font-bold text-white bg-blue-600 px-2 py-0.5 rounded-full shadow-xs">
{unreadCount}
</span>
) : (
<span className="text-[11px] text-slate-400 font-mono">
{allMailboxNotifications.length}
</span>
)}
</button>
{/* Starred */}
<button
type="button"
onClick={() => {
setActiveFolder('starred');
setSelectedDraft(null);
}}
className={`w-full flex items-center justify-between px-3 py-2 rounded-xl text-xs font-medium transition cursor-pointer ${
activeFolder === 'starred'
? 'bg-amber-500/20 text-white border border-amber-500/30'
: 'text-slate-300 hover:text-white hover:bg-slate-800/60'
}`}
>
<div className="flex items-center gap-2.5">
<Star className="w-4 h-4 text-amber-400" />
<span>Starred</span>
</div>
<span className="text-[11px] text-slate-400 font-mono">
{starredNotifications.length}
</span>
</button>
{/* Sent */}
<button
type="button"
onClick={() => {
setActiveFolder('sent');
setSelectedDraft(null);
}}
className={`w-full flex items-center justify-between px-3 py-2 rounded-xl text-xs font-medium transition cursor-pointer ${
activeFolder === 'sent'
? 'bg-indigo-600/20 text-white border border-indigo-500/30'
: 'text-slate-300 hover:text-white hover:bg-slate-800/60'
}`}
>
<div className="flex items-center gap-2.5">
<Send className="w-4 h-4 text-indigo-400" />
<span>Sent</span>
</div>
<span className="text-[11px] text-slate-400 font-mono">
{sentNotifications.length}
</span>
</button>
{/* Drafts */}
<button
type="button"
onClick={() => {
setActiveFolder('drafts');
setSelectedMessage(null);
}}
className={`w-full flex items-center justify-between px-3 py-2 rounded-xl text-xs font-medium transition cursor-pointer ${
activeFolder === 'drafts'
? 'bg-purple-600/20 text-white border border-purple-500/30'
: 'text-slate-300 hover:text-white hover:bg-slate-800/60'
}`}
>
<div className="flex items-center gap-2.5">
<FileText className="w-4 h-4 text-purple-400" />
<span>Drafts</span>
</div>
{drafts.length > 0 ? (
<span className="text-[10px] font-bold text-purple-300 bg-purple-500/20 border border-purple-500/30 px-2 py-0.5 rounded-full">
{drafts.length}
</span>
) : (
<span className="text-[11px] text-slate-400 font-mono">
0
</span>
)}
</button>
{/* Trash */}
<button
type="button"
onClick={() => {
setActiveFolder('trash');
setSelectedDraft(null);
}}
className={`w-full flex items-center justify-between px-3 py-2 rounded-xl text-xs font-medium transition cursor-pointer ${
activeFolder === 'trash'
? 'bg-rose-600/20 text-white border border-rose-500/30'
: 'text-slate-300 hover:text-white hover:bg-slate-800/60'
}`}
>
<div className="flex items-center gap-2.5">
<Trash2 className="w-4 h-4 text-rose-400" />
<span>Trash</span>
</div>
<span className="text-[11px] text-slate-400 font-mono">
{trashedNotifications.length}
</span>
</button>
</nav>
{/* Quick Filter: Unread Toggle */}
{activeFolder === 'inbox' && (
<div className="pt-2 border-t border-slate-800/80">
<label className="flex items-center gap-2 px-2.5 py-1.5 rounded-xl hover:bg-slate-800/50 cursor-pointer text-xs text-slate-300">
<input
type="checkbox"
checked={showUnreadOnly}
onChange={e => setShowUnreadOnly(e.target.checked)}
className="rounded border-slate-700 bg-slate-900 text-blue-600 focus:ring-blue-500"
/>
<span>Unread only</span>
</label>
</div>
)}
</div>
{/* Sidebar Footer Branding */}
<div className="p-3 rounded-2xl bg-slate-900/40 border border-slate-800/60 space-y-1 text-[11px] text-slate-400">
<div className="flex items-center gap-1.5 text-slate-300 font-semibold">
<span className="w-2 h-2 rounded-full bg-emerald-400" />
<span>In-App Notifications</span>
</div>
<p className="text-[10px] text-slate-400 leading-snug">
Messages are delivered directly to your In-App Mailbox and Notification Bell.
</p>
</div>
</aside>
{/* ======================================================== */}
{/* PANE 2: Message List / Summary Cards */}
{/* ======================================================== */}
<section className="w-80 sm:w-96 shrink-0 border-r border-slate-800/80 bg-[#0d121f]/60 flex flex-col overflow-hidden">
{/* Search Box Header */}
<div className="p-3 border-b border-slate-800/80 bg-[#0d121f]/90 space-y-2">
<div className="relative">
<Search className="w-3.5 h-3.5 absolute left-3 top-1/2 -translate-y-1/2 text-slate-400" />
<input
type="text"
value={searchTerm}
onChange={e => setSearchTerm(e.target.value)}
placeholder="Search messages by subject, sender, or text..."
className="w-full pl-8 pr-7 py-1.5 rounded-xl bg-slate-900 border border-slate-700/80 text-xs text-slate-100 placeholder-slate-400 focus:border-blue-500 focus:outline-none transition shadow-inner"
/>
{searchTerm && (
<button
type="button"
onClick={() => setSearchTerm('')}
className="absolute right-2.5 top-1/2 -translate-y-1/2 text-slate-400 hover:text-white"
>
<X className="w-3.5 h-3.5" />
</button>
)}
</div>
<div className="flex items-center justify-between text-[11px] text-slate-400 px-1">
<span className="capitalize font-semibold text-slate-200">
{activeFolder} ({activeFolder === 'drafts' ? filteredDrafts.length : filteredMessages.length})
</span>
{activeFolder === 'inbox' && unreadCount > 0 && (
<span className="text-blue-400 font-medium">{unreadCount} unread</span>
)}
</div>
</div>
{/* List of Messages or Drafts */}
<div className="flex-1 overflow-y-auto divide-y divide-slate-800/60">
{activeFolder === 'drafts' ? (
filteredDrafts.length === 0 ? (
<div className="py-16 px-6 text-center text-slate-400">
<FileText className="w-8 h-8 mx-auto text-slate-600 mb-2" />
<p className="text-xs font-semibold text-slate-300">No Drafts Saved</p>
<p className="text-[11px] text-slate-400 mt-1">
When you save unfinished messages, they will appear here.
</p>
</div>
) : (
filteredDrafts.map(d => (
<div
key={d.id}
onClick={() => handleEditDraft(d)}
className="p-3.5 hover:bg-slate-800/60 transition cursor-pointer group flex flex-col gap-1.5 relative"
>
<div className="flex items-center justify-between gap-1">
<span className="text-[10px] font-bold text-purple-300 bg-purple-500/15 border border-purple-500/30 px-1.5 py-0.2 rounded">
Draft
</span>
<span className="text-[10px] text-slate-400 font-mono">
{formatDate(d.updatedAt)}
</span>
</div>
<h4 className="text-xs font-semibold text-white group-hover:text-purple-300 transition truncate">
{d.subject || 'Untitled Draft'}
</h4>
<p className="text-[11px] text-slate-300 line-clamp-2 leading-relaxed">
{stripMarkdown(d.message || 'No content written yet.')}
</p>
<div className="flex items-center justify-between pt-1">
<span className="text-[10px] text-slate-400 truncate">
To: {d.recipientEmail || 'No recipient selected'}
</span>
<button
type="button"
onClick={e => {
e.stopPropagation();
deleteDraft(d.id);
}}
className="text-slate-400 hover:text-rose-400 p-1 rounded transition"
title="Delete draft"
>
<Trash2 className="w-3 h-3" />
</button>
</div>
</div>
))
)
) : filteredMessages.length === 0 ? (
<div className="py-16 px-6 text-center text-slate-400">
<MailOpen className="w-8 h-8 mx-auto text-slate-600 mb-2" />
<p className="text-xs font-semibold text-slate-300">No Messages Found</p>
<p className="text-[11px] text-slate-400 mt-1">
{searchTerm
? `No messages matched "${searchTerm}"`
: `No items in ${activeFolder}`}
</p>
</div>
) : (
filteredMessages.map(item => {
const isSelected = selectedMessage?.id === item.id;
const isUnread = Number(item.status) !== NotificationStatus.Read;
const isStarred = starredIds.includes(String(item.id));
return (
<div
key={item.id}
onClick={() => handleSelectMessage(item)}
className={`p-3.5 transition cursor-pointer flex flex-col gap-1 relative ${
isSelected
? 'bg-blue-600/15 border-l-4 border-l-blue-500 text-white shadow-inner'
: 'hover:bg-slate-800/50 border-l-4 border-l-transparent'
}`}
>
{/* Top line: unread dot, platform badge, star, time */}
<div className="flex items-center justify-between gap-1">
<div className="flex items-center gap-1.5 min-w-0">
{isUnread && (
<span
className="w-2 h-2 rounded-full bg-blue-500 shrink-0 shadow-sm shadow-blue-500 animate-pulse"
title="Unread notification"
/>
)}
<span className="text-[11px] font-semibold text-slate-300 truncate">
{item.destination?.includes('From:')
? item.destination.split('From:')[1]?.trim().replace(/[<>]/g, '')
: item.destination || 'PFM System'}
</span>
</div>
<div className="flex items-center gap-1.5 shrink-0">
<span className="text-[9px] font-bold text-blue-300 bg-blue-500/15 border border-blue-500/30 px-1.5 py-0.2 rounded font-mono">
In-App
</span>
<button
type="button"
onClick={e => {
e.stopPropagation();
toggleStar(item.id);
}}
className={`p-0.5 rounded transition ${
isStarred ? 'text-amber-400 hover:text-amber-300' : 'text-slate-400 hover:text-slate-300'
}`}
title={isStarred ? 'Unstar message' : 'Star message'}
>
<Star className={`w-3.5 h-3.5 ${isStarred ? 'fill-amber-400' : ''}`} />
</button>
<span className="text-[10px] text-slate-400 font-mono">
{formatDate(item.createdAt)}
</span>
</div>
</div>
{/* Subject */}
<h4
className={`text-xs truncate ${
isUnread ? 'font-bold text-white' : 'font-medium text-slate-300'
}`}
>
{item.subject || 'Statutory Platform Notice'}
</h4>
{/* Snippet preview stripped of markdown syntax */}
<p className="text-[11px] text-slate-400 line-clamp-2 leading-relaxed">
{stripMarkdown(item.message || 'No additional details provided.')}
</p>
</div>
);
})
)}
</div>
</section>
{/* ======================================================== */}
{/* PANE 3: Full Message Detail & Interactive Actions */}
{/* ======================================================== */}
<main className="flex-1 bg-[#090d16] flex flex-col overflow-y-auto">
{activeFolder === 'drafts' ? (
<div className="flex-1 flex flex-col items-center justify-center p-8 text-center text-slate-400">
<FileText className="w-12 h-12 text-slate-600 mb-3" />
<h3 className="text-sm font-bold text-white">Drafts Folder</h3>
<p className="text-xs text-slate-400 max-w-md mt-1 mb-4">
Click any draft on the left pane to resume composing and dispatch your notification.
</p>
<button
type="button"
onClick={() => handleOpenCompose()}
className="flex items-center gap-2 px-4 py-2 rounded-xl bg-blue-600 hover:bg-blue-500 text-white text-xs font-semibold shadow-lg shadow-blue-600/30 transition cursor-pointer"
>
<PenSquare className="w-4 h-4" />
<span>Create New Message</span>
</button>
</div>
) : !selectedMessage ? (
<div className="flex-1 flex flex-col items-center justify-center p-8 text-center text-slate-400">
<div className="w-16 h-16 rounded-3xl bg-slate-900 border border-slate-800 flex items-center justify-center text-slate-600 mb-4 shadow-xl">
<Mail className="w-8 h-8" />
</div>
<h3 className="text-sm font-bold text-white">No Message Selected</h3>
<p className="text-xs text-slate-400 max-w-sm mt-1 mb-4">
Select an in-app conversation or email notice from the list to view its contents and attachments.
</p>
<button
type="button"
onClick={() => handleOpenCompose()}
className="flex items-center gap-2 px-4 py-2 rounded-xl bg-slate-900 hover:bg-slate-800 text-slate-200 border border-slate-700 text-xs font-semibold transition cursor-pointer"
>
<PenSquare className="w-3.5 h-3.5 text-blue-400" />
<span>Compose New Message</span>
</button>
</div>
) : (
<div className="flex-1 flex flex-col">
{/* Message Header Toolbar */}
<div className="p-5 border-b border-slate-800/80 bg-[#0d121f]/60 flex items-center justify-between shrink-0">
<div className="flex items-center gap-3">
<button
type="button"
onClick={() => handleReplyMessage(selectedMessage)}
className="flex items-center gap-1.5 px-3 py-1.5 rounded-xl bg-blue-600 hover:bg-blue-500 text-white text-xs font-semibold shadow-md shadow-blue-600/20 transition cursor-pointer"
title="Reply to message"
>
<Reply className="w-3.5 h-3.5" />
<span>Reply</span>
</button>
<button
type="button"
onClick={() => toggleStar(selectedMessage.id)}
className={`flex items-center gap-1.5 px-3 py-1.5 rounded-xl border text-xs font-medium transition cursor-pointer ${
starredIds.includes(String(selectedMessage.id))
? 'bg-amber-500/15 border-amber-500/30 text-amber-300'
: 'bg-slate-900/80 border-slate-700/80 text-slate-300 hover:text-white'
}`}
>
<Star
className={`w-3.5 h-3.5 ${
starredIds.includes(String(selectedMessage.id)) ? 'fill-amber-400' : ''
}`}
/>
<span>{starredIds.includes(String(selectedMessage.id)) ? 'Starred' : 'Star'}</span>
</button>
</div>
<div className="flex items-center gap-2">
{activeFolder === 'trash' ? (
<>
<button
type="button"
onClick={() => restoreMessage(selectedMessage.id)}
className="flex items-center gap-1.5 px-3 py-1.5 rounded-xl bg-slate-900/80 hover:bg-slate-800 border border-slate-700 text-xs text-slate-200 transition cursor-pointer"
title="Restore message to Inbox"
>
<RotateCcw className="w-3.5 h-3.5 text-emerald-400" />
<span>Restore</span>
</button>
<button
type="button"
onClick={() => permanentDelete(selectedMessage.id)}
className="flex items-center gap-1.5 px-3 py-1.5 rounded-xl bg-rose-950/40 hover:bg-rose-900/40 border border-rose-800/60 text-xs text-rose-300 transition cursor-pointer"
title="Permanently erase message"
>
<Trash2 className="w-3.5 h-3.5 text-rose-400" />
<span>Delete Forever</span>
</button>
</>
) : (
<button
type="button"
onClick={() => {
deleteMessage(selectedMessage.id);
setSelectedMessage(null);
}}
className="p-2 rounded-xl text-slate-400 hover:text-rose-400 hover:bg-rose-950/20 border border-transparent hover:border-rose-900/40 transition cursor-pointer"
title="Move message to Trash"
>
<Trash2 className="w-4 h-4" />
</button>
)}
</div>
</div>
{/* Message Details & Body */}
<div className="p-6 space-y-6 flex-1 overflow-y-auto max-w-4xl">
{/* Subject Header */}
<div>
<h2 className="text-xl font-bold text-white tracking-tight leading-tight">
{selectedMessage.subject || 'In-App Notification'}
</h2>
<div className="flex flex-wrap items-center gap-2 mt-2">
<span className="text-[10px] font-semibold text-blue-300 bg-blue-500/15 border border-blue-500/30 px-2 py-0.5 rounded-md flex items-center gap-1">
<Smartphone className="w-3 h-3 text-blue-400" />
Channel: In-App
</span>
<span className="text-[10px] font-mono text-slate-400 bg-slate-900 px-2 py-0.5 rounded-md border border-slate-800">
ID: #{selectedMessage.id}
</span>
<span className="text-[10px] text-slate-400">
Received: {formatDate(selectedMessage.createdAt)}
</span>
</div>
</div>
{/* Sender & Recipient Card */}
<div className="p-4 rounded-2xl bg-slate-900/60 border border-slate-800 flex items-start justify-between gap-4">
<div className="flex items-start gap-3">
<div className="w-10 h-10 rounded-2xl bg-gradient-to-br from-blue-600 to-indigo-600 flex items-center justify-center font-bold text-xs text-white shadow-md shadow-blue-500/20 shrink-0">
{selectedMessage.destination?.includes('@')
? selectedMessage.destination.split('@')[0].slice(0, 2).toUpperCase()
: 'PF'}
</div>
<div>
<div className="flex items-center gap-2">
<p className="text-xs font-bold text-white">
{selectedMessage.destination?.includes('From:')
? selectedMessage.destination.split('From:')[1]?.trim().replace(/[<>]/g, '')
: selectedMessage.destination || 'PFM Automated Dispatcher'}
</p>
<span className="text-[10px] text-slate-400 font-mono">
(In-App Notification)
</span>
</div>
<p className="text-[11px] text-slate-400 mt-0.5">
To:{' '}
<strong className="text-slate-300">
{selectedMessage.destination?.includes('To:')
? selectedMessage.destination.split('To:')[1]?.split('|')[0]?.trim()
: currentUserEmail || 'You'}
</strong>
</p>
</div>
</div>
<span className="text-[10px] text-slate-400 font-mono shrink-0 flex items-center gap-1">
<Clock className="w-3 h-3" />
{formatDate(selectedMessage.createdAt)}
</span>
</div>
{/* Fully-Rendered Markdown & HTML Message Body with Branding */}
<MarkdownViewer
content={selectedMessage.message || ''}
subject={selectedMessage.subject || ''}
showBrandingHeader={true}
/>
{/* Inline Quick Reply Section */}
<div className="pt-6 border-t border-slate-800 space-y-3">
<div className="flex items-center justify-between">
<h4 className="text-xs font-bold text-white flex items-center gap-1.5">
<Reply className="w-3.5 h-3.5 text-blue-400" />
<span>Quick Reply</span>
</h4>
<span className="text-[10px] text-slate-400">
Send a quick response below or open the rich text composer
</span>
</div>
{inlineReplySuccess && (
<div className="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30 text-emerald-300 text-xs flex items-center gap-2">
<CheckCircle2 className="w-4 h-4 text-emerald-400" />
<span>Reply dispatched successfully!</span>
</div>
)}
<textarea
rows={4}
value={inlineReplyText}
onChange={e => setInlineReplyText(e.target.value)}
placeholder="Type your reply..."
className="w-full p-3.5 rounded-2xl bg-slate-900/90 border border-slate-700/80 hover:border-slate-600 focus:border-blue-500 text-slate-100 placeholder-slate-400 text-xs focus:outline-none transition shadow-inner resize-y leading-relaxed"
/>
<div className="flex items-center justify-between">
<button
type="button"
onClick={() => handleReplyMessage(selectedMessage)}
className="text-xs text-blue-400 hover:text-blue-300 font-medium transition cursor-pointer"
>
Open rich compose editor with live preview
</button>
<button
type="button"
disabled={isSending || !inlineReplyText.trim()}
onClick={handleSendInlineReply}
className="flex items-center gap-2 px-5 py-2 rounded-xl bg-blue-600 hover:bg-blue-500 text-white text-xs font-semibold shadow-md shadow-blue-600/30 transition disabled:opacity-40 cursor-pointer"
>
{isSending ? (
<div className="w-3.5 h-3.5 border-2 border-white border-t-transparent rounded-full animate-spin" />
) : (
<Send className="w-3.5 h-3.5" />
)}
<span>Send Reply</span>
</button>
</div>
</div>
</div>
</div>
)}
</main>
</div>
{/* Compose Message Modal */}
<ComposeMessageModal
isOpen={isComposeOpen}
onClose={() => setIsComposeOpen(false)}
initialRecipient={composeInitialRecipient}
initialSubject={composeInitialSubject}
initialMessage={composeInitialMessage}
initialPlatform={composeInitialPlatform}
draftToEdit={selectedDraft}
/>
{/* Self-Reply Prevention Modal */}
{isSelfReplyModalOpen && (
<div className="fixed inset-0 z-50 flex items-center justify-center p-4 bg-slate-950/80 backdrop-blur-sm animate-in fade-in duration-150">
<div className="w-full max-w-md bg-[#0d1322] border border-rose-500/30 rounded-2xl shadow-2xl overflow-hidden p-6 space-y-4">
<div className="flex items-start justify-between gap-3">
<div className="flex items-center gap-3">
<div className="w-10 h-10 rounded-xl bg-rose-500/15 border border-rose-500/30 flex items-center justify-center text-rose-400 shrink-0">
<ShieldAlert className="w-5 h-5" />
</div>
<div>
<h3 className="text-sm font-bold text-white">Action Not Allowed</h3>
<p className="text-[11px] text-rose-300 font-medium">Self-Reply Restricted</p>
</div>
</div>
<button
type="button"
onClick={() => setIsSelfReplyModalOpen(false)}
className="p-1 rounded-lg text-slate-400 hover:text-white hover:bg-slate-800 transition cursor-pointer"
>
<X className="w-4 h-4" />
</button>
</div>
<p className="text-xs text-slate-300 leading-relaxed">
You cannot reply to a notification that originated from your own account. Please compose a new message and select another recipient from the directory if you wish to follow up with a colleague.
</p>
<div className="pt-2 border-t border-slate-800 flex justify-end gap-2">
<button
type="button"
onClick={() => setIsSelfReplyModalOpen(false)}
className="px-4 py-2 rounded-xl bg-blue-600 hover:bg-blue-500 text-white text-xs font-semibold shadow-md shadow-blue-600/25 transition cursor-pointer"
>
Understood
</button>
</div>
</div>
</div>
)}
</div>
);
};
@@ -29,7 +29,6 @@ import {
Filter,
FileText,
Activity,
ShieldCheck,
} from 'lucide-react';
import {
getProjects,
@@ -41,7 +40,6 @@ import {
createIndicator,
recordIndicatorActual,
getBudgets,
getActivities,
} from '../services/api';
import { Modal } from '../components/ui/Modal';
import { HelpTooltip } from '../components/ui/HelpTooltip';
@@ -75,7 +73,6 @@ import {
getUserEmail,
} from '../lib/formatters';
import { ProjectViewModal } from '../components/projects/ProjectViewModal';
import { ProjectComplianceModal } from '../components/projects/ProjectComplianceModal';
import { ProjectFormModal } from '../components/projects/ProjectFormModal';
import { ProjectMilestonesModal } from '../components/projects/ProjectMilestonesModal';
import { ProjectActivitiesModal } from '../components/projects/ProjectActivitiesModal';
@@ -195,8 +192,6 @@ export const ProjectsPage: React.FC = () => {
const [editingProject, setEditingProject] = useState<Project | null>(null);
const [activeModalProject, setActiveModalProject] = useState<Project | null>(null);
const [selectedProjectForCompliance, setSelectedProjectForCompliance] = useState<Project | null>(null);
const [isComplianceModalOpen, setIsComplianceModalOpen] = useState(false);
const [isMilestonesModalOpen, setIsMilestonesModalOpen] = useState(false);
const [isActivitiesModalOpen, setIsActivitiesModalOpen] = useState(false);
const [isIndicatorsModalOpen, setIsIndicatorsModalOpen] = useState(false);
@@ -242,31 +237,6 @@ export const ProjectsPage: React.FC = () => {
queryFn: () => getBudgets(1, 100),
});
const { data: allProjectActivities = new Map<string | number, any[]>() } = useQuery({
queryKey: ['allProjectActivities', projects.map((p) => p.id)],
queryFn: async () => {
const map = new Map<string | number, any[]>();
await Promise.all(
projects.map(async (p) => {
try {
const acts = await getActivities(p.id);
map.set(p.id, acts);
} catch {
map.set(p.id, []);
}
})
);
return map;
},
enabled: projects.length > 0,
});
const handleOpenComplianceStatus = (p: Project, e: React.MouseEvent) => {
e.stopPropagation();
setSelectedProjectForCompliance(p);
setIsComplianceModalOpen(true);
};
// Programme lookup map
const programmeMap = useMemo(() => {
const map = new Map<string | number, Programme>();
@@ -1007,24 +977,13 @@ export const ProjectsPage: React.FC = () => {
/>
</div>
</SortableTh>
<th className="py-3.5 px-4 text-right font-semibold whitespace-nowrap w-36">
<div className="flex items-center justify-end gap-1">
<span>Project Variance</span>
<HelpTooltip
title="Project Variance"
content="Approved allocated budget minus scheduled milestone activity values. Positive (green) indicates within budget constraints; negative (red) indicates cost overrun."
size="sm"
placement="bottom"
/>
</div>
</th>
<th className="py-3.5 px-4 text-right font-semibold whitespace-nowrap w-56">Actions</th>
<th className="py-3.5 px-4 text-right font-semibold whitespace-nowrap w-36">Actions</th>
</tr>
</thead>
<tbody className="divide-y divide-slate-800/60 font-medium">
{loadingProjects ? (
<tr>
<td colSpan={7} className="p-12 text-center text-slate-400 text-xs">
<td colSpan={6} className="p-12 text-center text-slate-400 text-xs">
<div className="flex flex-col items-center justify-center space-y-2">
<div className="w-6 h-6 border-2 border-blue-500 border-t-transparent rounded-full animate-spin" />
<span>Loading project directory...</span>
@@ -1033,7 +992,7 @@ export const ProjectsPage: React.FC = () => {
</tr>
) : sortedProjects.length === 0 ? (
<tr>
<td colSpan={7} className="p-12 text-center text-slate-400">
<td colSpan={6} className="p-12 text-center text-slate-400">
<div className="flex flex-col items-center justify-center space-y-3">
<FolderKanban className="w-10 h-10 text-slate-600" />
<p className="text-sm font-semibold text-slate-300">No matching projects found</p>
@@ -1207,51 +1166,17 @@ export const ProjectsPage: React.FC = () => {
</div>
</td>
{/* Project Variance Column */}
{(() => {
const approvedBudget = approvedBudgetsByProject.get(p.id) || 0;
const pActs = allProjectActivities.get(p.id) || [];
const pActsTotal = pActs.reduce((sum, a) => sum + (Number(a.amount) || 0), 0);
const pVariance = approvedBudget - pActsTotal;
const isPos = pVariance >= 0;
return (
<td className="py-3.5 px-4 text-right whitespace-nowrap w-36 font-mono font-bold" onClick={(e) => e.stopPropagation()}>
<span
className={`inline-flex items-center px-2 py-0.5 rounded text-xs border ${
isPos
? 'text-emerald-400 bg-emerald-500/10 border-emerald-500/30'
: 'text-rose-400 bg-rose-500/10 border-rose-500/30'
}`}
title={`Approved Budget: ${formatZAR(approvedBudget)} | Milestone Activities: ${formatZAR(pActsTotal)} | Variance: ${isPos ? '+' : ''}${formatZAR(pVariance)}`}
>
{isPos ? `+${formatZAR(pVariance)}` : `-${formatZAR(Math.abs(pVariance))}`}
</span>
</td>
);
})()}
{/* Row Action: View Project & Compliance Status */}
<td className="py-3.5 px-4 text-right whitespace-nowrap w-56" onClick={(e) => e.stopPropagation()}>
<div className="flex items-center justify-end gap-2">
{/* Row Action: View Project (Opens Large WBS & Gantt Console) */}
<td className="py-3.5 px-4 text-right whitespace-nowrap w-36" onClick={(e) => e.stopPropagation()}>
<button
type="button"
onClick={(e) => handleOpenProjectView(p, e)}
className="inline-flex items-center gap-1.5 px-3 py-1.5 text-xs font-semibold text-white bg-gradient-to-r from-blue-600 to-indigo-600 hover:from-blue-500 hover:to-indigo-500 rounded-xl transition cursor-pointer shadow-sm shadow-blue-600/25 active:scale-95"
className="inline-flex items-center gap-1.5 px-3.5 py-1.5 text-xs font-semibold text-white bg-gradient-to-r from-blue-600 to-indigo-600 hover:from-blue-500 hover:to-indigo-500 rounded-xl transition cursor-pointer shadow-sm shadow-blue-600/25 active:scale-95"
title="Open Project View & Interactive Gantt Timeline"
>
<Eye className="w-3.5 h-3.5" />
<span>View Project</span>
</button>
<button
type="button"
onClick={(e) => handleOpenComplianceStatus(p, e)}
className="inline-flex items-center gap-1.5 px-3 py-1.5 text-xs font-semibold text-emerald-300 bg-emerald-950/40 hover:bg-emerald-900/60 border border-emerald-500/30 rounded-xl transition cursor-pointer shadow-sm active:scale-95"
title="View Compliance Status, Risks & Beneficiaries"
>
<ShieldCheck className="w-3.5 h-3.5 text-emerald-400" />
<span>Compliance Status</span>
</button>
</div>
</td>
</tr>
);
@@ -1442,7 +1367,7 @@ export const ProjectsPage: React.FC = () => {
<tbody className="divide-y divide-slate-800/50">
{sortedIndicatorsData.length === 0 ? (
<tr>
<td colSpan={7} className="py-12 text-center text-slate-500">
<td colSpan={6} className="py-12 text-center text-slate-500">
<TrendingUp className="w-8 h-8 text-slate-600 mx-auto mb-2" />
{indicatorSearchTerm || indicatorProjectFilter !== 'all' || indicatorUnitFilter !== 'all'
? 'No indicators match your filter criteria.'
@@ -1464,11 +1389,10 @@ export const ProjectsPage: React.FC = () => {
setSelectedIndicatorForActual(ind);
setActualInput(ind.actualAmount);
}}
className="inline-flex items-center gap-1 text-xs font-semibold text-slate-300 hover:text-white bg-slate-800/80 hover:bg-slate-700 px-3 py-1.5 rounded-lg border border-slate-700/60 transition cursor-pointer"
title="Edit actual realized value in place"
className="inline-flex items-center gap-1 text-xs font-semibold text-blue-400 hover:text-white bg-blue-500/10 hover:bg-blue-600 px-3 py-1.5 rounded-lg border border-blue-500/25 transition cursor-pointer"
>
<Edit2 className="w-3.5 h-3.5 text-blue-400" />
<span>Edit Actual</span>
<CheckCircle2 className="w-3.5 h-3.5" />
<span>Record Actual</span>
</button>
</td>
</tr>
@@ -1733,16 +1657,6 @@ export const ProjectsPage: React.FC = () => {
</div>
)}
{/* Project View Modal (Comprehensive Console, Navigable Gantt Timeline & WBS) */}
<ProjectComplianceModal
isOpen={isComplianceModalOpen}
onClose={() => {
setIsComplianceModalOpen(false);
setSelectedProjectForCompliance(null);
}}
project={selectedProjectForCompliance}
programme={selectedProjectForCompliance ? programmeMap.get(selectedProjectForCompliance.programmeId) || null : null}
/>
<ProjectViewModal
isOpen={isProjectViewModalOpen}
onClose={() => {
@@ -1972,7 +1886,7 @@ export const ProjectsPage: React.FC = () => {
<Modal
isOpen={!!selectedIndicatorForActual}
onClose={() => setSelectedIndicatorForActual(null)}
title="Edit Indicator Actual Value"
title="Record Indicator Actual Value"
subtitle={selectedIndicatorForActual?.name || ''}
helpText="Logs a certified field or audited measurement against the target, recalculating the achievement percentage and RAG rating (BR-009)."
>
@@ -59,13 +59,7 @@ import {
getContracts,
getAuditLogs,
getNotifications,
notifyInviteApproved,
getCurrentUserTenantId,
} from '../services/api';
import {
getApprovedInviteIds,
markInviteAsApprovedInStorage,
} from '../services/notificationRulesService';
import { Modal } from '../components/ui/Modal';
import { HelpTooltip } from '../components/ui/HelpTooltip';
import { useToast } from '../components/ui/Toast';
@@ -244,31 +238,6 @@ export const SettingsPage: React.FC = () => {
const [inviteRecipientUuid, setInviteRecipientUuid] = useState('');
const [inviteMessage, setInviteMessage] = useState('');
const [invitePlatform, setInvitePlatform] = useState<NotificationPlatform>(NotificationPlatform.Email);
const [inviteAutoApprove, setInviteAutoApprove] = useState<boolean>(true);
// Approved invites tracking state
const currentTenantId = getCurrentUserTenantId();
const [approvedInviteIds, setApprovedInviteIds] = useState<string[]>(() =>
getApprovedInviteIds(currentTenantId)
);
const handleApproveInvite = async (inv: Invite, idx: number) => {
const inviteKey = inv.id ? String(inv.id) : `inv_${idx}`;
markInviteAsApprovedInStorage(inviteKey, currentTenantId);
setApprovedInviteIds((prev) => (prev.includes(inviteKey) ? prev : [...prev, inviteKey]));
await notifyInviteApproved({
invite: inv,
}).catch(console.warn);
queryClient.invalidateQueries({ queryKey: ['invites'] });
queryClient.invalidateQueries({ queryKey: ['inapp-notifications'] });
queryClient.invalidateQueries({ queryKey: ['notifications'] });
success(
'Invitation Approved',
'Partner user has been notified via In-App and Email messages with link to Partner Portal (https://partner.ifri.khongisa.co.za/).'
);
};
// Invites filtering & search
const [inviteSearchTerm, setInviteSearchTerm] = useState('');
@@ -313,33 +282,12 @@ export const SettingsPage: React.FC = () => {
const sendInviteMutation = useMutation({
mutationFn: (payload: InviteRequest) => sendInvite(payload),
onSuccess: (data, variables) => {
onSuccess: () => {
success('Invitation Dispatched', 'Statutory communications invitation sent successfully.');
queryClient.invalidateQueries({ queryKey: ['invites'] });
setIsSendInviteModalOpen(false);
setInviteRecipientUuid('');
setInviteMessage('');
if (inviteAutoApprove) {
const invId = (data as any)?.id ? String((data as any).id) : `inv_${Date.now()}`;
markInviteAsApprovedInStorage(invId, currentTenantId);
setApprovedInviteIds((prev) => (prev.includes(invId) ? prev : [...prev, invId]));
notifyInviteApproved({
invite: {
id: invId,
recipient: variables.recipient,
invitedOrganisationId: variables.invitedOrganisationId,
organisationId: variables.organisationId,
awardId: variables.awardId,
contractId: variables.contractId,
message: variables.message,
},
}).then(() => {
queryClient.invalidateQueries({ queryKey: ['inapp-notifications'] });
queryClient.invalidateQueries({ queryKey: ['notifications'] });
}).catch(console.warn);
}
},
onError: (err: unknown) => {
toastError('Dispatch Error', err);
@@ -1177,7 +1125,7 @@ export const SettingsPage: React.FC = () => {
</div>
</div>
<div className="overflow-x-auto min-w-0 w-full">
<table className="w-full text-left text-xs border-collapse min-w-[950px]">
<table className="w-full text-left text-xs border-collapse min-w-[850px]">
<thead>
<tr className="bg-slate-900/60 border-b border-slate-800/80 text-slate-400 uppercase tracking-wider font-semibold">
<SortableTh column="recipient" currentColumn={inviteSortCol} direction={inviteSortDir} onSort={handleInviteSort} className="py-3.5 px-5">
@@ -1192,38 +1140,26 @@ export const SettingsPage: React.FC = () => {
<SortableTh column="invitedOrganisationId" currentColumn={inviteSortCol} direction={inviteSortDir} onSort={handleInviteSort} className="py-3.5 px-4">
Target Org / Grant
</SortableTh>
<th className="py-3.5 px-4 font-semibold text-slate-400 uppercase tracking-wider">
Status
</th>
<SortableTh column="createdAt" currentColumn={inviteSortCol} direction={inviteSortDir} onSort={handleInviteSort} align="right" className="py-3.5 px-5 text-right">
Created Date
</SortableTh>
<th className="py-3.5 px-5 text-right font-semibold text-slate-400 uppercase tracking-wider">
Actions
</th>
</tr>
</thead>
<tbody className="divide-y divide-slate-800/50">
{loadingInvites ? (
<tr>
<td colSpan={7} className="py-8 text-center text-slate-500">
<td colSpan={5} className="py-8 text-center text-slate-500">
Loading invitations ledger...
</td>
</tr>
) : sortedInvites.length === 0 ? (
<tr>
<td colSpan={7} className="py-8 text-center text-slate-500">
<td colSpan={5} className="py-8 text-center text-slate-500">
No invitations recorded yet. Use &ldquo;Dispatch Invitation&rdquo; to send one.
</td>
</tr>
) : (
sortedInvites.map((inv, idx) => {
const isApproved =
approvedInviteIds.includes(String(inv.id)) ||
approvedInviteIds.includes(`inv_${idx}`) ||
approvedInviteIds.includes(String(idx));
return (
sortedInvites.map((inv, idx) => (
<tr key={idx} className="hover:bg-slate-800/40 transition-colors">
<td className="py-3.5 px-5 font-mono text-slate-300 text-[11px]">
{inv.recipient}
@@ -1239,43 +1175,11 @@ export const SettingsPage: React.FC = () => {
<td className="py-3.5 px-4 text-slate-400 text-[11px]">
Org #{inv.invitedOrganisationId || inv.organisationId} &bull; Award #{inv.awardId}
</td>
<td className="py-3.5 px-4">
{isApproved ? (
<span className="inline-flex items-center gap-1 px-2 py-0.5 rounded-full text-[10px] font-semibold bg-emerald-500/10 text-emerald-400 border border-emerald-500/20">
<CheckCircle className="w-3 h-3" />
Approved
</span>
) : (
<span className="inline-flex items-center gap-1 px-2 py-0.5 rounded-full text-[10px] font-semibold bg-amber-500/10 text-amber-400 border border-amber-500/20">
<RotateCcw className="w-3 h-3" />
Pending Approval
</span>
)}
</td>
<td className="py-3.5 px-5 text-right font-mono text-slate-400 text-[11px]">
{inv.createdAt ? formatDate(inv.createdAt) : 'Recently'}
</td>
<td className="py-3.5 px-5 text-right">
{isApproved ? (
<span className="inline-flex items-center gap-1 text-[11px] text-emerald-400/90 font-medium">
<Check className="w-3 h-3" />
Partner Notified
</span>
) : (
<button
type="button"
onClick={() => handleApproveInvite(inv, idx)}
className="inline-flex items-center gap-1 px-2.5 py-1 rounded-lg text-xs font-semibold bg-emerald-600/20 text-emerald-400 hover:bg-emerald-600/30 border border-emerald-500/30 transition shadow-xs cursor-pointer"
title="Approve this invitation and issue InApp and Email notifications to the partner user"
>
<Check className="w-3 h-3" />
<span>Approve</span>
</button>
)}
</td>
</tr>
);
})
))
)}
</tbody>
</table>
@@ -2655,22 +2559,6 @@ export const SettingsPage: React.FC = () => {
/>
</div>
<div className="flex items-start gap-2.5 p-3 rounded-xl bg-blue-950/20 border border-blue-900/40">
<input
type="checkbox"
id="inviteAutoApprove"
checked={inviteAutoApprove}
onChange={(e) => setInviteAutoApprove(e.target.checked)}
className="mt-0.5 w-4 h-4 rounded text-blue-600 bg-slate-900 border-slate-700 focus:ring-blue-500 cursor-pointer"
/>
<label htmlFor="inviteAutoApprove" className="text-xs text-slate-300 cursor-pointer select-none">
<span className="font-semibold text-white block">Formally Approve Invitation &amp; Notify Partner</span>
<span className="text-[11px] text-slate-400 leading-relaxed block mt-0.5">
Automatically marks invite as Approved and issues In-App and Email notifications directing the partner user to the Partner Portal (<strong className="text-blue-400 font-mono">https://partner.ifri.khongisa.co.za/</strong>).
</span>
</label>
</div>
<div className="pt-3 border-t border-slate-800/80 flex justify-end gap-2">
<button
type="button"
@@ -962,7 +962,6 @@ export const TenantManagementPage: React.FC = () => {
isOpen={isCreateModalOpen}
onClose={() => setIsCreateModalOpen(false)}
title="Provision New Tenant Partition"
subtitle="Define an isolated multi-tenant partition for grants, portfolios, and users."
size="md"
>
<form
@@ -971,6 +970,17 @@ export const TenantManagementPage: React.FC = () => {
)}
className="space-y-4"
>
<div className="p-3.5 rounded-xl bg-blue-950/20 border border-blue-800/30 text-xs text-blue-200 flex items-start gap-2.5">
<Info className="w-4 h-4 text-blue-400 shrink-0 mt-0.5" />
<div className="space-y-1 leading-relaxed">
<p className="font-semibold text-white">Multi-Tenant Partition Boundary</p>
<p>
Creating a new tenant defines an isolated partition boundary for grants, portfolios, projects, and users.
New tenants are automatically initialized in the Active state.
</p>
</div>
</div>
<div>
<label className="block text-xs font-semibold text-slate-300 mb-1.5">
Tenant Organization Name <span className="text-rose-400">*</span>
@@ -997,7 +1007,7 @@ export const TenantManagementPage: React.FC = () => {
<button
type="submit"
disabled={createMutation.isPending}
className="flex items-center gap-1.5 px-4 py-2 bg-blue-600 hover:bg-blue-500 text-white text-xs font-semibold rounded-xl shadow-md transition disabled:opacity-50 cursor-pointer"
className="flex items-center gap-1.5 px-4 py-2 bg-gradient-to-r from-blue-600 to-indigo-600 hover:from-blue-500 hover:to-indigo-500 text-white text-xs font-semibold rounded-xl shadow-md transition disabled:opacity-50 cursor-pointer"
>
{createMutation.isPending && <RefreshCw className="w-3.5 h-3.5 animate-spin" />}
<span>{createMutation.isPending ? 'Provisioning...' : 'Create Tenant'}</span>
@@ -1011,7 +1021,6 @@ export const TenantManagementPage: React.FC = () => {
isOpen={isUpdateModalOpen}
onClose={() => setIsUpdateModalOpen(false)}
title={`Update Tenant: ${selectedTenant?.name || ''}`}
subtitle="Modify tenant partition name and operational access status."
size="md"
>
{selectedTenant && (
@@ -1055,12 +1064,13 @@ export const TenantManagementPage: React.FC = () => {
{/* Warning when selecting Inactive or Disabled */}
{Number(updateForm.watch('status')) !== ActivityStatus.Active && (
<div className="p-3 rounded-xl bg-amber-500/10 border border-amber-500/20 text-xs text-amber-200 flex items-start gap-2.5">
<div className="p-3 rounded-xl bg-amber-950/30 border border-amber-800/40 text-xs text-amber-200 flex items-start gap-2.5">
<AlertTriangle className="w-4 h-4 text-amber-400 shrink-0 mt-0.5" />
<div className="space-y-0.5">
<p className="font-semibold text-amber-300">Lockout Notice</p>
<p className="text-[11px] text-amber-200/90 leading-relaxed">
Setting this tenant to Inactive or Disabled immediately locks out assigned users from accessing the API.
<div className="space-y-1">
<p className="font-semibold text-white">Multitenancy Lockout Warning</p>
<p className="text-[11px] leading-relaxed text-amber-300/90">
Changing this tenant's status to Inactive or Disabled immediately locks out all users assigned to this partition.
The backend API will deny requests until the tenant is restored to Active status.
</p>
</div>
</div>
@@ -1077,7 +1087,7 @@ export const TenantManagementPage: React.FC = () => {
<button
type="submit"
disabled={updateMutation.isPending}
className="flex items-center gap-1.5 px-4 py-2 bg-blue-600 hover:bg-blue-500 text-white text-xs font-semibold rounded-xl shadow-md transition disabled:opacity-50 cursor-pointer"
className="flex items-center gap-1.5 px-4 py-2 bg-gradient-to-r from-blue-600 to-indigo-600 hover:from-blue-500 hover:to-indigo-500 text-white text-xs font-semibold rounded-xl shadow-md transition disabled:opacity-50 cursor-pointer"
>
{updateMutation.isPending && <RefreshCw className="w-3.5 h-3.5 animate-spin" />}
<span>{updateMutation.isPending ? 'Saving...' : 'Update Tenant'}</span>
@@ -1092,47 +1102,66 @@ export const TenantManagementPage: React.FC = () => {
isOpen={isDetailModalOpen}
onClose={() => setIsDetailModalOpen(false)}
title={`Tenant Details: ${selectedTenant?.name || ''}`}
subtitle="Partition boundary information, creation audit, and operational status."
size="lg"
>
{selectedTenant && (
<div className="space-y-4">
<div className="grid grid-cols-2 sm:grid-cols-3 gap-3 bg-slate-950/60 p-3.5 rounded-xl border border-slate-800 text-xs">
<div className="space-y-5">
<div className="grid grid-cols-1 sm:grid-cols-2 gap-4 bg-slate-950/60 p-4 rounded-xl border border-slate-800">
<div>
<p className="text-[10px] text-slate-500 uppercase tracking-wider font-semibold">Tenant ID</p>
<p className="text-[11px] text-slate-500 uppercase tracking-wider">Tenant Numeric ID</p>
<p className="text-sm font-bold text-white mt-0.5">#{selectedTenant.id}</p>
</div>
<div>
<p className="text-[10px] text-slate-500 uppercase tracking-wider font-semibold">Tenant Name</p>
<p className="text-xs font-semibold text-slate-200 mt-0.5 truncate">{selectedTenant.name || '—'}</p>
<p className="text-[11px] text-slate-500 uppercase tracking-wider">Tenant Name</p>
<p className="text-sm font-semibold text-slate-200 mt-0.5">{selectedTenant.name || '—'}</p>
</div>
<div>
<p className="text-[10px] text-slate-500 uppercase tracking-wider font-semibold">Operational Status</p>
<p className="text-[11px] text-slate-500 uppercase tracking-wider">Operational Status</p>
<div className="mt-1">
<ActivityStatusBadge status={selectedTenant.status} />
</div>
</div>
<div>
<p className="text-[10px] text-slate-500 uppercase tracking-wider font-semibold">Created Date</p>
<p className="text-[11px] text-slate-500 uppercase tracking-wider">Created Date</p>
<p className="text-xs text-slate-300 mt-0.5">{formatDate(selectedTenant.createdAt)}</p>
</div>
<div>
<p className="text-[10px] text-slate-500 uppercase tracking-wider font-semibold">Created By</p>
<p className="text-xs font-mono text-slate-300 mt-0.5 truncate">
<p className="text-[11px] text-slate-500 uppercase tracking-wider">Created By</p>
<p className="text-xs font-mono text-slate-300 mt-0.5">
{getUserEmail(selectedTenant.createdBy) || selectedTenant.createdBy || 'System Admin'}
</p>
</div>
{selectedTenant.updatedAt && (
<div>
<p className="text-[10px] text-slate-500 uppercase tracking-wider font-semibold">Last Updated</p>
<p className="text-[11px] text-slate-500 uppercase tracking-wider">Last Updated</p>
<p className="text-xs text-slate-300 mt-0.5">{formatDate(selectedTenant.updatedAt)}</p>
</div>
)}
{selectedTenant.updatedBy && (
<div>
<p className="text-[11px] text-slate-500 uppercase tracking-wider">Updated By</p>
<p className="text-xs font-mono text-slate-300 mt-0.5">
{getUserEmail(selectedTenant.updatedBy) || selectedTenant.updatedBy}
</p>
</div>
)}
</div>
<div className="p-3.5 rounded-xl bg-slate-900/80 border border-slate-800 text-xs text-slate-300 space-y-2">
<p className="font-semibold text-white flex items-center gap-1.5">
<ShieldCheck className="w-4 h-4 text-blue-400" />
Partition Scope &amp; Authentication
</p>
<p className="text-[11px] text-slate-400 leading-relaxed">
When users authenticate, their security token contains claims identifying their tenant partition.
The system automatically scopes data queries to this tenant and enforces operational lockout if the status is not Active.
</p>
</div>
<div className="flex items-center justify-end gap-2.5 pt-3 border-t border-slate-800">
@@ -1142,7 +1171,7 @@ export const TenantManagementPage: React.FC = () => {
setIsDetailModalOpen(false);
handleOpenUpdate(selectedTenant);
}}
className="flex items-center gap-1.5 px-4 py-2 bg-blue-600 hover:bg-blue-500 text-white text-xs font-semibold rounded-xl transition cursor-pointer"
className="flex items-center gap-1.5 px-4 py-2 bg-gradient-to-r from-blue-600 to-indigo-600 hover:from-blue-500 hover:to-indigo-500 text-white text-xs font-semibold rounded-xl transition cursor-pointer"
>
<Edit2 className="w-3.5 h-3.5" />
<span>Edit Tenant Status</span>
@@ -1,19 +1,6 @@
import axios, { AxiosError } from 'axios';
import { apiClient } from './httpClient';
import { toolsService } from '../utils/hashids';
import {
notifyTenantManagersAndExecutivesOnRecordStatusChange,
notifyInviteApproved,
notifyNewUserCreated,
isApprovedOrActiveStatus,
} from './notificationRulesService';
export {
notifyTenantManagersAndExecutivesOnRecordStatusChange,
notifyInviteApproved,
notifyNewUserCreated,
isApprovedOrActiveStatus,
};
import { toolsService } from './toolsService';
import {
getCurrentUserSub,
getCurrentUserTenantId,
@@ -77,7 +64,6 @@ import {
AuditLog,
ProblemDetails,
ActivityStatus,
ApprovalStatus,
Tenant,
TenantOrganisation,
TenantUser,
@@ -112,8 +98,6 @@ import {
Claim,
CreateUserRequest,
AddUserClaimRequest,
CreateNotificationRequest,
UpdateNotificationRequest,
} from '../types';
import {
@@ -253,7 +237,6 @@ export const createOrganisation = async (payload: CreateOrganisationRequest): Pr
};
export const updateOrganisation = async (payload: UpdateOrganisationRequest): Promise<Organisation> => {
const orgStatus = payload.status !== undefined ? Number(payload.status) : ActivityStatus.Active;
const res = await apiClient.put('/v1/api/governance/organisations', {
organisationId: toIntegerId(payload.organisationId),
name: payload.name,
@@ -262,16 +245,8 @@ export const updateOrganisation = async (payload: UpdateOrganisationRequest): Pr
idNumber: payload.idNumber,
organisationUser: payload.organisationUser,
type: Number(payload.type),
status: orgStatus,
status: payload.status !== undefined ? Number(payload.status) : ActivityStatus.Active,
});
if (isApprovedOrActiveStatus(orgStatus)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Organisation',
recordId: payload.organisationId,
newStatus: orgStatus,
title: payload.name,
}).catch(console.warn);
}
return res.data;
};
@@ -645,14 +620,6 @@ export const updateInstrument = async (payload: UpdateInstrumentRequest): Promis
if (existing) {
saveStoredInstruction(updatedInstrument);
}
if (isApprovedOrActiveStatus(payload.status)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Funding Instrument',
recordId: targetId!,
newStatus: payload.status,
title: payload.name,
}).catch(console.warn);
}
return updatedInstrument;
};
@@ -698,21 +665,12 @@ export const updateProgramme = async (payload: UpdateProgrammeRequest): Promise<
if (ownerId && typeof ownerId === 'string' && ownerId.includes('@')) {
ownerId = getUserIdByEmail(ownerId) || userSub || ownerId;
}
const progStatus = Number(payload.status) || 1;
const res = await apiClient.put('/v1/api/projects/programme', {
programmeId: toIntegerId(payload.programmeId),
name: payload.name,
ownerId: ownerId || userSub || '00000000-0000-0000-0000-000000000000',
status: progStatus,
status: Number(payload.status) || 1,
});
if (isApprovedOrActiveStatus(progStatus)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Programme',
recordId: payload.programmeId,
newStatus: progStatus,
title: payload.name,
}).catch(console.warn);
}
return res.data;
};
@@ -765,13 +723,6 @@ export const updateProjectStatus = async (payload: UpdateProjectStatusRequest):
projectId: toIntegerId(payload.projectId),
status: Number(payload.status),
});
if (isApprovedOrActiveStatus(payload.status)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Project',
recordId: payload.projectId,
newStatus: payload.status,
}).catch(console.warn);
}
};
export const getActivities = async (projectId: string | number): Promise<Activity[]> => {
@@ -873,14 +824,6 @@ export const updateMilestone = async (payload: UpdateMilestoneRequest): Promise<
priority: Number(payload.priority) || 1,
status: Number(payload.status) || 1,
});
if (isApprovedOrActiveStatus(payload.status)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Milestone',
recordId: payload.milestoneId,
newStatus: payload.status,
title: payload.name,
}).catch(console.warn);
}
};
export const getProjectIndicators = async (projectId: string | number): Promise<Indicator[]> => {
@@ -939,13 +882,6 @@ export const updateAward = async (payload: UpdateAwardRequest): Promise<void> =>
amount: Number(payload.amount),
...(payload.status !== undefined ? { status: Number(payload.status) } : {}),
});
if (payload.status === undefined || isApprovedOrActiveStatus(payload.status)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Award',
recordId: payload.awardId,
newStatus: payload.status !== undefined ? payload.status : ApprovalStatus.Approved,
}).catch(console.warn);
}
};
export const fetchHashId = async (id64: number | string): Promise<string> => {
@@ -1080,14 +1016,6 @@ export const updateContract = async (payload: UpdateContractRequest): Promise<vo
contractId: toIntegerId(payload.contractId),
status: Number(payload.status),
});
if (isApprovedOrActiveStatus(payload.status)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Contract',
recordId: payload.contractId,
newStatus: payload.status,
}).catch(console.warn);
}
};
export const uploadContractFile = async (
@@ -1148,13 +1076,6 @@ export const updateBudget = async (payload: UpdateBudgetRequest): Promise<void>
budgetId: toIntegerId(payload.budgetId),
status: Number(payload.status),
});
if (isApprovedOrActiveStatus(payload.status)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Budget',
recordId: payload.budgetId,
newStatus: payload.status,
}).catch(console.warn);
}
};
// ==========================================
@@ -1193,11 +1114,6 @@ export const updateDisbursement = async (payload: UpdateDisbursementRequest): Pr
export const approveDisbursement = async (disbursementId: string | number): Promise<void> => {
const hashedDisbId = await toolsService.encodeId(disbursementId);
await apiClient.post(`/v1/api/execution/disbursements/${hashedDisbId}/approve`, {});
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Disbursement',
recordId: disbursementId,
newStatus: ApprovalStatus.Approved,
}).catch(console.warn);
};
/**
@@ -1398,13 +1314,6 @@ export const updateEvidence = async (payload: UpdateEvidenceRequest): Promise<vo
evidenceType: Number(payload.evidenceType),
status: Number(payload.status),
});
if (isApprovedOrActiveStatus(payload.status)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Evidence',
recordId: payload.evidenceId,
newStatus: payload.status,
}).catch(console.warn);
}
};
// ==========================================
@@ -1705,53 +1614,6 @@ export const getNotifications = async (organisationId?: string | number): Promis
return [];
};
export const getUserNotifications = async (userId?: string): Promise<Notification[]> => {
try {
const url = userId ? `/v1/api/communications/notifications/user/${encodeURIComponent(userId)}` : `/v1/api/communications/notifications/inbox`;
const res = await apiClient.get<Notification[]>(url);
if (res.data && Array.isArray(res.data)) {
return res.data;
}
} catch (err: any) {
console.warn('[getUserNotifications] API error:', err);
}
return [];
};
export const createNotification = async (payload: CreateNotificationRequest): Promise<void> => {
const tenantId = getCurrentUserTenantId();
const orgId = payload.organisationId !== undefined && payload.organisationId !== '' && payload.organisationId !== null
? toIntegerId(payload.organisationId)
: (tenantId !== null ? tenantId : 1);
await apiClient.post('/v1/api/communications/notifications', {
organisationId: orgId,
recipient: payload.recipient,
platform: payload.platform,
subject: payload.subject || null,
destination: payload.destination || 'In-App User Inbox',
message: payload.message,
status: payload.status !== undefined ? payload.status : undefined,
});
};
export const updateNotification = async (payload: UpdateNotificationRequest): Promise<void> => {
await apiClient.put('/v1/api/communications/notifications', {
notificationId: toIntegerId(payload.notificationId),
destination: payload.destination || undefined,
status: payload.status,
sentAt: payload.sentAt || new Date().toISOString(),
error: payload.error || null,
});
};
export const markNotificationAsRead = async (notificationId: number | string): Promise<void> => {
await updateNotification({
notificationId: toIntegerId(notificationId),
status: NotificationStatus.Read,
});
};
// ==========================================
// 9. Governance: Tenants APIs
// ==========================================
@@ -1778,14 +1640,6 @@ export const updateTenant = async (payload: UpdateTenantRequest): Promise<void>
name: payload.name,
status: Number(payload.status),
});
if (isApprovedOrActiveStatus(payload.status)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Tenant',
recordId: payload.tenantId,
newStatus: payload.status,
title: payload.name,
}).catch(console.warn);
}
};
export const getTenantOrganisations = async (tenantId: string | number): Promise<TenantOrganisation[]> => {
@@ -1889,41 +1743,14 @@ export const updateBeneficiary = async (payload: UpdateBeneficiaryRequest): Prom
export const getOutcome = async (outcomeId: string | number): Promise<Outcome> => {
const hashedOutcomeId = await toolsService.encodeId(outcomeId);
try {
const res = await apiClient.get<Outcome>(`/v1/api/projects/outcome/${hashedOutcomeId}`);
const res = await apiClient.get<Outcome>(`/v1/api/projects/outcomes/${hashedOutcomeId}`);
return res.data;
} catch {
const res = await apiClient.get<Outcome>(`/v1/api/projects/outcomes/single/${hashedOutcomeId}`);
return res.data;
}
};
export const getBeneficiaryOutcomes = async (beneficiaryId: string | number): Promise<Outcome[]> => {
const hashedBeneficiaryId = await toolsService.encodeId(beneficiaryId);
try {
const res = await apiClient.get<Outcome[]>(`/v1/api/projects/beneficiaries/${hashedBeneficiaryId}/outcomes`);
return Array.isArray(res.data) ? res.data : (res.data ? [res.data] : []);
} catch (err: any) {
if (err?.response?.status === 404) {
try {
const res = await apiClient.get<Outcome[]>(`/v1/api/projects/outcomes/${hashedBeneficiaryId}`);
return Array.isArray(res.data) ? res.data : (res.data ? [res.data] : []);
} catch {
return [];
}
}
return [];
}
};
export const getProjectOutcomes = async (projectId: string | number): Promise<Outcome[]> => {
const hashedProjectId = await toolsService.resolveProjectId(projectId);
try {
const res = await apiClient.get<Outcome[]>(`/v1/api/projects/${hashedProjectId}/outcomes`);
return Array.isArray(res.data) ? res.data : [];
} catch {
return [];
}
return res.data || [];
};
export const createOutcome = async (payload: CreateOutcomeRequest): Promise<void> => {
@@ -1931,13 +1758,12 @@ export const createOutcome = async (payload: CreateOutcomeRequest): Promise<void
beneficiaryId: toIntegerId(payload.beneficiaryId),
name: payload.name,
description: payload.description,
status: payload.status !== undefined ? Number(payload.status) : 1,
};
try {
await apiClient.post('/v1/api/projects/beneficiaries/outcomes', body);
await apiClient.post('/v1/api/projects/beneficiaris/outcomes', body);
} catch (err: any) {
if (err?.response?.status === 404) {
await apiClient.post('/v1/api/projects/beneficiaris/outcomes', body);
await apiClient.post('/v1/api/projects/beneficiaries/outcomes', body);
} else {
throw err;
}
@@ -1949,16 +1775,7 @@ export const updateOutcome = async (payload: UpdateOutcomeRequest): Promise<void
outcomeId: toIntegerId(payload.outcomeId),
name: payload.name,
description: payload.description,
status: Number(payload.status),
});
if (isApprovedOrActiveStatus(payload.status)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Outcome',
recordId: payload.outcomeId,
newStatus: payload.status,
title: payload.name,
}).catch(console.warn);
}
};
// ==========================================
@@ -2020,14 +1837,6 @@ export const updateChangeRequest = async (payload: UpdateChangeRequest): Promise
revisedBudget: Number(payload.revisedBudget),
status: Number(payload.status),
});
if (isApprovedOrActiveStatus(payload.status)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Change Request',
recordId: payload.changeRequestId,
newStatus: payload.status,
title: payload.title,
}).catch(console.warn);
}
};
// ==========================================
@@ -2075,8 +1884,6 @@ export const createComplianceItem = async (payload: CreateComplianceItemRequest)
projectId: toIntegerId(payload.projectId),
title: payload.title,
requirements: payload.requirements,
status: payload.status !== undefined ? Number(payload.status) : 1,
beneficiaryId: payload.beneficiaryId ? toIntegerId(payload.beneficiaryId) : null,
});
};
@@ -2086,16 +1893,7 @@ export const updateComplianceItem = async (payload: UpdateComplianceItemRequest)
title: payload.title,
requirements: payload.requirements,
status: Number(payload.status),
beneficiaryId: payload.beneficiaryId ? toIntegerId(payload.beneficiaryId) : null,
});
if (isApprovedOrActiveStatus(payload.status)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Compliance Item',
recordId: payload.complianceItemId,
newStatus: payload.status,
title: payload.title,
}).catch(console.warn);
}
};
// ==========================================
@@ -2163,15 +1961,6 @@ export const updateIssue = async (payload: UpdateIssueRequest): Promise<void> =>
status: payload.status !== undefined ? Number(payload.status) : ActivityStatus.Active,
assignedTo: payload.assignedTo,
});
const issueStatus = payload.status !== undefined ? payload.status : ActivityStatus.Active;
if (isApprovedOrActiveStatus(issueStatus)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Issue',
recordId: payload.issueId,
newStatus: issueStatus,
title: payload.title,
}).catch(console.warn);
}
};
// ==========================================
@@ -2236,14 +2025,6 @@ export const updateSiteVisit = async (payload: UpdateSiteVisitRequest): Promise<
status: Number(payload.status),
visitedAt: visitedAtIso,
});
if (isApprovedOrActiveStatus(payload.status)) {
notifyTenantManagersAndExecutivesOnRecordStatusChange({
recordType: 'Site Visit',
recordId: payload.siteVisitId,
newStatus: payload.status,
title: payload.inspectorName,
}).catch(console.warn);
}
};
const LOCAL_RULES_KEY = 'pfm_local_rules';
@@ -1,416 +0,0 @@
import {
NotificationPlatform,
NotificationStatus,
ApprovalStatus,
ActivityStatus,
ContractStatus,
ComplianceStatus,
User,
Invite,
CreateNotificationRequest,
} from '../types';
import { apiClient } from './httpClient';
import {
getCurrentUserSub,
getCurrentUserClaims,
getCurrentUserTenantId,
} from '../auth/AuthProvider';
export const CONSOLE_PORTAL_URL = 'https://console.ifri.khongisa.co.za/';
export const PARTNER_PORTAL_URL = 'https://partner.ifri.khongisa.co.za/';
/**
* Dispatches a notification request directly via apiClient
*/
export async function dispatchNotification(payload: CreateNotificationRequest): Promise<void> {
const tenantId = getCurrentUserTenantId();
const orgId =
payload.organisationId !== undefined && payload.organisationId !== '' && payload.organisationId !== null
? Number(payload.organisationId)
: (tenantId !== null ? tenantId : 1);
await apiClient.post('/v1/api/communications/notifications', {
organisationId: orgId,
recipient: payload.recipient,
platform: payload.platform,
subject: payload.subject || null,
destination: payload.destination || 'In-App User Inbox',
message: payload.message,
status: payload.status !== undefined ? payload.status : undefined,
});
}
/**
* Retrieves users from directory directly via apiClient
*/
export async function fetchDirectoryUsers(page = 1, pageSize = 200): Promise<User[]> {
try {
const res = await apiClient.post<User[]>(`/v1/api/users/${page}/${pageSize}`, {});
return res.data || [];
} catch (err) {
console.warn('[NotificationRules] Failed to fetch users directory:', err);
return [];
}
}
/**
* Validates whether a given status corresponds to "Approved" or "Active".
*/
export function isApprovedOrActiveStatus(status: number | string | undefined | null): boolean {
if (status === undefined || status === null) return false;
// Numeric enum matching
const numStatus = Number(status);
if (
numStatus === ApprovalStatus.Approved || // 3
numStatus === ActivityStatus.Active || // 1
numStatus === ContractStatus.Active || // 3
numStatus === ContractStatus.Executed || // 3
numStatus === ComplianceStatus.Met || // 2
numStatus === ComplianceStatus.Exceeded // 3
) {
return true;
}
// String matching
const strStatus = String(status).toLowerCase().trim();
return (
strStatus === 'approved' ||
strStatus === 'active' ||
strStatus === 'executed' ||
strStatus === 'met' ||
strStatus === 'exceeded' ||
strStatus === 'verified'
);
}
/**
* Formats a friendly label for the approved or active status.
*/
export function getApprovedOrActiveStatusLabel(status: number | string | undefined | null): string {
if (status === undefined || status === null) return 'Active';
const numStatus = Number(status);
if (numStatus === ApprovalStatus.Approved) return 'Approved';
if (numStatus === ActivityStatus.Active) return 'Active';
if (numStatus === ContractStatus.Active) return 'Active';
if (numStatus === ComplianceStatus.Met) return 'Compliant (Met)';
const str = String(status);
return str.charAt(0).toUpperCase() + str.slice(1);
}
/**
* Retrieves Tenant Managers and Executives within the active tenant context.
* Falls back to the currently logged in user if directory lookup is restricted or empty.
*/
export async function getTenantManagersAndExecutives(): Promise<User[]> {
try {
const tenantId = getCurrentUserTenantId();
const users = await fetchDirectoryUsers(1, 200);
const managersAndExecutives = users.filter((u) => {
const roleStr = String(u.role || '').toLowerCase();
const isManagerOrExec =
roleStr.includes('manager') ||
roleStr.includes('executive') ||
roleStr.includes('director') ||
roleStr === '2' || // Role ID 2 = Executive
roleStr === '4'; // Role ID 4 = Manager
const matchesTenant =
!tenantId || !u.tenant_id || Number(u.tenant_id) === Number(tenantId);
return isManagerOrExec && matchesTenant;
});
if (managersAndExecutives.length > 0) {
return managersAndExecutives;
}
// Secondary fallback: Any user with admin or supervisor if no direct manager/executive found
const elevatedUsers = users.filter((u) => {
const roleStr = String(u.role || '').toLowerCase();
return (
roleStr.includes('admin') ||
roleStr.includes('supervisor') ||
roleStr === '1' ||
roleStr === '3'
);
});
if (elevatedUsers.length > 0) {
return elevatedUsers;
}
} catch (err) {
console.warn('[NotificationRules] Directory lookup failed, using authenticated identity fallback:', err);
}
// Graceful fallback to authenticated user identity so telemetry notification is recorded
const currentSub = getCurrentUserSub();
const currentClaims = getCurrentUserClaims();
if (currentSub) {
return [
{
id: currentSub,
email: (currentClaims.email as string) || (currentClaims.preferred_username as string) || 'manager@pfm.org.za',
status: ActivityStatus.Active,
lastLoginAt: null,
role: 'Manager',
name: (currentClaims.name as string) || 'Tenant Manager',
},
];
}
return [];
}
export interface RecordStatusChangeNotificationParams {
recordType: string;
recordId: string | number;
newStatus: number | string;
title?: string;
previousStatus?: number | string;
}
/**
* RULE 1:
* "Whenever a record change status to Approved, Active (for contract or similar records) exclusding users;
* the system must issue an InApp and Email message to Tenant Managers and Executives."
*/
export async function notifyTenantManagersAndExecutivesOnRecordStatusChange(
params: RecordStatusChangeNotificationParams
): Promise<void> {
const { recordType, recordId, newStatus, title } = params;
// Rule constraint: Strictly exclude users
if (recordType.toLowerCase() === 'user' || recordType.toLowerCase() === 'users') {
return;
}
// Only trigger when the target status is Approved or Active
if (!isApprovedOrActiveStatus(newStatus)) {
return;
}
const statusLabel = getApprovedOrActiveStatusLabel(newStatus);
const orgId = getCurrentUserTenantId() || 1;
const managersAndExecutives = await getTenantManagersAndExecutives();
if (managersAndExecutives.length === 0) {
return;
}
const recordDescriptor = title
? `${recordType} "${title}" (#${recordId})`
: `${recordType} #${recordId}`;
const inAppSubject = `[${statusLabel}] ${recordType} #${recordId} is now ${statusLabel}`;
const inAppMessage = `### Statutory Record Update\n\nThe record **${recordDescriptor}** has officially transitioned to **${statusLabel}** status.\n\n- **Record Category:** ${recordType}\n- **Identifier:** #${recordId}\n- **Updated Status:** ${statusLabel}\n- **Timestamp:** ${new Date().toLocaleString()}\n- **Portal Reference:** [Open PFM Console](${CONSOLE_PORTAL_URL})\n\nPlease review the updated portfolio commitments accordingly.`;
const emailSubject = `[PFM Governance Alert] ${recordType} #${recordId} Status Transition: ${statusLabel}`;
const emailMessage = `### Formal Statutory Notification\n\nThis is an automated notification to Tenant Managers and Executives regarding an approved record status update.\n\n**Record Details:**\n- **Category:** ${recordType}\n- **Reference Identifier:** #${recordId}\n${title ? `- **Title:** ${title}\n` : ''}- **New Lifecycle Status:** **${statusLabel}**\n- **Effective Timestamp:** ${new Date().toUTCString()}\n\nYou can inspect this record in the PFM Management Console: [Access Management Console](${CONSOLE_PORTAL_URL}).`;
// Dispatch both InApp and Email notifications to each Tenant Manager and Executive
for (const recipient of managersAndExecutives) {
if (!recipient.id) continue;
const recipientEmail = recipient.email || 'manager@pfm.org.za';
// 1. In-App Notification
try {
const inAppReq: CreateNotificationRequest = {
organisationId: orgId,
recipient: recipient.id,
platform: NotificationPlatform.InApp,
subject: inAppSubject,
destination: recipientEmail,
message: inAppMessage,
status: NotificationStatus.Delivered,
};
await dispatchNotification(inAppReq);
} catch (err) {
console.warn(`[NotificationRules] Failed to send InApp message to ${recipient.id}:`, err);
}
// 2. Email Notification
try {
const emailReq: CreateNotificationRequest = {
organisationId: orgId,
recipient: recipient.id,
platform: NotificationPlatform.Email,
subject: emailSubject,
destination: `To: ${recipientEmail} | From: PFM Automated Governance System`,
message: emailMessage,
status: NotificationStatus.Queued,
};
await dispatchNotification(emailReq);
} catch (err) {
console.warn(`[NotificationRules] Failed to send Email message to ${recipientEmail}:`, err);
}
}
}
export interface InviteApprovedNotificationParams {
invite: Partial<Invite> & {
id: number | string;
recipient: string;
invitedOrganisationId?: number | string;
organisationId?: number | string;
awardId?: number | string;
contractId?: number | string;
message?: string;
};
partnerUser?: User | null;
partnerEmail?: string;
}
/**
* RULE 2:
* "When an Invite is Approved, the Partner user must be notified via Email and InApp message as well."
*/
export async function notifyInviteApproved(
params: InviteApprovedNotificationParams
): Promise<void> {
const { invite, partnerUser, partnerEmail } = params;
if (!invite.recipient) return;
const orgId = invite.invitedOrganisationId || invite.organisationId || getCurrentUserTenantId() || 1;
const targetEmail = partnerEmail || partnerUser?.email || invite.recipient;
const inAppSubject = 'Onboarding Invitation Approved: Access to Partner Portal Granted';
const inAppMessage = `### Statutory Invitation Approved\n\nYour statutory onboarding invitation for **Organisation #${invite.invitedOrganisationId || invite.organisationId}** (Funding Award #${invite.awardId || 'N/A'}, Contract #${invite.contractId || 'N/A'}) has been formally **Approved**.\n\nYou may now access the **PFM Partner Portal** to review contractual agreements, complete KYC compliance, and submit milestone deliverables:\n\n👉 [Open Partner Portal](${PARTNER_PORTAL_URL})`;
const emailSubject = '[PFM Partner Portal] Statutory Invitation Approved - Welcome Onboard';
const emailMessage = `### Formal Statutory Onboarding Approval\n\nDear Grantee / Project Partner,\n\nWe are pleased to inform you that your statutory onboarding invitation has been formally **Approved** by the funding authority.\n\n**Invitation Summary:**\n- **Recipient Key:** \`${invite.recipient}\`\n- **Target Organisation:** #${invite.invitedOrganisationId || invite.organisationId}\n- **Funding Award ID:** #${invite.awardId || 'N/A'}\n- **Contract Reference:** #${invite.contractId || 'N/A'}\n- **Authorisation Status:** **Approved & Active**\n\n**Next Steps:**\nPlease log in to the PFM Partner Portal at: **${PARTNER_PORTAL_URL}**\n\nOnce logged in, please complete your statutory recipient onboarding, verify bank details, and review milestone schedules.`;
// 1. In-App Notification to Partner
try {
const inAppReq: CreateNotificationRequest = {
organisationId: orgId,
recipient: invite.recipient,
platform: NotificationPlatform.InApp,
subject: inAppSubject,
destination: targetEmail,
message: inAppMessage,
status: NotificationStatus.Delivered,
};
await dispatchNotification(inAppReq);
} catch (err) {
console.warn('[NotificationRules] Failed to issue InApp invite approval notification:', err);
}
// 2. Email Notification to Partner
try {
const emailReq: CreateNotificationRequest = {
organisationId: orgId,
recipient: invite.recipient,
platform: NotificationPlatform.Email,
subject: emailSubject,
destination: `To: ${targetEmail} | From: PFM Statutory Communications`,
message: emailMessage,
status: NotificationStatus.Queued,
};
await dispatchNotification(emailReq);
} catch (err) {
console.warn('[NotificationRules] Failed to issue Email invite approval notification:', err);
}
}
export interface NewUserCreatedNotificationParams {
userId: string;
email: string;
isPartner: boolean;
roleName?: string;
tenantId?: number | string | null;
}
/**
* RULE 3:
* "When a new user is created, an InApp and Email message must be issued to them notifying them of this
* and directing them to login (https://console.ifri.khongisa.co.za/),
* PartnerUsers (users with Partner role) should be instructed to navigate to the partner portal (https://partner.ifri.khongisa.co.za/)"
*/
export async function notifyNewUserCreated(
params: NewUserCreatedNotificationParams
): Promise<void> {
const { userId, email, isPartner, roleName, tenantId } = params;
if (!userId || !email) return;
const orgId = tenantId ? Number(tenantId) : (getCurrentUserTenantId() || 1);
const targetUrl = isPartner ? PARTNER_PORTAL_URL : CONSOLE_PORTAL_URL;
const targetPortalName = isPartner ? 'PFM Partner Portal' : 'PFM Management Console';
const roleDisplay = roleName || (isPartner ? 'Partner' : 'Console User');
const inAppSubject = `Welcome to PFM - Your Account Has Been Created`;
const inAppMessage = isPartner
? `### Welcome to the Post-Fund Management (PFM) Platform\n\nYour user account has been successfully provisioned with the **${roleDisplay}** role.\n\nAs a designated project partner, please navigate to the **Partner Portal** to complete statutory recipient onboarding, verify banking details, and collaborate on project deliverables:\n\n👉 [Open Partner Portal](${PARTNER_PORTAL_URL})\n\n**Registered Email:** \`${email}\``
: `### Welcome to the Post-Fund Management (PFM) Platform\n\nYour user account has been successfully provisioned with the **${roleDisplay}** role.\n\nPlease log in to the **Management Console** using your registered corporate credentials to access your administrative dashboard and governance responsibilities:\n\n👉 [Open Management Console](${CONSOLE_PORTAL_URL})\n\n**Registered Email:** \`${email}\``;
const emailSubject = `Welcome to PFM - Account Provisioned & Login Instructions`;
const emailMessage = isPartner
? `### Welcome to the PFM Platform - Partner Account Activation\n\nDear Partner,\n\nYour account on the Post-Fund Management (PFM) Platform has been successfully created with the **Partner** role.\n\n**Your Access Details:**\n- **Registered Email:** ${email}\n- **Assigned Role:** ${roleDisplay}\n- **Dedicated Portal URL:** **${PARTNER_PORTAL_URL}**\n\n**Instructions:**\n1. Navigate to the Partner Portal: [${PARTNER_PORTAL_URL}](${PARTNER_PORTAL_URL})\n2. Sign in using your registered email address.\n3. Complete your organization's statutory onboarding checklist and review assigned grant awards.`
: `### Welcome to the PFM Platform - User Account Provisioned\n\nDear Colleague,\n\nYour account on the Post-Fund Management (PFM) Platform has been successfully created with the **${roleDisplay}** role.\n\n**Your Access Details:**\n- **Registered Email:** ${email}\n- **Assigned Role:** ${roleDisplay}\n- **Management Console URL:** **${CONSOLE_PORTAL_URL}**\n\n**Instructions:**\n1. Navigate to the Management Console: [${CONSOLE_PORTAL_URL}](${CONSOLE_PORTAL_URL})\n2. Sign in using your registered credentials.\n3. Access your assigned programmes, portfolios, and operational tools.`;
// 1. In-App Message
try {
const inAppReq: CreateNotificationRequest = {
organisationId: orgId,
recipient: userId,
platform: NotificationPlatform.InApp,
subject: inAppSubject,
destination: email,
message: inAppMessage,
status: NotificationStatus.Delivered,
};
await dispatchNotification(inAppReq);
} catch (err) {
console.warn('[NotificationRules] Failed to send InApp message for new user:', err);
}
// 2. Email Message
try {
const emailReq: CreateNotificationRequest = {
organisationId: orgId,
recipient: userId,
platform: NotificationPlatform.Email,
subject: emailSubject,
destination: `To: ${email} | From: PFM Security & Identity Administration`,
message: emailMessage,
status: NotificationStatus.Queued,
};
await dispatchNotification(emailReq);
} catch (err) {
console.warn('[NotificationRules] Failed to send Email message for new user:', err);
}
}
/**
* Local storage persistence helper for approved invitations ledger state.
*/
const APPROVED_INVITES_STORAGE_KEY_PREFIX = 'pfm_approved_invites_';
export function getApprovedInviteIds(tenantId?: number | string | null): string[] {
if (typeof window === 'undefined') return [];
try {
const key = `${APPROVED_INVITES_STORAGE_KEY_PREFIX}${tenantId || 'global'}`;
const raw = localStorage.getItem(key);
return raw ? JSON.parse(raw) : [];
} catch {
return [];
}
}
export function markInviteAsApprovedInStorage(
inviteId: string | number,
tenantId?: number | string | null
): void {
if (typeof window === 'undefined') return;
try {
const key = `${APPROVED_INVITES_STORAGE_KEY_PREFIX}${tenantId || 'global'}`;
const current = getApprovedInviteIds(tenantId);
const strId = String(inviteId);
if (!current.includes(strId)) {
const updated = [...current, strId];
localStorage.setItem(key, JSON.stringify(updated));
}
} catch {}
}
@@ -6,7 +6,7 @@ export const LOCAL_STORAGE_SYSTEM_ROLES_KEY = 'pfm_cache_system_roles';
export const LOCAL_STORAGE_ROLE_CLAIMS_PREFIX = 'pfm_cache_role_claims_';
export const LOCAL_STORAGE_SYSTEM_CLAIMS_KEY = 'pfm_cache_system_claims';
export const LOCAL_STORAGE_RBAC_VERSION_KEY = 'pfm_rbac_cache_version';
export const CURRENT_RBAC_CACHE_VERSION = 'v2.2';
export const CURRENT_RBAC_CACHE_VERSION = 'v2.1';
/**
* Invalidates and purges legacy cached claims if the schema version differs.
@@ -55,7 +55,6 @@ export const DEFAULT_ROLE_CLAIMS: Record<string, Claim[]> = {
],
supervisor: [
{ claimId: 20, claimType: 'dashboard', claimValue: 'view, export' },
{ claimId: 38, claimType: 'compliance', claimValue: 'view, export' },
{ claimId: 21, claimType: 'projects_milestones', claimValue: 'view, add, update, export' },
{ claimId: 22, claimType: 'grant_financials', claimValue: 'view, add, update, export' },
{ claimId: 23, claimType: 'evidence_risks', claimValue: 'view, add, update, export' },
@@ -67,7 +66,6 @@ export const DEFAULT_ROLE_CLAIMS: Record<string, Claim[]> = {
],
manager: [
{ claimId: 10, claimType: 'dashboard', claimValue: 'all' },
{ claimId: 39, claimType: 'compliance', claimValue: 'all' },
{ claimId: 11, claimType: 'projects_milestones', claimValue: 'all' },
{ claimId: 12, claimType: 'grant_financials', claimValue: 'all' },
{ claimId: 13, claimType: 'evidence_risks', claimValue: 'all' },
@@ -82,7 +80,6 @@ export const DEFAULT_ROLE_CLAIMS: Record<string, Claim[]> = {
],
executive: [
{ claimId: 1, claimType: 'dashboard', claimValue: 'all' },
{ claimId: 40, claimType: 'compliance', claimValue: 'all' },
{ claimId: 2, claimType: 'governance', claimValue: 'all' },
{ claimId: 3, claimType: 'projects_milestones', claimValue: 'all' },
{ claimId: 4, claimType: 'grant_financials', claimValue: 'all' },
@@ -520,7 +517,7 @@ export async function resolveUserRolesAndClaims(
export async function preloadAndCacheAllRoleClaims(): Promise<void> {
const roles = await fetchAndCacheSystemRoles();
await Promise.allSettled(
roles.map((role) => fetchAndCacheRoleClaims(role.id || role.Id || '', role.name || role.Name || ''))
roles.map((role) => fetchAndCacheRoleClaims(role.id, role.name))
);
}
@@ -563,7 +560,7 @@ export async function getSystemClaims(): Promise<Claim[]> {
try {
const roles = await fetchAndCacheSystemRoles();
for (const r of roles) {
const claims = await fetchAndCacheRoleClaims(r.id || r.Id || '', r.name || r.Name || '');
const claims = await fetchAndCacheRoleClaims(r.id, r.name);
claims.forEach((c) => {
const norm = normalizeClaim(c);
if (norm.claimType && !claimsMap.has(norm.claimType)) {
@@ -1,7 +1,6 @@
import { getTenant, getTenants } from './api';
import { getTenant } from './api';
import { ActivityStatus, Tenant } from '../types';
import { setActivationPending } from './userSyncService';
import { encodeHashIdSync, isAlreadyHashId } from '../utils/hashids';
export interface TenantLockoutResult {
isActive: boolean;
@@ -10,17 +9,21 @@ export interface TenantLockoutResult {
statusCode?: number;
}
// In-memory cache for fast tenant status checks (avoids repeated API round trips during navigations)
let cachedTenantLockout: {
key: string;
result: TenantLockoutResult;
timestamp: number;
} | null = null;
const LOCKOUT_CACHE_TTL_MS = 60 * 1000;
const LOCKOUT_CACHE_TTL_MS = 60 * 1000; // 60 seconds
export function clearTenantLockoutCache(): void {
cachedTenantLockout = null;
}
/**
* Checks whether a given status value corresponds to ActivityStatus.Active (1)
*/
export function isStatusActive(status: any): boolean {
if (status === undefined || status === null || status === '') {
return false;
@@ -37,6 +40,9 @@ export function isStatusActive(status: any): boolean {
return false;
}
/**
* Formats a human-readable status label from numeric or string status
*/
export function getStatusLabel(status: any): string {
if (status === ActivityStatus.Active || status === 1 || String(status).toLowerCase() === 'active') {
return 'Active';
@@ -59,36 +65,38 @@ export function getStatusLabel(status: any): string {
return 'Not Specified';
}
function isValidHashableOrHashedTenantId(val: unknown): val is number | string {
if (val === undefined || val === null || val === '') return false;
if (typeof val === 'number') {
return !isNaN(val) && isFinite(val) && val > 0;
}
if (typeof val === 'string') {
const trimmed = val.trim();
if (!trimmed) return false;
if (/^\d+$/.test(trimmed)) {
return parseInt(trimmed, 10) > 0;
}
return isAlreadyHashId(trimmed);
}
return false;
}
/**
* Calls the GetTenant endpoint for the provided tenant identifier.
*
* Rules:
* - If nothing is returned (empty response, 404, or failure) OR
* - There is a response object and its Status is not Active
* Then lockout is triggered and the existing lockout modal is shown.
*/
export async function verifyTenantLockout(
tenantId?: number | string | null,
tenantClaim?: string | null,
forceRefresh = false
): Promise<TenantLockoutResult> {
// Resolve a valid numeric ID or HashId to avoid passing plain-text tenant names to /v1/api/governance/tenants/{id}
let candidateId: number | string | null = null;
if (isValidHashableOrHashedTenantId(tenantId)) {
candidateId = tenantId;
} else if (isValidHashableOrHashedTenantId(tenantClaim)) {
candidateId = tenantClaim;
const primaryId =
tenantId !== undefined && tenantId !== null && tenantId !== ''
? tenantId
: tenantClaim !== undefined && tenantClaim !== null && tenantClaim !== ''
? tenantClaim
: null;
if (primaryId === null || primaryId === undefined || primaryId === '') {
const errorMsg =
'Tenant identification claims (tenant / tenant_id) not found in credentials. Access is restricted.';
setActivationPending(true, errorMsg);
return {
isActive: false,
tenant: null,
errorMessage: errorMsg,
};
}
const cacheKey = String(candidateId ?? tenantClaim ?? 'default-1').trim().toLowerCase();
const cacheKey = String(primaryId).trim().toLowerCase();
if (!forceRefresh && cachedTenantLockout && cachedTenantLockout.key === cacheKey) {
if (
cachedTenantLockout.result.isActive &&
@@ -101,76 +109,32 @@ export async function verifyTenantLockout(
let tenantRes: Tenant | null = null;
let lastError: any = null;
// 1. If we have a valid numeric tenantId or HashId, encode it via HashIds and call GET /v1/api/governance/tenants/{hashedId}
if (candidateId !== null) {
try {
const hashedId = encodeHashIdSync(candidateId);
tenantRes = await getTenant(hashedId || candidateId);
tenantRes = await getTenant(primaryId);
} catch (err: any) {
lastError = err;
tenantRes = null;
}
// If primary identifier returned nothing, and tenantClaim provides a different candidate, attempt fallback
if (!tenantRes && tenantClaim && String(tenantClaim) !== String(primaryId)) {
try {
tenantRes = await getTenant(tenantClaim);
lastError = null;
} catch (err: any) {
lastError = err;
tenantRes = null;
}
}
// 2. If tenant lookup by ID wasn't possible or didn't resolve, resolve via getTenants() (matching tenantClaim name if provided)
if (!tenantRes) {
try {
const allTenants = await getTenants();
if (Array.isArray(allTenants) && allTenants.length > 0) {
const claimStr = tenantClaim ? String(tenantClaim).trim().toLowerCase() : '';
const matched = claimStr
? allTenants.find(
(t) =>
(t.name && t.name.trim().toLowerCase() === claimStr) ||
String(t.id).toLowerCase() === claimStr ||
encodeHashIdSync(t.id).toLowerCase() === claimStr
)
: null;
const targetTenant = matched || allTenants.find((t) => isStatusActive((t as any).status ?? (t as any).Status)) || allTenants[0];
if (targetTenant && targetTenant.id !== undefined && targetTenant.id !== null) {
try {
const hashedTargetId = encodeHashIdSync(targetTenant.id);
tenantRes = await getTenant(hashedTargetId || targetTenant.id);
lastError = null;
} catch {
tenantRes = targetTenant;
lastError = null;
}
}
}
} catch (err: any) {
if (!lastError) lastError = err;
}
}
// 3. Final fallback: query default primary tenant ID 1 encoded as a HashId (matching ConsoleUI)
if (!tenantRes && candidateId !== 1 && candidateId !== '1') {
try {
const hashedDefaultId = encodeHashIdSync(1);
tenantRes = await getTenant(hashedDefaultId);
lastError = null;
} catch (err: any) {
if (!lastError) lastError = err;
tenantRes = null;
}
}
// Condition 1: If nothing is returned
if (!tenantRes || (typeof tenantRes === 'object' && Object.keys(tenantRes).length === 0)) {
let serverMsg =
const serverMsg =
lastError?.response?.data?.detail ||
lastError?.response?.data?.message ||
lastError?.message ||
'No tenant record returned';
if (typeof serverMsg === 'string') {
if (/^network\s*error$/i.test(serverMsg.trim())) {
serverMsg = 'Permission Check';
} else {
serverMsg = serverMsg.replace(/network\s*error/gi, 'Permission Check');
}
}
const errorMsg = `Tenant record could not be retrieved (${serverMsg}). Account is locked out.`;
setActivationPending(true, errorMsg);
return {
@@ -181,8 +145,10 @@ export async function verifyTenantLockout(
};
}
// Handle wrapped response structures: { data: { ... } } or { result: { ... } }
const tenantObj: Tenant = (tenantRes as any)?.data || (tenantRes as any)?.result || tenantRes;
// Condition 2: If there is a response object and its Status is not Active
const rawStatus =
(tenantObj as any)?.status ??
(tenantObj as any)?.Status ??
@@ -193,7 +159,7 @@ export async function verifyTenantLockout(
if (!active) {
const statusLabel = getStatusLabel(rawStatus);
const tenantName = tenantObj?.name || String(candidateId ?? tenantClaim ?? '1');
const tenantName = tenantObj?.name || String(primaryId);
const errorMsg = `Tenant account "${tenantName}" is not Active (Status: ${statusLabel}). Account is locked out.`;
setActivationPending(true, errorMsg);
return {
@@ -203,8 +169,7 @@ export async function verifyTenantLockout(
};
}
setActivationPending(false);
// Success: Response object returned and Status is Active
const successResult: TenantLockoutResult = {
isActive: true,
tenant: tenantObj,
@@ -0,0 +1,249 @@
import Hashids from 'hashids';
import { useQuery } from '@tanstack/react-query';
const env = (typeof import.meta !== 'undefined' && import.meta.env
? import.meta.env
: {}) as Record<string, string | undefined>;
/**
* Deterministic Hashids configuration matching pfm-api HasherSettings.
* Ensures 100% interoperability with the C# Hashids.net NuGet package on the backend.
*/
export const HASHER_SETTINGS = {
minHashLength: Number(env.VITE_HASHER_MIN_LENGTH) || 11,
salt:
(env.VITE_HASHER_SALT as string) ||
'TGlnaHQgQ2hhcm1zLCBNaWRyYW5kQm9va3MgbWFrZSBsb3RzIG9mIG1vbmV5IGFuZCBhcmUgYSBzdWNjZXNzZnVsIHZpcmFsIHN0b3J5IGluIFNvdXRoIEFmcmljYQ==',
};
// Singleton Hashids instance initialized with salt & minHashLength
let hasher = new Hashids(HASHER_SETTINGS.salt, HASHER_SETTINGS.minHashLength);
/**
* Dynamically reconfigures the deterministic Hashids instance from runtime configuration.
*/
export function updateHasherSettings(salt?: string, minLength?: number | string): void {
let updated = false;
if (salt && typeof salt === 'string' && salt.trim() !== '') {
HASHER_SETTINGS.salt = salt.trim();
updated = true;
}
if (minLength !== undefined && minLength !== null && minLength !== '') {
const parsed = Number(minLength);
if (!isNaN(parsed) && parsed > 0) {
HASHER_SETTINGS.minHashLength = parsed;
updated = true;
}
}
if (updated) {
hasher = new Hashids(HASHER_SETTINGS.salt, HASHER_SETTINGS.minHashLength);
}
}
/**
* Checks whether an incoming string is already a valid Hashid matching the configured salt and min length.
* Prevents double-encoding already-hashed route parameters or IDs.
*/
function isAlreadyHashId(candidate: string): boolean {
if (typeof candidate !== 'string' || candidate.length < HASHER_SETTINGS.minHashLength) {
return false;
}
try {
const decoded = hasher.decode(candidate);
return Array.isArray(decoded) && decoded.length > 0;
} catch {
return false;
}
}
/**
* Deterministically encodes a numeric ID or numeric string into a HashID string.
* Synchronous and does not perform HTTP network round trips.
*/
export function encodeHashIdSync(id: number | string | null | undefined): string {
if (id === undefined || id === null || id === '') {
return '';
}
// If already a number
if (typeof id === 'number') {
if (isNaN(id) || !isFinite(id) || id < 0) return '';
return hasher.encode(id);
}
const str = String(id).trim();
if (!str) return '';
// Check if string is already a valid HashID
if (isAlreadyHashId(str)) {
return str;
}
// Check if string is pure digits (e.g. "123")
if (/^\d+$/.test(str)) {
try {
const num = parseInt(str, 10);
if (!isNaN(num) && num >= 0) {
return hasher.encode(num);
}
} catch {
// Fall through
}
}
// Non-numeric identifiers (UUIDs, codes) returned as-is
return str;
}
/**
* Deterministically decodes a HashID string back to original numeric ID or string.
* Synchronous and does not perform HTTP network round trips.
*/
export function decodeHashIdSync(hashId: string | number | null | undefined): number | string {
if (hashId === undefined || hashId === null || hashId === '') return '';
if (typeof hashId === 'number') return hashId;
const str = String(hashId).trim();
if (!str) return '';
// If already pure integer string
if (/^-?\d+$/.test(str)) {
const parsed = parseInt(str, 10);
return isNaN(parsed) ? str : parsed;
}
try {
const decoded = hasher.decode(str);
if (Array.isArray(decoded) && decoded.length > 0) {
return Number(decoded[0]);
}
} catch {
// If decoding fails, return raw string
}
return str;
}
/**
* Decodes a HashID or numeric value strictly to a canonical integer.
* Useful for request payloads expecting int64 integers.
*/
export function decodeToNumberSync(hashId: number | string | null | undefined): number {
if (hashId === null || hashId === undefined || hashId === '') return 0;
if (typeof hashId === 'number') {
return isNaN(hashId) ? 0 : Math.trunc(hashId);
}
const str = String(hashId).trim();
if (/^-?\d+$/.test(str)) {
const parsed = parseInt(str, 10);
return isNaN(parsed) ? 0 : parsed;
}
try {
const decoded = hasher.decode(str);
if (Array.isArray(decoded) && decoded.length > 0) {
return Number(decoded[0]);
}
} catch {}
const fallback = Number(str);
return isNaN(fallback) ? 0 : Math.trunc(fallback);
}
export const toolsService = {
/**
* Synchronous encoding
*/
encodeIdSync(id: number | string | null | undefined): string {
return encodeHashIdSync(id);
},
/**
* Synchronous decoding
*/
decodeIdSync(hashId: string | number | null | undefined): number | string {
return decodeHashIdSync(hashId);
},
/**
* Synchronous decoding strictly to canonical integer
*/
decodeToNumberSync(hashId: number | string | null | undefined): number {
return decodeToNumberSync(hashId);
},
/**
* Encodes a raw ID to a HashID (returns Promise for backward compatibility with existing callers)
*/
async encodeId(id: number | string | null | undefined, _context = 'general'): Promise<string> {
return encodeHashIdSync(id);
},
/**
* Decodes a HashID string back to original identifier
*/
async decodeId(hashId: string | null | undefined, _context = 'general'): Promise<number | string> {
return decodeHashIdSync(hashId);
},
/**
* Domain-specific convenience resolvers for entities
*/
async resolveProjectId(projectId: number | string): Promise<string> {
return encodeHashIdSync(projectId);
},
async resolveOrganisationId(organisationId: number | string): Promise<string> {
return encodeHashIdSync(organisationId);
},
async resolveProgrammeId(programmeId: number | string): Promise<string> {
return encodeHashIdSync(programmeId);
},
async resolvePortfolioId(portfolioId: number | string): Promise<string> {
return encodeHashIdSync(portfolioId);
},
async resolveAwardId(awardId: number | string): Promise<string> {
return encodeHashIdSync(awardId);
},
async resolveContractId(contractId: number | string): Promise<string> {
return encodeHashIdSync(contractId);
},
/**
* Resolves query parameters or path variables encoded as HashIDs before performing API calls
*/
async resolveHashedParams<T extends Record<string, any>>(
params: T,
keysToHash: (keyof T)[]
): Promise<T> {
const resolved: any = { ...params };
for (const key of keysToHash) {
const val = params[key];
if (val !== undefined && val !== null) {
resolved[key] = encodeHashIdSync(val);
}
}
return resolved;
},
/**
* Compatibility cache primer (now a no-op as Hashids calculation is instantaneous client-side)
*/
async primeCache(_items: { id: number | string; context: string }[]): Promise<void> {
// No-op - instant deterministic computation
},
};
/**
* React Hook for consuming HashIDs with TanStack Query caching in components
*/
export function useHashId(id?: number | string | null, context = 'general') {
return useQuery({
queryKey: ['hashId', context, id !== undefined && id !== null ? String(id) : ''],
queryFn: () => Promise.resolve(encodeHashIdSync(id)),
enabled: id !== undefined && id !== null && id !== '',
staleTime: Infinity,
});
}
@@ -252,22 +252,47 @@ async function executeBackendSync(
organisationId: resolvedOrgId,
};
const endpoint = '/v1/api/integration/sync';
const candidateEndpoints = USER_SYNC_CANDIDATE_ENDPOINTS;
let lastError: any = null;
for (const endpoint of candidateEndpoints) {
try {
const res = await apiClient.post(endpoint, payload);
let res;
if (endpoint === '/v1/api/integration/sync') {
try {
res = await apiClient.post(endpoint, payload);
} catch (postErr: any) {
const errStatus = postErr?.response?.status;
if (errStatus === 400 || errStatus === 415 || errStatus === 422) {
res = await apiClient.post(endpoint, {});
} else {
throw postErr;
}
}
} else {
res = await apiClient.post(endpoint, payload);
}
return { endpoint, data: res?.data };
} catch (err: any) {
lastError = err;
const status = err?.response?.status;
if (status === 400 || status === 415 || status === 422) {
try {
const resFallback = await apiClient.post(endpoint, {});
return { endpoint, data: resFallback?.data };
} catch (fallbackErr) {
// Fail fast on token expiration/invalid
if (status === 401) {
throw err;
}
}
// User blocked or pending activation
if (status === 403 || status === 423) {
throw err;
}
// If 404 or 405, continue to next fallback candidate
}
}
throw lastError || new Error('Failed to reach user sync endpoint');
}
/**
@@ -328,21 +353,13 @@ export async function syncUserAccount(
// Non-401 error: Account is registered/authenticated, but administrator has not enabled it yet
clearSuccessfulSyncRecord();
let serverMsg =
const serverMsg =
err?.response?.data?.detail ||
err?.response?.data?.message ||
err?.response?.data?.error ||
err?.message ||
'Account is not yet enabled by the administrator.';
if (typeof serverMsg === 'string') {
if (/^network\s*error$/i.test(serverMsg.trim())) {
serverMsg = 'Permission Check';
} else {
serverMsg = serverMsg.replace(/network\s*error/gi, 'Permission Check');
}
}
setActivationPending(true, serverMsg);
return {
+2 -37
View File
@@ -28,7 +28,6 @@ export enum NotificationStatus {
Failed = 7,
Cancelled = 8,
Bounced = 9,
Draft = 10,
}
export enum NotificationPlatform {
@@ -214,12 +213,6 @@ export enum ApprovalStatus {
PendingReview = 2,
}
export enum ComplianceStatus {
NotMet = 1,
Met = 2,
Exceeded = 3,
}
export enum ActivityStatus {
Active = 1,
Inactive = 2,
@@ -783,10 +776,7 @@ export interface Risk {
createdAt: string;
owner?: string;
mitigationAction?: string;
mitigation?: string | null;
status?: string;
category?: string | null;
title?: string | null;
}
export interface CreateRiskRequest {
@@ -857,24 +847,6 @@ export interface InviteRequest {
platform: NotificationPlatform;
}
export interface CreateNotificationRequest {
organisationId: number | string;
recipient: string;
platform: NotificationPlatform;
subject?: string | null;
destination?: string | null;
message: string;
status?: NotificationStatus;
}
export interface UpdateNotificationRequest {
notificationId: number;
destination?: string | null;
status: NotificationStatus;
sentAt?: string | null;
error?: string | null;
}
// ==========================================
// New OpenAPI 3.1.1 Entities & Request Models
// ==========================================
@@ -939,7 +911,6 @@ export interface Outcome {
beneficiaryId: number | string;
name: string | null;
description: string | null;
status?: ComplianceStatus | number;
createdBy?: string;
createdAt?: string;
}
@@ -948,14 +919,12 @@ export interface CreateOutcomeRequest {
beneficiaryId: number | string;
name: string;
description: string;
status?: ComplianceStatus | number;
}
export interface UpdateOutcomeRequest {
outcomeId: number | string;
name: string;
description: string;
status: ComplianceStatus | number;
}
export interface ChangeRequest {
@@ -993,10 +962,9 @@ export interface ComplianceItem {
id: number | string;
tenantId?: number | string;
projectId: number | string;
beneficiaryId?: number | string | null;
title: string | null;
requirements: string | null;
status: ComplianceStatus | ApprovalStatus | number;
status: ApprovalStatus;
createdBy: string;
verifiedBy?: string | null;
createdAt: string;
@@ -1007,16 +975,13 @@ export interface CreateComplianceItemRequest {
projectId: number | string;
title: string;
requirements: string;
status?: ComplianceStatus | number;
beneficiaryId?: number | string | null;
}
export interface UpdateComplianceItemRequest {
complianceItemId: number | string;
title: string;
requirements: string;
status: ComplianceStatus | number;
beneficiaryId?: number | string | null;
status: ApprovalStatus;
}
export interface Issue {
@@ -4,13 +4,11 @@ const env = (typeof import.meta !== 'undefined' && import.meta.env
? import.meta.env
: {}) as Record<string, string | undefined>;
export const DEFAULT_HASHER_SALT =
'TGlnaHQgQ2hhcm1zLCBNaWRyYW5kQm9va3MgbWFrZSBsb3RzIG9mIG1vbmV5IGFuZCBhcmUgYSBzdWNjZXNzZnVsIHZpcmFsIHN0b3J5IGluIFNvdXRoIEFmcmljYQ==';
export const DEFAULT_MIN_HASH_LENGTH = 11;
export const HASHER_SETTINGS = {
minHashLength: Number(env.VITE_HASHER_MIN_LENGTH) || DEFAULT_MIN_HASH_LENGTH,
salt: (env.VITE_HASHER_SALT as string) || DEFAULT_HASHER_SALT,
minHashLength: Number(env.VITE_HASHER_MIN_LENGTH) || 11,
salt:
(env.VITE_HASHER_SALT as string) ||
'TGlnaHQgQ2hhcm1zLCBNaWRyYW5kQm9va3MgbWFrZSBsb3RzIG9mIG1vbmV5IGFuZCBhcmUgYSBzdWNjZXNzZnVsIHZpcmFsIHN0b3J5IGluIFNvdXRoIEFmcmljYQ==',
};
let hasher = new Hashids(HASHER_SETTINGS.salt, HASHER_SETTINGS.minHashLength);
@@ -37,27 +35,14 @@ export function updateHasherSettings(salt?: string, minLength?: number | string)
* Validates if candidate is already a HashID generated by this hasher.
*/
export function isHashId(candidate: string | null | undefined): boolean {
if (
!candidate ||
typeof candidate !== 'string' ||
candidate.length < HASHER_SETTINGS.minHashLength ||
/^\d+$/.test(candidate)
) {
if (!candidate || typeof candidate !== 'string' || candidate.length < HASHER_SETTINGS.minHashLength) {
return false;
}
try {
const decodedNumbers = hasher.decode(candidate);
if (Array.isArray(decodedNumbers) && decodedNumbers.length > 0) {
if (hasher.encode(decodedNumbers as number[]) === candidate) {
return true;
}
}
if (Array.isArray(decodedNumbers) && decodedNumbers.length > 0) return true;
const decodedHex = hasher.decodeHex(candidate);
if (decodedHex && decodedHex.length > 0) {
if (hasher.encodeHex(decodedHex) === candidate) {
return true;
}
}
if (decodedHex && decodedHex.length > 0) return true;
} catch {
return false;
}
@@ -209,132 +194,3 @@ export function decodeEntityId(hashId: string | number | null | undefined): stri
return str;
}
/**
* Checks whether an incoming string is already a valid Hashid matching the configured salt and min length.
* Prevents double-encoding already-hashed route parameters or IDs.
*/
export function isAlreadyHashId(candidate: string | null | undefined): boolean {
return isHashId(candidate);
}
/**
* Deterministically encodes a numeric ID or numeric string into a HashID string.
* Synchronous and does not perform HTTP network round trips.
*/
export function encodeHashIdSync(id: number | string | bigint | null | undefined): string {
return encodeEntityId(id);
}
/**
* Deterministically decodes a HashID string back to original numeric ID or string.
* Synchronous and does not perform HTTP network round trips.
*/
export function decodeHashIdSync(hashId: string | number | null | undefined): number | string {
if (hashId === undefined || hashId === null || hashId === '') return '';
if (typeof hashId === 'number') return hashId;
const str = String(hashId).trim();
if (!str) return '';
if (/^-?\d+$/.test(str)) {
const parsed = parseInt(str, 10);
return isNaN(parsed) ? str : parsed;
}
try {
const decoded = hasher.decode(str);
if (Array.isArray(decoded) && decoded.length > 0) {
return Number(decoded[0]);
}
const decodedHex = hasher.decodeHex(str);
if (decodedHex) {
const num = Number(BigInt('0x' + decodedHex));
if (!isNaN(num)) return Math.trunc(num);
}
} catch {}
return str;
}
/**
* Decodes a HashID or numeric value strictly to a canonical integer.
* Useful for request payloads expecting int64 integers.
*/
export function decodeToNumberSync(hashId: number | string | null | undefined): number {
if (hashId === null || hashId === undefined || hashId === '') return 0;
if (typeof hashId === 'number') {
return isNaN(hashId) ? 0 : Math.trunc(hashId);
}
const str = String(hashId).trim();
if (/^-?\d+$/.test(str)) {
const parsed = parseInt(str, 10);
return isNaN(parsed) ? 0 : parsed;
}
try {
const decoded = hasher.decode(str);
if (Array.isArray(decoded) && decoded.length > 0) {
return Number(decoded[0]);
}
const decodedHex = hasher.decodeHex(str);
if (decodedHex) {
const num = Number(BigInt('0x' + decodedHex));
if (!isNaN(num)) return Math.trunc(num);
}
} catch {}
const fallback = Number(str);
return isNaN(fallback) ? 0 : Math.trunc(fallback);
}
/**
* Legacy service resolver facade for compatibility with API endpoints and monitoring tables.
*/
export const toolsService = {
encodeIdSync(id: number | string | bigint | null | undefined): string {
return encodeHashIdSync(id);
},
decodeIdSync(hashId: string | number | null | undefined): number | string {
return decodeHashIdSync(hashId);
},
decodeToNumberSync(hashId: number | string | null | undefined): number {
return decodeToNumberSync(hashId);
},
async encodeId(id: number | string | bigint | null | undefined): Promise<string> {
return encodeHashIdSync(id);
},
async decodeId(hashId: string | number | null | undefined): Promise<number | string> {
return decodeHashIdSync(hashId);
},
async resolveProjectId(projectId: number | string): Promise<string> {
return encodeHashIdSync(projectId);
},
async resolveOrganisationId(organisationId: number | string): Promise<string> {
return encodeHashIdSync(organisationId);
},
async resolveProgrammeId(programmeId: number | string): Promise<string> {
return encodeHashIdSync(programmeId);
},
async resolvePortfolioId(portfolioId: number | string): Promise<string> {
return encodeHashIdSync(portfolioId);
},
async resolveAwardId(awardId: number | string): Promise<string> {
return encodeHashIdSync(awardId);
},
async resolveContractId(contractId: number | string): Promise<string> {
return encodeHashIdSync(contractId);
},
async resolveHashedParams<T extends Record<string, any>>(
params: T,
keysToHash: (keyof T)[]
): Promise<T> {
const resolved: any = { ...params };
for (const key of keysToHash) {
const val = params[key];
if (val !== undefined && val !== null) {
resolved[key] = encodeHashIdSync(val);
}
}
return resolved;
},
async primeCache(): Promise<void> {},
};
+1 -2
View File
@@ -4,9 +4,8 @@ interface ImportMetaEnv {
readonly VITE_OIDC_AUTHORITY?: string;
readonly VITE_OIDC_AUDIENCE?: string;
readonly VITE_OIDC_CLIENT_ID?: string;
readonly VITE_OIDC_CLIENT_SECRET?: string;
readonly VITE_API_BASE_URL?: string;
readonly VITE_HASHER_SALT?: string;
readonly VITE_HASHER_MIN_LENGTH?: string;
}
interface ImportMeta {
+2 -2
View File
@@ -50,7 +50,7 @@ export default defineConfig(async ({ command }) => {
build: {
chunkSizeWarningLimit: 600,
rollupOptions: {
onwarn(warning: any, defaultHandler: any) {
onwarn(warning, defaultHandler) {
// Suppress benign Rollup warnings where Zod's internal explanatory doc comments mention `@__PURE__`
if (
warning.code === 'INVALID_ANNOTATION' &&
@@ -61,7 +61,7 @@ export default defineConfig(async ({ command }) => {
defaultHandler(warning);
},
output: {
manualChunks(id: string) {
manualChunks(id) {
if (id.includes('node_modules')) {
// 1. Heavy export and PDF document generation
if (id.includes('xlsx')) {
@@ -9,8 +9,6 @@ public class ComplianceItem : Models.ComplianceItem, ITenantEntity
public virtual Project? Project { get; set; }
public virtual Beneficiary? Beneficiary { get; set; }
public virtual User? Creator { get; set; }
public virtual User? Verifier { get; set; }
@@ -25,7 +23,6 @@ public sealed class ComplianceItemConfiguration : IEntityTypeConfiguration<Compl
builder.HasKey(pk => pk.Id);
builder.Property(f => f.TenantId).IsRequired();
builder.Property(f => f.ProjectId).IsRequired();
builder.Property(f => f.BeneficiaryId).IsRequired(false);
builder.Property(f => f.CreatedBy).IsRequired();
builder.Property(f => f.VerifiedBy).IsRequired(false);
builder.Property(f => f.CreatedAt).IsRequired().HasDefaultValueSql("now()");
@@ -33,7 +30,7 @@ public sealed class ComplianceItemConfiguration : IEntityTypeConfiguration<Compl
builder.Property(f => f.Title).IsRequired().HasMaxLength(LabelLength);
builder.Property(f => f.Requirements).IsRequired().HasMaxLength(MediumTextLength);
builder.Property(f => f.Status).IsRequired().HasConversion<int>().HasDefaultValueSql("1")
.HasSentinel(ComplianceStatus.NotMet);
.HasSentinel(ApprovalStatus.Pending);
builder.HasOne(f => f.Project)
.WithMany()
@@ -41,12 +38,6 @@ public sealed class ComplianceItemConfiguration : IEntityTypeConfiguration<Compl
.IsRequired()
.OnDelete(DeleteBehavior.Restrict);
builder.HasOne(f => f.Beneficiary)
.WithMany()
.HasForeignKey(fk => fk.BeneficiaryId)
.IsRequired(false)
.OnDelete(DeleteBehavior.SetNull);
builder.HasOne(f => f.Creator)
.WithMany()
.HasForeignKey(fk => fk.CreatedBy)
@@ -25,8 +25,6 @@ public sealed class OutcomeConfiguration : IEntityTypeConfiguration<Outcome>
builder.Property(f => f.CreatedAt).IsRequired().HasDefaultValueSql("now()");
builder.Property(f => f.Name).IsRequired().HasMaxLength(LabelLength);
builder.Property(f => f.Description).IsRequired().HasMaxLength(TextLength);
builder.Property(f => f.Status).IsRequired().HasConversion<int>().HasDefaultValueSql("1")
.HasSentinel(ComplianceStatus.NotMet);
builder.HasOne(f => f.Tenant)
.WithMany()
-8
View File
@@ -23,7 +23,6 @@ public enum NotificationStatus : int
Failed = 7,
Cancelled = 8,
Bounced = 9,
Draft = 10,
}
public enum NotificationPlatform : int
@@ -199,10 +198,3 @@ public enum ActivityStatus : int
Inactive = 2,
Disabled = 3,
}
public enum ComplianceStatus : int
{
NotMet = 1,
Met = 2,
Exceeded = 3,
}
@@ -27,5 +27,5 @@ public static class Constants
public const int ShortLabelLength = 100;
public const int TextLength = 1024;
public const int MediumTextLength = 2048;
public const int LargeTextLength = 1_048_576; // 1 MB — accommodates branded HTML emails with embedded logo
public const int LargeTextLength = 4096;
}
@@ -137,7 +137,6 @@ public static class Mappers
CreatedAt = entity.CreatedAt,
CreatedBy = entity.CreatedBy,
ProjectId = entity.ProjectId,
BeneficiaryId = entity.BeneficiaryId,
Requirements = entity.Requirements,
Status = entity.Status,
Title = entity.Title,
@@ -289,8 +288,7 @@ public static class Mappers
CreatedAt = entity.CreatedAt,
CreatedBy = entity.CreatedBy,
Description = entity.Description,
Name = entity.Name,
Status = entity.Status
Name = entity.Name
};
public static Portfolio Map(this Entities.Portfolio entity) => new()
@@ -8,13 +8,11 @@ public class ComplianceItem
public long ProjectId { get; set; }
public long? BeneficiaryId { get; set; }
public string? Title { get; set; }
public string? Requirements { get; set; }
public ComplianceStatus Status { get; set; } = ComplianceStatus.NotMet;
public ApprovalStatus Status { get; set; }
public Guid CreatedBy { get; set; }
@@ -15,6 +15,4 @@ public class Outcome
public string? Name { get; set; }
public string? Description { get; set; }
public ComplianceStatus Status { get; set; } = ComplianceStatus.NotMet;
}
@@ -1,60 +0,0 @@
using Microsoft.EntityFrameworkCore.Migrations;
#nullable disable
namespace PostFundManagement.Infrastructure.Database.Migrations
{
/// <inheritdoc />
public partial class AddedComplianceStatusAndBeneficiaryLink : Migration
{
/// <inheritdoc />
protected override void Up(MigrationBuilder migrationBuilder)
{
migrationBuilder.AddColumn<int>(
name: "Status",
table: "Outcomes",
type: "integer",
nullable: false,
defaultValueSql: "1");
migrationBuilder.AddColumn<long>(
name: "BeneficiaryId",
table: "ComplianceItems",
type: "bigint",
nullable: true);
migrationBuilder.CreateIndex(
name: "IX_ComplianceItems_BeneficiaryId",
table: "ComplianceItems",
column: "BeneficiaryId");
migrationBuilder.AddForeignKey(
name: "FK_ComplianceItems_Beneficiaries_BeneficiaryId",
table: "ComplianceItems",
column: "BeneficiaryId",
principalTable: "Beneficiaries",
principalColumn: "Id",
onDelete: ReferentialAction.SetNull);
}
/// <inheritdoc />
protected override void Down(MigrationBuilder migrationBuilder)
{
migrationBuilder.DropForeignKey(
name: "FK_ComplianceItems_Beneficiaries_BeneficiaryId",
table: "ComplianceItems");
migrationBuilder.DropIndex(
name: "IX_ComplianceItems_BeneficiaryId",
table: "ComplianceItems");
migrationBuilder.DropColumn(
name: "Status",
table: "Outcomes");
migrationBuilder.DropColumn(
name: "BeneficiaryId",
table: "ComplianceItems");
}
}
}
@@ -1,60 +0,0 @@
using Microsoft.EntityFrameworkCore.Migrations;
#nullable disable
namespace PostFundManagement.Infrastructure.Database.Migrations
{
/// <inheritdoc />
public partial class IncreasedLargeTextLengthTo1MB : Migration
{
/// <inheritdoc />
protected override void Up(MigrationBuilder migrationBuilder)
{
migrationBuilder.AlterColumn<string>(
name: "Findings",
table: "SiteVisits",
type: "character varying(1048576)",
maxLength: 1048576,
nullable: true,
oldClrType: typeof(string),
oldType: "character varying(4096)",
oldMaxLength: 4096,
oldNullable: true);
migrationBuilder.AlterColumn<string>(
name: "Message",
table: "Notifications",
type: "character varying(1048576)",
maxLength: 1048576,
nullable: false,
oldClrType: typeof(string),
oldType: "character varying(4096)",
oldMaxLength: 4096);
}
/// <inheritdoc />
protected override void Down(MigrationBuilder migrationBuilder)
{
migrationBuilder.AlterColumn<string>(
name: "Findings",
table: "SiteVisits",
type: "character varying(4096)",
maxLength: 4096,
nullable: true,
oldClrType: typeof(string),
oldType: "character varying(1048576)",
oldMaxLength: 1048576,
oldNullable: true);
migrationBuilder.AlterColumn<string>(
name: "Message",
table: "Notifications",
type: "character varying(4096)",
maxLength: 4096,
nullable: false,
oldClrType: typeof(string),
oldType: "character varying(1048576)",
oldMaxLength: 1048576);
}
}
}
@@ -393,9 +393,6 @@ namespace PostFundManagement.Infrastructure.Database.Migrations
NpgsqlPropertyBuilderExtensions.UseIdentityByDefaultColumn(b.Property<long>("Id"));
b.Property<long?>("BeneficiaryId")
.HasColumnType("bigint");
b.Property<DateTime>("CreatedAt")
.ValueGeneratedOnAdd()
.HasColumnType("timestamp with time zone")
@@ -433,8 +430,6 @@ namespace PostFundManagement.Infrastructure.Database.Migrations
b.HasKey("Id");
b.HasIndex("BeneficiaryId");
b.HasIndex("CreatedBy");
b.HasIndex("ProjectId");
@@ -958,8 +953,8 @@ namespace PostFundManagement.Infrastructure.Database.Migrations
b.Property<string>("Message")
.IsRequired()
.HasMaxLength(1048576)
.HasColumnType("character varying(1048576)");
.HasMaxLength(4096)
.HasColumnType("character varying(4096)");
b.Property<long>("OrganisationId")
.HasColumnType("bigint");
@@ -1083,11 +1078,6 @@ namespace PostFundManagement.Infrastructure.Database.Migrations
.HasMaxLength(256)
.HasColumnType("character varying(256)");
b.Property<int>("Status")
.ValueGeneratedOnAdd()
.HasColumnType("integer")
.HasDefaultValueSql("1");
b.Property<long>("TenantId")
.HasColumnType("bigint");
@@ -1405,8 +1395,8 @@ namespace PostFundManagement.Infrastructure.Database.Migrations
.HasColumnType("uuid");
b.Property<string>("Findings")
.HasMaxLength(1048576)
.HasColumnType("character varying(1048576)");
.HasMaxLength(4096)
.HasColumnType("character varying(4096)");
b.Property<string>("InspectorName")
.IsRequired()
@@ -1796,11 +1786,6 @@ namespace PostFundManagement.Infrastructure.Database.Migrations
modelBuilder.Entity("PostFundManagement.Domain.Entities.ComplianceItem", b =>
{
b.HasOne("PostFundManagement.Domain.Entities.Beneficiary", "Beneficiary")
.WithMany()
.HasForeignKey("BeneficiaryId")
.OnDelete(DeleteBehavior.SetNull);
b.HasOne("PostFundManagement.Domain.Entities.User", "Creator")
.WithMany()
.HasForeignKey("CreatedBy")
@@ -1824,8 +1809,6 @@ namespace PostFundManagement.Infrastructure.Database.Migrations
.HasForeignKey("VerifiedBy")
.OnDelete(DeleteBehavior.NoAction);
b.Navigation("Beneficiary");
b.Navigation("Creator");
b.Navigation("Project");
@@ -26,20 +26,22 @@ OIDC_AUDIENCE="${VITE_OIDC_AUDIENCE:-${OIDC_AUDIENCE:-${SecuritySettings__Audien
# 4. OIDC Client ID
OIDC_CLIENT_ID="${VITE_OIDC_CLIENT_ID:-${OIDC_CLIENT_ID:-${SecuritySettings__ClientId:-${SecuritySettings_ClientId:-${CLIENT_ID:-}}}}}"
# 5. OIDC Scope
# 5. OIDC Client Secret
OIDC_CLIENT_SECRET="${VITE_OIDC_CLIENT_SECRET:-${OIDC_CLIENT_SECRET:-${SecuritySettings__ClientSecret:-${SecuritySettings_ClientSecret:-${CLIENT_SECRET:-}}}}}"
# 6. OIDC Scope
OIDC_SCOPE="${VITE_OIDC_SCOPE:-${OIDC_SCOPE:-${SecuritySettings__Scope:-${SecuritySettings_Scope:-${SCOPE:-}}}}}"
# 6. Hasher Settings
# 7. Hasher Settings
HASHER_SALT="${VITE_HASHER_SALT:-${HASHER_SALT:-${HasherSettings__Salt:-${HasherSettings_Salt:-}}}}}"
HASHER_MIN_LENGTH="${VITE_HASHER_MIN_LENGTH:-${HASHER_MIN_LENGTH:-${HasherSettings__MinLength:-${HasherSettings_MinLength:-}}}}}"
if [ -d "$TARGET_DIR" ]; then
echo "[docker-entrypoint] Generating runtime configuration files in $TARGET_DIR..."
# Generate env-config.js for instant, synchronous window.__RUNTIME_CONFIG__ initialization
# Public SPA clients use Authorization Code flow with PKCE; client secrets and hasher salts must NEVER be injected or exposed here.
cat <<EOF > "$TARGET_DIR/env-config.js"
// Generated dynamically at container startup from deployment environment variables
// Note: Secrets such as client secrets, private keys, or hashing salts must NEVER be exposed here.
window.__RUNTIME_CONFIG__ = {
API_BASE_URL: "${API_BASE_URL}",
VITE_API_BASE_URL: "${API_BASE_URL}",
@@ -49,8 +51,12 @@ window.__RUNTIME_CONFIG__ = {
VITE_OIDC_AUDIENCE: "${OIDC_AUDIENCE}",
OIDC_CLIENT_ID: "${OIDC_CLIENT_ID}",
VITE_OIDC_CLIENT_ID: "${OIDC_CLIENT_ID}",
OIDC_CLIENT_SECRET: "${OIDC_CLIENT_SECRET}",
VITE_OIDC_CLIENT_SECRET: "${OIDC_CLIENT_SECRET}",
OIDC_SCOPE: "${OIDC_SCOPE}",
VITE_OIDC_SCOPE: "${OIDC_SCOPE}",
HASHER_SALT: "${HASHER_SALT}",
VITE_HASHER_SALT: "${HASHER_SALT}",
HASHER_MIN_LENGTH: "${HASHER_MIN_LENGTH}",
VITE_HASHER_MIN_LENGTH: "${HASHER_MIN_LENGTH}",
ApiSettings: {
@@ -60,9 +66,11 @@ window.__RUNTIME_CONFIG__ = {
Authority: "${OIDC_AUTHORITY}",
Audience: "${OIDC_AUDIENCE}",
ClientId: "${OIDC_CLIENT_ID}",
ClientSecret: "${OIDC_CLIENT_SECRET}",
Scope: "${OIDC_SCOPE}"
},
HasherSettings: {
Salt: "${HASHER_SALT}",
MinHashLength: "${HASHER_MIN_LENGTH}"
}
};
@@ -78,9 +86,11 @@ EOF
"Authority": "${OIDC_AUTHORITY}",
"Audience": "${OIDC_AUDIENCE}",
"ClientId": "${OIDC_CLIENT_ID}",
"ClientSecret": "${OIDC_CLIENT_SECRET}",
"Scope": "${OIDC_SCOPE}"
},
"HasherSettings": {
"Salt": "${HASHER_SALT}",
"MinHashLength": "${HASHER_MIN_LENGTH}"
}
}
+3 -3
View File
@@ -1,5 +1,5 @@
<!doctype html>
<html lang="en" class="dark h-full bg-slate-950 text-slate-100">
<html lang="en" class="h-full bg-slate-950 text-slate-100">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
@@ -10,8 +10,8 @@
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link href="https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@300;400;500;600;700;800&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
</head>
<body class="dark h-full bg-slate-950 font-sans text-slate-100 antialiased selection:bg-emerald-500/20 selection:text-emerald-300">
<div id="root" class="min-h-full flex flex-col bg-slate-950 text-slate-100"></div>
<body class="h-full bg-slate-950 font-sans text-slate-100 antialiased selection:bg-emerald-500/20 selection:text-emerald-300">
<div id="root" class="min-h-full flex flex-col"></div>
<script src="/env-config.js"></script>
<script type="module" src="/src/main.tsx"></script>
</body>
@@ -1,15 +1,16 @@
{
"_comment": "Runtime configuration for Docker/Kubernetes deployments. Leave values empty in source control so local .env (VITE_*) variables are used during development. Container entrypoint scripts can populate these fields at container startup.",
"SecuritySettings": {
"Authority": "",
"Audience": "",
"ClientId": "",
"Scope": ""
},
"ApiSettings": {
"BaseUrl": ""
"BaseUrl": "https://api.ifri.khongisa.co.za/"
},
"SecuritySettings": {
"Authority": "https://sts.security.khongisa.co.za",
"Audience": "pfm-api-dev",
"ClientId": "pfm-scalar-dev",
"ClientSecret": "secret_71f88570a46eb22eb5270b47f69e3332c84d8db85d008f0276cb7431c8872d27",
"Scope": "openid profile roles email address pfm-api-dev"
},
"HasherSettings": {
"MinHashLength": ""
"Salt": "TGlnaHQgQ2hhcm1zLCBNaWRyYW5kQm9va3MgbWFrZSBsb3RzIG9mIG1vbmV5IGFuZCBhcmUgYSBzdWNjZXNzZnVsIHZpcmFsIHN0b3J5IGluIFNvdXRoIEFmcmljYQ==",
"MinHashLength": 11
}
}
+27 -8
View File
@@ -2,10 +2,29 @@ import React from 'react';
import { BrowserRouter, Routes, Route, Navigate } from 'react-router-dom';
import { QueryClientProvider } from '@tanstack/react-query';
import { queryClient } from './lib/queryClient';
import { AuthProvider, ProtectedRoute, useAuth } from './auth/AuthProvider';
import { ToastProvider } from './components/ui/Toast';
import { AuthProvider, useAuth } from './auth/AuthProvider';
import { LandingPage } from './components/landing/LandingPage';
import { DashboardPage } from './components/dashboard/DashboardPage';
import { LaserDivider } from './components/layout/LaserDivider';
function AuthenticatedLayout() {
return (
<div className="h-screen w-screen overflow-hidden bg-slate-950 text-slate-100 flex flex-row select-none">
{/* Fixed-width vertical navigation pane on the left */}
<aside className="w-64 sm:w-72 md:w-80 shrink-0 h-full relative flex flex-col">
{/* Navigation placeholder / empty clean pane */}
</aside>
{/* Laser beam divider with central light source */}
<LaserDivider />
{/* Content pane occupying the rest of the screen */}
<main className="flex-1 h-full min-w-0 relative flex flex-col overflow-y-auto">
<DashboardPage />
</main>
</div>
);
}
function AppRoutes() {
const { isAuthenticated, isLoading, login } = useAuth();
@@ -36,14 +55,16 @@ function AppRoutes() {
<Route
path="/dashboard"
element={
<ProtectedRoute>
<DashboardPage />
</ProtectedRoute>
isAuthenticated ? (
<AuthenticatedLayout />
) : (
<LandingPage onLogin={login} isLoading={isLoading} />
)
}
/>
<Route
path="*"
element={<Navigate to={isAuthenticated ? '/dashboard' : '/'} replace />}
element={<Navigate to={isAuthenticated ? "/dashboard" : "/"} replace />}
/>
</Routes>
);
@@ -52,13 +73,11 @@ function AppRoutes() {
export default function App() {
return (
<QueryClientProvider client={queryClient}>
<ToastProvider>
<AuthProvider>
<BrowserRouter>
<AppRoutes />
</BrowserRouter>
</AuthProvider>
</ToastProvider>
</QueryClientProvider>
);
}
File diff suppressed because it is too large Load Diff
@@ -1,323 +0,0 @@
import React, { useMemo } from 'react';
import { Navigate } from 'react-router-dom';
import { useAuth } from './AuthProvider';
export type RoleClaim =
| 'dashboard'
| 'governance'
| 'projects_milestones'
| 'grant_financials'
| 'evidence_risks'
| 'beneficiaries'
| 'change_management'
| 'site_visits'
| 'compliance'
| 'settings_invites'
| 'settings_users'
| 'settings_auditlog'
| 'settings_notifications'
| 'tenant_self_service'
| 'tenant_management'
| 'unrestricted';
export type ClaimAction = 'view' | 'add' | 'update' | 'export' | 'all';
export interface RoleClaimDefinition {
claim: RoleClaim;
label: string;
description: string;
}
export const ROLE_CLAIM_DEFINITIONS: RoleClaimDefinition[] = [
{ claim: 'dashboard', label: 'Partner Dashboard', description: 'Overview of ongoing projects, funding awards, and inbox' },
{ claim: 'governance', label: 'Governance & Structure', description: 'Holding entities, investment portfolios, and statutory programmes' },
{ claim: 'projects_milestones', label: 'Projects & Milestones', description: 'Work breakdown structure, scheduled milestones, and progress' },
{ claim: 'grant_financials', label: 'Grant & Financials', description: 'Funding awards, budget line allocations, and disbursements' },
{ claim: 'evidence_risks', label: 'M&E, Evidence & Risks', description: 'Evidence submission and risk registers' },
{ claim: 'beneficiaries', label: 'Beneficiaries', description: 'Target demographics, compliance tracking, and outcomes' },
{ claim: 'change_management', label: 'Change Management', description: 'Contractual change requests, issues, and enactments' },
{ claim: 'site_visits', label: 'Site Visits', description: 'Physical field inspection reports and inspector findings' },
{ claim: 'compliance', label: 'Compliance', description: 'Statutory compliance, outcome fulfillment, and risk monitoring' },
{ claim: 'settings_invites', label: 'Settings Invites', description: 'Statutory onboarding invitations and applicant notifications' },
{ claim: 'settings_users', label: 'Settings Users', description: 'Direct user account administration and role memberships' },
{ claim: 'settings_auditlog', label: 'Settings Audit Log', description: 'System-wide activity ledger and telemetry records' },
{ claim: 'settings_notifications', label: 'Notifications & Messages', description: 'In-app and email communications with the funding organisation' },
{ claim: 'tenant_self_service', label: 'Tenant Self-Service', description: 'Tenant configuration parameters and self-managed sub-users' },
{ claim: 'tenant_management', label: 'Tenant Management', description: 'Multi-tenant partition directory and cross-tenant isolation' },
{ claim: 'unrestricted', label: 'Unrestricted Access', description: 'Full system-wide control' },
];
export const CLAIM_ACTION_OPTIONS: { action: ClaimAction; label: string; description: string }[] = [
{ action: 'view', label: 'view', description: 'Can view records based on role' },
{ action: 'add', label: 'add', description: 'Can create records or give feedback; change non-approve statuses' },
{ action: 'update', label: 'update', description: 'Can use approve status change in dropdowns' },
{ action: 'export', label: 'export', description: 'Can click export buttons (Spreadsheet/PDF)' },
{ action: 'all', label: 'all', description: 'Can do everything' },
];
/**
* RBAC on PartnerUI ONLY functions for Partner roles.
* No other roles (Admin, Executive, Supervisor, Manager, Contributor) are permitted on this app.
*/
export const ROLE_CLAIM_MAP: Record<string, RoleClaim[]> = {
partner: [
'dashboard',
'projects_milestones',
'grant_financials',
'evidence_risks',
'beneficiaries',
'change_management',
'site_visits',
'compliance',
'settings_notifications',
],
};
/**
* Checks whether the user's roles include the mandatory 'Partner' role.
* On PartnerUI, ONLY users with the 'Partner' role are permitted.
*/
export function isPartnerRoleOnlyPermitted(roles: string[] = []): boolean {
return Array.isArray(roles) && roles.some((r) => r.toLowerCase().trim() === 'partner');
}
/**
* Resolves action capability set given a claim value string for a Partner user.
*/
export function resolveClaimActionSet(
claimValue: string | null | undefined,
roleName?: string
): Set<ClaimAction> {
const actions = new Set<ClaimAction>();
if (!claimValue && !roleName) return actions;
const rawVal = (claimValue || '').toLowerCase().trim();
const role = (roleName || '').toLowerCase().trim();
// Only Partner role is recognized in PartnerUI
if (role && role !== 'partner') {
return actions;
}
if (rawVal) {
if (rawVal === 'all' || rawVal === 'unrestricted' || rawVal === 'true' || rawVal === '1') {
actions.add('all');
actions.add('view');
actions.add('add');
actions.add('update');
actions.add('export');
return actions;
}
if (rawVal === 'none' || rawVal === 'restricted' || rawVal === 'false' || rawVal === '0') {
return actions;
}
const tokens = rawVal.split(',').map((t) => t.trim());
for (const val of tokens) {
if (val === 'all') {
actions.add('all');
actions.add('view');
actions.add('add');
actions.add('update');
actions.add('export');
} else if (val === 'view' || val === 'read') {
actions.add('view');
} else if (val === 'add' || val === 'edit' || val === 'write' || val === 'create') {
actions.add('view');
actions.add('add');
} else if (val === 'update' || val === 'approve' || val === 'verify') {
actions.add('view');
actions.add('add');
actions.add('update');
} else if (val === 'export') {
actions.add('view');
actions.add('export');
}
}
return actions;
}
// Default fallback for Partner role: view, add (submit evidence, log activities, send messages, execute contract), export
if (role === 'partner') {
actions.add('view');
actions.add('add');
actions.add('export');
}
return actions;
}
/**
* Helper to extract explicit claim value from varied dictionary structures
*/
export function extractExplicitClaimValue(
claims: Record<string, any> = {},
claim: RoleClaim
): string | null {
if (!claims || typeof claims !== 'object') return null;
if (claims[claim] !== undefined && claims[claim] !== null) {
return String(claims[claim]).trim();
}
if (claims[`role_claim:${claim}`] !== undefined) {
return String(claims[`role_claim:${claim}`]).trim();
}
if (claims[`claim:${claim}`] !== undefined) {
return String(claims[`claim:${claim}`]).trim();
}
const noUnderscore = claim.replace(/_/g, '');
if (claims[noUnderscore] !== undefined) {
return String(claims[noUnderscore]).trim();
}
const arrayCandidates = [
claims.claims,
claims.UserClaims,
claims.user_claims,
claims.role_claims,
];
for (const arr of arrayCandidates) {
if (Array.isArray(arr)) {
for (const item of arr) {
if (typeof item === 'object' && item !== null) {
const type = (item.type || item.claimType || item.name || '').toLowerCase().trim();
if (type === claim || type === noUnderscore) {
return String(item.value || item.claimValue || 'all').trim();
}
} else if (typeof item === 'string') {
const [type, val] = item.split(':').map((s) => s.trim().toLowerCase());
if (type === claim || type === noUnderscore) {
return val || 'all';
}
}
}
}
}
return null;
}
/**
* Evaluates whether a user with given roles and token claims has permission for a specific claim and action.
*
* CRITICAL RULE FOR PARTNER UI:
* RBAC on PartnerUI ONLY functions for Partner roles. No other roles are permitted on this app.
*/
export function evaluateUserPermission(
roles: string[] = [],
claims: Record<string, any> = {},
claim: RoleClaim,
action: ClaimAction = 'view'
): boolean {
// Security Gate: Only users with the 'Partner' role are permitted on PartnerUI.
const isPartner = isPartnerRoleOnlyPermitted(roles);
if (!isPartner) return false;
// 1. Check if Partner user has explicit claim in claims dictionary
const rawClaimValue = extractExplicitClaimValue(claims, claim);
if (rawClaimValue !== null && rawClaimValue !== '') {
const actionSet = resolveClaimActionSet(rawClaimValue, 'partner');
return actionSet.has('all') || actionSet.has(action);
}
// 2. Check Partner base role mappings
const allowedClaims = ROLE_CLAIM_MAP['partner'];
if (allowedClaims && allowedClaims.includes(claim)) {
const actionSet = resolveClaimActionSet(undefined, 'partner');
if (actionSet.has('all') || actionSet.has(action)) {
return true;
}
}
return false;
}
/**
* Evaluates Maker-Checker separation of duties constraint.
*/
export function isRecordMaker(
createdBy?: string | null,
currentUserId?: string | null,
currentUserSub?: string | null,
currentUserEmail?: string | null
): boolean {
if (!createdBy) return false;
const creator = createdBy.trim().toLowerCase();
if (currentUserId && creator === currentUserId.trim().toLowerCase()) return true;
if (currentUserSub && creator === currentUserSub.trim().toLowerCase()) return true;
if (currentUserEmail && creator === currentUserEmail.trim().toLowerCase()) return true;
return false;
}
/**
* React hook exposing RBAC evaluation helpers for PartnerUI components.
* Enforces that only the Partner role has permissions in this application.
*/
export function useRbac() {
const { roles, claims, user, sub } = useAuth();
const permissions = useMemo(() => {
const isPartner = isPartnerRoleOnlyPermitted(roles);
const canAccess = (claim: RoleClaim, action: ClaimAction = 'view'): boolean => {
if (!isPartner) return false;
return evaluateUserPermission(roles, claims, claim, action);
};
const canView = (claim: RoleClaim): boolean => canAccess(claim, 'view');
const canAdd = (claim: RoleClaim): boolean => canAccess(claim, 'add');
const canApprove = (claim: RoleClaim): boolean => canAccess(claim, 'update');
const canExport = (claim: RoleClaim): boolean => canAccess(claim, 'export');
const isMaker = (createdBy?: string | null): boolean => {
return isRecordMaker(createdBy, user?.id, sub, user?.email);
};
const canApproveRecord = (claim: RoleClaim, createdBy?: string | null): boolean => {
if (!canApprove(claim)) return false;
return !isMaker(createdBy);
};
const getApprovalRestrictionReason = (claim: RoleClaim, createdBy?: string | null): string | null => {
if (!isPartner) return 'Partner role required';
if (!canApprove(claim)) return 'Requires approval permission from the funding organisation';
if (isMaker(createdBy)) return 'Maker-Checker policy: Record creators cannot approve their own records';
return null;
};
return {
isPartner,
isUnrestricted: false,
canAccess,
canView,
canAdd,
canApprove,
canExport,
isMaker,
canApproveRecord,
getApprovalRestrictionReason,
};
}, [roles, claims, user, sub]);
return permissions;
}
/**
* Route protection component for claim-restricted screens in PartnerUI.
*/
export const ClaimProtectedRoute: React.FC<{
claim: RoleClaim;
action?: ClaimAction;
children: React.ReactNode;
}> = ({ claim, action = 'view', children }) => {
const { canAccess } = useRbac();
const allowed = canAccess(claim, action);
if (!allowed) {
return React.createElement(Navigate, { to: '/dashboard', replace: true });
}
return React.createElement(React.Fragment, null, children);
};
@@ -1,202 +0,0 @@
import React, { useState, useEffect } from 'react';
import { createPortal } from 'react-dom';
import { useNavigate } from 'react-router-dom';
import {
RefreshCw,
LogOut,
Building2,
Clock,
ArrowLeft,
Sparkles,
} from 'lucide-react';
import { PfmPartnerLogo } from '../common/PfmPartnerLogo';
import { AuthUserProfile, UserClaims } from '../../auth/AuthProvider';
import { cancelSessionExpiration, dismissSubordinateModals } from '../../services/sessionExpiration';
interface AccountActivationModalProps {
user: AuthUserProfile | null;
claims: UserClaims;
sub: string;
onSync: (force?: boolean) => Promise<{ success: boolean; isUnauthorized?: boolean; errorMessage?: string }>;
onLogout: () => Promise<void>;
initialError?: string | null;
}
const formatLockoutMessage = (msg?: string | null): string | null => {
if (!msg) return null;
const trimmed = msg.trim();
if (/^network\s*error$/i.test(trimmed)) {
return 'Permission Check';
}
return trimmed.replace(/network\s*error/gi, 'Permission Check');
};
export const AccountActivationModal: React.FC<AccountActivationModalProps> = ({
user,
claims,
onSync,
onLogout,
initialError,
}) => {
const navigate = useNavigate();
const [isSyncing, setIsSyncing] = useState(false);
const [errorMessage, setErrorMessage] = useState<string | null>(formatLockoutMessage(initialError) || null);
useEffect(() => {
if (initialError !== undefined) {
setErrorMessage(formatLockoutMessage(initialError));
}
}, [initialError]);
useEffect(() => {
cancelSessionExpiration();
dismissSubordinateModals();
}, []);
const displayName =
user?.name ||
(claims.name as string) ||
(claims.preferred_username as string) ||
'Partner';
const tenant = user?.tenant || (claims.tenant as string) || (claims.org as string) || 'Partner Organisation';
const handleSyncClick = async () => {
if (isSyncing) return;
setIsSyncing(true);
setErrorMessage(null);
try {
const result = await onSync(true);
if (result.isUnauthorized) {
await onLogout();
navigate('/', { replace: true });
return;
}
if (!result.success) {
setErrorMessage(
formatLockoutMessage(
result.errorMessage ||
'Activation is still being reviewed by your funding administrator. Please check back shortly.'
)
);
}
} catch (err: unknown) {
const errObj = err as { response?: { status?: number }; message?: string };
if (errObj?.response?.status === 401) {
await onLogout();
navigate('/', { replace: true });
return;
}
setErrorMessage('Permission Check: Unable to verify activation right now. Please try again in a few moments.');
} finally {
setIsSyncing(false);
}
};
const handleSignOut = async () => {
await onLogout();
navigate('/', { replace: true });
};
const handleNavigateLanding = () => {
navigate('/');
};
const modalContent = (
<div
role="dialog"
aria-modal="true"
aria-labelledby="activation-modal-title"
className="fixed inset-0 z-[9999] flex items-center justify-center p-4 sm:p-6 bg-slate-950/80 backdrop-blur-2xl animate-in fade-in duration-300 select-none overflow-y-auto"
>
{/* Background ambient lighting matching LandingPage */}
<div className="pointer-events-none absolute inset-0 overflow-hidden">
<div className="absolute top-1/2 left-1/2 -translate-x-1/2 -translate-y-1/2 w-[500px] h-[500px] bg-gradient-to-tr from-emerald-500/15 via-teal-500/10 to-cyan-500/15 blur-[120px] rounded-full" />
</div>
<div
className="relative w-full max-w-md rounded-3xl border border-white/10 bg-slate-900/85 backdrop-blur-xl shadow-[0_25px_60px_rgba(0,0,0,0.85),inset_0_1px_1px_rgba(255,255,255,0.15)] overflow-hidden flex flex-col items-center text-center p-8 sm:p-10 my-auto space-y-6"
onClick={(e) => e.stopPropagation()}
>
{/* Glowing Brand Icon Lockup */}
<div className="relative flex items-center justify-center pt-2">
<div className="absolute -inset-3 rounded-full bg-emerald-500/20 blur-xl animate-pulse" />
<PfmPartnerLogo className="h-16 w-16 drop-shadow-[0_8px_24px_rgba(16,185,129,0.35)] relative z-10" />
</div>
{/* Title & Organization Pill */}
<div className="space-y-2">
<div className="inline-flex items-center gap-1.5 px-3 py-1 rounded-full bg-emerald-500/10 border border-emerald-500/20 text-[11px] font-semibold text-emerald-300">
<Clock className="w-3.5 h-3.5 text-emerald-400" />
<span>Activation Pending</span>
</div>
<h2 id="activation-modal-title" className="text-2xl font-bold tracking-tight text-white">
Welcome,{' '}
<span className="bg-gradient-to-r from-emerald-300 via-teal-200 to-cyan-300 bg-clip-text text-transparent">
{displayName}
</span>
</h2>
<div className="inline-flex items-center gap-1.5 text-xs text-slate-400 font-medium">
<Building2 className="w-3.5 h-3.5 text-teal-400 shrink-0" />
<span>{tenant}</span>
</div>
</div>
{/* Core Friendly Message */}
<p className="text-sm text-slate-300 leading-relaxed max-w-sm">
Your credentials have been authenticated. Your funding administrator is finalizing your portfolio access.
</p>
{/* Notice badge if check returned not yet ready */}
{errorMessage && (
<div className="w-full rounded-2xl bg-amber-500/10 border border-amber-500/20 p-3 text-xs text-amber-300/90 leading-relaxed text-center flex items-center justify-center gap-2">
<Sparkles className="w-4 h-4 text-amber-400 shrink-0" />
<span>{formatLockoutMessage(errorMessage)}</span>
</div>
)}
{/* Action Button matching Specular / Landing styling */}
<div className="w-full space-y-3 pt-2">
<button
onClick={handleSyncClick}
disabled={isSyncing}
type="button"
id="activation-sync-btn"
className="w-full py-3.5 px-6 rounded-2xl bg-gradient-to-r from-emerald-600 via-teal-600 to-emerald-500 hover:from-emerald-500 hover:to-teal-500 active:scale-[0.99] disabled:opacity-60 disabled:pointer-events-none text-white font-bold text-sm tracking-wide shadow-[0_12px_30px_rgba(16,185,129,0.35),inset_0_1px_1px_rgba(255,255,255,0.3)] hover:shadow-[0_16px_36px_rgba(16,185,129,0.5)] transition-all flex items-center justify-center gap-2 cursor-pointer"
>
<RefreshCw className={`w-4 h-4 text-emerald-100 ${isSyncing ? 'animate-spin' : ''}`} />
<span>{isSyncing ? 'Checking Status...' : 'Check Account Status'}</span>
</button>
{/* Minimal Secondary Actions */}
<div className="flex items-center justify-center gap-4 text-xs pt-1">
<button
onClick={handleNavigateLanding}
type="button"
className="inline-flex items-center gap-1.5 text-slate-400 hover:text-slate-200 transition-colors py-1 cursor-pointer"
>
<ArrowLeft className="w-3.5 h-3.5" />
<span>Landing Page</span>
</button>
<span className="text-slate-700">•</span>
<button
onClick={handleSignOut}
type="button"
className="inline-flex items-center gap-1.5 text-slate-400 hover:text-rose-400 transition-colors py-1 cursor-pointer"
>
<LogOut className="w-3.5 h-3.5" />
<span>Sign Out</span>
</button>
</div>
</div>
</div>
</div>
);
return typeof document !== 'undefined'
? createPortal(modalContent, document.body)
: modalContent;
};
@@ -1,111 +0,0 @@
import React, { useEffect } from 'react';
import { createPortal } from 'react-dom';
import { useNavigate } from 'react-router-dom';
import { ShieldCheck, LogOut, ArrowLeft, Lock } from 'lucide-react';
import { PfmPartnerLogo } from '../common/PfmPartnerLogo';
import { AuthUserProfile, UserClaims } from '../../auth/AuthProvider';
import { cancelSessionExpiration, dismissSubordinateModals } from '../../services/sessionExpiration';
interface NonPartnerAccessDeniedModalProps {
user: AuthUserProfile | null;
claims: UserClaims;
sub: string;
roles: string[];
onLogout: () => Promise<void>;
}
export const NonPartnerAccessDeniedModal: React.FC<NonPartnerAccessDeniedModalProps> = ({
user,
claims,
roles,
onLogout,
}) => {
const navigate = useNavigate();
useEffect(() => {
cancelSessionExpiration();
dismissSubordinateModals();
}, []);
const displayEmail =
user?.email ||
(claims.email as string) ||
(claims['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress'] as string) ||
'Authenticated User';
const assignedRolesDisplay = roles.length > 0 ? roles.join(', ') : user?.role || (claims.role as string) || 'Standard User';
const handleLogoutClick = async () => {
await onLogout();
navigate('/', { replace: true });
};
const handleLandingClick = () => {
navigate('/');
};
const modalContent = (
<div
role="alertdialog"
aria-modal="true"
aria-labelledby="non-partner-denied-title"
className="fixed inset-0 z-[9999] flex items-center justify-center p-4 bg-slate-950/85 backdrop-blur-2xl animate-in fade-in duration-300 overflow-y-auto"
>
<div className="pointer-events-none absolute inset-0 overflow-hidden">
<div className="absolute top-1/2 left-1/2 -translate-x-1/2 -translate-y-1/2 w-[450px] h-[450px] bg-rose-500/10 blur-[120px] rounded-full" />
</div>
<div
className="relative w-full max-w-md rounded-3xl border border-white/10 bg-slate-900/85 backdrop-blur-xl shadow-[0_25px_60px_rgba(0,0,0,0.85),inset_0_1px_1px_rgba(255,255,255,0.15)] overflow-hidden flex flex-col items-center text-center p-8 sm:p-10 my-auto space-y-6"
onClick={(e) => e.stopPropagation()}
>
<div className="relative flex items-center justify-center pt-2">
<div className="absolute -inset-3 rounded-full bg-rose-500/20 blur-xl" />
<PfmPartnerLogo className="h-16 w-16 drop-shadow-[0_8px_24px_rgba(244,63,94,0.35)] relative z-10" />
</div>
<div className="space-y-2">
<div className="inline-flex items-center gap-1.5 px-3 py-1 rounded-full bg-rose-500/10 border border-rose-500/20 text-[11px] font-semibold text-rose-300">
<Lock className="w-3.5 h-3.5 text-rose-400" />
<span>Partner Access Only</span>
</div>
<h2 id="non-partner-denied-title" className="text-2xl font-bold tracking-tight text-white">
Role Authorization Required
</h2>
</div>
<p className="text-sm text-slate-300 leading-relaxed max-w-sm">
This portal is reserved for registered Grantee and Partner accounts. Your current profile (<strong className="text-rose-300">{assignedRolesDisplay}</strong>) does not have access.
</p>
<div className="w-full rounded-2xl bg-slate-950/50 border border-white/5 p-3 text-xs text-slate-400 font-mono truncate">
Signed in as {displayEmail}
</div>
<div className="w-full space-y-3 pt-2">
<button
onClick={handleLogoutClick}
type="button"
className="w-full py-3.5 px-6 rounded-2xl bg-gradient-to-r from-rose-600 via-rose-500 to-amber-600 hover:from-rose-500 hover:to-amber-500 text-white font-bold text-sm tracking-wide shadow-[0_12px_30px_rgba(244,63,94,0.35),inset_0_1px_1px_rgba(255,255,255,0.3)] hover:shadow-[0_16px_36px_rgba(244,63,94,0.5)] transition-all flex items-center justify-center gap-2 cursor-pointer"
>
<LogOut className="w-4 h-4 text-rose-100" />
<span>Switch Account / Sign Out</span>
</button>
<button
onClick={handleLandingClick}
type="button"
className="inline-flex items-center gap-1.5 text-xs text-slate-400 hover:text-slate-200 transition-colors py-1 cursor-pointer"
>
<ArrowLeft className="w-3.5 h-3.5" />
<span>Return to Landing Page</span>
</button>
</div>
</div>
</div>
);
return typeof document !== 'undefined'
? createPortal(modalContent, document.body)
: modalContent;
};
@@ -1,153 +0,0 @@
import React, { useEffect, useState, useRef } from 'react';
import { createPortal } from 'react-dom';
import { Clock, LogOut, RefreshCw } from 'lucide-react';
import { PfmPartnerLogo } from '../common/PfmPartnerLogo';
import { clearSessionAndRedirectToLanding, dismissSubordinateModals } from '../../services/sessionExpiration';
interface SessionExpiredModalProps {
isOpen: boolean;
onDismiss?: () => void;
reason?: string | null;
countdownSeconds?: number;
}
export const SessionExpiredModal: React.FC<SessionExpiredModalProps> = ({
isOpen,
onDismiss,
reason,
countdownSeconds = 8,
}) => {
const [timeLeftMs, setTimeLeftMs] = useState(countdownSeconds * 1000);
const [isPaused, setIsPaused] = useState(false);
const totalDurationMs = countdownSeconds * 1000;
const isClearingRef = useRef(false);
useEffect(() => {
if (isOpen) {
dismissSubordinateModals();
}
}, [isOpen]);
useEffect(() => {
const handleCancelled = () => {
setTimeLeftMs(countdownSeconds * 1000);
setIsPaused(false);
isClearingRef.current = false;
};
window.addEventListener('pfm:session-expired-cancelled', handleCancelled);
return () => {
window.removeEventListener('pfm:session-expired-cancelled', handleCancelled);
};
}, [countdownSeconds]);
useEffect(() => {
if (!isOpen) {
setTimeLeftMs(countdownSeconds * 1000);
setIsPaused(false);
isClearingRef.current = false;
return;
}
const intervalMs = 50;
const interval = setInterval(() => {
setTimeLeftMs((prev) => {
if (isPaused) return prev;
const next = prev - intervalMs;
if (next <= 0) {
clearInterval(interval);
handleAction();
return 0;
}
return next;
});
}, intervalMs);
return () => clearInterval(interval);
}, [isOpen, isPaused, countdownSeconds]);
const handleAction = () => {
if (isClearingRef.current) return;
isClearingRef.current = true;
if (onDismiss) {
onDismiss();
} else {
clearSessionAndRedirectToLanding();
}
};
if (!isOpen) return null;
const secondsRemaining = Math.max(0, Math.ceil(timeLeftMs / 1000));
const progressPercent = Math.max(0, Math.min(100, (timeLeftMs / totalDurationMs) * 100));
const modalContent = (
<div
id="session-expired-modal-backdrop"
className="fixed inset-0 z-[9999] flex items-center justify-center p-4 bg-slate-950/85 backdrop-blur-2xl animate-in fade-in duration-300 overflow-y-auto"
onMouseEnter={() => setIsPaused(true)}
onMouseLeave={() => setIsPaused(false)}
role="dialog"
aria-modal="true"
aria-labelledby="session-expired-title"
>
<div className="pointer-events-none absolute inset-0 overflow-hidden">
<div className="absolute top-1/2 left-1/2 -translate-x-1/2 -translate-y-1/2 w-[450px] h-[450px] bg-amber-500/10 blur-[120px] rounded-full" />
</div>
<div
id="session-expired-modal-content"
className="relative w-full max-w-md rounded-3xl border border-white/10 bg-slate-900/85 backdrop-blur-xl shadow-[0_25px_60px_rgba(0,0,0,0.85),inset_0_1px_1px_rgba(255,255,255,0.15)] overflow-hidden flex flex-col items-center text-center p-8 sm:p-10 my-auto space-y-6"
>
<div className="relative flex items-center justify-center pt-2">
<div className="absolute -inset-3 rounded-full bg-amber-500/20 blur-xl" />
<PfmPartnerLogo className="h-16 w-16 drop-shadow-[0_8px_24px_rgba(245,158,11,0.35)] relative z-10" />
</div>
<div className="space-y-2">
<div className="inline-flex items-center gap-1.5 px-3 py-1 rounded-full bg-amber-500/10 border border-amber-500/20 text-[11px] font-semibold text-amber-300">
<Clock className="w-3.5 h-3.5 text-amber-400" />
<span>Session Expired</span>
</div>
<h2 id="session-expired-title" className="text-2xl font-bold tracking-tight text-white">
Security Session Ended
</h2>
</div>
<p className="text-sm text-slate-300 leading-relaxed max-w-sm">
{reason
? reason.replace(/network\s*error/gi, 'Permission Check')
: 'Your security credentials have expired for your protection. Please sign in again to continue.'}
</p>
{/* Smooth Countdown Bar */}
<div className="w-full space-y-2">
<div className="h-1.5 w-full bg-slate-800 rounded-full overflow-hidden">
<div
className="h-full bg-gradient-to-r from-emerald-400 to-teal-400 transition-all duration-75 ease-linear rounded-full"
style={{ width: `${progressPercent}%` }}
/>
</div>
<span className="text-[11px] text-slate-400 font-mono">
Redirecting in {secondsRemaining}s
</span>
</div>
<div className="w-full pt-1">
<button
onClick={handleAction}
type="button"
className="w-full py-3.5 px-6 rounded-2xl bg-gradient-to-r from-emerald-600 via-teal-600 to-emerald-500 hover:from-emerald-500 hover:to-teal-500 text-white font-bold text-sm tracking-wide shadow-[0_12px_30px_rgba(16,185,129,0.35),inset_0_1px_1px_rgba(255,255,255,0.3)] hover:shadow-[0_16px_36px_rgba(16,185,129,0.5)] transition-all flex items-center justify-center gap-2 cursor-pointer"
>
<RefreshCw className="w-4 h-4 text-emerald-100" />
<span>Sign In Again Now</span>
</button>
</div>
</div>
</div>
);
return typeof document !== 'undefined'
? createPortal(modalContent, document.body)
: modalContent;
};
File diff suppressed because it is too large Load Diff
@@ -138,9 +138,9 @@ export const ProjectCard: React.FC<ProjectCardProps> = ({
#{hashedProjectId}
</span>
)}
{(project as any).code && (
{project.code && (
<span className="font-mono text-xs text-slate-300 bg-white/5 border border-white/10 px-2 py-0.5 rounded-md">
{(project as any).code}
{project.code}
</span>
)}
{renderStatusBadge(project.status, 'In Progress')}
@@ -162,7 +162,7 @@ export const ProjectCard: React.FC<ProjectCardProps> = ({
<div className="bg-slate-950/60 border border-white/10 px-4 py-2 rounded-2xl">
<div className="text-[10px] text-slate-400 uppercase tracking-wider font-semibold">Total Budget</div>
<div className="text-sm font-bold text-emerald-300 font-mono">
{formatCurrency((project as any).budget || totalAwardsAmount)}
{formatCurrency(project.budget || totalAwardsAmount)}
</div>
</div>
@@ -390,7 +390,7 @@ export const ProjectCard: React.FC<ProjectCardProps> = ({
<div className="flex items-center gap-2 truncate">
<FileText className="w-3.5 h-3.5 text-emerald-400 shrink-0" />
<span className="text-slate-200 font-medium truncate">
{(ev as any).title || ev.fileName || `Evidence #${encodeHashIdSync(ev.id)}`}
{ev.title || ev.fileName || `Evidence #${encodeHashIdSync(ev.id)}`}
</span>
</div>
{ev.documentUrl && (
@@ -1,188 +0,0 @@
import React, { useState, useMemo } from 'react';
import {
Copy,
Check,
Mail,
MessageSquare,
Code2,
Eye,
ShieldCheck,
} from 'lucide-react';
import { NotificationPlatform } from '../../types';
import { parseMarkdownToHtml, isHtmlContent, stripMarkdown } from '../../lib/markdownUtils';
export interface MessageViewerProps {
content: string;
platform?: NotificationPlatform | number | string;
subject?: string;
className?: string;
showFormatHeader?: boolean;
maxHeightClass?: string;
}
export const MessageViewer: React.FC<MessageViewerProps> = ({
content,
platform,
subject,
className = '',
showFormatHeader = true,
maxHeightClass = 'max-h-[60vh]',
}) => {
const [copied, setCopied] = useState(false);
const [showRaw, setShowRaw] = useState(false);
// Determine whether this message represents an Email (HTML) or In-App (Markup)
const isEmail = useMemo(() => {
if (
platform === NotificationPlatform.Email ||
platform === 1 ||
platform === '1' ||
String(platform).toLowerCase() === 'email'
) {
return true;
}
// If platform is not explicitly InApp, detect if content is structured HTML
if (
platform !== NotificationPlatform.InApp &&
platform !== 5 &&
platform !== '5' &&
String(platform).toLowerCase() !== 'inapp' &&
isHtmlContent(content)
) {
return true;
}
return false;
}, [platform, content]);
const isInApp = useMemo(() => {
if (
platform === NotificationPlatform.InApp ||
platform === 5 ||
platform === '5' ||
String(platform).toLowerCase() === 'inapp'
) {
return true;
}
return !isEmail;
}, [platform, isEmail]);
// Convert the message to its respective format:
// - Email: HTML rendered
// - In-App: Markup (Markdown) parsed to HTML
const renderedHtml = useMemo(() => {
if (!content) return '<p class="text-slate-400 italic">No message content</p>';
// Format 1: Email => HTML
if (isEmail) {
if (isHtmlContent(content)) {
return content.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '');
}
return parseMarkdownToHtml(content);
}
// Format 2: In-App => Markup (Markdown)
return parseMarkdownToHtml(content);
}, [content, isEmail]);
const handleCopy = () => {
const textToCopy = showRaw ? content : stripMarkdown(content) || content;
navigator.clipboard.writeText(textToCopy);
setCopied(true);
setTimeout(() => setCopied(false), 2000);
};
return (
<div className={`flex flex-col rounded-2xl bg-slate-900/50 border border-white/10 overflow-hidden w-full max-w-full ${className}`}>
{/* Format Header & Controls Bar */}
{showFormatHeader && (
<div className="px-4 py-2.5 border-b border-white/[0.08] bg-[#0b101d]/90 flex items-center justify-between text-xs text-slate-400 gap-3 shrink-0">
<div className="flex items-center gap-2 flex-wrap">
{isEmail ? (
<span className="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-lg bg-cyan-500/10 border border-cyan-500/20 text-cyan-300 font-semibold text-[11px]">
<Mail className="w-3.5 h-3.5 text-cyan-400" />
<span>Email (HTML)</span>
</span>
) : (
<span className="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-lg bg-emerald-500/10 border border-emerald-500/20 text-emerald-300 font-semibold text-[11px]">
<MessageSquare className="w-3.5 h-3.5 text-emerald-400" />
<span>In-App (Markup)</span>
</span>
)}
<span className="text-[11px] text-slate-400 hidden sm:inline">
{isEmail ? 'Rendered as HTML Email' : 'Converted from Markup to Formatted View'}
</span>
</div>
<div className="flex items-center gap-1.5 shrink-0">
{/* View Mode Toggle: Formatted vs Raw */}
<button
type="button"
onClick={() => setShowRaw(!showRaw)}
className="flex items-center gap-1 px-2 py-1 rounded-lg bg-slate-800/80 hover:bg-slate-700 text-slate-300 hover:text-white text-[11px] font-medium transition cursor-pointer border border-white/10"
title={showRaw ? 'Switch to Formatted view' : 'View Raw message content'}
>
{showRaw ? (
<>
<Eye className="w-3 h-3 text-emerald-400" />
<span>Formatted</span>
</>
) : (
<>
<Code2 className="w-3 h-3" />
<span>Raw</span>
</>
)}
</button>
{/* Copy Button */}
<button
type="button"
onClick={handleCopy}
className="flex items-center gap-1 px-2 py-1 rounded-lg bg-slate-800/80 hover:bg-slate-700 text-slate-300 hover:text-white text-[11px] font-medium transition cursor-pointer border border-white/10"
title="Copy message content"
>
{copied ? (
<>
<Check className="w-3 h-3 text-emerald-400" />
<span className="text-emerald-300">Copied</span>
</>
) : (
<>
<Copy className="w-3 h-3" />
<span>Copy</span>
</>
)}
</button>
</div>
</div>
)}
{/* Message Body Content - with explicit max height, max width, word wrapping, and automatic scrollbars */}
<div className={`w-full max-w-full p-4 sm:p-6 overflow-x-auto overflow-y-auto ${maxHeightClass} text-sm leading-relaxed text-slate-200 [scrollbar-width:thin] [scrollbar-color:#334155_transparent]`}>
{showRaw ? (
<pre className="font-mono text-xs text-slate-300 whitespace-pre-wrap break-words [word-break:break-word] bg-[#080d18] p-4 rounded-xl border border-white/5 max-w-full overflow-x-auto [scrollbar-width:thin] [scrollbar-color:#334155_transparent]">
{content}
</pre>
) : (
<div
className="prose prose-invert max-w-full w-full break-words [word-break:break-word] text-xs sm:text-sm leading-relaxed text-slate-200 [&_h1]:text-white [&_h1]:text-xl [&_h1]:font-bold [&_h1]:mb-3 [&_h2]:text-white [&_h2]:text-lg [&_h2]:font-bold [&_h2]:mb-2 [&_h3]:text-white [&_h3]:text-base [&_h3]:font-bold [&_h3]:mb-2 [&_h4]:text-white [&_h4]:font-semibold [&_a]:text-emerald-400 [&_a:hover]:underline [&_ul]:list-disc [&_ul]:pl-5 [&_ul]:my-2 [&_ol]:list-decimal [&_ol]:pl-5 [&_ol]:my-2 [&_li]:text-slate-300 [&_table]:w-full [&_table]:max-w-full [&_table]:border-collapse [&_table]:my-3 [&_th]:border [&_th]:border-slate-700 [&_th]:bg-slate-800/80 [&_th]:p-2.5 [&_th]:break-words [&_td]:border [&_td]:border-slate-800 [&_td]:p-2.5 [&_td]:break-words [&_blockquote]:border-l-4 [&_blockquote]:border-emerald-500 [&_blockquote]:pl-4 [&_blockquote]:italic [&_blockquote]:my-2 [&_code]:bg-slate-800 [&_code]:px-1.5 [&_code]:py-0.5 [&_code]:rounded [&_code]:text-emerald-300 [&_code]:break-all [&_pre]:max-w-full [&_pre]:overflow-x-auto [&_img]:max-w-full [&_img]:h-auto [&_iframe]:max-w-full"
dangerouslySetInnerHTML={{ __html: renderedHtml }}
/>
)}
</div>
{/* Footer Info Stamp */}
<div className="px-5 py-2.5 border-t border-white/[0.08] bg-[#090e1a] flex items-center justify-between text-[11px] text-slate-400 shrink-0">
<div className="flex items-center gap-1.5">
<ShieldCheck className="w-3.5 h-3.5 text-emerald-400" />
<span>PFM Communications • {isEmail ? 'Email HTML Format' : 'In-App Markup Format'}</span>
</div>
<span className="font-mono text-[10px] text-slate-400">
{stripMarkdown(content).length} characters
</span>
</div>
</div>
);
};
@@ -1,33 +0,0 @@
import React from 'react';
import { PfmPartnerLogo } from '../common/PfmPartnerLogo';
interface BrandLogoProps {
size?: number;
className?: string;
showGlow?: boolean;
animateOnHover?: boolean;
}
export const BrandLogo: React.FC<BrandLogoProps> = ({
size = 32,
className = '',
showGlow = false,
animateOnHover = true,
}) => {
return (
<div
className={`inline-flex items-center justify-center relative ${
animateOnHover ? 'transition-transform duration-300 hover:scale-105' : ''
} ${className}`}
>
{showGlow && (
<div
className="absolute inset-0 rounded-full bg-emerald-500/25 blur-md pointer-events-none"
style={{ width: size, height: size }}
/>
)}
<PfmPartnerLogo size={size} className="relative z-10" />
</div>
);
};
@@ -1,378 +0,0 @@
import React, { createContext, useContext, useState, useEffect, useRef, ReactNode } from 'react';
import { createPortal } from 'react-dom';
import {
CheckCircle2,
AlertCircle,
Info,
X,
Copy,
Check,
ChevronDown,
ChevronUp,
} from 'lucide-react';
import { parseFriendlyError, ErrorCategory } from '../../utils/apiErrorParser';
export type ToastType = 'success' | 'error' | 'info';
export interface ToastItem {
id: string;
type: ToastType;
title: string;
message?: string;
duration: number; // in milliseconds
createdAt: number;
statusCode?: number;
category?: ErrorCategory;
categoryLabel?: string;
technicalDetails?: string;
fieldErrors?: Array<{ field: string; message: string }>;
errorsList?: string[];
}
export interface ToastOptions {
duration?: number;
statusCode?: number;
category?: ErrorCategory;
categoryLabel?: string;
technicalDetails?: string;
fieldErrors?: Array<{ field: string; message: string }>;
errorsList?: string[];
}
interface ToastContextType {
toast: (type: ToastType, title: string, message?: string, options?: ToastOptions) => void;
success: (title: string, message?: string, options?: ToastOptions) => void;
error: (titleOrError: unknown, messageOrError?: unknown, options?: ToastOptions) => void;
info: (title: string, message?: string, options?: ToastOptions) => void;
}
const ToastContext = createContext<ToastContextType | undefined>(undefined);
// Default durations (in ms):
// Errors linger significantly longer (14s) so users have sufficient time to read and note the failure.
const DEFAULT_DURATIONS: Record<ToastType, number> = {
success: 4500,
info: 6000,
error: 14000,
};
const ToastCard: React.FC<{
toast: ToastItem;
onRemove: (id: string) => void;
}> = ({ toast, onRemove }) => {
const [isPaused, setIsPaused] = useState(false);
const [remainingTime, setRemainingTime] = useState(toast.duration);
const [copied, setCopied] = useState(false);
const [showTechnical, setShowTechnical] = useState(false);
const intervalRef = useRef<ReturnType<typeof setInterval> | null>(null);
useEffect(() => {
if (isPaused) {
if (intervalRef.current) clearInterval(intervalRef.current);
return;
}
const step = 100;
intervalRef.current = setInterval(() => {
setRemainingTime((prev) => {
if (prev <= step) {
if (intervalRef.current) clearInterval(intervalRef.current);
onRemove(toast.id);
return 0;
}
return prev - step;
});
}, step);
return () => {
if (intervalRef.current) clearInterval(intervalRef.current);
};
}, [isPaused, toast.id, onRemove]);
const handleCopy = () => {
const textToCopy = [
`PFM Partner Portal Notice: ${toast.title}`,
toast.message ? `Details: ${toast.message}` : '',
toast.statusCode ? `Status Code: ${toast.statusCode}` : '',
toast.technicalDetails ? `Technical Info: ${toast.technicalDetails}` : '',
`Timestamp: ${new Date(toast.createdAt).toISOString()}`,
]
.filter(Boolean)
.join('\n');
navigator.clipboard.writeText(textToCopy).then(() => {
setCopied(true);
setTimeout(() => setCopied(false), 2000);
});
};
const progressPercent = Math.max(0, Math.min(100, (remainingTime / toast.duration) * 100));
return (
<div
onMouseEnter={() => setIsPaused(true)}
onMouseLeave={() => setIsPaused(false)}
className={`pointer-events-auto relative flex flex-col rounded-2xl border shadow-2xl transition-all duration-200 overflow-hidden bg-[#0d1322] backdrop-blur-none ${
toast.type === 'success'
? 'border-emerald-500/60 text-gray-100 shadow-emerald-950/40 ring-1 ring-emerald-500/20'
: toast.type === 'error'
? 'border-rose-500/70 text-gray-100 shadow-rose-950/60 ring-1 ring-rose-500/30'
: 'border-teal-500/60 text-gray-100 shadow-teal-950/40 ring-1 ring-teal-500/20'
}`}
>
<div className="flex items-start gap-3 p-4">
{toast.type === 'success' && <CheckCircle2 className="w-5 h-5 text-emerald-400 shrink-0 mt-0.5" />}
{toast.type === 'error' && <AlertCircle className="w-5 h-5 text-rose-400 shrink-0 mt-0.5" />}
{toast.type === 'info' && <Info className="w-5 h-5 text-teal-400 shrink-0 mt-0.5" />}
<div className="flex-1 min-w-0">
<div className="flex items-center gap-1.5 flex-wrap">
<h4 className="text-sm font-semibold text-white tracking-tight leading-snug">{toast.title}</h4>
{toast.categoryLabel && (
<span
className={`text-[10px] font-medium px-1.5 py-0.5 rounded border ${
toast.category === 'validation'
? 'bg-amber-950/60 text-amber-300 border-amber-800/60'
: toast.category === 'creation'
? 'bg-emerald-950/60 text-emerald-300 border-emerald-800/60'
: toast.category === 'update'
? 'bg-teal-950/60 text-teal-300 border-teal-800/60'
: toast.category === 'security'
? 'bg-rose-950/60 text-rose-300 border-rose-800/60'
: toast.category === 'notFound'
? 'bg-slate-800 text-slate-300 border-slate-700'
: toast.category === 'conflict'
? 'bg-purple-950/60 text-purple-300 border-purple-800/60'
: 'bg-slate-800 text-slate-300 border-slate-700'
}`}
>
{toast.categoryLabel}
</span>
)}
{toast.statusCode && (
<span className="text-[10px] font-mono font-medium px-1.5 py-0.5 rounded bg-slate-800 text-slate-300 border border-slate-700">
HTTP {toast.statusCode}
</span>
)}
</div>
{toast.errorsList && toast.errorsList.length > 0 ? (
<div className="mt-2 space-y-1.5">
<ul className="space-y-1.5">
{toast.errorsList.map((err, idx) => (
<li
key={idx}
className="text-xs text-rose-200/95 flex items-start gap-2 bg-rose-950/40 px-2.5 py-1.5 rounded-lg border border-rose-900/40"
>
<span className="text-rose-400 font-bold mt-0.5 text-sm leading-none">•</span>
<span className="leading-snug break-words font-medium">{err}</span>
</li>
))}
</ul>
</div>
) : toast.message ? (
<div className="text-xs mt-1.5 text-slate-300 leading-relaxed whitespace-pre-line break-words">
{toast.message.includes('\n') ? (
<ul className="space-y-1.5 mt-1">
{toast.message
.split('\n')
.map((l) => l.trim())
.filter(Boolean)
.map((line, idx) => (
<li
key={idx}
className="flex items-start gap-2 text-rose-200/95 bg-rose-950/40 px-2.5 py-1.5 rounded-lg border border-rose-900/40"
>
<span className="text-rose-400 font-bold mt-0.5 text-sm leading-none">•</span>
<span className="leading-snug break-words font-medium">{line.replace(/^[•\-*]\s*/, '')}</span>
</li>
))}
</ul>
) : (
<p>{toast.message}</p>
)}
</div>
) : null}
{toast.technicalDetails && (
<div className="mt-2.5 pt-2 border-t border-slate-800/80">
<button
type="button"
onClick={() => setShowTechnical(!showTechnical)}
className="inline-flex items-center gap-1 text-[11px] text-slate-400 hover:text-slate-200 transition-colors cursor-pointer"
>
<span>{showTechnical ? 'Hide Technical Reference' : 'Show Technical Reference'}</span>
{showTechnical ? <ChevronUp className="w-3 h-3" /> : <ChevronDown className="w-3 h-3" />}
</button>
{showTechnical && (
<div className="mt-1.5 p-2 rounded bg-[#090d16] border border-slate-800 font-mono text-[10px] text-slate-400 break-all select-all">
{toast.technicalDetails}
</div>
)}
</div>
)}
{toast.type === 'error' && (
<div className="mt-3 flex items-center justify-between gap-2 pt-2 border-t border-slate-800/60 text-[11px] text-slate-400">
<span className="text-[10px] text-slate-500">
{isPaused ? 'Timer paused (hovering)' : 'Notification lingers for review'}
</span>
<button
type="button"
onClick={handleCopy}
className="inline-flex items-center gap-1 px-2 py-1 rounded bg-slate-800/80 hover:bg-slate-700 text-slate-300 hover:text-white transition-colors cursor-pointer"
title="Copy details to clipboard for support or administrator"
>
{copied ? <Check className="w-3 h-3 text-emerald-400" /> : <Copy className="w-3 h-3" />}
<span>{copied ? 'Copied' : 'Copy Details'}</span>
</button>
</div>
)}
</div>
<button
onClick={() => onRemove(toast.id)}
className="text-slate-400 hover:text-white p-1 rounded-lg hover:bg-slate-800/60 transition-colors shrink-0 cursor-pointer"
title="Dismiss notification"
aria-label="Dismiss"
>
<X className="w-4 h-4" />
</button>
</div>
<div className="w-full bg-slate-800/40 h-1 overflow-hidden">
<div
className={`h-full transition-all duration-100 ease-linear ${
toast.type === 'success'
? 'bg-emerald-500'
: toast.type === 'error'
? 'bg-rose-500'
: 'bg-teal-500'
}`}
style={{ width: `${progressPercent}%` }}
/>
</div>
</div>
);
};
export const ToastProvider: React.FC<{ children: ReactNode }> = ({ children }) => {
const [toasts, setToasts] = useState<ToastItem[]>([]);
const removeToast = (id: string) => {
setToasts((prev) => prev.filter((t) => t.id !== id));
};
const addToast = (
type: ToastType,
title: string,
message?: string,
options?: ToastOptions
) => {
const id = Math.random().toString(36).substring(2, 9);
const duration = options?.duration || DEFAULT_DURATIONS[type];
setToasts((prev) => [
...prev,
{
id,
type,
title,
message,
duration,
createdAt: Date.now(),
statusCode: options?.statusCode,
category: options?.category,
categoryLabel: options?.categoryLabel,
technicalDetails: options?.technicalDetails,
fieldErrors: options?.fieldErrors,
errorsList: options?.errorsList,
},
]);
};
const success = (title: string, message?: string, options?: ToastOptions) =>
addToast('success', title, message, options);
const info = (title: string, message?: string, options?: ToastOptions) =>
addToast('info', title, message, options);
const error = (
titleOrError: unknown,
messageOrError?: unknown,
options?: ToastOptions
) => {
let rawError: unknown = null;
let actionTitle = 'Action Failed';
if (typeof titleOrError === 'string') {
actionTitle = titleOrError;
rawError = messageOrError;
} else {
rawError = titleOrError;
if (typeof messageOrError === 'string') {
actionTitle = messageOrError;
}
}
const parsed = parseFriendlyError(rawError, actionTitle);
let finalMessage = parsed.message;
if (
typeof messageOrError === 'string' &&
messageOrError.trim() &&
!messageOrError.includes('Request failed with status code') &&
(!parsed.hasReturnObject || !parsed.errorsList?.length)
) {
finalMessage = messageOrError.trim();
}
let finalErrorsList = parsed.errorsList || options?.errorsList;
if (!finalErrorsList && typeof finalMessage === 'string' && finalMessage.includes(',')) {
const parts = finalMessage.split(',').map((p) => p.trim()).filter(Boolean);
if (parts.length > 1) {
finalErrorsList = parts;
}
}
addToast('error', parsed.title, finalMessage, {
duration: options?.duration || DEFAULT_DURATIONS.error,
statusCode: parsed.statusCode || options?.statusCode,
category: options?.category || parsed.category,
categoryLabel: options?.categoryLabel || parsed.categoryLabel,
technicalDetails: parsed.technicalDetails || options?.technicalDetails,
fieldErrors: parsed.fieldErrors || options?.fieldErrors,
errorsList: finalErrorsList,
});
};
const toastRegion = (
<div
role="region"
aria-label="System Notifications"
className="fixed bottom-5 right-5 z-[999999] flex flex-col gap-3 max-w-md sm:max-w-lg w-full pointer-events-none p-2"
style={{ zIndex: 999999 }}
>
{toasts.map((t) => (
<ToastCard key={t.id} toast={t} onRemove={removeToast} />
))}
</div>
);
return (
<ToastContext.Provider value={{ toast: addToast, success, error, info }}>
{children}
{typeof document !== 'undefined' ? createPortal(toastRegion, document.body) : null}
</ToastContext.Provider>
);
};
export const useToast = () => {
const context = useContext(ToastContext);
if (!context) {
throw new Error('useToast must be used within a ToastProvider');
}
return context;
};
+38 -203
View File
@@ -1,11 +1,10 @@
import { updateHasherSettings as updateToolsHasherSettings } from './services/toolsService';
import { updateHasherSettings as updateUtilsHasherSettings } from './utils/hashids';
import { updateHasherSettings } from './services/toolsService';
export interface SecuritySettings {
Authority: string;
Audience: string;
ClientId: string;
ClientSecret?: string;
ClientSecret: string;
Scope?: string;
}
@@ -14,7 +13,7 @@ export interface ApiSettings {
}
export interface HasherSettings {
Salt?: string;
Salt: string;
MinHashLength: number;
}
@@ -31,7 +30,8 @@ export interface AppConfig {
export const defaultSecuritySettings: SecuritySettings = {
Authority: 'https://sts.security.khongisa.co.za',
Audience: 'pfm-api-dev',
ClientId: 'pfm-console-dev',
ClientId: 'pfm-scalar-dev',
ClientSecret: 'secret_71f88570a46eb22eb5270b47f69e3332c84d8db85d008f0276cb7431c8872d27',
Scope: 'openid profile roles email address pfm-api-dev',
};
@@ -40,22 +40,15 @@ export const defaultApiSettings: ApiSettings = {
};
export const defaultHasherSettings: HasherSettings = {
Salt: '',
Salt: 'TGlnaHQgQ2hhcm1zLCBNaWRyYW5kQm9va3MgbWFrZSBsb3RzIG9mIG1vbmV5IGFuZCBhcmUgYSBzdWNjZXNzZnVsIHZpcmFsIHN0b3J5IGluIFNvdXRoIEFmcmljYQ==',
MinHashLength: 11,
};
function syncAllHasherSettings(salt: string | undefined, minHashLength: number): void {
updateToolsHasherSettings(salt, minHashLength);
updateUtilsHasherSettings(salt, minHashLength);
}
function pickFirstNonEmpty(...candidates: any[]): string | undefined {
for (const c of candidates) {
if (c !== undefined && c !== null) {
const s = String(c).trim();
if (s !== '' && s !== 'undefined' && s !== 'null') {
return s;
}
if (s !== '' && s !== 'undefined' && s !== 'null') return s;
}
}
return undefined;
@@ -63,17 +56,13 @@ function pickFirstNonEmpty(...candidates: any[]): string | undefined {
function normalizeBaseUrl(url: string): string {
let trimmed = url.trim();
if (!/^https?:\/\//i.test(trimmed)) {
trimmed = `https://${trimmed}`;
}
if (!/^https?:\/\//i.test(trimmed)) trimmed = `https://${trimmed}`;
return trimmed.endsWith('/') ? trimmed : `${trimmed}/`;
}
function normalizeAuthorityUrl(url: string): string {
let trimmed = url.trim();
if (!/^https?:\/\//i.test(trimmed)) {
trimmed = `https://${trimmed}`;
}
if (!/^https?:\/\//i.test(trimmed)) trimmed = `https://${trimmed}`;
return trimmed.replace(/\/+$/, '');
}
@@ -83,177 +72,44 @@ function getWindowRuntimeConfig(): Record<string, any> {
return win.__RUNTIME_CONFIG__ || win.APP_CONFIG || win._env_ || {};
}
function extractSourceConfig(src: Record<string, any>): {
authority?: string;
audience?: string;
clientId?: string;
clientSecret?: string;
scope?: string;
baseUrl?: string;
hasherSalt?: string;
hasherMinLength?: number;
} {
function extractSourceConfig(src: Record<string, any>) {
if (!src || typeof src !== 'object') return {};
const sec = src.SecuritySettings || src.securitySettings || {};
const api = src.ApiSettings || src.apiSettings || {};
const hasher = src.HasherSettings || src.hasherSettings || {};
const minLenRaw = pickFirstNonEmpty(
src.VITE_HASHER_MIN_LENGTH,
src.HASHER_MIN_LENGTH,
src.HasherSettings__MinHashLength,
hasher.MinHashLength,
hasher.minHashLength,
src.MinHashLength,
src.minHashLength
);
const parsedMinLen = minLenRaw !== undefined ? Number(minLenRaw) : undefined;
return {
authority: pickFirstNonEmpty(
src.VITE_OIDC_AUTHORITY,
src.OIDC_AUTHORITY,
src.SecuritySettings__Authority,
sec.Authority,
sec.authority,
src.Authority,
src.authority
),
audience: pickFirstNonEmpty(
src.VITE_OIDC_AUDIENCE,
src.OIDC_AUDIENCE,
src.SecuritySettings__Audience,
sec.Audience,
sec.audience,
src.Audience,
src.audience
),
clientId: pickFirstNonEmpty(
src.VITE_OIDC_CLIENT_ID,
src.OIDC_CLIENT_ID,
src.SecuritySettings__ClientId,
sec.ClientId,
sec.clientId,
src.ClientId,
src.clientId
),
clientSecret: pickFirstNonEmpty(
src.VITE_OIDC_CLIENT_SECRET,
src.OIDC_CLIENT_SECRET,
src.SecuritySettings__ClientSecret,
sec.ClientSecret,
sec.clientSecret,
src.ClientSecret,
src.clientSecret
),
scope: pickFirstNonEmpty(
src.VITE_OIDC_SCOPE,
src.OIDC_SCOPE,
src.SecuritySettings__Scope,
sec.Scope,
sec.scope,
src.Scope,
src.scope
),
baseUrl: pickFirstNonEmpty(
src.VITE_API_BASE_URL,
src.API_BASE_URL,
src.ApiSettings__BaseUrl,
api.BaseUrl,
api.baseUrl,
src.BaseUrl,
src.baseUrl
),
hasherSalt: pickFirstNonEmpty(
src.VITE_HASHER_SALT,
src.HASHER_SALT,
src.HasherSettings__Salt,
hasher.Salt,
hasher.salt,
src.Salt,
src.salt
),
hasherMinLength:
parsedMinLen !== undefined && !isNaN(parsedMinLen) && parsedMinLen > 0
? parsedMinLen
: undefined,
authority: pickFirstNonEmpty(src.VITE_OIDC_AUTHORITY, src.OIDC_AUTHORITY, src.SecuritySettings?.Authority, src.SecuritySettings__Authority),
audience: pickFirstNonEmpty(src.VITE_OIDC_AUDIENCE, src.OIDC_AUDIENCE, src.SecuritySettings?.Audience, src.SecuritySettings__Audience),
clientId: pickFirstNonEmpty(src.VITE_OIDC_CLIENT_ID, src.OIDC_CLIENT_ID, src.SecuritySettings?.ClientId, src.SecuritySettings__ClientId),
clientSecret: pickFirstNonEmpty(src.VITE_OIDC_CLIENT_SECRET, src.OIDC_CLIENT_SECRET, src.SecuritySettings?.ClientSecret, src.SecuritySettings__ClientSecret),
scope: pickFirstNonEmpty(src.VITE_OIDC_SCOPE, src.OIDC_SCOPE, src.SecuritySettings?.Scope, src.SecuritySettings__Scope),
baseUrl: pickFirstNonEmpty(src.VITE_API_BASE_URL, src.API_BASE_URL, src.ApiSettings?.BaseUrl, src.ApiSettings__BaseUrl),
hasherSalt: pickFirstNonEmpty(src.VITE_HASHER_SALT, src.HASHER_SALT, src.HasherSettings?.Salt, src.HasherSettings__Salt),
hasherMinLength: Number(pickFirstNonEmpty(src.VITE_HASHER_MIN_LENGTH, src.HASHER_MIN_LENGTH, src.HasherSettings?.MinHashLength)) || undefined,
};
}
function resolveConfig(fetchedJson?: Record<string, any>): AppConfig {
const winCfg = extractSourceConfig(getWindowRuntimeConfig());
const fetchCfg = fetchedJson ? extractSourceConfig(fetchedJson) : {};
const envCfg = extractSourceConfig(
(typeof import.meta !== 'undefined' && (import.meta as any).env
? (import.meta as any).env
: {}) as Record<string, any>
);
const hasWin = Object.values(winCfg).some((v) => v !== undefined);
const hasFetch = Object.values(fetchCfg).some((v) => v !== undefined);
const hasEnv = Object.values(envCfg).some((v) => v !== undefined);
const envCfg = extractSourceConfig((typeof import.meta !== 'undefined' && (import.meta as any).env ? (import.meta as any).env : {}) as Record<string, any>);
let source: ConfigSource = 'fallback-defaults';
if (hasWin) source = 'runtime-injected';
else if (hasFetch) source = 'runtime-fetched';
else if (hasEnv) source = 'build-env';
const authority = normalizeAuthorityUrl(
pickFirstNonEmpty(winCfg.authority, fetchCfg.authority, envCfg.authority, defaultSecuritySettings.Authority)!
);
const audience = pickFirstNonEmpty(
winCfg.audience,
fetchCfg.audience,
envCfg.audience,
defaultSecuritySettings.Audience
)!;
const clientId = pickFirstNonEmpty(
winCfg.clientId,
fetchCfg.clientId,
envCfg.clientId,
defaultSecuritySettings.ClientId
)!;
const clientSecret = pickFirstNonEmpty(
winCfg.clientSecret,
fetchCfg.clientSecret,
envCfg.clientSecret
);
const scope = pickFirstNonEmpty(
winCfg.scope,
fetchCfg.scope,
envCfg.scope,
defaultSecuritySettings.Scope
);
const baseUrl = normalizeBaseUrl(
pickFirstNonEmpty(winCfg.baseUrl, fetchCfg.baseUrl, envCfg.baseUrl, defaultApiSettings.BaseUrl)!
);
const hasherSalt = pickFirstNonEmpty(
winCfg.hasherSalt,
fetchCfg.hasherSalt,
envCfg.hasherSalt,
defaultHasherSettings.Salt
);
const hasherMinLength =
winCfg.hasherMinLength ||
fetchCfg.hasherMinLength ||
envCfg.hasherMinLength ||
defaultHasherSettings.MinHashLength;
if (Object.values(winCfg).some((v) => v !== undefined)) source = 'runtime-injected';
else if (Object.values(fetchCfg).some((v) => v !== undefined)) source = 'runtime-fetched';
else if (Object.values(envCfg).some((v) => v !== undefined)) source = 'build-env';
return {
SecuritySettings: {
Authority: authority,
Audience: audience,
ClientId: clientId,
...(clientSecret ? { ClientSecret: clientSecret } : {}),
Scope: scope,
Authority: normalizeAuthorityUrl(pickFirstNonEmpty(winCfg.authority, fetchCfg.authority, envCfg.authority, defaultSecuritySettings.Authority)!),
Audience: pickFirstNonEmpty(winCfg.audience, fetchCfg.audience, envCfg.audience, defaultSecuritySettings.Audience)!,
ClientId: pickFirstNonEmpty(winCfg.clientId, fetchCfg.clientId, envCfg.clientId, defaultSecuritySettings.ClientId)!,
ClientSecret: pickFirstNonEmpty(winCfg.clientSecret, fetchCfg.clientSecret, envCfg.clientSecret, defaultSecuritySettings.ClientSecret)!,
Scope: pickFirstNonEmpty(winCfg.scope, fetchCfg.scope, envCfg.scope, defaultSecuritySettings.Scope),
},
ApiSettings: {
BaseUrl: baseUrl,
BaseUrl: normalizeBaseUrl(pickFirstNonEmpty(winCfg.baseUrl, fetchCfg.baseUrl, envCfg.baseUrl, defaultApiSettings.BaseUrl)!),
},
HasherSettings: {
Salt: hasherSalt || '',
MinHashLength: hasherMinLength,
Salt: pickFirstNonEmpty(winCfg.hasherSalt, fetchCfg.hasherSalt, envCfg.hasherSalt, defaultHasherSettings.Salt)!,
MinHashLength: winCfg.hasherMinLength || fetchCfg.hasherMinLength || envCfg.hasherMinLength || defaultHasherSettings.MinHashLength,
},
ConfigSource: source,
LoadedAt: new Date().toISOString(),
@@ -261,7 +117,7 @@ function resolveConfig(fetchedJson?: Record<string, any>): AppConfig {
}
let runtimeConfig: AppConfig = resolveConfig();
syncAllHasherSettings(runtimeConfig.HasherSettings.Salt, runtimeConfig.HasherSettings.MinHashLength);
updateHasherSettings(runtimeConfig.HasherSettings.Salt, runtimeConfig.HasherSettings.MinHashLength);
const configListeners: Array<(config: AppConfig) => void> = [];
@@ -273,49 +129,28 @@ export function onConfigChanged(listener: (config: AppConfig) => void): () => vo
};
}
let loadPromise: Promise<AppConfig> | null = null;
export async function loadRuntimeConfig(forceReload = false): Promise<AppConfig> {
if (loadPromise && !forceReload) {
return loadPromise;
}
loadPromise = (async () => {
export async function loadRuntimeConfig(): Promise<AppConfig> {
let fetchedJson: Record<string, any> | undefined;
if (typeof window !== 'undefined') {
try {
const res = await fetch(`/config.json?_t=${Date.now()}`, {
cache: 'no-store',
headers: { Accept: 'application/json' },
}).catch(() => null);
if (res && res.ok) {
const contentType = res.headers.get('content-type') || '';
if (contentType.includes('application/json') || contentType.includes('text/plain')) {
fetchedJson = await res.json().catch(() => undefined);
} else {
const text = await res.text().catch(() => '');
if (text.trim().startsWith('{')) {
fetchedJson = JSON.parse(text);
}
}
}
} catch {
// Fallback if /config.json is unreachable
// Safe fallback
}
}
runtimeConfig = resolveConfig(fetchedJson);
syncAllHasherSettings(runtimeConfig.HasherSettings.Salt, runtimeConfig.HasherSettings.MinHashLength);
updateHasherSettings(runtimeConfig.HasherSettings.Salt, runtimeConfig.HasherSettings.MinHashLength);
configListeners.forEach((fn) => fn(runtimeConfig));
return runtimeConfig;
})();
return loadPromise;
}
export const getAppConfig = (): AppConfig => runtimeConfig;
export const getSecuritySettings = (): SecuritySettings => runtimeConfig.SecuritySettings;
export const getApiBaseUrl = (): string => runtimeConfig.ApiSettings.BaseUrl;
export const getHasherSettings = (): HasherSettings => runtimeConfig.HasherSettings;
export const getAppConfig = () => runtimeConfig;
export const getSecuritySettings = () => runtimeConfig.SecuritySettings;
export const getApiBaseUrl = () => runtimeConfig.ApiSettings.BaseUrl;
export const getHasherSettings = () => runtimeConfig.HasherSettings;
@@ -1,357 +0,0 @@
import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
import { useState, useEffect, useMemo, useCallback } from 'react';
import { useAuth } from '../auth/AuthProvider';
import {
getUserNotifications,
getNotifications,
createNotification,
markNotificationAsRead,
getCurrentUserTenantId,
} from '../services/api';
import {
Notification,
NotificationPlatform,
NotificationStatus,
CreateNotificationRequest,
} from '../types';
export interface DraftMessage {
id: string;
recipientId: string;
recipientEmail: string;
recipientName?: string;
subject: string;
message: string;
platform?: NotificationPlatform;
updatedAt: string;
}
export function useInAppNotifications() {
const { user, claims } = useAuth();
const queryClient = useQueryClient();
const userId = (user?.id || claims?.sub || '') as string;
const userEmail = (user?.email || claims?.email || '') as string;
const draftsStorageKey = `pfm_partner_mailbox_drafts_${userId || 'default'}`;
const starredStorageKey = `pfm_partner_mailbox_starred_${userId || 'default'}`;
const trashStorageKey = `pfm_partner_mailbox_trash_${userId || 'default'}`;
const sentStorageKey = `pfm_partner_mailbox_sent_${userId || 'default'}`;
const readStorageList = useCallback(<T,>(key: string, fallbackKey?: string): T[] => {
try {
const stored = localStorage.getItem(key);
const parsed: T[] = stored ? JSON.parse(stored) : [];
if (fallbackKey && fallbackKey !== key) {
const fallbackStored = localStorage.getItem(fallbackKey);
const fallbackParsed: T[] = fallbackStored ? JSON.parse(fallbackStored) : [];
if (fallbackParsed.length > 0) {
const merged = [...parsed];
for (const item of fallbackParsed) {
const itemId = (item as any)?.id ?? item;
if (!merged.some(m => ((m as any)?.id ?? m) === itemId)) {
merged.push(item);
}
}
localStorage.setItem(key, JSON.stringify(merged));
localStorage.removeItem(fallbackKey);
return merged;
}
}
return parsed;
} catch {
return [];
}
}, []);
const [starredIds, setStarredIds] = useState<string[]>(() =>
readStorageList<string>(starredStorageKey, 'pfm_partner_mailbox_starred_default')
);
const [trashedIds, setTrashedIds] = useState<string[]>(() =>
readStorageList<string>(trashStorageKey, 'pfm_partner_mailbox_trash_default')
);
const [drafts, setDrafts] = useState<DraftMessage[]>(() =>
readStorageList<DraftMessage>(draftsStorageKey, 'pfm_partner_mailbox_drafts_default')
);
const [localSent, setLocalSent] = useState<Notification[]>(() =>
readStorageList<Notification>(sentStorageKey, 'pfm_partner_mailbox_sent_default')
);
const syncFromStorage = useCallback(() => {
setStarredIds(readStorageList<string>(starredStorageKey, 'pfm_partner_mailbox_starred_default'));
setTrashedIds(readStorageList<string>(trashStorageKey, 'pfm_partner_mailbox_trash_default'));
setDrafts(readStorageList<DraftMessage>(draftsStorageKey, 'pfm_partner_mailbox_drafts_default'));
setLocalSent(readStorageList<Notification>(sentStorageKey, 'pfm_partner_mailbox_sent_default'));
}, [readStorageList, starredStorageKey, trashStorageKey, draftsStorageKey, sentStorageKey]);
useEffect(() => {
syncFromStorage();
}, [syncFromStorage]);
useEffect(() => {
const handleSync = () => syncFromStorage();
window.addEventListener('pfm-mailbox-sync', handleSync);
window.addEventListener('storage', handleSync);
return () => {
window.removeEventListener('pfm-mailbox-sync', handleSync);
window.removeEventListener('storage', handleSync);
};
}, [syncFromStorage]);
const { data: rawNotifications = [], isLoading, refetch } = useQuery<Notification[]>({
queryKey: ['inapp-notifications', userId],
queryFn: async () => {
let list = await getUserNotifications(userId || undefined);
if (!list || list.length === 0) {
const orgList = await getNotifications();
if (orgList && orgList.length > 0) {
list = orgList;
}
}
return list || [];
},
refetchInterval: 30000,
staleTime: 10000,
});
const inAppNotifications = useMemo(() => {
return rawNotifications.filter(
n => Number(n.platform) === NotificationPlatform.InApp || n.platform === (NotificationPlatform.InApp as any)
);
}, [rawNotifications]);
const inboxNotifications = useMemo(() => {
return inAppNotifications.filter(
n => !trashedIds.includes(String(n.id)) && Number(n.status) !== NotificationStatus.Draft
);
}, [inAppNotifications, trashedIds]);
const allMailboxNotifications = inboxNotifications;
const unreadNotifications = useMemo(() => {
return inboxNotifications.filter(
n =>
Number(n.status) !== NotificationStatus.Read &&
Number(n.status) !== NotificationStatus.Cancelled &&
Number(n.status) !== NotificationStatus.Failed
);
}, [inboxNotifications]);
const unreadCount = unreadNotifications.length;
const top5Unread = useMemo(() => unreadNotifications.slice(0, 5), [unreadNotifications]);
const starredNotifications = useMemo(() => {
return inAppNotifications.filter(
n =>
starredIds.includes(String(n.id)) &&
!trashedIds.includes(String(n.id))
);
}, [inAppNotifications, starredIds, trashedIds]);
const trashedNotifications = useMemo(() => {
return inAppNotifications.filter(n => trashedIds.includes(String(n.id)));
}, [inAppNotifications, trashedIds]);
const markAsReadMutation = useMutation({
mutationFn: async (id: number | string) => {
await markNotificationAsRead(id);
},
onMutate: async (id) => {
await queryClient.cancelQueries({ queryKey: ['inapp-notifications', userId] });
queryClient.setQueryData<Notification[]>(['inapp-notifications', userId], (old = []) =>
old.map(n => (String(n.id) === String(id) ? { ...n, status: NotificationStatus.Read } : n))
);
},
onSettled: () => {
queryClient.invalidateQueries({ queryKey: ['inapp-notifications'] });
},
});
const markAllAsRead = useCallback(async () => {
const unread = unreadNotifications;
for (const item of unread) {
try {
await markNotificationAsRead(item.id);
} catch {}
}
queryClient.invalidateQueries({ queryKey: ['inapp-notifications'] });
}, [unreadNotifications, queryClient]);
const toggleStar = useCallback((id: string | number) => {
const strId = String(id);
setStarredIds(prev => {
const next = prev.includes(strId) ? prev.filter(x => x !== strId) : [...prev, strId];
try {
localStorage.setItem(starredStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
}, [starredStorageKey]);
const deleteMessage = useCallback((id: string | number) => {
const strId = String(id);
setTrashedIds(prev => {
const next = prev.includes(strId) ? prev : [...prev, strId];
try {
localStorage.setItem(trashStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
}, [trashStorageKey]);
const restoreMessage = useCallback((id: string | number) => {
const strId = String(id);
setTrashedIds(prev => {
const next = prev.filter(x => x !== strId);
try {
localStorage.setItem(trashStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
}, [trashStorageKey]);
const permanentDelete = useCallback((id: string | number) => {
const strId = String(id);
setTrashedIds(prev => {
const next = prev.filter(x => x !== strId);
try {
localStorage.setItem(trashStorageKey, JSON.stringify(next));
} catch {}
return next;
});
setLocalSent(prev => {
const next = prev.filter(n => String(n.id) !== strId);
try {
localStorage.setItem(sentStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
}, [trashStorageKey, sentStorageKey]);
const saveDraft = useCallback((draft: Omit<DraftMessage, 'id' | 'updatedAt'> & { id?: string }) => {
const draftId = draft.id || `draft_${Date.now()}`;
const newDraft: DraftMessage = {
...draft,
id: draftId,
updatedAt: new Date().toISOString(),
};
setDrafts(prev => {
const current = readStorageList<DraftMessage>(draftsStorageKey, 'pfm_partner_mailbox_drafts_default');
const base = current.length >= prev.length ? current : prev;
const filtered = base.filter(d => d.id !== draftId);
const next = [newDraft, ...filtered];
try {
localStorage.setItem(draftsStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
return draftId;
}, [draftsStorageKey, readStorageList]);
const deleteDraft = useCallback((id: string) => {
setDrafts(prev => {
const current = readStorageList<DraftMessage>(draftsStorageKey, 'pfm_partner_mailbox_drafts_default');
const base = current.length >= prev.length ? current : prev;
const next = base.filter(d => d.id !== id);
try {
localStorage.setItem(draftsStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
}, [draftsStorageKey, readStorageList]);
const sendMessageMutation = useMutation({
mutationFn: async (payload: {
recipientId: string;
recipientEmail: string;
recipientName?: string;
subject: string;
message: string;
platform?: NotificationPlatform;
organisationId?: number | string;
draftId?: string;
}) => {
const orgId = payload.organisationId || getCurrentUserTenantId() || 1;
const targetPlatform = payload.platform || NotificationPlatform.InApp;
const formattedDestination = `To: ${payload.recipientEmail} | From: ${userEmail || 'Partner User'}`;
const req: CreateNotificationRequest = {
organisationId: orgId,
recipient: payload.recipientId,
platform: targetPlatform,
subject: payload.subject,
destination: formattedDestination,
message: payload.message,
status: targetPlatform === NotificationPlatform.InApp ? NotificationStatus.Delivered : NotificationStatus.Queued,
};
await createNotification(req);
const sentItem: Notification = {
id: `sent_${Date.now()}`,
organisationId: orgId,
recipient: payload.recipientId,
platform: targetPlatform,
status: NotificationStatus.Sent,
subject: payload.subject,
message: payload.message,
destination: formattedDestination,
createdAt: new Date().toISOString(),
sentAt: new Date().toISOString(),
};
setLocalSent(prev => {
const next = [sentItem, ...prev];
try {
localStorage.setItem(sentStorageKey, JSON.stringify(next));
window.dispatchEvent(new Event('pfm-mailbox-sync'));
} catch {}
return next;
});
if (payload.draftId) {
deleteDraft(payload.draftId);
}
},
onSuccess: () => {
queryClient.invalidateQueries({ queryKey: ['inapp-notifications'] });
},
});
return {
rawNotifications,
inAppNotifications,
allMailboxNotifications,
inboxNotifications,
unreadNotifications,
unreadCount,
top5Unread,
starredNotifications,
trashedNotifications,
sentNotifications: localSent,
drafts,
starredIds,
trashedIds,
isLoading,
refetch,
markAsRead: (id: string | number) => markAsReadMutation.mutate(id),
markAllAsRead,
toggleStar,
deleteMessage,
restoreMessage,
permanentDelete,
saveDraft,
deleteDraft,
sendMessage: sendMessageMutation.mutateAsync,
isSending: sendMessageMutation.isPending,
};
}
+1 -7
View File
@@ -1,13 +1,7 @@
@import "tailwindcss";
:root {
color-scheme: dark;
}
@layer base {
html, body {
background-color: #020617; /* slate-950 */
color: #f8fafc; /* slate-100 */
body {
font-family: 'Plus Jakarta Sans', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
}
@@ -1,683 +0,0 @@
import {
ApprovalStatus,
ComplianceStatus,
ContractStatus,
ActivityStatus,
Priority,
OrganisationType,
IndustrySector,
ProjectType,
UnitOfMeasure,
EvidenceType,
RiskLikelihood,
RiskImpact,
NotificationPlatform,
NotificationStatus,
EmailStatuses,
UserRole,
} from '../types';
export const formatZAR = (amount: number): string => {
return new Intl.NumberFormat('en-ZA', {
style: 'currency',
currency: 'ZAR',
maximumFractionDigits: 0,
}).format(amount || 0);
};
export const formatCompactZAR = (amount: number): string => {
const num = Number(amount) || 0;
if (num >= 1_000_000_000) {
return `R ${(num / 1_000_000_000).toFixed(2)}bn`;
}
if (num >= 1_000_000) {
return `R ${(num / 1_000_000).toFixed(1)}m`;
}
if (num >= 1_000) {
return `R ${(num / 1_000).toFixed(0)}k`;
}
return formatZAR(num);
};
export const formatDate = (dateStr?: string | null): string => {
if (!dateStr) return '—';
try {
const d = new Date(dateStr);
if (isNaN(d.getTime())) return dateStr;
return d.toLocaleDateString('en-GB', {
day: 'numeric',
month: 'short',
year: 'numeric',
});
} catch {
return dateStr;
}
};
export const formatShortDate = (dateStr?: string | null): string => {
if (!dateStr) return '—';
try {
const d = new Date(dateStr);
if (isNaN(d.getTime())) return dateStr;
return d.toLocaleDateString('en-GB', {
day: '2-digit',
month: 'short',
year: 'numeric',
});
} catch {
return dateStr;
}
};
export const EMAIL_STATUS_OPTIONS = [
{ value: EmailStatuses.GeneralError, label: 'General Error' },
{ value: EmailStatuses.AuthenticationError, label: 'Authentication Error' },
{ value: EmailStatuses.ProtocolError, label: 'Protocol Error' },
{ value: EmailStatuses.Connected, label: 'Connected' },
{ value: EmailStatuses.Disconnected, label: 'Disconnected' },
{ value: EmailStatuses.TooManyConnections, label: 'Too Many Connections' },
{ value: EmailStatuses.ConnectionAborted, label: 'Connection Aborted' },
{ value: EmailStatuses.Success, label: 'Success' },
];
export const EMAIL_STATUSES_OPTIONS = EMAIL_STATUS_OPTIONS;
export const NOTIFICATION_STATUS_OPTIONS = [
{ value: NotificationStatus.Pending, label: 'Pending' },
{ value: NotificationStatus.Queued, label: 'Queued' },
{ value: NotificationStatus.Processing, label: 'Processing' },
{ value: NotificationStatus.Sent, label: 'Sent' },
{ value: NotificationStatus.Delivered, label: 'Delivered' },
{ value: NotificationStatus.Read, label: 'Read' },
{ value: NotificationStatus.Failed, label: 'Failed' },
{ value: NotificationStatus.Cancelled, label: 'Cancelled' },
{ value: NotificationStatus.Bounced, label: 'Bounced' },
{ value: NotificationStatus.Draft, label: 'Draft' },
];
export const NOTIFICATION_PLATFORM_OPTIONS = [
{ value: NotificationPlatform.Email, label: 'Email' },
{ value: NotificationPlatform.SMS, label: 'SMS' },
{ value: NotificationPlatform.WhatsApp, label: 'WhatsApp' },
{ value: NotificationPlatform.PushNotification, label: 'Push Notification' },
{ value: NotificationPlatform.InApp, label: 'In App' },
{ value: NotificationPlatform.Teams, label: 'Teams' },
{ value: NotificationPlatform.Slack, label: 'Slack' },
{ value: NotificationPlatform.Webhook, label: 'Webhook' },
{ value: NotificationPlatform.Other, label: 'Other' },
];
export const EVIDENCE_TYPE_OPTIONS = [
{ value: EvidenceType.AttendanceRegister, label: 'Attendance Register' },
{ value: EvidenceType.BankStatement, label: 'Bank Statement' },
{ value: EvidenceType.CompletionCertificate, label: 'Completion Certificate' },
{ value: EvidenceType.FinancialInvoiceOrReceipt, label: 'Financial Invoice Or Receipt' },
{ value: EvidenceType.GeotaggedPhoto, label: 'Geotagged Photo' },
{ value: EvidenceType.InspectionReport, label: 'Inspection Report' },
{ value: EvidenceType.MeetingMinutes, label: 'Meeting Minutes' },
{ value: EvidenceType.PayrollOrStipendRegister, label: 'Payroll Or Stipend Register' },
{ value: EvidenceType.ProcurementDocument, label: 'Procurement Document' },
{ value: EvidenceType.TechnicalSpecificationOrDesign, label: 'Technical Specification Or Design' },
{ value: EvidenceType.VideoRecording, label: 'Video Recording' },
{ value: EvidenceType.Other, label: 'Other' },
];
export const PROJECT_TYPE_OPTIONS = [
{ value: ProjectType.CapacityBuildingAndTraining, label: 'Capacity Building And Training' },
{ value: ProjectType.CapitalExpenditureAndInfrastructure, label: 'Capital Expenditure And Infrastructure' },
{ value: ProjectType.CommercializationAndScaling, label: 'Commercialization And Scaling' },
{ value: ProjectType.FeasibilityAndTechnicalAssistance, label: 'Feasibility And Technical Assistance' },
{ value: ProjectType.OperationalGrantAndSubsidy, label: 'Operational Grant And Subsidy' },
{ value: ProjectType.ProductDevelopmentAndPrototyping, label: 'Product Development And Prototyping' },
{ value: ProjectType.ResearchAndDevelopment, label: 'Research And Development' },
{ value: ProjectType.SocialImpactAndCommunityDevelopment, label: 'Social Impact And Community Development' },
{ value: ProjectType.TechnologyTransferAndAdoption, label: 'Technology Transfer And Adoption' },
{ value: ProjectType.Innovation, label: 'Innovation' },
{ value: ProjectType.Other, label: 'Other' },
];
export const INDUSTRY_SECTOR_OPTIONS = [
{ value: IndustrySector.AgricultureAndAgroProcessing, label: 'Agriculture And Agro Processing' },
{ value: IndustrySector.AutomotiveAndTransportEquipment, label: 'Automotive And Transport Equipment' },
{ value: IndustrySector.ChemicalsAndPharmaceuticals, label: 'Chemicals And Pharmaceuticals' },
{ value: IndustrySector.ConstructionAndInfrastructure, label: 'Construction And Infrastructure' },
{ value: IndustrySector.CreativeIndustriesAndMedia, label: 'Creative Industries And Media' },
{ value: IndustrySector.DefenseAndAerospace, label: 'Defense And Aerospace' },
{ value: IndustrySector.EducationAndSkillsDevelopment, label: 'Education And Skills Development' },
{ value: IndustrySector.EnergyAndUtilities, label: 'Energy And Utilities' },
{ value: IndustrySector.FinancialServices, label: 'Financial Services' },
{ value: IndustrySector.HealthcareAndLifeSciences, label: 'Healthcare And Life Sciences' },
{ value: IndustrySector.InformationCommunicationTechnology, label: 'Information Communication Technology' },
{ value: IndustrySector.ManufacturingAndIndustrial, label: 'Manufacturing And Industrial' },
{ value: IndustrySector.MiningAndMetals, label: 'Mining And Metals' },
{ value: IndustrySector.RealEstateAndHousing, label: 'Real Estate And Housing' },
{ value: IndustrySector.RetailAndConsumerGoods, label: 'Retail And Consumer Goods' },
{ value: IndustrySector.TourismAndHospitality, label: 'Tourism And Hospitality' },
{ value: IndustrySector.WaterAndSanitation, label: 'Water And Sanitation' },
{ value: IndustrySector.Other, label: 'Other' },
];
export const ORGANISATION_TYPE_OPTIONS = [
{ value: OrganisationType.NonGovernmentalOrganisation, label: 'Non-Governmental Organisation' },
{ value: OrganisationType.CivilSocietyOrganisation, label: 'Civil Society Organisation' },
{ value: OrganisationType.Trust, label: 'Trust' },
{ value: OrganisationType.FaithBasedOrganisation, label: 'Faith-Based Organisation' },
{ value: OrganisationType.PrivateLimitedCompany, label: 'Private Limited Company' },
{ value: OrganisationType.PublicLimitedCompany, label: 'Public Limited Company' },
{ value: OrganisationType.SoleProprietorship, label: 'Sole Proprietorship' },
{ value: OrganisationType.Partnership, label: 'Partnership' },
{ value: OrganisationType.SocialEnterprise, label: 'Social Enterprise' },
{ value: OrganisationType.NationalGovernmentMinistry, label: 'National Government Ministry' },
{ value: OrganisationType.ProvincialGovernmentEntity, label: 'Provincial Government Entity' },
{ value: OrganisationType.LocalGovernmentMunicipality, label: 'Local Government Municipality' },
{ value: OrganisationType.StateOwnedEnterprise, label: 'State-Owned Enterprise' },
{ value: OrganisationType.PublicAgency, label: 'Public Agency' },
{ value: OrganisationType.PublicUniversity, label: 'Public University' },
{ value: OrganisationType.PrivateUniversity, label: 'Private University' },
{ value: OrganisationType.ResearchInstitute, label: 'Research Institute' },
{ value: OrganisationType.TechnicalVocationalCollege, label: 'Technical Vocational College' },
{ value: OrganisationType.Cooperative, label: 'Cooperative' },
{ value: OrganisationType.MicrofinanceInstitution, label: 'Microfinance Institution' },
{ value: OrganisationType.CommercialBank, label: 'Commercial Bank' },
{ value: OrganisationType.DevelopmentFinanceInstitution, label: 'Development Finance Institution' },
{ value: OrganisationType.UnitedNationsAgency, label: 'United Nations Agency' },
{ value: OrganisationType.IntergovernmentalOrganisation, label: 'Intergovernmental Organisation' },
{ value: OrganisationType.InternationalNGO, label: 'International NGO' },
{ value: OrganisationType.Consortium, label: 'Consortium' },
{ value: OrganisationType.SpecialPurposeVehicle, label: 'Special Purpose Vehicle' },
];
export const PRIORITY_OPTIONS = [
{ value: Priority.Low, label: 'Low' },
{ value: Priority.Medium, label: 'Medium' },
{ value: Priority.High, label: 'High' },
{ value: Priority.Critical, label: 'Critical' },
];
export const UNIT_OF_MEASURE_OPTIONS = [
{ value: UnitOfMeasure.Count, label: 'Count' },
{ value: UnitOfMeasure.Percentage, label: 'Percentage' },
{ value: UnitOfMeasure.Currency, label: 'Currency' },
{ value: UnitOfMeasure.Area, label: 'Area' },
{ value: UnitOfMeasure.Weight, label: 'Weight' },
{ value: UnitOfMeasure.Volume, label: 'Volume' },
{ value: UnitOfMeasure.DurationDays, label: 'Duration (Days)' },
{ value: UnitOfMeasure.DurationMonths, label: 'Duration (Months)' },
{ value: UnitOfMeasure.Ratio, label: 'Ratio' },
];
export const CONTRACT_STATUS_OPTIONS = [
{ value: ContractStatus.Draft, label: 'Draft' },
{ value: ContractStatus.PendingApproval, label: 'Pending Approval' },
{ value: ContractStatus.Active, label: 'Active' },
{ value: ContractStatus.Expired, label: 'Expired' },
{ value: ContractStatus.Terminated, label: 'Terminated' },
{ value: ContractStatus.Amended, label: 'Amended' },
];
export const APPROVAL_STATUS_OPTIONS = [
{ value: ApprovalStatus.Pending, label: 'Pending' },
{ value: ApprovalStatus.Review, label: 'Review' },
{ value: ApprovalStatus.Approved, label: 'Approved' },
{ value: ApprovalStatus.Rejected, label: 'Rejected' },
{ value: ApprovalStatus.Removed, label: 'Removed' },
];
export const ACTIVITY_STATUS_OPTIONS = [
{ value: ActivityStatus.Active, label: 'Active' },
{ value: ActivityStatus.Inactive, label: 'Inactive' },
{ value: ActivityStatus.Disabled, label: 'Disabled' },
];
export const RISK_LIKELIHOOD_OPTIONS = [
{ value: RiskLikelihood.Rare, label: 'Rare' },
{ value: RiskLikelihood.Unlikely, label: 'Unlikely' },
{ value: RiskLikelihood.Possible, label: 'Possible' },
{ value: RiskLikelihood.Likely, label: 'Likely' },
{ value: RiskLikelihood.AlmostCertain, label: 'Almost Certain' },
];
export const RISK_IMPACT_OPTIONS = [
{ value: RiskImpact.Minor, label: 'Minor' },
{ value: RiskImpact.Moderate, label: 'Moderate' },
{ value: RiskImpact.Major, label: 'Major' },
{ value: RiskImpact.Critical, label: 'Critical' },
{ value: RiskImpact.Severe, label: 'Severe' },
];
export const getApprovalStatusBadge = (status: ApprovalStatus | number) => {
const s = Number(status);
switch (s) {
case ApprovalStatus.Approved:
return {
label: 'Approved',
className: 'bg-emerald-500/10 text-emerald-400 border-emerald-500/30 font-semibold',
dot: 'bg-emerald-500',
};
case ApprovalStatus.Review:
return {
label: 'In Review',
className: 'bg-amber-500/10 text-amber-400 border-amber-500/30 font-semibold',
dot: 'bg-amber-500',
};
case ApprovalStatus.Rejected:
return {
label: 'Needs Changes',
className: 'bg-rose-500/10 text-rose-400 border-rose-500/30 font-semibold',
dot: 'bg-rose-500',
};
case ApprovalStatus.Removed:
return {
label: 'Removed',
className: 'bg-slate-800/80 text-slate-400 border-slate-700/80 font-semibold',
dot: 'bg-slate-500',
};
case ApprovalStatus.Pending:
default:
return {
label: 'Pending',
className: 'bg-teal-500/10 text-teal-300 border-teal-500/30 font-semibold',
dot: 'bg-teal-400',
};
}
};
export const getComplianceStatusBadge = (status: ComplianceStatus | number) => {
const s = Number(status);
switch (s) {
case ComplianceStatus.Exceeded:
return {
label: 'Exceeded Expectation',
className: 'bg-purple-500/15 text-purple-300 border-purple-500/30 font-semibold',
dot: 'bg-purple-400',
};
case ComplianceStatus.Met:
return {
label: 'Met',
className: 'bg-emerald-500/15 text-emerald-300 border-emerald-500/30 font-semibold',
dot: 'bg-emerald-400',
};
case ComplianceStatus.NotMet:
default:
return {
label: 'Not Met',
className: 'bg-rose-500/15 text-rose-300 border-rose-500/30 font-semibold',
dot: 'bg-rose-400',
};
}
};
export const COMPLIANCE_STATUS_OPTIONS = [
{ value: ComplianceStatus.NotMet, label: 'Not Met' },
{ value: ComplianceStatus.Met, label: 'Met' },
{ value: ComplianceStatus.Exceeded, label: 'Exceeded Expectation' },
];
export const getContractStatusBadge = (status: ContractStatus | number) => {
const s = Number(status);
switch (s) {
case ContractStatus.Active:
return {
label: 'Active',
className: 'bg-emerald-500/10 text-emerald-400 border-emerald-500/30 font-semibold',
};
case ContractStatus.PendingApproval:
return {
label: 'Pending Approval',
className: 'bg-amber-500/10 text-amber-400 border-amber-500/30 font-semibold',
};
case ContractStatus.Amended:
return {
label: 'Amended',
className: 'bg-indigo-500/10 text-indigo-400 border-indigo-500/30 font-semibold',
};
case ContractStatus.Expired:
return {
label: 'Expired',
className: 'bg-slate-800/80 text-slate-400 border-slate-700/80 font-semibold',
};
case ContractStatus.Terminated:
return {
label: 'Terminated',
className: 'bg-rose-500/10 text-rose-400 border-rose-500/30 font-semibold',
};
case ContractStatus.Draft:
default:
return {
label: 'Draft',
className: 'bg-slate-800/80 text-slate-300 border-slate-700/80 font-semibold',
};
}
};
export const getActivityStatusBadge = (status: ActivityStatus | number | string | boolean | null | undefined) => {
if (status === null || status === undefined) {
return {
label: 'Active',
className: 'bg-emerald-500/10 text-emerald-400 border-emerald-500/30 font-semibold',
};
}
if (typeof status === 'boolean') {
return status
? { label: 'Active', className: 'bg-emerald-500/10 text-emerald-400 border-emerald-500/30 font-semibold' }
: { label: 'Inactive', className: 'bg-slate-800/80 text-slate-400 border-slate-700/80 font-semibold' };
}
const str = String(status).trim().toLowerCase();
if (str === '1' || str === 'active' || str === 'enabled') {
return {
label: 'Active',
className: 'bg-emerald-500/10 text-emerald-400 border-emerald-500/30 font-semibold',
};
}
if (str === '2' || str === 'inactive') {
return {
label: 'Inactive',
className: 'bg-slate-800/80 text-slate-400 border-slate-700/80 font-semibold',
};
}
if (str === '3' || str === 'disabled' || str === 'suspended' || str === 'terminated') {
return {
label: str === 'suspended' ? 'Suspended' : 'Disabled',
className: 'bg-rose-500/10 text-rose-400 border-rose-500/30 font-semibold',
};
}
if (str === 'approved') {
return {
label: 'Approved',
className: 'bg-emerald-500/10 text-emerald-400 border-emerald-500/30 font-semibold',
};
}
if (str === 'pending' || str === 'review') {
return {
label: 'Pending',
className: 'bg-amber-500/10 text-amber-400 border-amber-500/30 font-semibold',
};
}
const s = Number(status);
switch (s) {
case ActivityStatus.Active:
return {
label: 'Active',
className: 'bg-emerald-500/10 text-emerald-400 border-emerald-500/30 font-semibold',
};
case ActivityStatus.Inactive:
return {
label: 'Inactive',
className: 'bg-slate-800/80 text-slate-400 border-slate-700/80 font-semibold',
};
case ActivityStatus.Disabled:
return {
label: 'Disabled',
className: 'bg-rose-500/10 text-rose-400 border-rose-500/30 font-semibold',
};
default:
return {
label: String(status),
className: 'bg-slate-800/80 text-slate-300 border-slate-700/80 font-semibold',
};
}
};
export const getOrganisationStatusBadge = (statusOrOrg: any) => {
let val: any = statusOrOrg;
if (statusOrOrg !== null && typeof statusOrOrg === 'object') {
val =
statusOrOrg.status ??
statusOrOrg.Status ??
statusOrOrg.activityStatus ??
statusOrOrg.ActivityStatus ??
statusOrOrg.approvalStatus ??
statusOrOrg.ApprovalStatus ??
statusOrOrg.statusId ??
statusOrOrg.StatusId ??
statusOrOrg.state ??
statusOrOrg.State ??
(statusOrOrg.isActive !== undefined ? (statusOrOrg.isActive ? 1 : 2) : undefined) ??
(statusOrOrg.IsActive !== undefined ? (statusOrOrg.IsActive ? 1 : 2) : undefined);
}
return getActivityStatusBadge(val);
};
export const getPriorityBadge = (priority: Priority | number) => {
const p = Number(priority);
switch (p) {
case Priority.Critical:
return { label: 'Critical', className: 'bg-rose-500/10 text-rose-400 border-rose-500/30 font-semibold' };
case Priority.High:
return { label: 'High', className: 'bg-amber-500/10 text-amber-400 border-amber-500/30 font-semibold' };
case Priority.Medium:
return { label: 'Medium', className: 'bg-teal-500/10 text-teal-300 border-teal-500/30 font-semibold' };
case Priority.Low:
default:
return { label: 'Low', className: 'bg-slate-800/80 text-slate-400 border-slate-700/80 font-semibold' };
}
};
export const getOrganisationTypeLabel = (type: OrganisationType | number): string => {
const opt = ORGANISATION_TYPE_OPTIONS.find((o) => o.value === Number(type));
return opt ? opt.label : 'Organisation';
};
export const getIndustrySectorLabel = (sector: IndustrySector | number): string => {
const opt = INDUSTRY_SECTOR_OPTIONS.find((o) => o.value === Number(sector));
return opt ? opt.label : 'Industry Sector';
};
export const getProjectTypeLabel = (type: ProjectType | number): string => {
const opt = PROJECT_TYPE_OPTIONS.find((o) => o.value === Number(type));
return opt ? opt.label : 'Project Type';
};
export const getEvidenceTypeLabel = (type: EvidenceType | number): string => {
const opt = EVIDENCE_TYPE_OPTIONS.find((o) => o.value === Number(type));
return opt ? opt.label : 'Evidence Document';
};
export const getUnitOfMeasureLabel = (uom?: UnitOfMeasure | number | null): string => {
if (uom === null || uom === undefined) return 'Qty';
const opt = UNIT_OF_MEASURE_OPTIONS.find((o) => o.value === Number(uom));
return opt ? opt.label : 'Qty';
};
export const getNotificationPlatformLabel = (platform?: NotificationPlatform | number | null): string => {
const opt = NOTIFICATION_PLATFORM_OPTIONS.find((o) => o.value === Number(platform));
return opt ? opt.label : 'Platform';
};
export const getNotificationStatusLabel = (status?: NotificationStatus | number | null): string => {
const opt = NOTIFICATION_STATUS_OPTIONS.find((o) => o.value === Number(status));
return opt ? opt.label : 'Status';
};
export const getEmailStatusLabel = (status?: EmailStatuses | number | null): string => {
const opt = EMAIL_STATUS_OPTIONS.find((o) => o.value === Number(status));
return opt ? opt.label : 'Status';
};
export const getEmailStatusBadge = (status?: EmailStatuses | number | null) => {
const s = Number(status);
switch (s) {
case EmailStatuses.Connected:
case EmailStatuses.Success:
return { label: getEmailStatusLabel(s), className: 'bg-emerald-50 text-emerald-800 border-emerald-300 font-semibold' };
case EmailStatuses.Disconnected:
return { label: getEmailStatusLabel(s), className: 'bg-slate-100 text-slate-700 border-slate-300 font-semibold' };
default:
return { label: getEmailStatusLabel(s), className: 'bg-rose-50 text-rose-800 border-rose-300 font-semibold' };
}
};
export const getNotificationStatusBadge = (status?: NotificationStatus | number | null) => {
const s = Number(status);
switch (s) {
case NotificationStatus.Draft:
return { label: 'Draft', className: 'bg-purple-50 text-purple-800 border-purple-300 font-semibold' };
case NotificationStatus.Delivered:
case NotificationStatus.Read:
return { label: getNotificationStatusLabel(s), className: 'bg-emerald-50 text-emerald-800 border-emerald-300 font-semibold' };
case NotificationStatus.Sent:
case NotificationStatus.Queued:
case NotificationStatus.Processing:
return { label: getNotificationStatusLabel(s), className: 'bg-sky-50 text-sky-800 border-sky-300 font-semibold' };
case NotificationStatus.Pending:
return { label: getNotificationStatusLabel(s), className: 'bg-amber-50 text-amber-900 border-amber-300 font-semibold' };
case NotificationStatus.Failed:
case NotificationStatus.Cancelled:
case NotificationStatus.Bounced:
default:
return { label: getNotificationStatusLabel(s), className: 'bg-rose-50 text-rose-800 border-rose-300 font-semibold' };
}
};
export const getRiskScoreColor = (likelihood: RiskLikelihood | number, impact: RiskImpact | number) => {
const score = (Number(likelihood) || 1) * (Number(impact) || 1);
if (score >= 15) {
return { level: 'Critical', color: 'bg-rose-600 text-white', badge: 'bg-rose-500/20 text-rose-300 border border-rose-500/40 font-bold' };
}
if (score >= 10) {
return { level: 'High', color: 'bg-orange-500 text-white', badge: 'bg-orange-500/20 text-orange-300 border border-orange-500/40 font-bold' };
}
if (score >= 5) {
return { level: 'Moderate', color: 'bg-amber-500 text-white', badge: 'bg-amber-500/20 text-amber-300 border border-amber-500/40 font-semibold' };
}
return { level: 'Low', color: 'bg-emerald-600 text-white', badge: 'bg-emerald-500/20 text-emerald-300 border border-emerald-500/40 font-semibold' };
};
const USER_EMAIL_CACHE: Record<string, string> = {};
const EMAIL_TO_USER_ID_CACHE: Record<string, string> = {};
export const registerUserEmail = (userId: string | number, email: string) => {
if (userId && email && typeof email === 'string' && email.trim()) {
const cleanId = String(userId).trim();
const cleanEmail = email.trim();
USER_EMAIL_CACHE[cleanId] = cleanEmail;
USER_EMAIL_CACHE[cleanId.toLowerCase()] = cleanEmail;
EMAIL_TO_USER_ID_CACHE[cleanEmail.toLowerCase()] = cleanId;
}
};
export const registerUserEmails = (users: Array<{ id: string | number; email?: string | null }>) => {
if (!Array.isArray(users)) return;
for (const u of users) {
if (u && u.id && u.email) {
registerUserEmail(u.id, u.email);
}
}
};
export const getUserIdByEmail = (email?: string | null): string | undefined => {
if (!email || typeof email !== 'string') return undefined;
return EMAIL_TO_USER_ID_CACHE[email.trim().toLowerCase()];
};
export const getUserEmail = (userIdOrEmail?: string | number | null): string => {
if (!userIdOrEmail) return '—';
const str = String(userIdOrEmail).trim();
if (!str) return '—';
if (str.includes('@')) return str;
if (USER_EMAIL_CACHE[str]) return USER_EMAIL_CACHE[str];
if (USER_EMAIL_CACHE[str.toLowerCase()]) return USER_EMAIL_CACHE[str.toLowerCase()];
try {
const storedUserJson = localStorage.getItem('pfm_auth_user');
const storedSub = localStorage.getItem('pfm_user_sub');
if (storedUserJson) {
const parsed = JSON.parse(storedUserJson);
if (parsed?.email) {
const email = String(parsed.email).trim();
if (
(parsed.id && String(parsed.id).toLowerCase() === str.toLowerCase()) ||
(parsed.sub && String(parsed.sub).toLowerCase() === str.toLowerCase()) ||
(storedSub && String(storedSub).toLowerCase() === str.toLowerCase())
) {
registerUserEmail(str, email);
return email;
}
}
}
} catch {}
return str;
};
export const USER_ROLE_OPTIONS = [
{ value: 'Partner', label: 'Partner' },
{ value: 'Admin', label: 'Admin' },
{ value: 'Executive', label: 'Executive' },
{ value: 'Supervisor', label: 'Supervisor' },
{ value: 'Manager', label: 'Manager' },
{ value: 'Contributor', label: 'Contributor' },
{ value: 'Unassigned', label: 'Unassigned' },
];
export const getUserRoleBadge = (role?: string | number | UserRole | null) => {
if (role === null || role === undefined || role === '' || String(role).trim().toLowerCase() === 'null' || String(role).trim().toLowerCase() === 'unassigned') {
return {
label: 'Unassigned',
className: 'bg-slate-800/80 text-slate-400 border-slate-700/80 shadow-xs',
dot: 'bg-slate-500',
};
}
const roleStr = String(role).trim().toLowerCase();
if (roleStr === 'partner') {
return {
label: 'Partner',
className: 'bg-emerald-500/15 text-emerald-300 border-emerald-500/30 shadow-xs shadow-emerald-500/10 font-semibold',
dot: 'bg-emerald-400',
};
}
if (roleStr === 'admin' || roleStr === 'superadmin' || roleStr === '1') {
return {
label: 'Admin',
className: 'bg-rose-500/15 text-rose-300 border-rose-500/30 shadow-xs shadow-rose-500/10 font-semibold',
dot: 'bg-rose-400',
};
}
if (roleStr === 'executive' || roleStr === '2') {
return {
label: 'Executive',
className: 'bg-amber-500/15 text-amber-300 border-amber-500/30 shadow-xs shadow-amber-500/10 font-semibold',
dot: 'bg-amber-400',
};
}
if (roleStr === 'supervisor' || roleStr === '3') {
return {
label: 'Supervisor',
className: 'bg-purple-500/15 text-purple-300 border-purple-500/30 shadow-xs shadow-purple-500/10 font-semibold',
dot: 'bg-purple-400',
};
}
if (roleStr === 'manager' || roleStr === 'programmemanager' || roleStr === 'projectmanager' || roleStr === '4') {
return {
label: 'Manager',
className: 'bg-blue-500/15 text-blue-300 border-blue-500/30 shadow-xs shadow-blue-500/10 font-semibold',
dot: 'bg-blue-400',
};
}
if (roleStr === 'contributor' || roleStr === 'viewer' || roleStr === 'recipientviewer' || roleStr === '5') {
return {
label: 'Contributor',
className: 'bg-emerald-500/15 text-emerald-300 border-emerald-500/30 shadow-xs shadow-emerald-500/10 font-semibold',
dot: 'bg-emerald-400',
};
}
const formatted = roleStr.charAt(0).toUpperCase() + roleStr.slice(1);
return {
label: formatted,
className: 'bg-cyan-500/15 text-cyan-300 border-cyan-500/30',
dot: 'bg-cyan-400',
};
};
@@ -1,151 +0,0 @@
/**
* Markdown & Branded HTML Formatting Utilities for PostFundManagement (PFM)
*/
export function isHtmlContent(content: string): boolean {
if (!content) return false;
const trimmed = content.trim();
return (
trimmed.startsWith('<!DOCTYPE') ||
trimmed.startsWith('<html') ||
trimmed.startsWith('<div') ||
trimmed.startsWith('<table') ||
trimmed.startsWith('<p') ||
trimmed.startsWith('<h') ||
trimmed.startsWith('<ul') ||
trimmed.startsWith('<ol') ||
trimmed.startsWith('<blockquote') ||
(trimmed.includes('</') && trimmed.includes('>')) ||
/<(strong|b|em|i|u|h[1-6]|ul|ol|li|table|blockquote|div|p|img|hr|br)\b/i.test(trimmed)
);
}
export function stripMarkdown(text: string): string {
if (!text) return '';
return text
.replace(/<[^>]*>/g, ' ')
.replace(/!\[.*?\]\(.*?\)/g, '')
.replace(/\[(.*?)\]\(.*?\)/g, '$1')
.replace(/#{1,6}\s+/g, '')
.replace(/(\*\*|__)(.*?)\1/g, '$2')
.replace(/(\*|_)(.*?)\1/g, '$2')
.replace(/~~(.*?)~~/g, '$1')
.replace(/`{1,3}.*?`{1,3}/gs, '')
.replace(/^>\s+/gm, '')
.replace(/^[-*+]\s+/gm, '')
.replace(/^\d+\.\s+/gm, '')
.replace(/\|/g, ' ')
.replace(/\s+/g, ' ')
.trim();
}
export function parseMarkdownToHtml(markdown: string): string {
if (!markdown) return '';
let html = markdown
.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
.replace(/\r\n/g, '\n');
html = html.replace(/```([a-zA-Z0-9_-]*)\n([\s\S]*?)```/g, (_match, _lang, code) => {
const escaped = code
.replace(/&/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;');
return `<pre style="background:#0b1120;border:1px solid #1e293b;border-radius:12px;padding:14px;overflow-x:auto;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:12px;color:#e2e8f0;margin:12px 0;"><code>${escaped}</code></pre>`;
});
html = html.replace(/`([^`]+)`/g, (_match, code) => {
const escaped = code
.replace(/&/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;');
return `<code style="background:#1e293b;color:#34d399;padding:2px 6px;border-radius:6px;font-family:monospace;font-size:12px;">${escaped}</code>`;
});
// Tables (| A | B |\n|---|---|\n| C | D |)
html = html.replace(/((?:\|[^\n]+\|\n?)+)/g, (match) => {
const rows = match.trim().split('\n');
if (rows.length < 2) return match;
const hasSeparator = rows[1] && rows[1].includes('---');
if (!hasSeparator) return match;
const parseCells = (row: string) =>
row
.split('|')
.slice(1, -1)
.map((c) => c.trim());
const headers = parseCells(rows[0]);
const bodyRows = rows.slice(2);
let tableHtml = `<div style="overflow-x:auto;margin:14px 0;"><table style="width:100%;border-collapse:collapse;border:1px solid #334155;border-radius:8px;font-size:12px;text-align:left;">`;
tableHtml += `<thead><tr style="background:#1e293b;color:#f8fafc;">`;
headers.forEach((h) => {
tableHtml += `<th style="padding:8px 12px;border:1px solid #334155;font-weight:600;">${h}</th>`;
});
tableHtml += `</tr></thead><tbody>`;
bodyRows.forEach((row, i) => {
const cells = parseCells(row);
const bg = i % 2 === 0 ? '#0f172a' : '#1e293b/40';
tableHtml += `<tr style="background:${bg};color:#cbd5e1;">`;
cells.forEach((c) => {
tableHtml += `<td style="padding:8px 12px;border:1px solid #334155;">${c}</td>`;
});
tableHtml += `</tr>`;
});
tableHtml += `</tbody></table></div>`;
return tableHtml;
});
html = html.replace(/^#### (.*?)$/gm, '<h4 style="font-size:14px;font-weight:700;color:#f8fafc;margin:12px 0 6px 0;">$1</h4>');
html = html.replace(/^### (.*?)$/gm, '<h3 style="font-size:16px;font-weight:700;color:#f8fafc;margin:14px 0 8px 0;">$1</h3>');
html = html.replace(/^## (.*?)$/gm, '<h2 style="font-size:18px;font-weight:800;color:#ffffff;margin:16px 0 8px 0;border-bottom:1px solid #1e293b;padding-bottom:6px;">$1</h2>');
html = html.replace(/^# (.*?)$/gm, '<h1 style="font-size:22px;font-weight:800;color:#ffffff;margin:18px 0 10px 0;border-bottom:1px solid #334155;padding-bottom:8px;">$1</h1>');
// Blockquotes and GitHub alerts
html = html.replace(/^>\s*\[!NOTE\]\s*(.*?)$/gim, '<div style="background:#0c4a6e22;border-left:4px solid #0284c7;padding:10px 14px;border-radius:8px;margin:10px 0;color:#bae6fd;font-size:12px;"><strong>NOTE:</strong> $1</div>');
html = html.replace(/^>\s*\[!IMPORTANT\]\s*(.*?)$/gim, '<div style="background:#83184322;border-left:4px solid #db2777;padding:10px 14px;border-radius:8px;margin:10px 0;color:#fbcfe8;font-size:12px;"><strong>IMPORTANT:</strong> $1</div>');
html = html.replace(/^>\s*\[!WARNING\]\s*(.*?)$/gim, '<div style="background:#713f1222;border-left:4px solid #d97706;padding:10px 14px;border-radius:8px;margin:10px 0;color:#fef08a;font-size:12px;"><strong>WARNING:</strong> $1</div>');
html = html.replace(/^>\s*\[!TIP\]\s*(.*?)$/gim, '<div style="background:#064e3b22;border-left:4px solid #059669;padding:10px 14px;border-radius:8px;margin:10px 0;color:#a7f3d0;font-size:12px;"><strong>TIP:</strong> $1</div>');
html = html.replace(/^>\s*(.*?)$/gm, '<blockquote style="border-left:3px solid #10b981;padding-left:12px;margin:8px 0;color:#94a3b8;font-style:italic;">$1</blockquote>');
// Horizontal Rules (---)
html = html.replace(/^(?:---|\*\*\*|___)\s*$/gm, '<hr style="border:none;border-top:1px solid #334155;margin:16px 0;" />');
// Strikethrough
html = html.replace(/~~(.*?)~~/g, '<del style="color:#64748b;">$1</del>');
html = html.replace(/\*\*\*(.*?)\*\*\*/g, '<strong><em>$1</em></strong>');
html = html.replace(/\*\*(.*?)\*\*/g, '<strong style="color:#ffffff;">$1</strong>');
html = html.replace(/__(.*?)__/g, '<strong style="color:#ffffff;">$1</strong>');
html = html.replace(/\*(.*?)\*/g, '<em style="color:#cbd5e1;">$1</em>');
html = html.replace(/\[(.*?)\]\((.*?)\)/g, '<a href="$2" target="_blank" rel="noopener noreferrer" style="color:#34d399;text-decoration:underline;">$1</a>');
html = html.replace(/^[-*+]\s+(.*?)$/gm, '<li style="margin-left:20px;list-style-type:disc;color:#cbd5e1;padding:2px 0;">$1</li>');
html = html.replace(/^\d+\.\s+(.*?)$/gm, '<li style="margin-left:20px;list-style-type:decimal;color:#cbd5e1;padding:2px 0;">$1</li>');
const paragraphs = html.split(/\n{2,}/);
html = paragraphs
.map((p) => {
const trimmed = p.trim();
if (!trimmed) return '';
if (
trimmed.startsWith('<h') ||
trimmed.startsWith('<div') ||
trimmed.startsWith('<table') ||
trimmed.startsWith('<pre') ||
trimmed.startsWith('<blockquote') ||
trimmed.startsWith('<hr') ||
trimmed.startsWith('<li')
) {
return trimmed;
}
return `<p style="margin:8px 0;line-height:1.6;color:#cbd5e1;">${trimmed.replace(/\n/g, '<br />')}</p>`;
})
.join('\n');
return html;
}
@@ -1,25 +1,11 @@
import { QueryClient, InvalidateQueryFilters } from '@tanstack/react-query';
import { bumpMutationEpoch } from '../services/httpClient';
import { QueryClient } from '@tanstack/react-query';
export const queryClient = new QueryClient({
defaultOptions: {
queries: {
staleTime: 1000 * 60 * 2, // 2 minutes fresh in memory
gcTime: 1000 * 60 * 10, // 10 minutes cache retention
refetchOnWindowFocus: false,
refetchOnReconnect: true,
retry: 1,
staleTime: 1000 * 60 * 5, // 5 minutes
},
},
});
/**
* Invalidates queries while simultaneously bumping the mutation epoch.
*/
export async function invalidateAndBustCache(
client: QueryClient,
filters?: InvalidateQueryFilters
): Promise<void> {
bumpMutationEpoch();
await client.invalidateQueries(filters);
}

Some files were not shown because too many files have changed in this diff Show More