# kexilo_admin_flutter

**Repository Path**: kexilo/kexilo_admin_flutter

## Basic Information

- **Project Name**: kexilo_admin_flutter
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-13
- **Last Updated**: 2026-02-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Kexilo Flutter Admin
<!-- 项目标题：用于快速识别仓库用途 -->

Flutter mobile client for `kexilo` full admin system.
<!-- 项目一句话概述：Flutter 移动端 Admin 客户端 -->

## Current Scope
<!-- 当前实现范围：用于明确一期功能边界 -->

- Full-admin single client architecture (no WebView transition).
- Unified auth flow:
  - `POST /auth/login`
  - `POST /auth/refresh`
  - `POST /auth/logout`
- Post-login bootstrap:
  - `GET /auth/me`
  - `GET /auth/permissions/current`
  - `GET /menus/tree`
- Menu-driven dashboard entry shells.

## Prerequisites
<!-- 运行前置条件：Flutter/Dart 版本要求 -->

- Flutter `3.27.3`
- Dart `3.6.1`

## Run
<!-- 本地运行步骤：先拉依赖，再运行并注入配置 -->

```bash
flutter pub get
flutter run \
  --dart-define=API_BASE_URL=http://localhost:8080/api \
  --dart-define=TENANT_ENABLED=false \
  --dart-define=DEFAULT_TENANT_ID=default \
  --dart-define=IM_WS_URL=ws://localhost:9001/ws
```

## Quality Checks
<!-- 质量检查：格式化、静态分析与测试 -->

```bash
dart format lib test
flutter analyze
flutter test
```

## Folder Highlights
<!-- 目录导览：快速定位关键模块 -->

- `lib/core/network`: `ApiClient`, API envelope/error models, interceptors.
- `lib/core/auth`: session persistence, login/refresh/logout, bootstrap state.
- `lib/core/menu`: backend menu tree models.
- `lib/features/auth`: login page.
- `lib/features/dashboard`: menu-driven dashboard shell.