1

CLAUDE.md

@@ -0,0 +1,106 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+**FastAdmin 1.6.x** admin panel built on **ThinkPHP 5.x** (forked from gitee.com/fastadminnet/framework.git). The project is a Macau lottery (澳门六合彩) data tracking application named "amlhc".
+
+- PHP >= 7.4.0, Apache-2.0 license
+- Database: MySQL with `fa_` table prefix, utf8mb4 charset
+- Frontend: RequireJS + Bootstrap 3.4 + AdminLTE skin
+
+## Key Directories
+
+| Path | Purpose |
+|---|---|
+| `application/admin/` | Admin backend — controllers, models, views, validates, lang |
+| `application/index/` | Public-facing frontend |
+| `application/api/` | REST API endpoints |
+| `application/common/` | Shared base controllers, models, libraries, global helpers |
+| `application/extra/` | Extra config: site.php, upload.php, queue.php, addons.php |
+| `public/` | Web root — entry point `index.php`, static assets in `assets/` |
+| `addons/` | Plugin directory (currently `command` addon installed) |
+| `sql/` | SQL migration/DDL files |
+| `thinkphp/` | Vendored ThinkPHP 5.x framework |
+
+## Config Loading Chain
+
+All files under `application/` are merged by ThinkPHP:
+1. `config.php` — main config (debug, modules, URL, template, session, cookie, FastAdmin settings)
+2. `database.php` — DB connection (reads from `.env`)
+3. `extra/*.php` — site, upload, queue, addons config
+4. `route.php` — URL routing (currently empty)
+
+Environment variables are loaded from `.env` via `think\Env`.
+
+## Admin Module Architecture
+
+All admin controllers extend `app\common\controller\Backend`, which provides:
+- RBAC auth via `app\admin\library\Auth` (salt double-MD5, session + cookie)
+- CRUD base operations (index/add/edit/del/multi) via `app\admin\library\traits\Backend`
+- Search/filtering, SelectPage, import/export
+- Layout templating via `application/admin/view/layout/default.html`
+
+**Standard controller pattern:** Each admin controller maps to a model + view directory + validate + lang file:
+```
+controller/X.php  →  model/X.php  →  view/x/  →  validate/X.php  →  lang/zh-cn/x.php
+```
+
+## Custom Domain Code (Lottery)
+
+| File | Purpose |
+|---|---|
+| `application/admin/controller/History.php` | Lottery history admin |
+| `application/admin/model/History.php` | `fa_history` model |
+| `application/admin/controller/Num.php` | `fa_num` color mapping API (`getColorMap`) |
+| `application/admin/model/Num.php` | `fa_num` model |
+| `application/index/controller/Index.php` | Scrapes lottery data from external API |
+
+## Frontend Build System
+
+**Grunt** (`Gruntfile.js`) is the build tool:
+- `grunt deploy` — copy npm packages to `public/assets/libs/`
+- `grunt backend:js` / `grunt frontend:js` — RequireJS optimizer for JS
+- `grunt backend:css` / `grunt frontend:css` — Less → CSS compilation
+
+JS uses RequireJS with separate entry points: `require-backend.js` and `require-frontend.js`.
+
+## Common Development Commands
+
+### Install dependencies
+```bash
+composer install
+npm install
+grunt deploy        # copy npm deps to public/assets/libs/
+grunt               # build all JS/CSS
+```
+
+### Run dev server
+```bash
+php -S 127.0.0.1:8000 -t public public/router.php
+```
+
+### Generate CRUD scaffolding (built-in)
+```bash
+php think crud --table=fa_xxx --controller=xxx --model=xxx
+```
+
+### Generate menu for admin controller
+```bash
+php think menu --controller=xxx/xxx
+```
+
+### Run tests
+```bash
+php think unit
+```
+
+## Important Notes
+
+- Admin entry is `public/index.php` (the admin module is accessed via URL routing, not a separate `admin.php`)
+- All database queries use ThinkPHP's query builder (`Db::name('table')`) or models
+- Language files use key-value pairs; keys are English labels (e.g., `'Num1' => '号码1'`)
+- The `.env` file contains actual credentials — never commit it
+- Runtime cache lives in `runtime/` — clear it when config changes don't take effect
+