🛡️ Admin Portal Overview

Purpose:
The admin-portal is a frontend web application designed for administrators to manage and monitor the microservices ecosystem (users, activities, logs, and configurations).

Project Path:
awesome-azure-microservices/admin-portal

Architecture Pattern:

• SPA (Single Page Application)
• Component-based architecture
• Follows best practices for Angular (v17+)

---

🧭 Features

Feature	Description
🔐 Login / Logout	Authenticated access using JWT
👥 User Management	View, edit, or deactivate users
📊 Activity Logs	View logs from tracking-service
⚙️ Service Monitor	Monitor health/status of microservices
🛠️ Admin Configurations	Toggle flags, roles, or system settings

---

🧱 Frontend Stack

• Framework: Angular v17+ (Standalone Components)
• Styling: SCSS / Tailwind CSS (optional)
• Routing: Angular Router with lazy-loaded modules
• State Management: RxJS + Signals (for local state)
• Testing: Jasmine & Karma (unit), Cypress (e2e)

---

🌐 API Integrations

API	Endpoint Source	Notes
Auth Service	/api/auth	For login and token validation
User Service	/api/users	Admin CRUD on users
Tracking Service	/api/logs	Fetch logs by user/date/type
Health Check API	/api/health	Microservices status and heartbeat

---

🔐 Authentication & Security

• Uses JWT token stored in HttpOnly cookie (or local storage for dev)
• Implements Auth Guard to protect admin routes
• HTTP Interceptors to append Authorization headers

---

🧪 Testing Strategy

• Unit Tests: Jasmine for components and services
• E2E Tests: Cypress for login flow and admin actions
• CI: Azure Pipelines run all test suites on PR

---

🚀 Deployment

• Containerized: via Docker and Azure App Service (Linux)
• CI/CD: GitHub Actions and Azure Pipelines integrated
• Environment Configuration: managed via environment.ts

---

📌 Sample Admin Use Cases

• View login logs for all users in the last 7 days
• Deactivate a suspicious user account
• Toggle feature flags for staging environment
• Monitor system uptime and retry failed logs