XPrivate Education — Business Flowcharts

flowchart LR
    Login(["🔑 Admin login
Google OAuth"]) --> Dash[📋 Daily Ops
Dashboard]
    Dash --> S1["⚡ Yang perlu
segera ditangani"]
    Dash --> S2["📊 Yang perlu
di-monitor"]
    Dash --> S3["📅 Operasi
akhir bulan"]

    style S1 fill:#fbbf24,color:#422006
    style S2 fill:#38bdf8,color:#0c2c4a
    style S3 fill:#a855f7,color:#2e1065
    

flowchart TD
    Open["Admin klik sesi di Approval Queue"] --> Decide{Approve
atau
Reject?}
    Decide -->|✓ Approve| Snap["🔒 Sistem freeze pricing + cancellation policy
(harga + policy sesi ini di-kunci,
tidak berubah meski admin edit master data nanti)"]
    Decide -->|✗ Reject| Audit["Reason di-audit
(REJECTED = final, tidak bisa di-undo)"]
    Snap --> Notify["Admin notif tutor + siswa
via WhatsApp manual"]

    style Snap fill:#fef3c7,color:#422006
    style Notify fill:#dbeafe,color:#1e3a8a
    

stateDiagram-v2
    [*] --> REQUESTED: Admin create sesi
    REQUESTED --> APPROVED: Admin approve (snapshot pricing + policy)
    REQUESTED --> REJECTED: Admin reject (reason audited)
    APPROVED --> IN_PROGRESS: Tutor Start (admin proxy iter 1)
    IN_PROGRESS --> COMPLETED: 2-step gate (tutor confirm + admin validate)
    APPROVED --> CANCELLED: Cancel flow (siswa/tutor/admin)
    APPROVED --> RESCHEDULED: Reschedule flow
    RESCHEDULED --> REQUESTED: New linked sesi created
    REJECTED --> [*]
    CANCELLED --> [*]
    COMPLETED --> [*]: Settlement UNPAID auto-created

    note right of COMPLETED
      Sub-states (COMPLETED variants):
      NO_SHOW_STUDENT (charge full),
      NO_SHOW_TUTOR (escalate cancellation)
    end note
    

flowchart TD
    Create["Admin create sesi
(siswa + tutor + datetime + mode + Tempat Les)"] --> Req[REQUESTED]
    Req --> AdminAppr["Admin approve
(via Approval Queue)"]
    AdminAppr --> Snap["Snapshot:
pricingMatrixId
amountStudent / amountTutor
transportFee
cancellationPolicyConfigId"]
    Snap --> Apr[APPROVED]
    Apr --> Start["Tutor mark Start
(admin proxy iter 1)"]
    Start --> InProg[IN_PROGRESS]
    InProg --> Materi["Mark attendance +
materi log + foto report (R2)"]
    Materi --> AdmVal["Admin validate completion
(2-step COMPLETED gate)"]
    AdmVal --> Done[COMPLETED]
    Done --> Settl["Settlement auto-created
(siswa + tutor side
UNPAID, snapshot-based)"]
    Settl --> EOM[End of month]
    EOM --> Tagihan[Tagihan generated]
    EOM --> Honor[Honorarium generated]

    style Snap fill:#fef3c7,color:#422006
    style Req fill:#fbbf24,color:#422006
    style Apr fill:#38bdf8,color:#0c2c4a
    style InProg fill:#a855f7,color:#2e1065
    style Done fill:#34d399,color:#052e1f
    

flowchart TD
    Cancel["TUTOR cancel ≤ 4 jam
via WhatsApp ke admin"] --> Decide{"Option α:
Tutor cari pengganti
SENDIRI dari komunitas?"}
    Decide -->|Yes try self-sub| SelfSub["Admin record self-sub attempt"]
    SelfSub --> SubOk{Pengganti
accept?}
    SubOk -->|SUCCESS| Clean["✓ Tutor original: CLEAN
(no penalty, no strike)
✓ Pengganti: full Honorarium
✓ Siswa: bayar normal
(sesi jalan dengan pengganti)"]
    SubOk -->|FAIL| Escalate["Escalate ke XPrivate
(Option β — transfer liability)"]
    Decide -->|No / fail| Escalate

    Escalate --> XDispatch{XPrivate
dispatch sub?}
    XDispatch -->|Yes| SesiJadi["Sesi jadi w/ pengganti
(via Substitute Matching)"]
    XDispatch -->|No| SesiCancel["Sesi cancelled
(siswa charge 0)"]

    SesiJadi --> Penalty
    SesiCancel --> Penalty

    Penalty["Tutor original penalty:
• Zero pay sesi (lost opp)
• Denda graduated 100/50/25%
• +1 strike
Denda = REVENUE XPrivate"]

    style Clean fill:#34d399,color:#052e1f
    style Penalty fill:#f87171,color:#420c0c
    

flowchart TD
    Cancel["SISWA cancel
via WhatsApp ke admin"] --> AdminEntry["Admin entry cancel di backoffice
+ reason + initiator: SISWA"]
    AdminEntry --> CalcEngine["Cancellation calc engine:
cek lead time vs bracket"]
    CalcEngine --> Lt1{Lead time
≥ 4 jam?}
    Lt1 -->|Yes| NoCharge["Charge siswa: 0
Honor tutor: 0
(sesi free cancel)"]
    Lt1 -->|No| Lt2{≥ 2 jam?}
    Lt2 -->|Yes| B3["Bracket: charge 25%
Honor 25%"]
    Lt2 -->|No| Lt3{≥ 1 jam?}
    Lt3 -->|Yes| B2["Bracket: charge 50%
Honor 50%"]
    Lt3 -->|No| B1["Bracket: charge 100%
Honor 100%"]

    NoCharge --> Logged["Audited + sesi CANCELLED"]
    B3 --> Logged
    B2 --> Logged
    B1 --> Logged

    Logged --> Override{Admin
override?}
    Override -->|Yes| Manual["Manual override w/ alasan
(audited)"]
    Override -->|No| Final[Final settlement entries]

    style NoCharge fill:#34d399,color:#052e1f
    style B1 fill:#f87171,color:#420c0c
    

flowchart TD
    Claim["Tutor claim FM via WhatsApp
(category + evidence)"] --> Entry["Admin entry claim di backoffice
+ evidence upload (R2)"]
    Entry --> Status1["Status: PENDING_L1"]
    Status1 --> L1{L1 Operator
review}
    L1 -->|APPROVE| NoPenalty["Status: APPROVED_L1
✓ No penalty for tutor
✓ Audit log"]
    L1 -->|REJECT| Status2["Status: REJECTED_L1
+ normal penalty escalate"]
    Status2 --> Banding{Tutor banding
dalam 14 hari?}
    Banding -->|No| Final["Penalty stays final
(REJECTED_L1 terminal)"]
    Banding -->|Yes| Status3["Status: PENDING_L2"]
    Status3 --> L2{L2 Admin
senior review}
    L2 -->|UPHOLD| Stayed["Status: UPHELD
Penalty stays final
+ audit"]
    L2 -->|OVERTURN| Refund["Status: OVERTURNED
✓ Refund penalty
✓ Audit
✓ Optional comp_notes
(finance off-system condolence)"]

    style NoPenalty fill:#34d399,color:#052e1f
    style Refund fill:#34d399,color:#052e1f
    style Final fill:#f87171,color:#420c0c
    style Stayed fill:#f87171,color:#420c0c
    

flowchart TD
    XCancel["Tutor X cancel via WhatsApp
→ admin info"] --> CheckSelf{"Tutor X coba
self-sub dulu?"}
    CheckSelf -->|Berhasil| Direct["Sesi jalan dengan tutor self-sub
(no penalty for X)"]
    CheckSelf -->|Gagal / skip| OpenDetail["Admin open schedule X
klik [Cari Sub]"]
    OpenDetail --> ListCand["List candidates sorted by distance:
Filter:
• subject match (Subject + SubjectLevel)
• Slot bebas (tidak overlap sesi)
• status ACTIVE
Display: nama, distance km,
Golongan, last_active"]
    ListCand --> Pick["Admin pilih candidate Z"]
    Pick --> Dispatch["Dispatch via WhatsApp manual
(template message)"]
    Dispatch --> Accept{Z accept?}
    Accept -->|Yes| Reassign["Admin update sesi assignment ke Z
(audit log capture)"]
    Reassign --> NewSnap["Re-snapshot Honorarium
(berdasarkan Z's Golongan)"]
    NewSnap --> Run["Sesi jalan dengan Z
(X kena penalty Option β)"]
    Accept -->|No| ListCand
    Accept -->|Habis kandidat| Cancel["Sesi cancelled
(siswa charge 0, X kena penalty)"]

    style Direct fill:#34d399,color:#052e1f
    style Run fill:#34d399,color:#052e1f
    style Cancel fill:#f87171,color:#420c0c
    

flowchart TD
    EOM[End of month trigger] --> GenT["Generate Tagihan per siswa
(aggregate semua sesi COMPLETED
+ NO_SHOW_STUDENT + cancellation
charges + adjustment lines)"]
    EOM --> GenH["Generate Honorarium per tutor
(aggregate sesi by Golongan
+ transport reimburse
+ adjustments + PPh placeholder)"]

    GenT --> Share["Tagihan dishare ke siswa
(welcome email + admin WA manual)"]
    Share --> Bayar["Siswa bayar offline
(bank transfer / e-wallet)
upload bukti via WA"]
    Bayar --> AdmVer["Admin verify bukti
+ mark Settlement.PAID bulk"]
    AdmVer --> Aging["Outstanding aging update
(0-30 / 31-60 / 61-90 / 90+)"]

    GenH --> Slip["Honor slip PDF generated
(breakdown per tutor per bulan)"]
    Slip --> Trf["Finance batch transfer off-system
(bank/e-wallet)"]
    Trf --> MarkH["Admin mark
SettlementTeacher.PAID bulk"]

    Aging --> WriteOff{Bad debt
review?}
    WriteOff -->|Yes| WO["Senior approval +
tax compliance flag +
audit"]
    WriteOff -->|No| OK[Move to next cycle]

    AdmVer --> Close[Ready for Period Close]
    MarkH --> Close

    style Close fill:#fef3c7,color:#422006
    

flowchart TD
    Trigger["Finance trigger monthly close"] --> CheckIP{Ada sesi
IN_PROGRESS?}
    CheckIP -->|Yes| BlockIP["BLOCK: finalize sesi dulu
(tutor confirm + admin validate)"]
    CheckIP -->|No| Checklist["Monthly close checklist UI
(step-through)"]
    Checklist --> S1["✓ Bills (Tagihan) generated"]
    Checklist --> S2["✓ Payments reconciled
(siswa bayar bukti verified)"]
    Checklist --> S3["✓ Honor batch ready
(Honorarium generated)"]
    Checklist --> S4["✓ FM cases reviewed
(no PENDING_L1/L2)"]
    Checklist --> S5["✓ Adjustments processed
(credit notes / refunds)"]

    S1 --> AllGood{Semua
checked?}
    S2 --> AllGood
    S3 --> AllGood
    S4 --> AllGood
    S5 --> AllGood
    AllGood -->|Yes| Lock["Period LOCK flag set
+ Lock audit (who/when)"]
    AllGood -->|No| Wait[Address pending items]

    Lock --> Effect["Effect:
• No backdated bookings
• No retroactive mark-paid
• No new adjustments"]
    Effect --> ReOpen{Need
re-open?}
    ReOpen -->|Yes| Senior["Senior admin approval
+ reason audited
+ unlock"]
    ReOpen -->|No| Done[Period closed final]

    style BlockIP fill:#f87171,color:#420c0c
    style Lock fill:#34d399,color:#052e1f
    style Done fill:#34d399,color:#052e1f
    

flowchart TD
    Reason["Termination reason:
• Strike 3 (auto-trigger)
• HR judgment (manual)
• Tutor resign"] --> Trigger["HR trigger termination via UI"]
    Trigger --> CheckFM{FM claim status
PENDING_L1 atau
PENDING_L2?}
    CheckFM -->|Yes| Block["⚠ BLOCKED:
Resolve FM claim dulu
(no termination during FM review)"]
    CheckFM -->|No| Checklist["Termination Checklist UI
(step-through)"]

    Checklist --> S1["1. Final settlement payout
(auto-trigger calc untuk
remaining unpaid sesi)"]
    Checklist --> S2["2. Document return tracking"]
    Checklist --> S3["3. Access revoke immediate
(revoke OAuth tokens +
login disabled atomic txn)"]
    Checklist --> S4["4. Archive flag
(tutor.status=ARCHIVED)"]

    S1 --> Final[Final terminated]
    S2 --> Final
    S3 --> Final
    S4 --> Final

    Final --> Archive["Tutor data preserved
(read-only via ARCHIVED status)
Historic sesi/settlement tetap query-able"]
    Archive --> Reactivate{Reactivation
request?}
    Reactivate -->|Yes| Senior2["Senior admin approval
+ audit log
+ ARCHIVED → ACTIVE"]
    Reactivate -->|No| End[Termination final]

    style Block fill:#f87171,color:#420c0c
    style Final fill:#fbbf24,color:#422006
    style End fill:#94a3b8,color:#1e293b
    

flowchart LR
    subgraph SM["STUDENT Matrix → Tagihan / sesi"]
      direction TB
      S1[Subject]
      S2["SubjectLevel ?
(optional child)"]
      S3[Tingkat]
      S4[Segmentasi]
      S1 --> SA[("amount/sesi")]
      S2 -.-> SA
      S3 --> SA
      S4 --> SA
    end

    subgraph TM["TUTOR Matrix → Honorarium / sesi"]
      direction TB
      T1[Subject]
      T2["SubjectLevel ?
(optional child)"]
      T3[Tingkat]
      T4[Segmentasi]
      T5["Golongan
(tutor tier)"]
      T1 --> TA[("amount/sesi")]
      T2 -.-> TA
      T3 --> TA
      T4 --> TA
      T5 --> TA
    end

    style SA fill:#38bdf8,color:#0c2c4a
    style TA fill:#a855f7,color:#2e1065
    

flowchart TD
    SA["amountStudent
← lookup STUDENT matrix"] --> Snap
    TA["amountTutor
← lookup TUTOR matrix"] --> Snap
    TR["transportFee
← app config bracket per km
(default <20km=Rp10k, >20km=Rp12k)"] --> Snap
    MS["mode_surcharge
(optional per-sesi escape hatch)"] --> Snap
    Snap["🔒 Snapshot at APPROVED
frozen ke Schedule record:
pricingMatrixIdStudent + pricingMatrixIdTutor
+ amountStudent + amountTutor
+ transportFee + mode_surcharge
+ cancellationPolicyConfigId"]
    Snap --> Margin["💵 XPrivate margin (derived per sesi)
= amountStudent − amountTutor − (XPrivate transport share)"]

    style SA fill:#38bdf8,color:#0c2c4a
    style TA fill:#a855f7,color:#2e1065
    style Snap fill:#fef3c7,color:#422006
    style Margin fill:#34d399,color:#052e1f
    

flowchart LR
    subgraph A1["Iter 1 ACTIVE"]
      AdminLogin["Admin Login
Google OAuth +
Workspace domain restrict
@xprivate.education"]
      Session[Session mgmt
timeout + remember-me]
      RBAC["Custom flexible RBAC
Role + Permission +
RolePermission + UserRole"]
    end

    subgraph DR["Iter 1 DB-READY (schema present, deferred activation)"]
      UserType["UserType enum:
• ADMIN ✓ (active)
• TUTOR (ready)
• SISWA (ready)
• PARENT (ready)"]
      IdProvider["IdentityProvider:
• Google OAuth ✓ (active)
• email/password (ready)
• social login (ready)"]
      UserIdentity["UserIdentity
(many-to-many link)"]
      TFA["TwoFactorMethod
(2FA TOTP / SMS ready)"]
      LoginAudit["LoginAuditEvent
(login events ready)"]
      PwdReset["PasswordReset
EmailVerification"]
      AccState["AccountState machine:
PENDING_INTERVIEW →
APPROVED → ACTIVE →
SUSPENDED → ARCHIVED"]
    end

    subgraph A2["Iter 2+ ACTIVATION"]
      TutorPortal["Tutor portal login
(basic email/pwd
or magic link)"]
      SiswaPortal["Siswa portal login"]
      Activate2FA["2FA TOTP activate
(opt-in or mandatory)"]
      SelfReg["Self-register flow
(apply → interview →
approved → active)"]
    end

    AdminLogin --> Session
    Session --> RBAC

    UserType -.-> TutorPortal
    UserType -.-> SiswaPortal
    IdProvider -.-> TutorPortal
    TFA -.-> Activate2FA
    AccState -.-> SelfReg

    style AdminLogin fill:#34d399,color:#052e1f
    style Session fill:#34d399,color:#052e1f
    style RBAC fill:#34d399,color:#052e1f
    style UserType fill:#fbbf24,color:#422006
    style IdProvider fill:#fbbf24,color:#422006
    style UserIdentity fill:#fbbf24,color:#422006
    style TFA fill:#fbbf24,color:#422006
    style LoginAudit fill:#fbbf24,color:#422006
    style PwdReset fill:#fbbf24,color:#422006
    style AccState fill:#fbbf24,color:#422006
    style TutorPortal fill:#38bdf8,color:#0c2c4a
    style SiswaPortal fill:#38bdf8,color:#0c2c4a
    style Activate2FA fill:#38bdf8,color:#0c2c4a
    style SelfReg fill:#38bdf8,color:#0c2c4a