@qlover/create-app 0.7.13 → 0.7.15

package/CHANGELOG.md

@@ -1,5 +1,94 @@
 # @qlover/create-app
 
+## 0.7.15
+
+### Patch Changes
+
+#### ✨ Features
+
+- **next-app:** enhance README and documentation for full-stack application template ([198e829](https://github.com/qlover/fe-base/commit/198e829719dfabb2261aa939c6ae69cdba45c9f0)) ([#522](https://github.com/qlover/fe-base/pull/522))
+  - Translated README.md to Chinese and expanded content to provide a comprehensive overview of the Next.js full-stack application template.
+  - Added detailed sections on features, project structure, environment requirements, and quick start instructions.
+  - Introduced new documentation files covering API development, component development, database management, internationalization, and validation guidelines.
+  - Removed outdated env.md file and replaced it with a more comprehensive environment variable configuration guide.
+  - Improved organization and clarity of documentation to facilitate better understanding and onboarding for developers.
+
+  These changes aim to enhance the usability and accessibility of the project documentation, supporting developers in leveraging the full capabilities of the template.
+
+- **next-app:** add comprehensive documentation for full-stack application template ([50029df](https://github.com/qlover/fe-base/commit/50029df11026b5f7e7ea0ae49d0938ed955971d3)) ([#522](https://github.com/qlover/fe-base/pull/522))
+  - Introduced new documentation files covering API development, component architecture, database management, internationalization, and validation guidelines.
+  - Enhanced the README with detailed project features, structure, and quick start instructions.
+  - Added environment variable configuration guide to streamline setup across different environments.
+  - Improved organization and clarity of documentation to facilitate better understanding and onboarding for developers.
+
+  These changes aim to enhance the usability and accessibility of the project documentation, supporting developers in leveraging the full capabilities of the template.
+
+## 0.7.14
+
+### Patch Changes
+
+#### ✨ Features
+
+- **next-app:** integrate SupabaseBridge and update database handling ([5d84568](https://github.com/qlover/fe-base/commit/5d84568849170c998c81b663f0eb5f5f144d8da3)) ([#518](https://github.com/qlover/fe-base/pull/518))
+  - Added SupabaseBridge for managing database interactions, implementing the DBBridgeInterface for standardized operations.
+  - Updated UserRepository to utilize the new DBBridgeInterface for database operations.
+  - Enhanced AppConfig to switch OpenAI configuration to Cerebras.
+  - Refactored UserSchema validation to improve type safety with Zod.
+  - Introduced new pagination handling in DBBridgeInterface for better data management.
+
+  These changes aim to enhance database management capabilities and improve the overall structure of data handling within the application.
+
+- **next-app:** add HomeI18n for localization and enhance layout components ([390a637](https://github.com/qlover/fe-base/commit/390a6375b458c57ca69517d3e4cf1b938f7b4aea)) ([#518](https://github.com/qlover/fe-base/pull/518))
+  - Introduced HomeI18n interface and constants for home page localization, improving internationalization support.
+  - Updated index.ts to export HomeI18n for easier access across the application.
+  - Refactored page.tsx to integrate homeI18n, enhancing metadata handling for the home page.
+  - Improved AdminLayout and BaseHeader components by adding right action buttons for language switching, theme toggling, and logout functionality.
+  - Enhanced BaseLayout to conditionally render admin navigation elements, improving user experience in the admin section.
+
+  These changes aim to provide better localization support and enhance the overall structure and usability of the application.
+
+- **next-app:** add admin page localization and SEO components ([d8ca688](https://github.com/qlover/fe-base/commit/d8ca68861c5b2dc80763622b2f37de6ea0cfb437)) ([#518](https://github.com/qlover/fe-base/pull/518))
+  - Introduced new localization constants for the admin page, enhancing internationalization support.
+  - Created admin18n interface for managing admin page metadata and content.
+  - Added ClientSeo component for improved SEO handling on the admin page.
+  - Updated admin page structure to utilize new localization and SEO features, enhancing user experience.
+  - Refactored localization files to include new keys for admin page content in both English and Chinese.
+
+  These changes aim to improve the admin page's usability and visibility through better localization and SEO practices.
+
+#### 🐞 Bug Fixes
+
+- **create-app:** change build to make ([ea48d14](https://github.com/qlover/fe-base/commit/ea48d140e6f7684efc2e3097046bce82b6448d14)) ([#518](https://github.com/qlover/fe-base/pull/518))
+
+#### ♻️ Refactors
+
+- **next-app:** remove i18nService dependency from layout components ([c4647fa](https://github.com/qlover/fe-base/commit/c4647fa3a51a72354a70e200dd92439d64548fa2)) ([#520](https://github.com/qlover/fe-base/pull/520))
+  - Eliminated the i18nService dependency from AdminLayout and BaseLayout components to simplify the code structure.
+  - Updated LanguageSwitcher to directly use the i18nService via IOC, enhancing encapsulation and reducing prop drilling.
+  - Adjusted memoization dependencies in right action buttons to reflect the removal of i18nService.
+
+  These changes aim to streamline the layout components and improve maintainability by reducing unnecessary dependencies.
+
+- **next-app:** reorganize imports and migrate PageParams to server ([fb6a47b](https://github.com/qlover/fe-base/commit/fb6a47b5b3a293b7d3e8488690e13b1509e9cfde)) ([#518](https://github.com/qlover/fe-base/pull/518))
+  - Updated import paths for PageParams and DBBridgeInterface to reflect new server structure.
+  - Removed obsolete migration-related interfaces and classes to streamline the codebase.
+  - Introduced new PageParams class in the server directory to handle localization and parameter management.
+
+  These changes aim to enhance code organization and improve the clarity of parameter handling within the application.
+
+- **next-app:** update PaginationInterface imports and add new file ([dfd9866](https://github.com/qlover/fe-base/commit/dfd98660ea51989e604cb7d78d935590473bc05b)) ([#518](https://github.com/qlover/fe-base/pull/518))
+  - Changed import paths for PaginationInterface across multiple files to reflect its new location in the server directory.
+  - Introduced a new PaginationInterface file in the server port directory, defining the structure for pagination handling.
+
+  These changes aim to improve code organization and maintainability by centralizing pagination-related definitions.
+
+- **next-app:** reorganize imports and update dependencies ([a1049f4](https://github.com/qlover/fe-base/commit/a1049f4bd61b012ca1938c803bdc3a4c43ef0c9a)) ([#518](https://github.com/qlover/fe-base/pull/518))
+  - Removed duplicate import statements in generateLocales.ts for cleaner code.
+  - Updated useEffect dependency array in UsersPage to include adminUserService, ensuring proper initialization.
+  - Cleaned up globals.ts by removing unnecessary comments, enhancing readability.
+
+  These changes aim to improve code organization and maintainability across the application.
+
 ## 0.7.13
 
 ### Patch Changes

package/dist/index.cjs

@@ -8,4 +8,4 @@ ${t}`,_n=Object.getOwnPropertyDescriptor(Function.prototype,"toString"),mn=Objec
 `))this.#e+=Math.max(1,Math.ceil(Ye(D,{countAnsiEscapeCodes:!0})/t))}get isEnabled(){return this.#a&&!this.#F}set isEnabled(t){if(typeof t!="boolean")throw new TypeError("The `isEnabled` option must be a boolean");this.#a=t}get isSilent(){return this.#F}set isSilent(t){if(typeof t!="boolean")throw new TypeError("The `isSilent` option must be a boolean");this.#F=t}frame(){let t=Date.now();(this.#i===-1||t-this.#c>=this.interval)&&(this.#i=++this.#i%this.#D.frames.length,this.#c=t);let{frames:r}=this.#D,u=r[this.#i];this.color&&(u=d[this.color](u));let i=typeof this.#s=="string"&&this.#s!==""?this.#s+" ":"",D=typeof this.text=="string"?" "+this.text:"",o=typeof this.#o=="string"&&this.#o!==""?" "+this.#o:"";return i+u+D+o}clear(){if(!this.#a||!this.#u.isTTY)return this;this.#u.cursorTo(0);for(let t=0;t<this.#n;t++)t>0&&this.#u.moveCursor(0,-1),this.#u.clearLine(1);return(this.#l||this.lastIndent!==this.#l)&&this.#u.cursorTo(this.#l),this.lastIndent=this.#l,this.#n=0,this}render(){return this.#F?this:(this.clear(),this.#u.write(this.frame()),this.#n=this.#e,this)}start(t){return t&&(this.text=t),this.#F?this:this.#a?this.isSpinning?this:(this.#t.hideCursor&&$e.hide(this.#u),this.#t.discardStdin&&V.default.stdin.isTTY&&(this.#r=!0,Je.start()),this.render(),this.#f=setInterval(this.render.bind(this),this.interval),this):(this.text&&this.#u.write(`- ${this.text}
 `),this)}stop(){return this.#a?(clearInterval(this.#f),this.#f=void 0,this.#i=0,this.clear(),this.#t.hideCursor&&$e.show(this.#u),this.#t.discardStdin&&V.default.stdin.isTTY&&this.#r&&(Je.stop(),this.#r=!1),this):this}succeed(t){return this.stopAndPersist({symbol:H.success,text:t})}fail(t){return this.stopAndPersist({symbol:H.error,text:t})}warn(t){return this.stopAndPersist({symbol:H.warning,text:t})}info(t){return this.stopAndPersist({symbol:H.info,text:t})}stopAndPersist(t={}){if(this.#F)return this;let r=t.prefixText??this.#s,u=this.#E(r," "),i=t.symbol??" ",D=t.text??this.text,s=typeof D=="string"?(i?" ":"")+D:"",a=t.suffixText??this.#o,l=this.#g(a," "),p=u+i+s+l+`
 `;return this.stop(),this.#u.write(p),this}};function rr(e){return new Ze(e)}async function ur(e,t){let r=typeof e=="function",u=typeof e.then=="function";if(!r&&!u)throw new TypeError("Parameter `action` must be a Function or a Promise");let{successText:i,failText:D}=typeof t=="object"?t:{successText:void 0,failText:void 0},o=rr(t).start();try{let a=await(r?e(o):e);return o.succeed(i===void 0?void 0:typeof i=="string"?i:i(a)),a}catch(s){throw o.fail(D===void 0?void 0:typeof D=="string"?D:D(s)),s}}var bt=require("fs");var P=require("path"),me=require("fs"),fr=h(cr(),1),Dt=require("fs");var de=require("fs"),X=class{static ensureDir(t){(0,de.existsSync)(t)||(0,de.mkdirSync)(t,{recursive:!0})}};var{copyFile:us,stat:is}=Dt.promises,_e=class e{constructor(t,r=e.IGNORE_FILE){this.ignoreTargetPath=t;this.ignoreFile=r}static IGNORE_FILE=".gitignore.template";getIg(t=this.ignoreTargetPath){let r=(0,P.join)(t,this.ignoreFile);if(!(0,me.existsSync)(r))return;let D=(0,me.readFileSync)(r,"utf8").split(`
-`).map(o=>o.trim()).filter(o=>o&&!o.startsWith("#"));return(0,fr.default)().add(D)}async copyFiles(t,r,u,i){let D=await Dt.promises.readdir(t);await Promise.all(D.map(async o=>{let s=(0,P.join)(t,o),a=(0,P.join)(r,o);if(u&&u.ignores(o))return;if(X.ensureDir((0,P.dirname)(a)),(await is(s)).isDirectory())await this.copyFiles(s,a,u,i);else{if(i&&await i(s,a))return;await us(s,a)}}))}copyPaths({sourcePath:t,targetPath:r,copyCallback:u}){X.ensureDir(r);let i=this.getIg();return this.copyFiles(t,r,i,u)}};var L=require("fs"),$D=h(kD(),1),xe=class{constructor(){}isJSONFilePath(t){return t.endsWith(".json")||t.endsWith(".json.template")}isTemplateFilePath(t){return t.endsWith(".template")}getRealTemplateFilePath(t){return t.replace(".template","")}readFile(t){return(0,L.readFileSync)(t,"utf-8")}readJSONFile(t){return JSON.parse(this.readFile(t))}writeFile(t,r){(0,L.writeFileSync)(this.getRealTemplateFilePath(t),r,{encoding:"utf-8"})}replaceFile(t,r){let u=this.readFile(t);return Object.keys(r).forEach(i=>{let D=r[i];u=u.replace(new RegExp(`\\[TPL:${i}\\]`,"g"),typeof D=="string"?D:JSON.stringify(D))}),u}mergeJSONFile(t,r){let u=this.readJSONFile(t),i=(0,$D.default)(r,u);this.writeFile(t,JSON.stringify(i,null,2))}composeConfigFile(t,r,u){if(this.isTemplateFilePath(r)){let i=this.replaceFile(r,t);if(this.isJSONFilePath(r)&&this.isJSONFilePath(u)){let D=this.getRealTemplateFilePath(u);return(0,L.existsSync)(D)?(this.mergeJSONFile(D,JSON.parse(i)),!0):(this.writeFile(D,i),!0)}return this.writeFile(u,i),!0}return!1}};var UD=["pack-app"],ye=class{ora;context;subPackages;copyer;compose;constructor(t){let r=t.options?.templateRootPath;if(!r)throw new Error("template path not exit");if(!(0,bt.existsSync)(r))throw new Error("template path not exit");this.ora=ur,this.context=new WD.ScriptContext("create-app",t),this.subPackages=["node-lib","react-app","next-app"],this.copyer=new _e((0,v.join)(this.context.options.configsRootPath,"_common")),this.compose=new xe}get logger(){return this.context.logger}async steps(t){try{return await HD.default.prompt(t)}catch(r){throw r.isTtyError,this.logger.error(r),r}}async action({label:t,task:r}){let u=r();u instanceof Promise||(u=Promise.resolve(u));let i=t;return this.ora(u,i),u}isPackageTemplate(t){return UD.includes(t)}async getGeneratorContext(){let t=wt(this.subPackages,UD),r=await this.steps(t);if(this.isPackageTemplate(r.template)){let u=Pt(this.subPackages),i=await this.steps(u);Object.assign(r,i)}return r.targetPath=(0,v.join)(process.cwd(),r.projectName),r.releasePath=r.releasePath||"src",r}async generate(){let t=await this.getGeneratorContext();if(this.logger.debug("context is:",t,this.context.options.templateRootPath),t.subPackages){await this.action({label:"Generate Directories(subPackages)",task:async()=>{await this.generateTemplateDir(t),await this.generateSubPackages(t),await this.generateConfigs(t,t.targetPath,"_common")}});return}await this.action({label:"Generate Directory",task:async()=>{await this.generateTemplateDir(t),await this.generateConfigs(t,t.targetPath,"_common"),await this.generateConfigs(t,t.targetPath,t.template)}})}async generateConfigs(t,r,u){let i=(a,l)=>(this.logger.debug("copyCallback",a,l),this.compose.composeConfigFile(t,a,l)),{configsRootPath:D,config:o}=this.context.options;if(!o){this.logger.debug("no copy config files");return}let s=(0,v.join)(D,u);if(!(0,bt.existsSync)(s)){this.logger.debug(`Config path not found: ${s}`);return}await this.copyer.copyPaths({sourcePath:s,targetPath:r,copyCallback:i})}generateTemplateDir(t){return this.copyer.copyPaths({sourcePath:(0,v.join)(this.context.options.templateRootPath,t.template),targetPath:t.targetPath})}async generateSubPackages(t){let{packagesNames:r="packages",subPackages:u=[],targetPath:i=""}=t,{templateRootPath:D}=this.context.options;for(let o of u){let s=(0,v.join)(D,o),a=(0,v.join)(i,r,o);this.logger.debug("copy sub package",s,a),await this.copyer.copyPaths({sourcePath:s,targetPath:a})}}};var vt={name:"@qlover/create-app",version:"0.7.13",description:"Create a new app with a single command",private:!1,type:"module",files:["dist","package.json","README.md","CHANGELOG.md"],bin:{"create-app":"dist/index.js"},scripts:{build:"tsup","create:app":"node ./dist/index.js"},repository:{type:"git",url:"git+https://github.com/qlover/fe-base.git",directory:"packages/create-app"},homepage:"https://github.com/qlover/fe-base#readme",keywords:["create-app","fe-scripts","scripts"],author:"qlover",license:"ISC",publishConfig:{access:"public"},devDependencies:{"@qlover/logger":"workspace:*",ignore:"^7.0.3",lodash:"^4.17.21",ora:"^8.1.1"},dependencies:{"@qlover/scripts-context":"workspace:*",commander:"^13.1.0",inquirer:"^12.3.2"}};function Wl(){let e=new YD.Command;return e.version(vt.version,"-v, --version","Show version").description(vt.description).option("-d, --dry-run","Do not touch or write anything, but show the commands").option("-V, --verbose","Show more information").option("--config","Copy config files (default: true)",!0).option("--no-config","Do not copy config files"),e.parse(),e.opts()}async function VD(e=process.cwd()){let{dryRun:t,verbose:r,...u}=Wl(),i=(0,xt.resolve)(e,"./templates"),D=(0,xt.resolve)(e,"./configs");(0,yt.existsSync)(i)||(console.error("Template is empty!"),process.exit(1)),(0,yt.existsSync)(D)||(console.error("Configs is empty!"),process.exit(1)),await new ye({dryRun:t,verbose:r,options:{...u,templateRootPath:i,configsRootPath:D}}).generate()}VD(__dirname).catch(e=>{console.error(e),process.exit(1)});
+`).map(o=>o.trim()).filter(o=>o&&!o.startsWith("#"));return(0,fr.default)().add(D)}async copyFiles(t,r,u,i){let D=await Dt.promises.readdir(t);await Promise.all(D.map(async o=>{let s=(0,P.join)(t,o),a=(0,P.join)(r,o);if(u&&u.ignores(o))return;if(X.ensureDir((0,P.dirname)(a)),(await is(s)).isDirectory())await this.copyFiles(s,a,u,i);else{if(i&&await i(s,a))return;await us(s,a)}}))}copyPaths({sourcePath:t,targetPath:r,copyCallback:u}){X.ensureDir(r);let i=this.getIg();return this.copyFiles(t,r,i,u)}};var L=require("fs"),$D=h(kD(),1),xe=class{constructor(){}isJSONFilePath(t){return t.endsWith(".json")||t.endsWith(".json.template")}isTemplateFilePath(t){return t.endsWith(".template")}getRealTemplateFilePath(t){return t.replace(".template","")}readFile(t){return(0,L.readFileSync)(t,"utf-8")}readJSONFile(t){return JSON.parse(this.readFile(t))}writeFile(t,r){(0,L.writeFileSync)(this.getRealTemplateFilePath(t),r,{encoding:"utf-8"})}replaceFile(t,r){let u=this.readFile(t);return Object.keys(r).forEach(i=>{let D=r[i];u=u.replace(new RegExp(`\\[TPL:${i}\\]`,"g"),typeof D=="string"?D:JSON.stringify(D))}),u}mergeJSONFile(t,r){let u=this.readJSONFile(t),i=(0,$D.default)(r,u);this.writeFile(t,JSON.stringify(i,null,2))}composeConfigFile(t,r,u){if(this.isTemplateFilePath(r)){let i=this.replaceFile(r,t);if(this.isJSONFilePath(r)&&this.isJSONFilePath(u)){let D=this.getRealTemplateFilePath(u);return(0,L.existsSync)(D)?(this.mergeJSONFile(D,JSON.parse(i)),!0):(this.writeFile(D,i),!0)}return this.writeFile(u,i),!0}return!1}};var UD=["pack-app"],ye=class{ora;context;subPackages;copyer;compose;constructor(t){let r=t.options?.templateRootPath;if(!r)throw new Error("template path not exit");if(!(0,bt.existsSync)(r))throw new Error("template path not exit");this.ora=ur,this.context=new WD.ScriptContext("create-app",t),this.subPackages=["node-lib","react-app","next-app"],this.copyer=new _e((0,v.join)(this.context.options.configsRootPath,"_common")),this.compose=new xe}get logger(){return this.context.logger}async steps(t){try{return await HD.default.prompt(t)}catch(r){throw r.isTtyError,this.logger.error(r),r}}async action({label:t,task:r}){let u=r();u instanceof Promise||(u=Promise.resolve(u));let i=t;return this.ora(u,i),u}isPackageTemplate(t){return UD.includes(t)}async getGeneratorContext(){let t=wt(this.subPackages,UD),r=await this.steps(t);if(this.isPackageTemplate(r.template)){let u=Pt(this.subPackages),i=await this.steps(u);Object.assign(r,i)}return r.targetPath=(0,v.join)(process.cwd(),r.projectName),r.releasePath=r.releasePath||"src",r}async generate(){let t=await this.getGeneratorContext();if(this.logger.debug("context is:",t,this.context.options.templateRootPath),t.subPackages){await this.action({label:"Generate Directories(subPackages)",task:async()=>{await this.generateTemplateDir(t),await this.generateSubPackages(t),await this.generateConfigs(t,t.targetPath,"_common")}});return}await this.action({label:"Generate Directory",task:async()=>{await this.generateTemplateDir(t),await this.generateConfigs(t,t.targetPath,"_common"),await this.generateConfigs(t,t.targetPath,t.template)}})}async generateConfigs(t,r,u){let i=(a,l)=>(this.logger.debug("copyCallback",a,l),this.compose.composeConfigFile(t,a,l)),{configsRootPath:D,config:o}=this.context.options;if(!o){this.logger.debug("no copy config files");return}let s=(0,v.join)(D,u);if(!(0,bt.existsSync)(s)){this.logger.debug(`Config path not found: ${s}`);return}await this.copyer.copyPaths({sourcePath:s,targetPath:r,copyCallback:i})}generateTemplateDir(t){return this.copyer.copyPaths({sourcePath:(0,v.join)(this.context.options.templateRootPath,t.template),targetPath:t.targetPath})}async generateSubPackages(t){let{packagesNames:r="packages",subPackages:u=[],targetPath:i=""}=t,{templateRootPath:D}=this.context.options;for(let o of u){let s=(0,v.join)(D,o),a=(0,v.join)(i,r,o);this.logger.debug("copy sub package",s,a),await this.copyer.copyPaths({sourcePath:s,targetPath:a})}}};var vt={name:"@qlover/create-app",version:"0.7.15",description:"Create a new app with a single command",private:!1,type:"module",files:["dist","package.json","README.md","CHANGELOG.md"],bin:{"create-app":"dist/index.js"},scripts:{build:"tsup","create:app":"node ./dist/index.js"},repository:{type:"git",url:"git+https://github.com/qlover/fe-base.git",directory:"packages/create-app"},homepage:"https://github.com/qlover/fe-base#readme",keywords:["create-app","fe-scripts","scripts"],author:"qlover",license:"ISC",publishConfig:{access:"public"},devDependencies:{"@qlover/logger":"workspace:*",ignore:"^7.0.3",lodash:"^4.17.21",ora:"^8.1.1"},dependencies:{"@qlover/scripts-context":"workspace:*",commander:"^13.1.0",inquirer:"^12.3.2"}};function Wl(){let e=new YD.Command;return e.version(vt.version,"-v, --version","Show version").description(vt.description).option("-d, --dry-run","Do not touch or write anything, but show the commands").option("-V, --verbose","Show more information").option("--config","Copy config files (default: true)",!0).option("--no-config","Do not copy config files"),e.parse(),e.opts()}async function VD(e=process.cwd()){let{dryRun:t,verbose:r,...u}=Wl(),i=(0,xt.resolve)(e,"./templates"),D=(0,xt.resolve)(e,"./configs");(0,yt.existsSync)(i)||(console.error("Template is empty!"),process.exit(1)),(0,yt.existsSync)(D)||(console.error("Configs is empty!"),process.exit(1)),await new ye({dryRun:t,verbose:r,options:{...u,templateRootPath:i,configsRootPath:D}}).generate()}VD(__dirname).catch(e=>{console.error(e),process.exit(1)});

package/dist/index.js

@@ -8,4 +8,4 @@ ${t}`,pD=Object.getOwnPropertyDescriptor(Function.prototype,"toString"),hD=Objec
 `))this.#e+=Math.max(1,Math.ceil(Le(n,{countAnsiEscapeCodes:!0})/t))}get isEnabled(){return this.#a&&!this.#F}set isEnabled(t){if(typeof t!="boolean")throw new TypeError("The `isEnabled` option must be a boolean");this.#a=t}get isSilent(){return this.#F}set isSilent(t){if(typeof t!="boolean")throw new TypeError("The `isSilent` option must be a boolean");this.#F=t}frame(){let t=Date.now();(this.#i===-1||t-this.#c>=this.interval)&&(this.#i=++this.#i%this.#n.frames.length,this.#c=t);let{frames:r}=this.#n,u=r[this.#i];this.color&&(u=E[this.color](u));let i=typeof this.#s=="string"&&this.#s!==""?this.#s+" ":"",n=typeof this.text=="string"?" "+this.text:"",o=typeof this.#o=="string"&&this.#o!==""?" "+this.#o:"";return i+u+n+o}clear(){if(!this.#a||!this.#u.isTTY)return this;this.#u.cursorTo(0);for(let t=0;t<this.#D;t++)t>0&&this.#u.moveCursor(0,-1),this.#u.clearLine(1);return(this.#l||this.lastIndent!==this.#l)&&this.#u.cursorTo(this.#l),this.lastIndent=this.#l,this.#D=0,this}render(){return this.#F?this:(this.clear(),this.#u.write(this.frame()),this.#D=this.#e,this)}start(t){return t&&(this.text=t),this.#F?this:this.#a?this.isSpinning?this:(this.#t.hideCursor&&je.hide(this.#u),this.#t.discardStdin&&ce.stdin.isTTY&&(this.#r=!0,We.start()),this.render(),this.#f=setInterval(this.render.bind(this),this.interval),this):(this.text&&this.#u.write(`- ${this.text}
 `),this)}stop(){return this.#a?(clearInterval(this.#f),this.#f=void 0,this.#i=0,this.clear(),this.#t.hideCursor&&je.show(this.#u),this.#t.discardStdin&&ce.stdin.isTTY&&this.#r&&(We.stop(),this.#r=!1),this):this}succeed(t){return this.stopAndPersist({symbol:k.success,text:t})}fail(t){return this.stopAndPersist({symbol:k.error,text:t})}warn(t){return this.stopAndPersist({symbol:k.warning,text:t})}info(t){return this.stopAndPersist({symbol:k.info,text:t})}stopAndPersist(t={}){if(this.#F)return this;let r=t.prefixText??this.#s,u=this.#E(r," "),i=t.symbol??" ",n=t.text??this.text,s=typeof n=="string"?(i?" ":"")+n:"",a=t.suffixText??this.#o,l=this.#g(a," "),p=u+i+s+l+`
 `;return this.stop(),this.#u.write(p),this}};function zt(e){return new He(e)}async function Kt(e,t){let r=typeof e=="function",u=typeof e.then=="function";if(!r&&!u)throw new TypeError("Parameter `action` must be a Function or a Promise");let{successText:i,failText:n}=typeof t=="object"?t:{successText:void 0,failText:void 0},o=zt(t).start();try{let a=await(r?e(o):e);return o.succeed(i===void 0?void 0:typeof i=="string"?i:i(a)),a}catch(s){throw o.fail(n===void 0?void 0:typeof n=="string"?n:n(s)),s}}import{existsSync as Nn}from"fs";var nr=ue(ir(),1);import{dirname as QD,join as Ze}from"path";import{existsSync as es,readFileSync as ts}from"fs";import{promises as Dr}from"fs";import{existsSync as JD,mkdirSync as ZD}from"fs";var H=class{static ensureDir(t){JD(t)||ZD(t,{recursive:!0})}};var{copyFile:rs,stat:us}=Dr,Ce=class e{constructor(t,r=e.IGNORE_FILE){this.ignoreTargetPath=t;this.ignoreFile=r}static IGNORE_FILE=".gitignore.template";getIg(t=this.ignoreTargetPath){let r=Ze(t,this.ignoreFile);if(!es(r))return;let n=ts(r,"utf8").split(`
-`).map(o=>o.trim()).filter(o=>o&&!o.startsWith("#"));return(0,nr.default)().add(n)}async copyFiles(t,r,u,i){let n=await Dr.readdir(t);await Promise.all(n.map(async o=>{let s=Ze(t,o),a=Ze(r,o);if(u&&u.ignores(o))return;if(H.ensureDir(QD(a)),(await us(s)).isDirectory())await this.copyFiles(s,a,u,i);else{if(i&&await i(s,a))return;await rs(s,a)}}))}copyPaths({sourcePath:t,targetPath:r,copyCallback:u}){H.ensureDir(r);let i=this.getIg();return this.copyFiles(t,r,i,u)}};var jn=ue(In(),1);import{readFileSync as $l,writeFileSync as Ul,existsSync as Wl}from"fs";var _e=class{constructor(){}isJSONFilePath(t){return t.endsWith(".json")||t.endsWith(".json.template")}isTemplateFilePath(t){return t.endsWith(".template")}getRealTemplateFilePath(t){return t.replace(".template","")}readFile(t){return $l(t,"utf-8")}readJSONFile(t){return JSON.parse(this.readFile(t))}writeFile(t,r){Ul(this.getRealTemplateFilePath(t),r,{encoding:"utf-8"})}replaceFile(t,r){let u=this.readFile(t);return Object.keys(r).forEach(i=>{let n=r[i];u=u.replace(new RegExp(`\\[TPL:${i}\\]`,"g"),typeof n=="string"?n:JSON.stringify(n))}),u}mergeJSONFile(t,r){let u=this.readJSONFile(t),i=(0,jn.default)(r,u);this.writeFile(t,JSON.stringify(i,null,2))}composeConfigFile(t,r,u){if(this.isTemplateFilePath(r)){let i=this.replaceFile(r,t);if(this.isJSONFilePath(r)&&this.isJSONFilePath(u)){let n=this.getRealTemplateFilePath(u);return Wl(n)?(this.mergeJSONFile(n,JSON.parse(i)),!0):(this.writeFile(n,i),!0)}return this.writeFile(u,i),!0}return!1}};var Gn=["pack-app"],Be=class{ora;context;subPackages;copyer;compose;constructor(t){let r=t.options?.templateRootPath;if(!r)throw new Error("template path not exit");if(!Nn(r))throw new Error("template path not exit");this.ora=Kt,this.context=new Hl("create-app",t),this.subPackages=["node-lib","react-app","next-app"],this.copyer=new Ce(N(this.context.options.configsRootPath,"_common")),this.compose=new _e}get logger(){return this.context.logger}async steps(t){try{return await Yl.prompt(t)}catch(r){throw r.isTtyError,this.logger.error(r),r}}async action({label:t,task:r}){let u=r();u instanceof Promise||(u=Promise.resolve(u));let i=t;return this.ora(u,i),u}isPackageTemplate(t){return Gn.includes(t)}async getGeneratorContext(){let t=mt(this.subPackages,Gn),r=await this.steps(t);if(this.isPackageTemplate(r.template)){let u=_t(this.subPackages),i=await this.steps(u);Object.assign(r,i)}return r.targetPath=N(process.cwd(),r.projectName),r.releasePath=r.releasePath||"src",r}async generate(){let t=await this.getGeneratorContext();if(this.logger.debug("context is:",t,this.context.options.templateRootPath),t.subPackages){await this.action({label:"Generate Directories(subPackages)",task:async()=>{await this.generateTemplateDir(t),await this.generateSubPackages(t),await this.generateConfigs(t,t.targetPath,"_common")}});return}await this.action({label:"Generate Directory",task:async()=>{await this.generateTemplateDir(t),await this.generateConfigs(t,t.targetPath,"_common"),await this.generateConfigs(t,t.targetPath,t.template)}})}async generateConfigs(t,r,u){let i=(a,l)=>(this.logger.debug("copyCallback",a,l),this.compose.composeConfigFile(t,a,l)),{configsRootPath:n,config:o}=this.context.options;if(!o){this.logger.debug("no copy config files");return}let s=N(n,u);if(!Nn(s)){this.logger.debug(`Config path not found: ${s}`);return}await this.copyer.copyPaths({sourcePath:s,targetPath:r,copyCallback:i})}generateTemplateDir(t){return this.copyer.copyPaths({sourcePath:N(this.context.options.templateRootPath,t.template),targetPath:t.targetPath})}async generateSubPackages(t){let{packagesNames:r="packages",subPackages:u=[],targetPath:i=""}=t,{templateRootPath:n}=this.context.options;for(let o of u){let s=N(n,o),a=N(i,r,o);this.logger.debug("copy sub package",s,a),await this.copyer.copyPaths({sourcePath:s,targetPath:a})}}};var Et={name:"@qlover/create-app",version:"0.7.13",description:"Create a new app with a single command",private:!1,type:"module",files:["dist","package.json","README.md","CHANGELOG.md"],bin:{"create-app":"dist/index.js"},scripts:{build:"tsup","create:app":"node ./dist/index.js"},repository:{type:"git",url:"git+https://github.com/qlover/fe-base.git",directory:"packages/create-app"},homepage:"https://github.com/qlover/fe-base#readme",keywords:["create-app","fe-scripts","scripts"],author:"qlover",license:"ISC",publishConfig:{access:"public"},devDependencies:{"@qlover/logger":"workspace:*",ignore:"^7.0.3",lodash:"^4.17.21",ora:"^8.1.1"},dependencies:{"@qlover/scripts-context":"workspace:*",commander:"^13.1.0",inquirer:"^12.3.2"}};function Kl(){let e=new zl;return e.version(Et.version,"-v, --version","Show version").description(Et.description).option("-d, --dry-run","Do not touch or write anything, but show the commands").option("-V, --verbose","Show more information").option("--config","Copy config files (default: true)",!0).option("--no-config","Do not copy config files"),e.parse(),e.opts()}async function kn(e=process.cwd()){let{dryRun:t,verbose:r,...u}=Kl(),i=Mn(e,"./templates"),n=Mn(e,"./configs");Ln(i)||(console.error("Template is empty!"),process.exit(1)),Ln(n)||(console.error("Configs is empty!"),process.exit(1)),await new Be({dryRun:t,verbose:r,options:{...u,templateRootPath:i,configsRootPath:n}}).generate()}import{fileURLToPath as Xl}from"url";import{dirname as Jl}from"path";var Zl=Xl(import.meta.url),Ql=Jl(Zl);kn(Ql).catch(e=>{console.error(e),process.exit(1)});
+`).map(o=>o.trim()).filter(o=>o&&!o.startsWith("#"));return(0,nr.default)().add(n)}async copyFiles(t,r,u,i){let n=await Dr.readdir(t);await Promise.all(n.map(async o=>{let s=Ze(t,o),a=Ze(r,o);if(u&&u.ignores(o))return;if(H.ensureDir(QD(a)),(await us(s)).isDirectory())await this.copyFiles(s,a,u,i);else{if(i&&await i(s,a))return;await rs(s,a)}}))}copyPaths({sourcePath:t,targetPath:r,copyCallback:u}){H.ensureDir(r);let i=this.getIg();return this.copyFiles(t,r,i,u)}};var jn=ue(In(),1);import{readFileSync as $l,writeFileSync as Ul,existsSync as Wl}from"fs";var _e=class{constructor(){}isJSONFilePath(t){return t.endsWith(".json")||t.endsWith(".json.template")}isTemplateFilePath(t){return t.endsWith(".template")}getRealTemplateFilePath(t){return t.replace(".template","")}readFile(t){return $l(t,"utf-8")}readJSONFile(t){return JSON.parse(this.readFile(t))}writeFile(t,r){Ul(this.getRealTemplateFilePath(t),r,{encoding:"utf-8"})}replaceFile(t,r){let u=this.readFile(t);return Object.keys(r).forEach(i=>{let n=r[i];u=u.replace(new RegExp(`\\[TPL:${i}\\]`,"g"),typeof n=="string"?n:JSON.stringify(n))}),u}mergeJSONFile(t,r){let u=this.readJSONFile(t),i=(0,jn.default)(r,u);this.writeFile(t,JSON.stringify(i,null,2))}composeConfigFile(t,r,u){if(this.isTemplateFilePath(r)){let i=this.replaceFile(r,t);if(this.isJSONFilePath(r)&&this.isJSONFilePath(u)){let n=this.getRealTemplateFilePath(u);return Wl(n)?(this.mergeJSONFile(n,JSON.parse(i)),!0):(this.writeFile(n,i),!0)}return this.writeFile(u,i),!0}return!1}};var Gn=["pack-app"],Be=class{ora;context;subPackages;copyer;compose;constructor(t){let r=t.options?.templateRootPath;if(!r)throw new Error("template path not exit");if(!Nn(r))throw new Error("template path not exit");this.ora=Kt,this.context=new Hl("create-app",t),this.subPackages=["node-lib","react-app","next-app"],this.copyer=new Ce(N(this.context.options.configsRootPath,"_common")),this.compose=new _e}get logger(){return this.context.logger}async steps(t){try{return await Yl.prompt(t)}catch(r){throw r.isTtyError,this.logger.error(r),r}}async action({label:t,task:r}){let u=r();u instanceof Promise||(u=Promise.resolve(u));let i=t;return this.ora(u,i),u}isPackageTemplate(t){return Gn.includes(t)}async getGeneratorContext(){let t=mt(this.subPackages,Gn),r=await this.steps(t);if(this.isPackageTemplate(r.template)){let u=_t(this.subPackages),i=await this.steps(u);Object.assign(r,i)}return r.targetPath=N(process.cwd(),r.projectName),r.releasePath=r.releasePath||"src",r}async generate(){let t=await this.getGeneratorContext();if(this.logger.debug("context is:",t,this.context.options.templateRootPath),t.subPackages){await this.action({label:"Generate Directories(subPackages)",task:async()=>{await this.generateTemplateDir(t),await this.generateSubPackages(t),await this.generateConfigs(t,t.targetPath,"_common")}});return}await this.action({label:"Generate Directory",task:async()=>{await this.generateTemplateDir(t),await this.generateConfigs(t,t.targetPath,"_common"),await this.generateConfigs(t,t.targetPath,t.template)}})}async generateConfigs(t,r,u){let i=(a,l)=>(this.logger.debug("copyCallback",a,l),this.compose.composeConfigFile(t,a,l)),{configsRootPath:n,config:o}=this.context.options;if(!o){this.logger.debug("no copy config files");return}let s=N(n,u);if(!Nn(s)){this.logger.debug(`Config path not found: ${s}`);return}await this.copyer.copyPaths({sourcePath:s,targetPath:r,copyCallback:i})}generateTemplateDir(t){return this.copyer.copyPaths({sourcePath:N(this.context.options.templateRootPath,t.template),targetPath:t.targetPath})}async generateSubPackages(t){let{packagesNames:r="packages",subPackages:u=[],targetPath:i=""}=t,{templateRootPath:n}=this.context.options;for(let o of u){let s=N(n,o),a=N(i,r,o);this.logger.debug("copy sub package",s,a),await this.copyer.copyPaths({sourcePath:s,targetPath:a})}}};var Et={name:"@qlover/create-app",version:"0.7.15",description:"Create a new app with a single command",private:!1,type:"module",files:["dist","package.json","README.md","CHANGELOG.md"],bin:{"create-app":"dist/index.js"},scripts:{build:"tsup","create:app":"node ./dist/index.js"},repository:{type:"git",url:"git+https://github.com/qlover/fe-base.git",directory:"packages/create-app"},homepage:"https://github.com/qlover/fe-base#readme",keywords:["create-app","fe-scripts","scripts"],author:"qlover",license:"ISC",publishConfig:{access:"public"},devDependencies:{"@qlover/logger":"workspace:*",ignore:"^7.0.3",lodash:"^4.17.21",ora:"^8.1.1"},dependencies:{"@qlover/scripts-context":"workspace:*",commander:"^13.1.0",inquirer:"^12.3.2"}};function Kl(){let e=new zl;return e.version(Et.version,"-v, --version","Show version").description(Et.description).option("-d, --dry-run","Do not touch or write anything, but show the commands").option("-V, --verbose","Show more information").option("--config","Copy config files (default: true)",!0).option("--no-config","Do not copy config files"),e.parse(),e.opts()}async function kn(e=process.cwd()){let{dryRun:t,verbose:r,...u}=Kl(),i=Mn(e,"./templates"),n=Mn(e,"./configs");Ln(i)||(console.error("Template is empty!"),process.exit(1)),Ln(n)||(console.error("Configs is empty!"),process.exit(1)),await new Be({dryRun:t,verbose:r,options:{...u,templateRootPath:i,configsRootPath:n}}).generate()}import{fileURLToPath as Xl}from"url";import{dirname as Jl}from"path";var Zl=Xl(import.meta.url),Ql=Jl(Zl);kn(Ql).catch(e=>{console.error(e),process.exit(1)});

package/dist/templates/next-app/README.en.md

@@ -0,0 +1,131 @@
+# Next.js Full-Stack Application Template
+
+A full-stack application template based on Next.js, implementing a clear front-end and back-end layered architecture using an interface-driven design pattern.
+
+[中文](./README.md)
+
+## 🌟 Key Features
+
+- 🏗️ Full-stack application architecture based on Next.js
+- 🔌 Interface-Driven Development pattern
+- 🎨 Theme system integrated with Tailwind CSS
+- 🌍 Comprehensive internationalization support (English & Chinese)
+- 🔄 TypeScript-based IOC container
+- 🛡️ Complete authentication and authorization system
+- 📡 Layered API architecture (Controllers, Services, Repositories)
+- 🎮 State management and page controller pattern
+- 🔗 SQL database bridging layer
+- 📦 Package management with pnpm
+
+## 🔧 Requirements
+
+- Node.js >= 16
+- pnpm >= 8.0
+
+## 📁 Project Structure
+
+```tree
+├── config/                     # Configuration directory
+│   ├── i18n/                  # Internationalization config
+│   ├── Identifier/            # Dependency injection identifiers
+│   ├── common.ts              # Common app configuration
+│   ├── IOCIdentifier.ts       # IOC container configuration
+│   └── theme.ts               # Theme configuration
+├── public/                    # Static assets directory
+├── src/
+│   ├── app/                  # Next.js app directory
+│   │   ├── [locale]/        # Internationalized routes
+│   │   ├── api/            # API route handlers
+│   │   └── layout.tsx      # Application layout
+│   ├── base/               # Client-side base code
+│   │   ├── port/          # Client interface definitions
+│   │   ├── cases/         # Business case implementations
+│   │   ├── services/      # Client service implementations
+│   │   └── types/         # Type definitions
+│   ├── server/            # Server-side code
+│   │   ├── port/         # Server interface definitions
+│   │   ├── services/     # Service implementations
+│   │   ├── repositorys/  # Data repositories
+│   │   ├── validators/   # Request validators
+│   │   └── sqlBridges/   # Database bridging layer
+│   ├── uikit/            # UI component library
+│   │   ├── components/   # Reusable components
+│   │   ├── context/     # React Context
+│   │   └── hook/        # React Hooks
+│   └── styles/          # Style files
+└── next.config.ts       # Next.js configuration file
+```
+
+## 🚀 Quick Start
+
+### Install Dependencies
+
+```bash
+pnpm install
+```
+
+### Development Mode
+
+```bash
+pnpm dev
+# cross-env APP_ENV=localhost next dev --turbopack --port 3100
+# Automatically loads .env.localhost -> .env
+
+pnpm dev:staging
+# cross-env APP_ENV=staging next dev --turbopack --port 3100
+# Automatically loads .env.staging -> .env
+```
+
+### Build Project
+
+```bash
+pnpm build
+```
+
+## 📚 Documentation Guide
+
+The project provides detailed development documentation covering all major features and best practices:
+
+### Basic Documentation
+
+- [Project Overview](./docs/en/index.md) - Project introduction and quick start guide
+- [Project Structure](./docs/en/project-structure.md) - Detailed project directory structure explanation
+- [Development Guide](./docs/en/development-guide.md) - Project development standards and best practices
+- [Environment Configuration](./docs/en/env.md) - Environment variables and configuration management
+- [Global Configuration](./docs/en/global.md) - Application global configuration and settings
+
+### Core Features
+
+- [Bootstrap Process](./docs/en/bootstrap.md) - Application startup process and lifecycle management
+- [IOC Container](./docs/en/ioc.md) - Dependency injection system usage guide
+- [Router Management](./docs/en/router.md) - Route configuration and page navigation
+- [State Management](./docs/en/store.md) - Application state management solution
+- [Request Handling](./docs/en/request.md) - API request handling mechanism
+
+### Feature Extensions
+
+- [Internationalization](./docs/en/i18n.md) - Multi-language support and translation management
+- [Theme System](./docs/en/theme.md) - Theme configuration and dark mode support
+- [TypeScript Guide](./docs/en/typescript-guide.md) - TypeScript usage standards and best practices
+
+## 🔨 Architecture Design
+
+### Interface-Driven Design Pattern
+
+The project adopts an interface-driven design pattern, achieving decoupling and testability through interface definitions:
+
+#### Client Interfaces (src/base/port)
+
+- **AppUserApiInterface**: User authentication related API interface
+- **AdminPageInterface**: Admin page base interface
+- **AsyncStateInterface**: Asynchronous state management interface
+- **RouterInterface**: Router management interface
+- **I18nServiceInterface**: Internationalization service interface
+
+#### Server Interfaces (src/server/port)
+
+- **ServerAuthInterface**: Server authentication interface
+- **DBBridgeInterface**: Database operation bridging interface
+- **UserRepositoryInterface**: User data repository interface
+- **ValidatorInterface**: Data validation interface
+- **ParamsHandlerInterface**: Parameter handling interface

package/dist/templates/next-app/README.md

@@ -1,36 +1,131 @@
-This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+# Next.js Full-Stack Application Template
 
-## Getting Started
+一个基于 Next.js 的全栈应用模板，采用面向接口的设计模式，实现了清晰的前后端分层架构。
 
-First, run the development server:
+[English](./README.en.md)
+
+## 🌟 特性亮点
+
+- 🏗️ 基于 Next.js 的全栈应用架构
+- 🔌 面向接口的设计模式（Interface-Driven Development）
+- 🎨 集成 Tailwind CSS 的主题系统
+- 🌍 完善的国际化支持（中英文）
+- 🔄 基于 TypeScript 的 IOC 容器
+- 🛡️ 完整的身份验证和授权系统
+- 📡 分层的 API 架构（控制器、服务、仓库）
+- 🎮 状态管理与页面控制器模式
+- 🔗 SQL 数据库桥接层
+- 📦 使用 pnpm 进行包管理
+
+## 🔧 环境要求
+
+- Node.js >= 16
+- pnpm >= 8.0
+
+## 📁 项目结构
+
+```tree
+├── config/                     # 配置文件目录
+│   ├── i18n/                  # 国际化配置
+│   ├── Identifier/            # 依赖注入标识符
+│   ├── common.ts              # 应用通用配置
+│   ├── IOCIdentifier.ts       # IOC容器配置
+│   └── theme.ts               # 主题配置
+├── public/                    # 静态资源目录
+├── src/
+│   ├── app/                  # Next.js 应用目录
+│   │   ├── [locale]/        # 国际化路由
+│   │   ├── api/            # API 路由处理器
+│   │   └── layout.tsx      # 应用布局
+│   ├── base/               # 客户端基础代码
+│   │   ├── port/          # 客户端接口定义
+│   │   ├── cases/         # 业务用例实现
+│   │   ├── services/      # 客户端服务实现
+│   │   └── types/         # 类型定义
+│   ├── server/            # 服务端代码
+│   │   ├── port/         # 服务端接口定义
+│   │   ├── services/     # 服务实现
+│   │   ├── repositorys/  # 数据仓库
+│   │   ├── validators/   # 请求验证器
+│   │   └── sqlBridges/   # 数据库桥接层
+│   ├── uikit/            # UI 组件库
+│   │   ├── components/   # 可复用组件
+│   │   ├── context/     # React Context
+│   │   └── hook/        # React Hooks
+│   └── styles/          # 样式文件
+└── next.config.ts       # Next.js 配置文件
+```
+
+## 🚀 快速开始
+
+### 安装依赖
+
+```bash
+pnpm install
+```
+
+### 开发模式
 
 ```bash
-npm run dev
-# or
-yarn dev
-# or
 pnpm dev
-# or
-bun dev
+# cross-env APP_ENV=localhost next dev --turbopack --port 3100
+# 自动加载 .env.localhost -> .env
+
+pnpm dev:staging
+# cross-env APP_ENV=staging next dev --turbopack --port 3100
+# 自动加载 .env.staging -> .env
+```
+
+### 构建项目
+
+```bash
+pnpm build
 ```
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+## 📚 文档指南
+
+项目提供了详细的开发文档，涵盖了所有主要功能和最佳实践：
+
+### 基础文档
+
+- [项目概述](./docs/zh/index.md) - 项目整体介绍和快速开始指南
+- [项目结构](./docs/zh/project-structure.md) - 详细的项目目录结构说明
+- [开发指南](./docs/zh/development-guide.md) - 项目开发规范和最佳实践
+- [环境配置](./docs/zh/env.md) - 环境变量和配置管理说明
+- [全局配置](./docs/zh/global.md) - 应用全局配置和设置说明
+
+### 核心功能
+
+- [启动流程](./docs/zh/bootstrap.md) - 应用启动流程和生命周期管理
+- [IOC容器](./docs/zh/ioc.md) - 依赖注入系统的使用说明
+- [路由管理](./docs/zh/router.md) - 路由配置和页面导航说明
+- [状态管理](./docs/zh/store.md) - 应用状态管理方案说明
+- [请求处理](./docs/zh/request.md) - API 请求处理机制说明
 
-You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+### 功能扩展
 
-This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+- [国际化](./docs/zh/i18n.md) - 多语言支持和翻译管理
+- [主题系统](./docs/zh/theme.md) - 主题配置和暗色模式支持
+- [TypeScript指南](./docs/zh/typescript-guide.md) - TypeScript 使用规范和最佳实践
 
-## Learn More
+## 🔨 架构设计
 
-To learn more about Next.js, take a look at the following resources:
+### 面向接口的设计模式
 
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+项目采用面向接口的设计模式，通过接口定义实现解耦和可测试性：
 
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+#### 客户端接口 (src/base/port)
 
-## Deploy on Vercel
+- **AppUserApiInterface**: 用户认证相关API接口
+- **AdminPageInterface**: 管理页面基础接口
+- **AsyncStateInterface**: 异步状态管理接口
+- **RouterInterface**: 路由管理接口
+- **I18nServiceInterface**: 国际化服务接口
 
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+#### 服务端接口 (src/server/port)
 
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+- **ServerAuthInterface**: 服务端认证接口
+- **DBBridgeInterface**: 数据库操作桥接接口
+- **UserRepositoryInterface**: 用户数据仓库接口
+- **ValidatorInterface**: 数据验证接口
+- **ParamsHandlerInterface**: 参数处理接口

package/dist/templates/next-app/config/IOCIdentifier.ts

@@ -1,9 +1,9 @@
 import type { AppConfig } from '@/base/cases/AppConfig';
 import type { DialogHandler } from '@/base/cases/DialogHandler';
 import type { RouterService } from '@/base/cases/RouterService';
-import type { DBBridgeInterface } from '@/base/port/DBBridgeInterface';
 import type { I18nService } from '@/base/services/I18nService';
 import type { UserService } from '@/base/services/UserService';
+import type { DBBridgeInterface } from '@/server/port/DBBridgeInterface';
 import type * as CorekitBridge from '@qlover/corekit-bridge';
 import type * as FeCorekit from '@qlover/fe-corekit';
 import type { LoggerInterface } from '@qlover/logger';
@@ -22,6 +22,19 @@ export const IOCIdentifier = Object.freeze({
   UserServiceInterface: 'UserServiceInterface',
   RouterServiceInterface: 'RouterServiceInterface',
   I18nServiceInterface: 'I18nServiceInterface',
+  /**
+   * 数据库桥接接口
+   *
+   * 你可以实现不同的例如：
+   *
+   * - Vercel Postgres
+   * - supabase
+   * - mysql
+   * - postgresql
+   * - mongodb
+   * - redis
+   * - sqllite
+   */
   DBBridgeInterface: 'DBBridgeInterface'
 });
 

package/dist/templates/next-app/config/Identifier/index.ts

@@ -2,6 +2,7 @@ export * from './api';
 export * from './common';
 export * from './common.error';
 export * from './page.about';
+export * from './page.admin';
 export * from './page.executor';
 export * from './page.home';
 export * from './page.identifiter';

package/dist/templates/next-app/config/Identifier/page.admin.ts

@@ -0,0 +1,48 @@
+/**
+ * @description Admin page title
+ * @localZh 管理员页面
+ * @localEn Admin page
+ */
+export const PAGE_ADMIN_TITLE = 'page__admin__title';
+
+/**
+ * @description Admin page description
+ * @localZh 管理员页面
+ * @localEn Admin page
+ */
+export const PAGE_ADMIN_DESCRIPTION = 'page__admin__description';
+
+/**
+ * @description Admin page keywords
+ * @localZh 管理员页面关键词
+ * @localEn Admin page
+ */
+export const PAGE_ADMIN_KEYWORDS = 'page__admin__keywords';
+
+/**
+ * @description Home page welcome message
+ * @localZh 欢迎来到管理员页面
+ * @localEn Welcome to the admin page
+ */
+export const ADMIN_WELCOME = 'admin__welcome';
+
+/**
+ * @description Admin users page title
+ * @localZh 后台管理 - 管理员用户页面
+ * @localEn Admin users page
+ */
+export const PAGE_ADMIN_USERS_TITLE = 'page__admin__users__title';
+
+/**
+ * @description Admin users page description
+ * @localZh 后台管理 - 管理员用户页面
+ * @localEn Admin users page
+ */
+export const PAGE_ADMIN_USERS_DESCRIPTION = 'page__admin__users__description';
+
+/**
+ * @description Admin users page keywords
+ * @localZh 后台管理 - 管理员用户页面关键词
+ * @localEn Admin users page keywords
+ */
+export const PAGE_ADMIN_USERS_KEYWORDS = 'page__admin__users__keywords';

package/dist/templates/next-app/config/i18n/admin18n.ts

@@ -0,0 +1,33 @@
+import * as i18nKeys from '../Identifier/page.admin';
+
+/**
+ * Register page i18n interface
+ *
+ * @description
+ * - welcome: welcome message
+ */
+export type AdminI18nInterface = typeof admin18n;
+
+export const admin18n = Object.freeze({
+  // basic meta properties
+  title: i18nKeys.PAGE_ADMIN_TITLE,
+  description: i18nKeys.PAGE_ADMIN_DESCRIPTION,
+  content: i18nKeys.PAGE_ADMIN_DESCRIPTION,
+  keywords: i18nKeys.PAGE_ADMIN_KEYWORDS,
+
+  // admin page
+  welcome: i18nKeys.ADMIN_WELCOME
+});
+
+export type AdminUsersI18nInterface = typeof adminUsers18n;
+
+export const adminUsers18n = Object.freeze({
+  // basic meta properties
+  title: i18nKeys.PAGE_ADMIN_USERS_TITLE,
+  description: i18nKeys.PAGE_ADMIN_USERS_DESCRIPTION,
+  content: i18nKeys.PAGE_ADMIN_USERS_DESCRIPTION,
+  keywords: i18nKeys.PAGE_ADMIN_USERS_KEYWORDS,
+
+  // admin page
+  welcome: i18nKeys.ADMIN_WELCOME
+});

package/dist/templates/next-app/config/i18n/index.ts

@@ -1,4 +1,6 @@
+export * from './HomeI18n';
+export * from './admin18n';
 export * from './i18nConfig';
-export * from './PageI18nInterface';
 export * from './loginI18n';
+export * from './PageI18nInterface';
 export * from './register18n';