# TemseeEdu — Administrative Onboarding Handbook

Welcome to **TemseeEdu**, a state-of-the-art school management suite designed for both modern cloud SaaS environments and offline standalone deployments. This handbook serves as a comprehensive operational manual to guide new administrators through system configurations, multi-channel communication networks, portals management, and security tasks.

---

## 1. Initial System Setup & Personalization

Upon successful registration or license activation, access your admin panel (`/admin`) and navigate to **System Settings** to customize the platform for your institution.

### 1.1 Branding & Visual Identity
- **School Details**: Provide your official school name, postal address, primary email, contact phone, and tagline. These details automatically populate invoices, report cards, and student ID cards.
- **Logo & Favicon**: Upload a high-resolution logo (PNG/SVG, preferably transparent) and favicon.
- **Theme Selection**: Customize the core visual system by selecting from standard light, dark, or system-matching layouts. Adjust primary theme colors to align with your school's color scheme.

---

## 2. Multi-Channel Communications

TemseeEdu integrates automatic notification dispatching across major channels to bridge communications between teachers, students, and parents.

### 2.1 SMS Gateway Integration (Arkesel Ghana)
To enable instantaneous parent/guardian mobile alerts:
1. Register an account at [Arkesel Ghana](https://arkesel.com) and purchase SMS credits.
2. In your admin dashboard, navigate to **Settings > SMS Configuration**.
3. Input your **Arkesel API Key** and set your custom **Sender ID** (must be approved by Arkesel, max 11 characters).
4. Save the configuration. System alerts (e.g. absent reports, result publishing, invoice generation) will now fire SMS broadcasts automatically.

### 2.2 Custom Email Gateway (SMTP / API)
Ensure mail delivery for student assignments, reports, and logins:
1. In your **SMTP Settings**, configure your host details (e.g. SMTP host, port, protocol: SSL/TLS, and credentials).
2. For cloud accounts, leverage integrated **Resend** or **Amazon SES** API integrations to guarantee high deliverability with zero configuration overhead.

---

## 3. Account Portals & Lifecycle Management

Managing user entities follows a strict relational structure in TemseeEdu.

```mermaid
graph TD
    A[School Administrator] -->|Provisions| B[Academic Year & Term]
    A -->|Registers| C[Classes & Gradescales]
    A -->|Admits| D[Student Profile]
    A -->|Links| E[Parent / Guardian Account]
    D -->|Authenticates| F[Student Portal]
    E -->|Authenticates| G[Parent Portal]
```

### 3.1 Portal Setup Guidelines
1. **Academic Terms**: Initialize the current academic year and term first (e.g., *2025/2026 Academic Year - Term 1*). All classes, assessments, and attendance records scope inside the active term.
2. **Class Creation**: Set up classes (e.g. *KG 1*, *Primary 5*, *JHS 3*) and assign their respective Class Teachers.
3. **Student Admission**: Add student records. Input their unique Student ID, assign their primary class, and upload files (birth certificates, passport photos).
4. **Parent Linkage**: Create guardian accounts and link them directly to their students. This grants parents full visual oversight of their children's invoices and report cards from their respective parent portal.

---

## 4. Platform Security & Operations

### 4.1 Database Backup & Restoration
To safeguard school records against data loss or accidental changes, TemseeEdu houses an integrated database recovery utility.
- **Backups**: Access **System > Database Backup** to run manual compressed snapshots (`.sql.gz`). Backups are isolated under private tenant folders, preventing any cross-tenant accessibility.
- **Recovery**: Restoring is a critical action. When restoring a database, the system will prompt a dual-factor safety confirmation modal requiring you to type `RESTORE` to overwrite active tables. Ensure you download a local backup before running a restore!

### 4.2 Polymorphic Audit Logging
- Every single creation, update, and deletion is captured dynamically by our **Polymorphic Audit Trail Engine**.
- Navigate to **System > Audit Logs** to view detailed actor profiles (the exact admin, parent, or student who executed the action), IP addresses, page URLs, and side-by-side JSON diff comparisons showing exact fields changed.

---

## 5. Standalone Offline Deployments

For standalone school editions running locally inside offline-ready campus servers:
- **Local Cache**: Standalone instances cache cryptographic JSON Web Tokens (`license.json`) locally within `storage/app/` to permit full system execution with zero active internet connectivity.
- **Key Validity**: In cases of key expiration or domain mismatch warnings, navigate to the **License Activation** form under the dashboard sidebar, type in your new key, and press "Activate" to fetch and sign your updated offline validation token securely.