sfu-dhil / sen

Social and Economic Networks

Social and Economic Networks

Social and Economic Networks (affectionately known as SEN) is a PHP application written using the Symfony Framework. It is a digital tool for collecting census data in the antebellum south.

Requirements

We have tried to keep the requirements minimal. How you install these requirements is up to you, but we have provided some recommendations

• Apache >= 2.4
• PHP >= 7.4
• Composer >= 2.0
• MariaDB >= 10.8¹
• Yarn >= 1.22

Installation

1. Fork and clone the project from GitHub.

2. Install the git submodules. git submodule update --init is a good way to do this

3. Install composer dependencies with composer install.

4. Install yarn dependencies with yarn install.

5. Create a MariaDB database and user.

    DROP DATABASE IF EXISTS sen;
    CREATE DATABASE sen;
    DROP USER IF EXISTS sen@localhost;
    CREATE USER sen@localhost IDENTIFIED BY 'abc123';
    GRANT ALL ON sen.* TO sen@localhost;

6. Copy .env to .env.local and edit configuration to suite your needs.

7. Either 1) create the schema and load fixture data, or 2) load a MySQLDump file if one has been provided.

   1.  php ./bin/console doctrine:schema:create --quiet
       php ./bin/console doctrine:fixtures:load --group=dev --purger=fk_purger

   2. ```bash
     mysql sen < sen.sql
   

8. Visit http://localhost/sen

9. happy coding!

Some of the steps above are made easier with the included MakeFiles which are in a git submodule. If you missed step 2 above they will be missing.

Footnotes

1. A similar version of MySQL should also work, but will not be supported. ↩

sen's Issues

Race field fixes

The race field needs the following specs:

• Term as present in archival record
• Standardized term
• Note field that allows PI to describe what's going on

Transaction Details display

Is your feature request related to a problem? Please describe.
Ease of functionality but not a problem.

Describe the solution you'd like
Please rearrange the columns as follows:

1. Firstparty
2. First Party Note
3. Conjunction
4. Secondparty
5. Second Party Note
6. Category
7. Notes
8. Date
9. Ledger
10. Page
11. Created
12. Updated

Describe alternatives you've considered
None

User Information
This arrangement will highlight the information the user is more likely to be looking for and group the information needed to find additional details (date, ledger, page) together.

Additional context

Bad issue test 2

What isn’t working as expected on the website? (required)

If you encountered an error message, please take a screenshot and paste it below. (required)

Is this the first time the error occurred? If not, describe its frequency. (required)

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

What steps did you take before you encountered the bug? (required)

What browser, operating system, and device were you using when you encountered the error? (required)

Additional context (optional)

Test Bug Report - Please Ignore

What isn’t working as expected on the website? (required)

Cheese isn't cheesy enough. Needs more cheese.

If you encountered an error message, please take a screenshot and paste it below. (required)

n/a

Is this the first time the error occurred? If not, describe its frequency. (required)

I've never been satisfied with the cheesiness of cheese.

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

http://example.com/cheese

What steps did you take before you encountered the bug? (required)

I ate some cheese.

What browser, operating system, and device were you using when you encountered the error? (required)

cheddar, gouda, etc.

Additional context (optional)

Gorgonzola is cheesier than most, but could be better.

Sort order of Browse drop down menu

What isn’t working as expected on the website? (required)

"Birth Statuses" appears between "Races" and "Relationships" instead of above "Cities"

If you encountered an error message, please take a screenshot and paste it below. (required)

n/a

Is this the first time the error occurred? If not, describe its frequency. (required)

Every time I use the Browse menu.

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

https://dhil.lib.sfu.ca/sen/person/

What steps did you take before you encountered the bug? (required)

Opened the Browse dropdown menu.

What browser, operating system, and device were you using when you encountered the error? (required)

Firefox 90.0.2 (64-bit), Mac OS Majave 10.14.6

Additional context (optional)

Tried to delete person and got error page

What isn’t working as expected on the website? (required)

I tried to delete a person (Crespo Y Dolong-Palmes, Augustine De La Ascensión) because she had two person pages (this one with an incorrect spelling of her first name) and I received the internal error message.

If you encountered an error message, please take a screenshot and paste it below. (required)

Is this the first time the error occurred? If not, describe its frequency. (required)

Yes. I haven't tried deleting another person.

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

https://dhil.lib.sfu.ca/en/person/671

What steps did you take before you encountered the bug? (required)

Navigated to this person details page from a person search.

What browser, operating system, and device were you using when you encountered the error? (required)

Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:89.0 Gecko/20100101 Firefox/89.0

Additional context (optional)

New/Edit Transaction page, required fields

What isn’t working as expected on the website? (required)

The following categories are set as required: Date, Page, First Party Note, Conjunction, and Second Party Note. As far as I can tell, this is the only edit/new page that has any fields designated as required. If any fields are to be required, they should be Date, Category, Ledger, Page, and First Party.

If you encountered an error message, please take a screenshot and paste it below. (required)

I cannot save an edited transaction or a new one without completing these fields.

Is this the first time the error occurred? If not, describe its frequency. (required)

Every time I try to edit or enter a new transaction.

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

https://dhil.lib.sfu.ca/sen/transaction/new

What steps did you take before you encountered the bug? (required)

I tried to enter a new transaction but didn't have information for the necessary required fields.

What browser, operating system, and device were you using when you encountered the error? (required)

Firefox 90.0.2 (64-bit), Mac OS Majave 10.14.6

Additional context (optional)

New Transaction page, Category and Conjunction fields

Is your feature request related to a problem? Please describe.
If possible, I would like to request drop down menus for the Category and Conjunction entry fields.

Describe the solution you'd like
A drop down menu activated by clicking on the arrow to the right of the entry box would be greatly appreciated. For Category, the drop down menu should include all of the categories on the Transaction Category List (https://dhil.lib.sfu.ca/sen/transaction_category/). For Conjunction, it should include "and", "to" and "[blank]".

Describe alternatives you've considered
If drop down menus are not easy, the status quo is fine.

User Information
This menu will help users unfamiliar with the standardized categories we are using.

Additional context
Add any other context or screenshots about the feature request here.

Event Details, death sources not imported

What isn’t working as expected on the website? (required)

16 rows of the Sacramental Records spreadsheet had sources for deaths but none have been imported:

• De La Peña, José
• Declouet, Alexander Francois Joseph
• Declouet, Alexandre Joseph
• Declouet, Charles Phillippe Auguste
• Declouet, Eliza
• Declouet, Francisco
• Declouet, Joseph Alexandre
• Declouet, Joseph Augustine
• Declouet, Louis Jean Laurent Brognier
• Declouet, Luis (bn. 1800)
• Declouet, Luis (bn. 1801)
• Declouet, Luisa Avelina
• Favrot, Louise
• Latill, Charles alias Esteves
• Latill, Luisa Virginea
• Villaescusa, Henrietta

If you encountered an error message, please take a screenshot and paste it below. (required)

n/a

Is this the first time the error occurred? If not, describe its frequency. (required)

n/a

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

https://dhil.lib.sfu.ca/sen/event/17
https://dhil.lib.sfu.ca/sen/event/26
https://dhil.lib.sfu.ca/sen/event/42
https://dhil.lib.sfu.ca/sen/event/53
https://dhil.lib.sfu.ca/sen/event/55
https://dhil.lib.sfu.ca/sen/event/58
https://dhil.lib.sfu.ca/sen/event/60
https://dhil.lib.sfu.ca/sen/event/23
https://dhil.lib.sfu.ca/sen/event/46
https://dhil.lib.sfu.ca/sen/event/71
https://dhil.lib.sfu.ca/sen/event/68
https://dhil.lib.sfu.ca/sen/event/75
https://dhil.lib.sfu.ca/sen/event/93
https://dhil.lib.sfu.ca/sen/person/765
https://dhil.lib.sfu.ca/sen/event/116
https://dhil.lib.sfu.ca/sen/event/129

What steps did you take before you encountered the bug? (required)

n/a

What browser, operating system, and device were you using when you encountered the error? (required)

Firefox 90.0.2 (64-bit), Mac OS Majave 10.14.6

Additional context (optional)

Importing of name fields

What isn’t working as expected on the website? (required)

Please remove autocapitalization of First Name and Last Name fields from both Sacramental and Notarial records imports. Proper capitalization will be the responsibility of the person entering the data.

If you encountered an error message, please take a screenshot and paste it below. (required)

n/a

Is this the first time the error occurred? If not, describe its frequency. (required)

n/a

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

e.g. https://dhil.lib.sfu.ca/sen/person/678

What steps did you take before you encountered the bug? (required)

n/a

What browser, operating system, and device were you using when you encountered the error? (required)

Firefox 90.0.2 (64-bit), Mac OS Majave 10.14.6

Additional context (optional)

City List import

What isn’t working as expected on the website? (required)

Import from spreadsheet to City List.

If you encountered an error message, please take a screenshot and paste it below. (required)

n/a

Is this the first time the error occurred? If not, describe its frequency. (required)

n/a

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

https://dhil.lib.sfu.ca/sen/city/

What steps did you take before you encountered the bug? (required)

n/a

What browser, operating system, and device were you using when you encountered the error? (required)

Firefox 90.0.2 (64-bit), Mac OS Majave 10.14.6

Additional context (optional)

Import from Sacramental Records spreadsheet. Five rows had residence data. Three were entered "street address, city, state" but two only had "city, state". The first three have been correctly captured as "New Orleans, Louisiana" but the latter two seem to have been identified "New Orleans" as the street address and "Louisiana" as the city.

Person List alphabetization

What isn’t working as expected on the website? (required)

Alphabetization of person list should be by last name, first name.

If you encountered an error message, please take a screenshot and paste it below. (required)

n/a

Is this the first time the error occurred? If not, describe its frequency. (required)

Every time I open the Person List page.

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

https://dhil.lib.sfu.ca/sen/person/

What steps did you take before you encountered the bug? (required)

I edited the five persons now appearing at the top of the Person List -- Domingo (Ferrier), Francisca (Delavilebeuvre), Francisca (Trepagnier), Maria (De Lafornchere), Maria (Delavilebeuvre) -- by adding their former slave owner's surname in parenthesis to their first name field so has to be able to distinguish between different individuals with the same first name. After making these edits, the five started appearing at the beginning of the alphabetized list instead of where they should in the alphabetized list (e.g. "?, Domigno" should appear between "?, Cirpriana" and "?, Ester").

What browser, operating system, and device were you using when you encountered the error? (required)

Firefox 90.0.2 (64-bit), Mac OS Majave 10.14.6

Additional context (optional)

Relationships List not for public viewing

Is your feature request related to a problem? Please describe.
Please make this list (https://dhil.lib.sfu.ca/sen/relationship/) only viewable to users who have log in privileges to the site.

Describe the solution you'd like

Describe alternatives you've considered

User Information
This information is best used to check for errors in imports and since relationships only appear one way (i.e. X is mother of Y but not also Y is child of X), it could be confusing to viewers.

Additional context

Manumission Event Category Details date import

What isn’t working as expected on the website? (required)

In the Event List page (https://dhil.lib.sfu.ca/sen/event/?page=1), the dates for the two manumission entries (Brouner at the bottom of page 1 and Beaurepos towards the top of page 2) are the only ones appearing as YYYY-MM-DD instead of being imported from the [event]_date_written column in the Sacramental Records spreadsheet. I had left the manumission_date_written columns blank in the spreadsheet but will correct that so please change the code to import from the manumission_date_written column instead of the manumission_date column for the first column of the Event List page.

If you encountered an error message, please take a screenshot and paste it below. (required)

n/a

Is this the first time the error occurred? If not, describe its frequency. (required)

n/a

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

https://dhil.lib.sfu.ca/sen/event/?page=1
https://dhil.lib.sfu.ca/sen/event/?page=2

What steps did you take before you encountered the bug? (required)

n/a

What browser, operating system, and device were you using when you encountered the error? (required)

Firefox 90.0.2 (64-bit), Mac OS Majave 10.14.6

Additional context (optional)

When I go to the About page my computer catches fire.

What isn’t working as expected on the website? (required)

I was expecting the About page to work. Instead it caught fire.

If you encountered an error message, please take a screenshot and paste it below. (required)

I did not encounter any errors. I just burned.

Is this the first time the error occurred? If not, describe its frequency. (required)

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

http://www.grougreougergergu.org

What steps did you take before you encountered the bug? (required)

What browser, operating system, and device were you using when you encountered the error? (required)

OS54

Additional context (optional)

Emancipation and Marriage transactions are also events

When creating a marriage or emancipation transaction from the notarial data, we must also create a corresponding event. The source of the event is the notarial record. The date of the event is the date in the ledger.

For marriage the spouse can be first party spouse or second party.

for emancipation the first party is the slave owner and former enslaved person would always be second party. There may not be a first party if the transaction is "registration of emancipation"

Event Details source field

What isn’t working as expected on the website? (required)

Two fields are named "Note". The second should be named "Source".

If you encountered an error message, please take a screenshot and paste it below. (required)

n/a

Is this the first time the error occurred? If not, describe its frequency. (required)

n/a

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

e.g. https://dhil.lib.sfu.ca/sen/event/105

What steps did you take before you encountered the bug? (required)

n/a

What browser, operating system, and device were you using when you encountered the error? (required)

Firefox 90.0.2 (64-bit), Mac OS Majave 10.14.6

Additional context (optional)

Test bad bug report

What isn’t working as expected on the website? (required)

If you encountered an error message, please take a screenshot and paste it below. (required)

Is this the first time the error occurred? If not, describe its frequency. (required)

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

What steps did you take before you encountered the bug? (required)

What browser, operating system, and device were you using when you encountered the error? (required)

Additional context (optional)

Relationship Category Details list

What isn’t working as expected on the website? (required)

Relationship Category Details list is unlimited and should be standardized as are other list pages (I think it's 25 entries per page).

If you encountered an error message, please take a screenshot and paste it below. (required)

n/a

Is this the first time the error occurred? If not, describe its frequency. (required)

Every time I open the Relationship Category Details page.

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

https://dhil.lib.sfu.ca/sen/relationship_category/1

What steps did you take before you encountered the bug? (required)

Opened this page.

What browser, operating system, and device were you using when you encountered the error? (required)

Firefox 90.0.2 (64-bit), Mac OS Majave 10.14.6

Additional context (optional)

Edit Event, Witnesses entry box missing

What isn’t working as expected on the website? (required)

When I try to edit an event (or add a new one), there is no entry box for witnesses.

If you encountered an error message, please take a screenshot and paste it below. (required)

n/a

Is this the first time the error occurred? If not, describe its frequency. (required)

Every time I try to edit an event or add a new one.

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

https://dhil.lib.sfu.ca/sen/event/25/edit

What steps did you take before you encountered the bug? (required)

From Event Details page, I clucked on the Edit button.

What browser, operating system, and device were you using when you encountered the error? (required)

Firefox 90.0.2 (64-bit), Mac OS Majave 10.14.6

Additional context (optional)

Ability to group racial categories together

PI needs a way group racial categories together (e.g., see all mulattos, male and female, together)

Transaction List display page

Is your feature request related to a problem? Please describe.
Ease of functionality request but not a problem.

Describe the solution you'd like
Please rearrange the order of the columns as follows: First Party, Conj., Second Party, Category, Date.

Describe alternatives you've considered
None

User Information
This will facilitate users who are browsing for the names of specific parties.

Additional context

Person List display

Is your feature request related to a problem? Please describe.
Ease of function request

Describe the solution you'd like
Please include the following column categories on the Person List display page (https://dhil.lib.sfu.ca/sen/person/) in this order:

1. Name
2. Race
3. Sex
4. Status
5. Birth Date as Written

Describe alternatives you've considered
None

User Information
Emphasizes the most important information about individuals that users might be looking for.

Additional context

Relationship Category Details list

What isn’t working as expected on the website? (required)

First and third columns should be flipped. E.g. on the Child list, first row, "Brouner, Louison" is the child of "?, Maria Juana".

If you encountered an error message, please take a screenshot and paste it below. (required)

n/a

Is this the first time the error occurred? If not, describe its frequency. (required)

n/a

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

https://dhil.lib.sfu.ca/sen/relationship_category/1
https://dhil.lib.sfu.ca/sen/relationship_category/2
https://dhil.lib.sfu.ca/sen/relationship_category/9
https://dhil.lib.sfu.ca/sen/relationship_category/7
https://dhil.lib.sfu.ca/sen/relationship_category/8
https://dhil.lib.sfu.ca/sen/relationship_category/3
https://dhil.lib.sfu.ca/sen/relationship_category/4

What steps did you take before you encountered the bug? (required)

n/a

What browser, operating system, and device were you using when you encountered the error? (required)

Firefox 90.0.2 (64-bit), Mac OS Majave 10.14.6

Additional context (optional)

internal error message

What isn’t working as expected on the website? (required)

Person search

If you encountered an error message, please take a screenshot and paste it below. (required)

2021-06-02T10:26:26-07:00
172.218.242.231
GET https://dhil.lib.sfu.ca/sen/person/search?q=mulatto
https://dhil.lib.sfu.ca/sen/person/search
500 - Doctrine\ORM\Query\QueryException
[Semantical Error] line 0, col 29 near 'first_name, person.last_name)': Error: Class App\Entity\Person has no field or association named first_name
Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:88.0) Gecko/20100101 Firefox/88.0

Is this the first time the error occurred? If not, describe its frequency. (required)

Yes

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

https://dhil.lib.sfu.ca/sen/person/search

What steps did you take before you encountered the bug? (required)

Entered "mulatto" into search term box and clicked "search"

What browser, operating system, and device were you using when you encountered the error? (required)

Firefox 88.0.1 (64 bit), Mac OS 10.14.6 (Mojave)

Additional context (optional)

Tried to add new event

What isn’t working as expected on the website? (required)

When I tried to save a new event, I received this error message.

If you encountered an error message, please take a screenshot and paste it below. (required)

Is this the first time the error occurred? If not, describe its frequency. (required)

Yes.

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

https://dhil.lib.sfu.ca/sen/event/new

What steps did you take before you encountered the bug? (required)

Entered information and pressed save button.

What browser, operating system, and device were you using when you encountered the error? (required)

Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:89.0) Gecko/20100101 Firefox/89.0

Additional context (optional)

Links to related persons on person pages broken

What isn’t working as expected on the website? (required)

Links to a related person (i.e. someone's child) should link to another page, but they do not.

If you encountered an error message, please take a screenshot and paste it below. (required)

N/A

Is this the first time the error occurred? If not, describe its frequency. (required)

It happens on all person show pages

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

See person/645 and try to click on "Father: Marigny De Mandeville, Antoine Philippe"; it is a link, but it links back to person/645.

What steps did you take before you encountered the bug? (required)

Went to a person page via the browse

What browser, operating system, and device were you using when you encountered the error? (required)

Chrome etc

Additional context (optional)

error message

What isn’t working as expected on the website? (required)

I had the create residence form open but hadn't entered any information and accidentally hit save instead of cancel.

If you encountered an error message, please take a screenshot and paste it below. (required)

2021-06-02T10:21:38-07:00
172.218.242.231
GET https://dhil.lib.sfu.ca/sen/residence/new
https://dhil.lib.sfu.ca/sen/residence/new
500 - Doctrine\DBAL\Exception\NotNullConstraintViolationException
An exception occurred while executing 'INSERT INTO residence (date, created, updated, person_id, city_id) VALUES (?, ?, ?, ?, ?)' with params [null, "2021-06-02 10:21:37", "2021-06-02 10:21:37", null, null]:

SQLSTATE[23000]: Integrity constraint violation: 1048 Column 'person_id' cannot be null
Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:88.0) Gecko/20100101 Firefox/88.0

Is this the first time the error occurred? If not, describe its frequency. (required)

Yes

What is the URL of the page where you encountered the bug? [Type NA if not applicable] (required)

https://dhil.lib.sfu.ca/sen/residence/new

What steps did you take before you encountered the bug? (required)

From https://dhil.lib.sfu.ca/sen/residence/, I clicked the "new" button, didn't enter any data, and then clicked "save"

What browser, operating system, and device were you using when you encountered the error? (required)

Firefox 88.0.1 (64 bit), Mac OS 10.14.6 (Mojave)

Additional context (optional)

Need an event archival source

The PI needs a way to keep track of the source of events (e.g., wedding event has a church record, what exactly is that record)?

PI needs to be able to enter details about that source

Person Details page, Relationship box sort order

Is your feature request related to a problem? Please describe.
Ease and consistency of use.

Describe the solution you'd like
I would like to request a customized sort order for the types of relationships that appear in the Relationship box as follows:

1. father
2. mother
3. spouse
4. child
5. godchild

Describe alternatives you've considered
n/a

User Information
By grouping spouses, children, and godchildren separately, the user will be able to easily identify the number of people in each relationship category.

Additional context
Add any other context or screenshots about the feature request here.