Gishen-Archive/Gishen-B2B
Archived
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
This repository has been archived on 2026-08-11. You can view files and clone it, but cannot push or open issues or pull requests.
8fe6d58a09
Gishen-B2B/docs/features/org-departments.md
kirukib 3778801ef5 Ship Gishen B2B institutional portal with polished layout and mock-backed flows. 
Deliver role-aware shell (sidebar, breadcrumbs, quick search, tables, detail/create layouts), locale-ready pages, shared backend/feature docs, and Vercel project config so HR, finance, and members can demo against typed mocks.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-06 21:18:23 +03:00

2.5 KiB
Raw Blame History

Feature: Org & departments

Organisation profile, commercial field visibility, departments/sites, and verification settings.

Workspace: /Users/kirukib/Desktop/Yaltopia Project/Gishen-B2B

Pages

Route Purpose
/organisation Org profile — HR-managed fields + read-only commercial (when active)
/departments Department/site list with search/site filter
/departments/new Create department (site, sub-limit, optional parent)
/settings/verification Verification method for member checkout

Entities

Endpoints

  • org.md
    • GET /v1/org, PATCH /v1/org
    • GET/POST/PATCH/DELETE /v1/org/departments*
    • PATCH /v1/org/verification

Commercial fields (Admin-owned)

Displayed read-only on /organisation once active:

  • Credit limit & usage
  • Payment terms
  • Price list reference
  • Contract start/end
  • Activation date

HR cannot mutate these — attempts return 403 FORBIDDEN.

HR-managed fields

Editable by SUPER_USER / HR_ADMIN:

  • Display name
  • Dependant limit
  • Join rules (join code, email domains)
  • Verification settings

Departments

Capability Roles
List / view SUPER_USER, HR_ADMIN, FINANCE
Create / edit / deactivate SUPER_USER, HR_ADMIN

Sub-limits optional per department for finance reporting and cap enforcement.

Verification settings

Method Description
employee_id Member enters employee ID at checkout
qr_code QR issued per member
domain_email Email domain match
manual_hr HR verifies manually

require_at_checkout: when true, Ecom checkout blocks until verified.

Validation / errors

Scenario Code
Duplicate department name DUPLICATE_DEPARTMENT
Delete dept with members DEPARTMENT_IN_USE
Edit commercial from B2B FORBIDDEN
Org pending ORG_PENDING on mutations

Clinical withhold

No clinical data on org/department screens.

UI notes

  • Commercial section: card with credit utilization bar (mint/forest brand)
  • Department table: name, code, parent, sub-limit, member count, actions
  • Verification: radio group + switch for checkout requirement

Related features