site_name: AgileLabs Framework Docs
site_description: AI agent friendly documentation for AgileLabs Framework
site_url: https://mkdocs.feinian.net/agilelabs-fx-docs/
docs_dir: .
use_directory_urls: false
strict: true

markdown_extensions:
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format

extra_javascript:
  - assets/javascripts/mermaid.min.js
  - assets/javascripts/mermaid-init.js

extra_css:
  - assets/stylesheets/mermaid.css

theme:
  name: mkdocs

nav:
  - 首页: README.md
  - Solution:
      - 方案总览: Solution/README.md
      - 认证:
          - 认证方案总览: Solution/authentication/README.md
          - AccessCode + JWT 登录方案: Solution/authentication/accesscode-jwt-login.md
      - 授权:
          - 授权方案总览: Solution/authorization/README.md
          - JWT 保护后台接口方案: Solution/authorization/jwt-protected-admin-apis.md
  - 开始:
      - 开始: start/overview.md
      - 服务启动与宿主接入: start/setup-and-bootstrap.md
      - 文档结构与阅读路径: start/project-structure.md
      - AI Agent 使用约定: start/ai-agent-guide.md
  - 教程:
      - 教程总览: tutorials/README.md
      - 教程配套代码:
          - 配套代码总览: samples/tutorials/README.md
          - backend-starter: samples/tutorials/backend-starter/README.md
          - frontend-starter: samples/tutorials/frontend-starter/README.md
          - fullstack-starter: samples/tutorials/fullstack-starter/README.md
      - 后端初始化:
          - 后端初始化总览: tutorials/backend-init/README.md
          - 创建后端解决方案: tutorials/backend-init/create-solution.md
          - 创建 Web 宿主: tutorials/backend-init/create-web-host.md
          - 接入 WebAPI 基础能力: tutorials/backend-init/configure-webapi.md
          - 接入数据访问骨架: tutorials/backend-init/add-data-access.md
          - 接入认证骨架: tutorials/backend-init/add-authentication.md
          - 运行与验证后端骨架: tutorials/backend-init/run-and-verify.md
      - 前端初始化:
          - 前端初始化总览: tutorials/frontend-init/README.md
          - 创建前端项目: tutorials/frontend-init/create-frontend-project.md
          - 配置 Tailwind 与图标库: tutorials/frontend-init/configure-tailwind-and-icons.md
          - 配置 Light / Dark 双主题: tutorials/frontend-init/configure-light-dark-theme.md
          - 连接 WebAPI: tutorials/frontend-init/connect-to-webapi.md
          - 配置开发代理与本地联调: tutorials/frontend-init/dev-proxy-and-local-debug.md
          - 构建并托管前端: tutorials/frontend-init/build-and-host.md
  - 任务:
      - 任务入口: tasks/README.md
      - 创建一个服务: tasks/create-service.md
      - 做一个 WebAPI: tasks/build-webapi.md
      - 托管前端: tasks/host-frontend.md
      - 做数据访问: tasks/use-data-access.md
      - 处理时间与多时区: tasks/handle-time.md
      - 运行 Job 与后台任务: tasks/run-jobs.md
      - 使用 WorkContext: tasks/use-workcontext.md
      - 选择真实项目参考: tasks/choose-real-project.md
  - 框架规范:
      - 规范总览: framework-standards/README.md
      - 框架使用与扩展: framework-standards/framework-usage.md
      - WebAPI 规范: framework-standards/webapi.md
      - 前端对接规范: framework-standards/frontend-contract.md
      - 前端项目规范: framework-standards/frontend-project.md
      - 时间与时区规范: framework-standards/time-and-timezone.md
      - 命名与数据转换规范: framework-standards/naming-and-data-conventions.md
      - 常见问题与隐式机制: framework-standards/faq-and-implicit-mechanisms.md
  - 检查:
      - 检查入口: checks/README.md
      - 框架使用检查: checks/framework-usage.md
      - WebAPI 与前端契约检查: checks/api-contract.md
      - 前端项目检查: checks/frontend-project.md
      - 命名与数据转换检查: checks/naming-and-data-conversion.md
      - 时间与时区检查: checks/time-and-timezone.md
  - 主题:
      - 主题手册: topics/README.md
      - 宿主与启动: topics/hosting.md
      - WebAPI: topics/webapi.md
      - 前端托管: topics/frontend-hosting.md
      - 数据访问: topics/data-access.md
      - 数据库命名: topics/database-naming.md
      - 时间与多时区: topics/time-and-timezone.md
      - WorkContext: topics/workcontext.md
      - AutoMapper: topics/automapper.md
      - 日志与诊断: topics/logging-and-diagnostics.md
  - 真实用例:
      - 真实用例总览: real-usecases/README.md
      - niusys-webapi: real-usecases/niusys-webapi.md
      - gmandarin-backend: real-usecases/gmandarin-backend.md
      - woscm: real-usecases/woscm.md
  - 参考:
      - 参考资料: reference/README.md
      - 包与组件: reference/packages.md
      - 测试: reference/testing.md
      - Drone CI/CD 参考: reference/drone-ci-cd.md
      - abcred.ai 的 Drone 配置示例: reference/drone-ci-cd-abcred-ai.md
      - EF Core 迁移到 Dapper: data-access/migrate-efcore-to-dapper.md
      - 工具、升级与变更记录: reference/tools-and-releases.md