---
title: Ax9000WRTBuild – Project Overview
type: curated
permalink: main/projects/6f47523e-e22e-4cdd-bd18-76e5e474ee0c/curated/ax9000-wrtbuild-project-overview
stable_id: 7b8945b7-d58e-4bbd-93d0-63b5569c98e4
scope: project
project_id: 6f47523e-e22e-4cdd-bd18-76e5e474ee0c
workspace_type: general
usage_profile_id: null
preference_context: general
document_type: overview
revision: 1
source_memory_ids: []
source_checkpoint_ids: []
source_file_ids: []
source_git_commit: a066d95b43240f85f5abcf18305c2edfe1da91a3
source_git_commits:
- a066d95b43240f85f5abcf18305c2edfe1da91a3
source_agent_sync_ids: []
model_connection: Sub2API
model_name: git-restore
source_count: 52
source_revisions:
  memory:be916376-ddf7-44e0-be53-963d5b2aa655: '1'
  memory:5daa77ea-300c-4185-b408-8e5d021e67d5: '1'
  memory:1033d1fb-6d87-4009-8b39-498c8963f6aa: '1'
  memory:e61163f1-50db-49d4-839b-a8bdb67741c2: '1'
  memory:86a5a0e1-2536-48c2-b48a-5e6b8e85cd50: '1'
  memory:814d437d-2c21-4f02-b17b-97fd3ec03f7e: '1'
  memory:650349fe-0a22-4d62-b3ab-329523cb1960: '1'
  memory:180c6231-32a2-4513-980b-613afff09cbe: '1'
  memory:635986da-9408-414d-8d89-73e76bd921ed: '1'
  memory:f8c5300e-3068-4003-a816-b20f997d9715: '1'
  memory:4f58f272-ba63-4f40-a617-c35cfa4cad6e: '1'
  memory:b83ec829-f008-4de0-a4a3-79ad7a6c3a98: '1'
  memory:bf2dc676-cc13-41f7-b05d-4ed20fc6360e: '1'
  memory:975e8c20-b999-4c43-80c0-78030668fec1: '1'
  memory:f1a1ef45-2ef0-4ace-9385-05a7bd12ab85: '1'
  memory:2dc986e1-06de-466f-bfd5-9221cc66fa14: '1'
  memory:77f1fcf5-022f-47b4-a605-52c12ba91612: '1'
source_dispositions:
  processed: 52
  unchanged: 0
  unsupported: 0
  skipped: 0
cited_source_ids:
- memory:86a5a0e1-2536-48c2-b48a-5e6b8e85cd50
- memory:814d437d-2c21-4f02-b17b-97fd3ec03f7e
- memory:650349fe-0a22-4d62-b3ab-329523cb1960
- memory:180c6231-32a2-4513-980b-613afff09cbe
- memory:635986da-9408-414d-8d89-73e76bd921ed
- memory:f8c5300e-3068-4003-a816-b20f997d9715
- memory:4f58f272-ba63-4f40-a617-c35cfa4cad6e
- memory:b83ec829-f008-4de0-a4a3-79ad7a6c3a98
- memory:bf2dc676-cc13-41f7-b05d-4ed20fc6360e
- memory:975e8c20-b999-4c43-80c0-78030668fec1
- memory:f1a1ef45-2ef0-4ace-9385-05a7bd12ab85
- memory:2dc986e1-06de-466f-bfd5-9221cc66fa14
- memory:77f1fcf5-022f-47b4-a605-52c12ba91612
- source_file:packages/luci-app-frpc/root/www/luci-static/resources/view/frpc.js
- source_file:packages/luci-app-frpc/Makefile
- source_file:packages/luci-app-frpc/po/zh_Hans/frpc.po
- source_file:AGENTS.md
- memory:be916376-ddf7-44e0-be53-963d5b2aa655
- memory:5daa77ea-300c-4185-b408-8e5d021e67d5
- memory:1033d1fb-6d87-4009-8b39-498c8963f6aa
- memory:e61163f1-50db-49d4-839b-a8bdb67741c2
job_cited_source_ids: []
conflicts: []
supersedes: []
preferences: []
source_cursor: 700
source_hash: 425f69c7d615a0522a06a54c0b88e30cbb169b3da8e430a957345bc06a169bb7
prompt_version: 2026-08-12.3
schema_version: '3'
curation_job_id: null
created_at: '2026-08-12T17:42:27.070190+00:00'
updated_at: '2026-09-23T14:58:44.741681+00:00'
tags:
- global_guidance
- architecture
restored_from_commit: 6a6a895eafcca6052e81a14fca103a42635dd1c2
---

# Global Guidance & Policies

- **Answer‑First** – deliver confirmed answers immediately. <br>
- **No Auto‑Project Creation** – only write global‑scope memory in temporary sessions.
- **Push After Commit** – commits are pushed automatically; rebase on new remote changes.
- **MemRelay Only** – all memory persists in MemRelay; no local `aidocs/` artifacts are created unless exported by the user.
- **Vault‑First Credential Access** – all sensitive data resides in Vaultwarden; any matching vault entry is automatically used.
- **Development Preferences** – communication is in Chinese; follow KISS & YAGNI, avoid unnecessary dependencies.

# Project Architecture

- **Host**: Windows 10/11 with WSL 2 and Docker Desktop (Linux container).
- **Container**: `openwrt‑local‑builder:25.12` based on Ubuntu 24.04.
- **Volume**: `openwrt‑build‑work` > 50 GB.
- **Back‑end**: FastAPI 0.139 (dev mode, unauthenticated by default).
- **Front‑end**: Vue 3 with Vite, served on `localhost:9000`.
- **OpenWrt Source**: `qosmio/openwrt‑ipq` 25.12‑nss with feeds from the official repository, Qosmio NSS, and community `kiddin9`.
- **Luci App**: `luci‑app‑ax900‑hardware` (fan & LED control).
- **NSS**: `kmod‑qca‑nss‑*`, `nss‑firmware‑ipq807x`.

## Key Decisions Supporting Architecture

- Use separate FastAPI for backend and Vue for the console.
- Replace fragile patch scripts with formal `.patch` files and Git
  apply.
- Adopt a single JSON‑Schema for configuration, driving both Pydantic
  types on the backend and TypeScript types for the front‑end.
- Lock Docker image digest, Git commit SHA, and the `uv.lock`
  to ensure deterministic builds.
- Store credentials securely in Vaultwarden.

*All architecture and decision points are derived from the project
memorandum and associated decisions documents.*