---
# System prepended metadata

title: Jira Tasks – Face Attendance (Main Features + Endpoints)

---

# Jira Tasks – Face Attendance (Main Features + Endpoints)

Short list of main app features with the API endpoint used per task (if any).

---

## 1. Launch & Auth

| # | Title | Description | Endpoint |
|---|--------|-------------|----------|
| 1 | **Splash & Session Check** | Splash screen with logo; then check login and location and route user to the right screen (login, home, pending approval, or register face). | `POST /api/attendance/status` |
| 2 | **Login** | Login screen (username and password), call API and route by user status (approved / pending / rejected or face not uploaded). | `POST /api/auth/login` |
| 3 | **Logout** | Logout button with confirmation, then clear session and navigate to login. | `POST /api/auth/logout` |

---

## 2. Location

| # | Title | Description | Endpoint |
|---|--------|-------------|----------|
| 4 | **Location (permission + request screen + overlay)** | Request location permission and get coordinates; dedicated screen to request enablement; overlay blocking the app when location is disabled until enabled. | — |

---

## 3. Home & Attendance

| # | Title | Description | Endpoint |
|---|--------|-------------|----------|
| 5 | **Home (tabs)** | Main screen with three tabs: Home, History, Profile, and bottom navigation bar. | — |
| 6 | **Check-in / Check-out** | On Home tab: show current location, check-in/check-out button (opens camera), timer after check-in, celebration on check-out, and waiting state for pending users. Status data from API. | `POST /api/attendance/status` (display status) |

---

## 4. Face Registration

| # | Title | Description | Endpoint |
|---|--------|-------------|----------|
| 7 | **Face Registration** | “Start register face” screen then camera screen: preview, user guidance, liveness (blink), upload face or record check-in/check-out via face. | `POST /api/face/upload` (first-time upload), `POST /api/attendance/check` (check-in/check-out) |

---

## 5. Attendance History

| # | Title | Description | Endpoint |
|---|--------|-------------|----------|
| 8 | **Attendance History** | History tab: month filter (previous/next), list of records with pull-to-refresh and load more on scroll. | `GET /api/attendance/list?date_from=&date_to=&skip=&take=` |

---

## 6. Profile & Contact Us

| # | Title | Description | Endpoint |
|---|--------|-------------|----------|
| 9 | **Profile** | Profile tab: user data (photo, name, email, employee ID, department, phone), Contact Us button, Logout. Data from session state (filled from attendance/status). | `POST /api/attendance/status` (data source), `POST /api/auth/logout` (on logout) |
| 10 | **Contact Us** | Screen with contact info (technical support, management, email) and copy phone/email on tap. | — |

---

## 7. Special States

| # | Title | Description | Endpoint |
|---|--------|-------------|----------|
| 11 | **Pending Approval** | Screen for users in “pending” state: waiting message and logout only. User state from session-check response. | `POST /api/attendance/status` (determines state), `POST /api/auth/logout` (on logout) |
| 12 | **No Internet** | Overlay when offline with message and retry button. | — |

---


