> ## Documentation Index
> Fetch the complete documentation index at: https://mako-docs.devinagiffy.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Admin Guide

> Complete guide for Hitler organization administrators

## Overview

As an organization admin, you have full control over your Hitler deployment. This guide covers everything you need to manage your organization effectively.

## Getting Started

### Initial Setup Checklist

<Steps>
  <Step title="Connect Slack">
    Install the Hitler bot in your Slack workspace via Settings → Integrations
  </Step>

  <Step title="Configure Settings">
    Set up timezone, check-in times, and notification preferences
  </Step>

  <Step title="Invite Team">Team members can self-serve via "Sign in with Slack"</Step>
  <Step title="Assign Managers">Promote appropriate users to Manager role</Step>
</Steps>

## User Management

### Viewing Users

Navigate to **Users** in the dashboard to see all organization members.

| Column | Description                 |
| ------ | --------------------------- |
| Name   | User's display name         |
| Email  | Primary email address       |
| Role   | Employee, Manager, or Admin |
| Status | Active or Inactive          |
| Joined | Account creation date       |

### Creating Users

Users can be created manually by admins. New users are created with a **temporary password** and are forced to change it on first login. This enables onboarding users who haven't signed in via Slack yet.

### Changing Roles

1. Click on a user row to open details
2. Select new role from dropdown
3. Click **Save Changes**

<Warning>
  Promoting to Admin gives full organization access. Only grant this to trusted individuals.
</Warning>

### Clear Bot DMs

From the **Team** page, admins can clear bot DM history for any user. Click on a team member and use the "Clear Bot DMs" action to remove all bot messages from that user's Slack DM conversation.

### Deactivating Users

When someone leaves the organization:

1. Find user in the Users list
2. Click **Deactivate**
3. Confirm the action

Deactivated users:

* Cannot sign in
* Are removed from all reports
* Historical data is retained (for compliance)

## Role Permissions

### Employee

| Permission   | Access              |
| ------------ | ------------------- |
| Own tasks    | Full CRUD           |
| Own moods    | Full CRUD           |
| Own journals | Full CRUD           |
| Own flags    | View only           |
| Inquiries    | Create and view own |

### Manager

Everything Employee has, plus:

| Permission | Access                |
| ---------- | --------------------- |
| Team tasks | View only             |
| Team moods | Aggregated stats only |
| Team flags | View and resolve      |
| Inquiries  | Respond to team       |

### Admin

Everything Manager has, plus:

| Permission            | Access             |
| --------------------- | ------------------ |
| User management       | Full CRUD          |
| Role assignment       | Full control       |
| Integrations          | Connect/disconnect |
| Organization settings | Full control       |
| Audit logs            | Full access        |

## Organization Settings

### General

* **Organization Name** - Displayed in emails and reports
* **Timezone** - Default timezone for the organization
* **Logo** - Custom branding (optional)

### Notifications

Configure default notification settings:

| Setting                 | Description                 | Default |
| ----------------------- | --------------------------- | ------- |
| Mood check-in time      | When daily prompts are sent | 9:00 AM |
| Task reminder lead time | How early to remind         | 1 hour  |
| Weekly summary day      | When summaries are sent     | Monday  |
| Weekly summary time     | Time of summary             | 9:00 AM |

### Message Controls

Admins can individually toggle 11 message types on/off to control bot behavior:

| Toggle                       | Description                                  |
| ---------------------------- | -------------------------------------------- |
| `enableSubmissionDeadline`   | DM reminders for missing morning submissions |
| `enableClassificationDigest` | Classification summary to ops channel        |
| `enableEodNudge`             | EOD nudge posted to morning thread           |
| `enableEodCollection`        | EOD collection and task status parsing       |
| `enableDailyReport`          | Daily public + private reports               |
| `enableWeeklyReport`         | Weekly reports on Friday                     |
| `enableMonthlyReport`        | Monthly report on last working day           |
| `enableBlockerEscalation`    | Hourly blocker escalation checks             |
| `enableThursdayCheckin`      | Thursday DMs to underperforming users        |
| `enableDeadlineNudges`       | Proactive deadline nudge messages            |
| `enableCardNotifications`    | Card (yellow/red) notification messages      |

### Privacy

Control data visibility:

* **Manager mood visibility** - Aggregated only (recommended) or individual
* **Data retention period** - How long to keep inactive user data
* **Export permissions** - Who can export organization data

## Integrations

### Slack

See [Slack Setup](/integrations/slack-setup) for detailed instructions.

Key admin actions:

* Install/reinstall the bot
* View connection status
* Disconnect integration

### Pipeline Filters

The **Pipeline** page shows tasks organized by pipeline stages (customizable Kanban columns). Admins can filter by assignee, status, and stage to get a focused view of work across the organization.

## Analytics

### Dashboard Metrics

The admin dashboard shows:

<CardGroup cols={2}>
  <Card title="Active Users" icon="users">
    Users who interacted in the last 7 days
  </Card>

  <Card title="Mood Participation" icon="heart">
    Percentage logging moods regularly
  </Card>

  <Card title="Task Completion" icon="check">
    Organization-wide completion rate
  </Card>

  <Card title="Active Flags" icon="flag">
    Open wellbeing flags requiring attention
  </Card>
</CardGroup>

### Reports

Generate downloadable reports:

* **Engagement Report** - User activity and participation
* **Wellbeing Report** - Anonymized mood trends
* **Task Report** - Productivity metrics

<Note>All reports are anonymized to protect individual privacy.</Note>

## Audit Logs

Access audit logs via **Settings → Audit Logs**.

Logged events include:

* User sign-ins
* Role changes
* Integration connections
* Setting modifications
* Data exports

### Log Retention

* Default: 90 days
* Enterprise: 1 year
* Custom retention available on request

## Security

### Best Practices

<AccordionGroup>
  <Accordion title="Limit Admin Access">
    Only grant Admin role to those who need it. Most managers only need Manager role.
  </Accordion>

  <Accordion title="Regular Access Reviews">
    Periodically review user list and deactivate departed employees.
  </Accordion>

  <Accordion title="Monitor Audit Logs">Check audit logs weekly for unusual activity.</Accordion>

  <Accordion title="Keep Integrations Updated">
    Re-authenticate integrations if you suspect token compromise.
  </Accordion>
</AccordionGroup>

### Data Security

* All data encrypted at rest (AES-256)
* TLS 1.3 for data in transit
* SOC 2 Type II compliant (Enterprise)
* GDPR compliant

## Troubleshooting

<AccordionGroup>
  <Accordion title="User can't sign in">
    1. Verify user is Active in Users list
    2. Check their Slack workspace has Hitler installed
    3. Ensure email matches Slack profile
  </Accordion>

  <Accordion title="Bot not working">
    1. Check integration status in Settings 2. Try reconnecting the integration 3. Verify bot is
       invited to channels
  </Accordion>

  <Accordion title="Missing users">
    Users appear after their first sign-in. They don't need to be manually added.
  </Accordion>

  <Accordion title="Data not syncing">
    1. Check your internet connection
    2. Verify API status at status.hitler.app
    3. Contact support if issues persist
  </Accordion>
</AccordionGroup>

## Support

<CardGroup cols={2}>
  <Card title="Documentation" icon="book" href="/">
    Browse all documentation
  </Card>

  <Card title="Contact Support" icon="headset" href="mailto:support@hitler.app">
    Email our support team
  </Card>
</CardGroup>