### 目录结构
* 目录结构 以 本项目 开心猫市/贴心猫文档 为例
```
[Web-Root]
│ bbs.php 拟扩展论坛（入口）
│ book.php 贴心猫文档（入口）
│ demo.php 文档演示（入口）
│ home.php 开心猫市（入口）
│ ... (自由扩展)
│ robots.txt
│
├─@read : readme files
├─html : 静态文件目录
├─imcat : 核心类库,流程代码,语言包等
│ ├─adpt : api/驱动类库
│ ├─core : 核心类库
│ ├─flow : 后台管理 流程脚本
│ └─lang : 多语言包
├─job6 : 虚拟简历 (sdiy模式-Smart-Diy(自定义)简易模式)
├─kits : 工具包演示 (php工具包)
├─root : 各种入口及配置;
│ ├─a3rd : 第三方 [登录/支付] 接口
│ ├─cfgs : 配置
│ ├─error : 错误页
│ ├─extra : 扩展脚本
│ ├─plus : 接口插件,ajax入口
│ ├─run : 启动文件及常用入口(最初规划在root根目录)
│ └─tools : 工具,二次开发,安装入口等
├─ures : 上传资源附件目录;
├─views : 视图模板(每套模版一个子目录)
│ ├─adm : 后台管理
│ ├─base : 基础视图(含引导首页)
│ ├─bbs : 拟扩展论坛
│ ├─book : 贴心猫文档
│ ├─comm : 贴心猫市
│ ├─demo : 文档演示
│ ├─sapi : APP-API 服务端
│ └─... (自由扩展)
├─ximps : 导入文件(静态图,第三方组件)
│ ├─static : 静态图片,图标,附件,字体等文件;
│ ├─vendor : 第三方PHP代码或组件;
│ └─vendui : 第三方前端代码或组件;
└─xvars : 可变动态文件(缓存,临时文件)
├─ctpl : Tpl-缓存目录
├─dbexp : 导出源sql
├─dborg : 安装源sql
├─debug : 调试文件
├─dtmp : 缓存/临时文件目录
└─remote : 远程采集缓存
```
### 写权限设置
以下目录/文件，需要写权限
* 目录 `/xvars/` 缓存,临时文件
* 目录 `/ures/` 上传资源附件目录
* 文件 `/root/boot/_paths.php` 路径配置（初始安装时，可能自动改写，或手动配置）
* 文件 `/root/boot/cfg_db.php` db配置（初始安装时，可能自动改写，或手动配置）
* 文件 `/root/boot/const.php` 基本参数（系统升级时，可能自动改写）
### 常用目录
#### 贴心猫-通用系统
* 模板目录概览
- /views/ - 项目模板:总目录
- /views/adm/ - 后台管理模板
- /views/base/ - 基础工具模板，如:map,动态js/css,工具等
- /views/comm/ - 默认前端展示模板（企业站为中文版模板）
- ... 其他模板
#### 贴心博客
* 前端`comm`模板 详情
- /views/comm/\_config/ - 功能演示版配置
- /views/comm/\_ctrls/ - 控制器方法扩展代码
- /views/comm/assets/ - 资源目录，如css,js,images
- /views/comm/about/ - 介绍模型模板
- /views/comm/home/ - 首页模板/公共区块，如头尾等
- /views/comm/info/ - 留言/导航等杂项模板
- /views/comm/wall/ - 便笺墙模板
- /views/comm/home/\_head.htm - 公共头文件
- /views/comm/home/\_foot.htm - 公共尾文件
- /views/comm/home/mhome.htm - 首页模板
* 导航首页相关文件目录
- /views/base/home/ - 首页/跳转 相关总目录
- /views/base/home/tips.htm - 本说明模板
- /views/base/home/\_layout.htm - 首页布局（预留）
- 首页跳转更多DIY，修改控制器文件 `/views/base/_ctrls/homeCtrl.php` 内的 `homeAct()` 方法
#### 爱窝房产系统
* 前端`comm`模板 详情
- /views/comm/\_config/ - 模板配置
- /views/comm/\_ctrls/ - 控制器方法扩展代码
- /views/comm/assets/ - 资源目录，如css,js,images
- /views/comm/about/ - 公司介绍模型模板
- /views/comm/house/ - 楼盘模型模板
- /views/comm/suite/ - 房源（出租，出售）模板
- /views/comm/home/ - 前端首页模板
- /views/comm/info/ - 留言/导航等杂项模板
- /views/comm/news/ - 资讯模型模板
- /views/comm/faqs/ - 问答模板
- /views/comm/topic/ - 专题模板
- /views/comm/u-inc/ - 公共区块，如头尾等
- /views/comm/u-inc/ahead.htm - 公共头文件
- /views/comm/u-inc/afoot.htm - 公共尾文件
- /views/comm/u-inc/amenu.htm - 公共菜单文件
* 导航首页相关文件目录
- /views/base/home/ - 导航首页相关 总目录
- /views/base/home/en.htm - 首页模板(英文版，预留)
- /views/base/home/cn.htm - 首页模板(中文版，预留)
- /views/base/home/_layout.htm - 首页布局
- 首页需自定义跳转或更多DIY，修改控制器文件 `/views/base/_ctrls/homeCtrl.php` 内的 `homeAct()` 方法
#### 开心企业站
* 模板目录概览
- /views/comm/ - 中文版模板（默认）
- /views/ven/ - 英文版模板
- /views/ves/ - 西班牙语模板
- /views/vfr/ - 法语模板
- /views/vru/ - 俄语模板
* 前端`comm`(中文版)模板 详情
- /views/comm/\_config/ - 中文版配置
- /views/comm/\_ctrls/ - 控制器方法扩展代码
- /views/comm/assets/ - 资源目录，如css,js,images
- /views/comm/about/ - 公司介绍模型模板
- /views/comm/cargo/ - 产品展示模型模板
- /views/comm/home/ - 中文版首页模板
- /views/comm/info/ - 留言/导航等杂项模板
- /views/comm/news/ - 资讯模型模板
- /views/comm/u-inc/ - 公共区块，如头尾等
- /views/comm/u-inc/ahead.htm - 公共头文件
- /views/comm/u-inc/afoot.htm - 公共尾文件
- /views/comm/u-inc/amenu.htm - 公共菜单文件
* 导航首页相关文件目录
- /views/base/home/ - 首页相关 总目录
- /views/base/home/en.htm - 首页模板(英文版)
- /views/base/home/cn.htm - 首页模板(中文版，预留)
- /views/base/home/\_layout.htm - 首页布局
- 首页需跳转或更多DIY，修改控制器文件 `/views/base/_ctrls/homeCtrl.php` 内的 `homeAct()` 方法
### 术语说明
* 申明
- 贴心猫，尽量不创造新的术语名称！
- 以下几个行业通用的说法，这里提示一下。
* 项目(应用/App)
- 整个贴心猫就是一个php建站项目（或叫应用）；
- 由贴心猫二次开发的 博客，房产，企业站都是一个项目；
- 本文档中，`多项目部署`相关章节提到过：多个项目公用一部分公共文件/代码。
* 模块(功能模块/Module)
- 一组相关的功能组合，称一个功能模块，如`后台管理`，`会员中心`，`pc展示`，`wap展示`等；
- 贴心猫中，按功能模块划分入口文件，设置模板分组；
* 模型(Model)
- 同一类数据，就是一个模型，一般对应一个数据表(或多个表)；
如：新闻(news)，产品(product)，博客文章(blog)，楼盘(house)，留言(gbook)；
- 前台为展示需要，把几个页面组合在一起，也按`模型`的方式处理，但不对应任何数据；
* 路由(Route)
- 路由就是系统定义的 url中特定的参数，根据它来关联模板/处理数据/展示数据；
- 详见：[Mkv路由]({surl(book:coreb-route)})
-End-