create-bubbles 0.1.26 → 0.1.27

package/template-vp-monorepo-react-nestjs/packages/shared/src/types/access-resources.ts

@@ -0,0 +1,168 @@
+import type {
+  AccessScope,
+  AccountStatus,
+  BuiltinRole,
+  EntityStatus,
+  PageQuery,
+  UserSummary,
+  VersionRequest,
+} from './access'
+
+export interface AccountRecord extends UserSummary {
+  status: AccountStatus
+  createdAt: string
+  updatedAt: string
+  platformRoleIds: string[]
+}
+
+export interface CompanyRecord {
+  id: string
+  name: string
+  code: string
+  description: string
+  status: EntityStatus
+  version: number
+  createdAt: string
+  updatedAt: string
+}
+
+export interface ProjectRecord extends CompanyRecord {
+  companyId: string
+}
+
+export interface AdministratorSummary extends UserSummary {
+  accountStatus: AccountStatus
+  memberStatus: EntityStatus
+  effective: boolean
+}
+
+export interface CompanyDetail extends CompanyRecord {
+  administrators: AdministratorSummary[]
+}
+
+export interface ProjectDetail extends ProjectRecord {
+  administrators: AdministratorSummary[]
+}
+
+export type ProjectAdministratorsResult = AdministratorSummary[]
+
+export interface MemberRecord {
+  id: string
+  userId: string
+  account: string
+  name: string
+  status: EntityStatus
+  accountStatus: AccountStatus
+  roleIds: string[]
+  roleNames: string[]
+  version: number
+  createdAt: string
+  updatedAt: string
+}
+
+export interface RoleRecord {
+  id: string
+  scope: AccessScope
+  name: string
+  description: string
+  builtin: BuiltinRole
+  permissionKeys: string[]
+  version: number
+  memberCount: number
+  assignable: boolean
+  createdAt: string
+  updatedAt: string
+}
+
+export interface UpdateProfileRequest extends VersionRequest {
+  name?: string
+  code?: string
+  description?: string
+}
+
+export interface SetAdministratorResult {
+  administrator: AdministratorSummary
+  replacedUserId: string | null
+}
+
+export interface AccountStatusRequest {
+  status: EntityStatus
+}
+
+export interface AssignPlatformRolesRequest {
+  roleIds: string[]
+}
+
+export interface RegisterCompanyMemberRequest {
+  name: string
+  account: string
+  password: string
+}
+
+export type CompanyMemberInvitationStatus = 'pending' | 'expired' | 'accepted' | 'revoked'
+
+/** 企业成员邀请的可持久化公开信息；任何查询响应都不会包含 token 或 token 摘要。 */
+export interface CompanyMemberInvitationRecord {
+  id: string
+  companyId: string
+  status: CompanyMemberInvitationStatus
+  createdByUserId: string
+  acceptedByUserId: string | null
+  expiresAt: string
+  acceptedAt: string | null
+  revokedAt: string | null
+  version: number
+  createdAt: string
+  updatedAt: string
+}
+
+export interface CompanyMemberInvitationQuery extends PageQuery {
+  status?: CompanyMemberInvitationStatus
+}
+
+/** 创建不绑定具体账号的一次性企业邀请链接。 */
+export type CreateCompanyMemberInvitationRequest = Record<string, never>
+
+export type RevokeCompanyMemberInvitationRequest = VersionRequest
+
+export type ResendCompanyMemberInvitationRequest = VersionRequest
+
+/** 创建或重发时仅返回一次的原始 token，调用方负责组装并安全传递邀请链接。 */
+export interface CompanyMemberInvitationIssueResult {
+  invitation: CompanyMemberInvitationRecord
+  token: string
+}
+
+export interface AcceptCompanyMemberInvitationRequest {
+  token: string
+}
+
+export interface AcceptCompanyMemberInvitationResult {
+  invitationId: string
+  companyId: string
+  companyName: string
+  member: MemberRecord
+}
+
+export interface AddProjectMemberRequest {
+  userId: string
+}
+
+export interface AssignMemberRolesRequest extends VersionRequest {
+  roleIds: string[]
+}
+
+export interface CreateRoleRequest {
+  name: string
+  description?: string
+  permissionKeys?: string[]
+}
+
+export interface UpdateRoleRequest extends VersionRequest {
+  name?: string
+  description?: string
+}
+
+export interface SetRolePermissionsRequest extends VersionRequest {
+  permissionKeys: string[]
+}

package/template-vp-monorepo-react-nestjs/packages/shared/src/types/access.ts

@@ -0,0 +1,71 @@
+export type ScopeType = 'platform' | 'company' | 'project'
+
+export type AccessScope =
+  | { type: 'platform' }
+  | { type: 'company'; companyId: string }
+  | { type: 'project'; companyId: string; projectId: string }
+
+export type EntityStatus = 'active' | 'disabled'
+export type AccountStatus = 'active' | 'locked' | 'disabled'
+export type BuiltinRole = 'administrator' | 'member' | null
+
+export interface PageQuery {
+  page?: number
+  pageSize?: number
+  query?: string
+}
+
+export interface PageResult<T> {
+  items: T[]
+  total: number
+  page: number
+  pageSize: number
+}
+
+export interface VersionRequest {
+  expectedVersion: number
+}
+
+export interface StatusRequest extends VersionRequest {
+  status: EntityStatus
+}
+
+export interface DeleteResult {
+  deleted: true
+}
+
+export interface UserSummary {
+  id: string
+  account: string
+  name: string
+}
+
+export interface WorkspaceEntry {
+  scope: AccessScope
+  name: string
+  companyName?: string
+  administrator: ScopeType | null
+}
+
+export interface WorkspacesResult {
+  user: UserSummary
+  workspaces: WorkspaceEntry[]
+}
+
+export interface EntityPageQuery extends PageQuery {
+  status?: EntityStatus
+}
+
+export interface AccountPageQuery extends PageQuery {
+  status?: AccountStatus
+}
+
+export interface AccessRoutePathInput {
+  scope: AccessScope
+  routeKey: string
+}
+
+export interface BuiltinPermissionKeysInput {
+  scopeType: ScopeType
+  builtin: Exclude<BuiltinRole, null>
+}

package/template-vp-monorepo-react-nestjs/packages/shared/src/types/auth.ts

@@ -33,3 +33,26 @@ export interface CurrentUser extends AuthUser {
 export interface LogoutResult {
   loggedOut: true
 }
+
+/** 当前用户验证旧密码后修改自己的全局账号密码。 */
+export interface ChangePasswordRequest {
+  oldPassword: string
+  newPassword: string
+  confirmPassword: string
+}
+
+/** 改密成功时仅返回操作结果，不回显密码或账号资料。 */
+export interface ChangePasswordResult {
+  passwordChanged: true
+}
+
+/** 平台管理员为其他全局账号设定新密码。 */
+export interface ResetAccountPasswordRequest {
+  newPassword: string
+  confirmPassword: string
+}
+
+/** 重置成功时仅返回操作结果，不回显密码或账号资料。 */
+export interface ResetAccountPasswordResult {
+  passwordReset: true
+}

package/template-vp-monorepo-react-nestjs/packages/shared/src/types/index.ts

@@ -1,11 +1,20 @@
 export type {
   AuthUser,
+  ChangePasswordRequest,
+  ChangePasswordResult,
   CurrentUser,
   LoginRequest,
   LoginResult,
   LogoutResult,
   RegisterRequest,
   RegisterResult,
+  ResetAccountPasswordRequest,
+  ResetAccountPasswordResult,
   SessionTerminalType,
 } from './auth'
 export type { ApiErrorDetail, ApiFailure } from './common'
+export type * from './access'
+export type * from './access-resources'
+export type * from './access-menus'
+export type * from './access-maintenance'
+export type * from './organization/models'

package/template-vp-monorepo-react-nestjs/packages/shared/src/types/organization/models.ts

@@ -0,0 +1,361 @@
+import type { AccessScope, AccountStatus, EntityStatus, PageQuery, VersionRequest } from '../access'
+import type { CompanyDetail, CompanyRecord, MemberRecord } from '../access-resources'
+
+export type OrganizationScope = Extract<AccessScope, { type: 'company' | 'project' }>
+export type CompanyEntityType = 'group' | 'company'
+export type OrganizationDuty = 'member' | 'leader' | 'deputy'
+export type ProjectOrganizationInitialization =
+  | { mode: 'blank' }
+  | { mode: 'template'; templateId: string; templateVersion: number }
+
+export interface OrganizationRelationInput {
+  organizationUnitId: string
+  duty: OrganizationDuty
+}
+
+export interface CompanyHierarchyFields {
+  parentCompanyId: string | null
+  entityType: CompanyEntityType
+  sort: number
+}
+
+export type CompanyHierarchyRecord = CompanyRecord & CompanyHierarchyFields
+export type CompanyHierarchyDetail = CompanyDetail & CompanyHierarchyFields
+export type CompanyHierarchyNode = CompanyHierarchyRecord & { children: CompanyHierarchyNode[] }
+
+export interface UpdateCompanyHierarchyRequest extends VersionRequest {
+  parentCompanyId: string | null
+  entityType: CompanyEntityType
+  sort?: number
+}
+
+export interface CreateCompanyRequest {
+  name: string
+  code: string
+  description?: string
+  administratorUserId: string
+  parentCompanyId?: string | null
+  entityType?: CompanyEntityType
+  sort?: number
+}
+
+export interface CreateProjectRequest {
+  name: string
+  code: string
+  description?: string
+  administratorUserId: string
+  organizationInitialization: ProjectOrganizationInitialization
+}
+
+export interface SetAdministratorRequest {
+  administratorUserId: string
+  replaceUserId?: string
+}
+
+export interface OrganizationTreeRecord {
+  id: string
+  scope: OrganizationScope
+  parentId: string | null
+  units: OrganizationUnitNode[]
+}
+
+export interface OrganizationTreeQuery {
+  parentId?: string
+}
+
+export interface OrganizationUnitRecord {
+  id: string
+  treeId: string
+  parentId: string | null
+  name: string
+  code: string
+  description: string
+  sort: number
+  status: EntityStatus
+  version: number
+  depth: number
+  fullPath: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface OrganizationUnitNode extends OrganizationUnitRecord {
+  effective: boolean
+  hasChildren: boolean
+}
+
+export interface CreateOrganizationUnitRequest {
+  parentId?: string | null
+  name: string
+  code: string
+  description?: string
+  sort?: number
+}
+
+export interface UpdateOrganizationUnitRequest extends VersionRequest {
+  name?: string
+  code?: string
+  description?: string
+  sort?: number
+}
+
+export interface MoveOrganizationUnitRequest extends VersionRequest {
+  parentId: string | null
+  sort?: number
+}
+
+export interface OrganizationMembershipRecord {
+  id: string
+  organizationUnit: Pick<OrganizationUnitRecord, 'id' | 'name' | 'code' | 'fullPath' | 'status'>
+  duty: OrganizationDuty
+  createdAt: string
+  updatedAt: string
+}
+
+export interface ReplaceMemberOrganizationUnitsRequest {
+  relations: OrganizationRelationInput[]
+}
+
+export interface ReplaceMemberOrganizationUnitsResult {
+  userId: string
+  relations: OrganizationMembershipRecord[]
+}
+
+export interface OrganizationUnitMemberInput {
+  userId: string
+  duty: OrganizationDuty
+}
+
+export interface OrganizationUnitMemberRecord {
+  membershipId: string
+  member: Pick<MemberRecord, 'id' | 'userId' | 'account' | 'name' | 'status' | 'accountStatus'>
+  duty: OrganizationDuty
+  createdAt: string
+  updatedAt: string
+}
+
+export interface ReplaceOrganizationUnitMembersRequest {
+  members: OrganizationUnitMemberInput[]
+}
+
+export interface ReplaceOrganizationUnitMembersResult {
+  organizationUnitId: string
+  members: OrganizationUnitMemberRecord[]
+}
+
+export interface PositionRecord {
+  id: string
+  scope: OrganizationScope
+  name: string
+  code: string
+  description: string
+  status: EntityStatus
+  version: number
+  memberCount: number
+  createdAt: string
+  updatedAt: string
+}
+
+export interface PositionListQuery extends PageQuery {
+  status?: EntityStatus
+}
+
+export interface CreatePositionRequest {
+  name: string
+  code: string
+  description?: string
+}
+
+export interface UpdatePositionRequest extends VersionRequest {
+  name?: string
+  code?: string
+  description?: string
+}
+
+export interface ReplaceMemberPositionsRequest {
+  positionIds: string[]
+}
+
+export interface ReplaceMemberPositionsResult {
+  userId: string
+  positions: PositionRecord[]
+}
+
+export interface PositionMemberRecord {
+  assignmentId: string
+  member: Pick<MemberRecord, 'id' | 'userId' | 'account' | 'name' | 'status' | 'accountStatus'>
+  createdAt: string
+}
+
+export interface ReplacePositionMembersRequest {
+  userIds: string[]
+}
+
+export interface ReplacePositionMembersResult {
+  positionId: string
+  members: PositionMemberRecord[]
+}
+
+export interface OrganizationTemplateUnitInput {
+  clientKey: string
+  parentClientKey: string | null
+  name: string
+  code: string
+  description?: string
+  sort: number
+}
+
+export interface OrganizationTemplatePositionInput {
+  name: string
+  code: string
+  description?: string
+  status: EntityStatus
+}
+
+export interface OrganizationTemplateUnitRecord extends Omit<
+  OrganizationTemplateUnitInput,
+  'clientKey' | 'parentClientKey'
+> {
+  id: string
+  parentId: string | null
+  templateVersion: number
+}
+
+export interface OrganizationTemplatePositionRecord extends OrganizationTemplatePositionInput {
+  id: string
+  templateVersion: number
+}
+
+export interface OrganizationTemplateRecord {
+  id: string
+  companyId: string
+  name: string
+  description: string
+  status: EntityStatus
+  isDefault: boolean
+  version: number
+  units: OrganizationTemplateUnitRecord[]
+  positions: OrganizationTemplatePositionRecord[]
+  createdAt: string
+  updatedAt: string
+}
+
+export interface OrganizationTemplateSummary extends Omit<
+  OrganizationTemplateRecord,
+  'units' | 'positions'
+> {
+  unitCount: number
+  positionCount: number
+}
+
+export interface OrganizationTemplateListQuery extends PageQuery {
+  status?: EntityStatus
+}
+
+export interface CreateOrganizationTemplateRequest {
+  name: string
+  description?: string
+  isDefault?: boolean
+  units: OrganizationTemplateUnitInput[]
+  positions: OrganizationTemplatePositionInput[]
+}
+
+export interface ReplaceOrganizationTemplateRequest extends VersionRequest {
+  name: string
+  description?: string
+  isDefault: boolean
+  units: OrganizationTemplateUnitInput[]
+  positions: OrganizationTemplatePositionInput[]
+}
+
+export interface UpdateOrganizationTemplateStatusRequest extends VersionRequest {
+  status?: EntityStatus
+  isDefault?: boolean
+}
+
+export type GlobalAccountCandidatePurpose = 'createCompanyAdministrator' | 'setCompanyAdministrator'
+export type OrganizationMemberCandidatePurpose =
+  | 'browseOrganization'
+  | 'assignPositionMembers'
+  | 'createProjectAdministrator'
+  | 'setProjectAdministrator'
+  | 'addProjectMember'
+export type CandidateDisabledReason =
+  | 'accountInactive'
+  | 'memberInactive'
+  | 'scopeInactive'
+  | 'organizationInactive'
+  | 'positionInactive'
+  | null
+
+export interface GlobalAccountCandidateQuery extends PageQuery {
+  purpose: GlobalAccountCandidatePurpose
+}
+
+export interface GlobalAccountCandidate {
+  userId: string
+  account: string
+  name: string
+  status: AccountStatus
+  disabled: boolean
+  disabledReason: CandidateDisabledReason
+}
+
+export interface OrganizationMemberCandidateQuery extends PageQuery {
+  purpose?: OrganizationMemberCandidatePurpose
+  organizationUnitIds?: string[]
+  positionIds?: string[]
+  roleIds?: string[]
+  projectIds?: string[]
+  unassigned?: boolean
+  includeDisabled?: boolean
+}
+
+export interface OrganizationUnitCandidateTag {
+  id: string
+  membershipId: string
+  name: string
+  fullPath: string
+  status: EntityStatus
+  effective: boolean
+  duty: OrganizationDuty
+}
+
+export interface PositionCandidateTag {
+  id: string
+  name: string
+  status: EntityStatus
+}
+
+export interface OrganizationMemberIdentity {
+  scope: OrganizationScope
+  scopeName: string
+  memberId: string
+  memberStatus: EntityStatus
+  scopeStatus: EntityStatus
+  organizationUnits: OrganizationUnitCandidateTag[]
+  positions: PositionCandidateTag[]
+  roles: Array<{ id: string; name: string }>
+}
+
+export interface OrganizationMemberCandidate {
+  userId: string
+  account: string
+  name: string
+  accountStatus: AccountStatus
+  identities: OrganizationMemberIdentity[]
+  disabled: boolean
+  disabledReason: CandidateDisabledReason
+}
+
+export interface ResolveCandidatesRequest {
+  userIds: string[]
+}
+
+export interface ResolveGlobalAccountCandidatesRequest extends ResolveCandidatesRequest {
+  purpose: GlobalAccountCandidatePurpose
+}
+
+export interface ResolveOrganizationMemberCandidatesRequest extends ResolveCandidatesRequest {
+  purpose?: OrganizationMemberCandidatePurpose
+}